Agenți AI (MCP)

Seturi de instrumente și instrumente

Cum expune serverul MCP AmICited peste 300 de instrumente fără a inunda contextul agentului dumneavoastră: un set mic anunțat, patru meta-instrumente pentru găsirea și rularea celorlalte și douăsprezece seturi de instrumente.

Deschideți în ChatGPT Deschideți în Claude

Serverul MCP AmICited înregistrează peste 300 de instrumente, câte unul pentru tot ce poate face dashboardul. Predarea tuturor acestor definiții unui model la fiecare cerere ar consuma o mare parte din contextul lui înainte de a face vreo muncă, iar modelele aleg instrumentele mai prost dintr-o listă foarte lungă. Așa că serverul le dezvăluie progresiv: clientul dumneavoastră vede o listă scurtă, iar agentul caută restul când are nevoie de ele.

Nu trebuie să gestionați nimic din toate acestea. Agenții urmează singuri tiparul, ghidați de instrucțiunile serverului și de skill-ul using-amicited. Această pagină explică ce fac ei, astfel încât să puteți citi o transcriere sau să restrângeți intenționat suprafața.

Ce vede clientul dumneavoastră#

tools/list anunță un set mic, fix:

Instrument	Pentru ce servește
`list_domains`	Domeniile din spațiul de lucru, cu id-urile de care are nevoie fiecare alt instrument
`list_prompts`	Prompturile urmărite pentru un domeniu
`list_competitors`	Concurenții urmăriți pentru un domeniu
`list_tags`	Etichetele de prompturi pentru un domeniu
`prompt_analytics`	Cifrele principale de vizibilitate AI
`report_link`	Un link funcțional către orice raport sau pagină de setări din aplicație
`list_toolsets`	Cele douăsprezece arii de produs, câte o linie fiecare, cu numărul de instrumente
`search_tools`	Găsiți un instrument după ce doriți să faceți
`describe_tool`	Citiți schema completă de intrare a unui instrument
`read_tool`	Rulați un instrument numai pentru citire, după nume
`run_tool`	Rulați orice instrument după nume, inclusiv scrieri și instrumente care consumă credite

Deoarece această listă nu se schimbă niciodată în timpul unei conversații, cache-ul de prompt al clientului rămâne valid, ceea ce păstrează sesiunile lungi rapide și ieftine.

Find, inspect, run#

Fiecare alt instrument este atins în trei pași:

text

search_tools  {"query": "which prompts cite competitors but not us"}
describe_tool {"name": "seo_get_citation_gap_invisible_winners"}
read_tool     {"name": "seo_get_citation_gap_invisible_winners", "arguments": {...}}

search_tools ordonează instrumentele după nume, descriere și set de instrumente. Funcționează cel mai bine cu întrebarea în cuvinte simple („is the site down”, „customer lifetime value”), nu cu un nume vag amintit. Transmiteți toolset cu o interogare goală pentru a răsfoi o arie și măriți offset pentru a parcurge una mare.
describe_tool returnează schema reală a argumentelor și tipul instrumentului. Agenții ar trebui să-l apeleze întotdeauna înainte de a rula un instrument, deoarece unele instrumente primesc argumente plate, iar altele un obiect query imbricat.
read_tool rulează instrumente al căror tip este read: citiri gratuite, repetabile, ale propriilor dumneavoastră date. Refuză orice altceva, motiv pentru care este marcat ca doar pentru citire și pentru care clienții prudenți (de exemplu Codex cu aprobările dezactivate) îl pot folosi fără a se opri să întrebe.
run_tool rulează totul, inclusiv celelalte trei tipuri:

Tip	Semnificație
`read`	Citește datele spațiului dumneavoastră de lucru. Gratuit.
`external`	Apelează un API terț (Google, Bing, Meta, OpenAI, furnizori de date) sau costă credite
`write`	Creează sau editează date ale spațiului de lucru. Necesită domeniul `amicited:write`
`destructive`	Șterge date sau pornește și oprește cheltuieli reale de reclame

Un instrument care nu este anunțat nu este mai puțin protejat. Fiecare instrument verifică singur permisiunile, limitele planului și creditele, iar run_tool aplică verificarea de scriere a instrumentului țintă, deci un token doar pentru citire nu poate ajunge la o scriere prin el.

Cele douăsprezece seturi de instrumente#

Fiecare instrument aparține exact unui set de instrumente. Agenții le folosesc pentru a decide unde să caute, iar dumneavoastră le puteți folosi pentru a fixa o arie (vedeți mai jos).

Set de instrumente	Ce acoperă	Exemple de instrumente
`domains`	Domenii, concurenți și etichete: id-urile pe care le primește fiecare alt set	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Prompturi urmărite și răspunsurile lor: creare, programare, citirea răspunsurilor, fan-out, acoperire	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Unde apare domeniul în răspunsurile AI: metrici în timp, surse citate, Share of Voice, hărți semantice	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console și Bing Webmaster Tools: interogări, pagini, acoperirea indexului, sitemap-uri, trimitere de URL-uri	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Raportare Google Ads, Microsoft Ads, Meta și LinkedIn: cheltuieli, campanii, cuvinte cheie, termeni de căutare, ROAS real	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: citiți performanța și creați sau editați campanii, grupuri de reclame, creativuri și urmărirea conversiilor	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Analiză organică construită în warehouse: mișcări, striking distance, goluri de CTR și de citare, canibalizare, index bloat	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	Analitice ecommerce: venituri și marjă, produse, clienți, cohorte și LTV, segmente, costuri	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Monitoare, heartbeat-uri, incidente, rapoarte SLA, ferestre de mentenanță, pagini de status	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	Articole AI, adnotări și reguli de linkuri interne pentru un magazin conectat	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Sănătatea site-ului pentru agenți AI: accesibilitate pentru agenți, revizuire llms.txt, Web Vitals, prospețime, site audit, backlink-uri	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Platforme de date conectate, starea sincronizării, importuri și inboxul de notificări	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Numele instrumentelor au prefixul ariei (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), ceea ce face transcrierile ușor de parcurs.

Fixarea seturilor de instrumente cu `?toolsets=`#

Unii clienți gestionează prost un apel run_tool imbricat, iar uneori doriți un agent îngust care vede o singură arie. Adăugați un parametru de interogare la URL-ul conexiunii:

text

https://api.flowhunt.io/mcp/amicited?toolsets=eshop,uptime
https://api.flowhunt.io/mcp/amicited?toolsets=all

Seturile de instrumente numite sunt apoi anunțate nativ în tools/list, lângă setul de bază. all anunță totul, ceea ce renunță la economiile de context, deci folosiți-l doar cu clienți care fac propria căutare de instrumente. Numele necunoscute sunt ignorate, nu respinse, deci verificați ortografia dacă o arie nu apare. Selecția este fixă pe durata conexiunii; niciun instrument nu o poate lărgi în timpul conversației.

Pagini, câmpuri și limite#

Pagini de 25 de rânduri. Fiecare instrument care returnează o listă de rânduri returnează implicit 25, până la maximum 500 pe apel. Când există mai multe rânduri, răspunsul include un bloc paging cu has_more și valoarea de transmis la apelul următor (un offset sau o pagină nativă sau un next_cursor).
fields. Instrumentele care returnează o singură listă de rânduri acceptă un array fields pentru a returna doar coloanele de care aveți nevoie. O coloană pe care rândurile nu o au este refuzată, nu ignorată.
Fără argument de spațiu de lucru. Spațiul de lucru este fixat de credențialele dumneavoastră, deci niciun instrument nu acceptă un id de spațiu de lucru. Aproape fiecare instrument are nevoie de un domain_id din list_domains.
Plafon orar. Apelurile de instrumente sunt numărate pe spațiu de lucru pe oră (consultați conectare). Listarea instrumentelor și citirea skill-urilor sunt gratuite; un instrument ascuns atins prin read_tool sau run_tool se numără o dată.

Articole conexe#

Skill-uri playbook Ce instrumente să apelați, în ce ordine, pentru întrebări reale. Rețete Prompturi care pun aceste instrumente la treabă.