AI agenti (MCP)

Toolsety a nástroje

Ako MCP server AmICited sprístupňuje viac než 300 nástrojov bez zaplavenia kontextu vášho agenta: malá inzerovaná sada, štyri meta-nástroje na hľadanie a spúšťanie ostatných a dvanásť toolsetov.

Otvoriť v ChatGPT Otvoriť v Claude

MCP server AmICited registruje viac než 300 nástrojov, jeden pre všetko, čo dashboard dokáže. Odovzdať modelu všetky tieto definície pri každej požiadavke by spotrebovalo veľkú časť jeho kontextu ešte predtým, než urobí akúkoľvek prácu, a modely vyberajú nástroje z veľmi dlhého zoznamu horšie. Server ich preto odhaľuje postupne: váš klient vidí krátky zoznam a agent si vyhľadá zvyšok, keď ho potrebuje.

Nič z toho nemusíte spravovať. Agenti sa tohto vzoru pridŕžajú sami, vedení pokynmi servera a skillom using-amicited. Táto stránka vysvetľuje, čo robia, aby ste vedeli čítať prepis alebo zámerne zúžiť povrch.

Čo vidí váš klient#

tools/list inzeruje malú, pevnú sadu:

Nástroj	Na čo slúži
`list_domains`	Domény vo workspacei s id, ktoré potrebuje každý ďalší nástroj
`list_prompts`	Sledované prompty pre doménu
`list_competitors`	Sledovaní konkurenti pre doménu
`list_tags`	Tagy promptov pre doménu
`prompt_analytics`	Hlavné čísla viditeľnosti v AI
`report_link`	Funkčný odkaz na ľubovoľný report alebo stránku nastavení v aplikácii
`list_toolsets`	Dvanásť produktových oblastí, po jednom riadku, s počtami nástrojov
`search_tools`	Nájdite nástroj podľa toho, čo chcete urobiť
`describe_tool`	Prečítajte úplnú vstupnú schému jedného nástroja
`read_tool`	Spustite nástroj len na čítanie podľa názvu
`run_tool`	Spustite ľubovoľný nástroj podľa názvu, vrátane zápisov a nástrojov míňajúcich kredity

Keďže sa tento zoznam počas konverzácie nikdy nemení, cache promptu klienta zostáva platná, vďaka čomu sú dlhé relácie rýchle a lacné.

Nájsť, preskúmať, spustiť#

Ku každému ďalšiemu nástroju sa dostanete v troch krokoch:

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 radí nástroje podľa názvu, popisu a toolsetu. Funguje najlepšie s otázkou jednoduchými slovami („is the site down“, „customer lifetime value“) než s napoly zapamätaným názvom. Zadajte toolset s prázdnym dotazom na prehliadanie jednej oblasti a zvýšte offset na listovanie vo veľkej.
describe_tool vráti skutočnú schému argumentov a druh nástroja. Agenti by ho mali vždy zavolať pred spustením nástroja, pretože niektoré nástroje berú ploché argumenty a iné vnorený objekt query.
read_tool spúšťa nástroje, ktorých druh je read: bezplatné, opakovateľné čítania vašich vlastných dát. Odmietne čokoľvek iné, preto je označený ako len na čítanie a preto ho môžu opatrní klienti (napríklad Codex s vypnutým schvaľovaním) používať bez zastavenia a pýtania sa.
run_tool spúšťa všetko, vrátane ostatných troch druhov:

Druh	Význam
`read`	Číta dáta vášho workspaceu. Zadarmo.
`external`	Volá API tretej strany (Google, Bing, Meta, OpenAI, poskytovatelia dát) alebo stojí kredity
`write`	Vytvára alebo upravuje dáta workspaceu. Vyžaduje rozsah `amicited:write`
`destructive`	Maže dáta alebo spúšťa a zastavuje skutočné výdavky na reklamu

Nástroj, ktorý nie je inzerovaný, nie je menej chránený. Každý nástroj sám kontroluje oprávnenia, limity plánu a kredity a run_tool uplatňuje kontrolu zápisu cieľového nástroja, takže token len na čítanie sa cez neho k zápisu nedostane.

Dvanásť toolsetov#

Každý nástroj patrí presne do jedného toolsetu. Agenti ich používajú na rozhodnutie, kde hľadať, a vy ich môžete použiť na pripnutie oblasti (pozrite nižšie).

Toolset	Čo pokrýva	Príklady nástrojov
`domains`	Domény, konkurenti a tagy: id, ktoré berie každý ďalší toolset	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Sledované prompty a ich odpovede: vytváranie, plánovanie, čítanie odpovedí, fan-outy, pokrytie	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Kde sa doména objavuje v AI odpovediach: metriky v čase, citované zdroje, Share of Voice, sémantické mapy	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console a Bing Webmaster Tools: dotazy, stránky, pokrytie indexu, sitemapy, odosielanie URL	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Reporting Google Ads, Microsoft Ads, Meta a LinkedIn: výdavky, kampane, kľúčové slová, vyhľadávacie výrazy, skutočný ROAS	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: čítanie výkonu a vytváranie či úprava kampaní, skupín reklám, kreatív a sledovania konverzií	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Organická analýza zo skladu: movers, striking distance, medzery CTR a citácií, kanibalizácia, index bloat	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	Analytika e-shopu: tržby a marža, produkty, zákazníci, kohorty a LTV, segmenty, vstupy nákladov	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Monitory, signály aktivity, incidenty, reporty SLA, okná údržby, stavové stránky	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	AI články, anotácie a pravidlá interného prelinkovania pre pripojený obchod	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Zdravie webu pre AI agentov: prístupnosť pre agentov, kontrola llms.txt, Web Vitals, čerstvosť, audit stránky, spätné odkazy	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Pripojené dátové platformy, stav synchronizácie, importy a schránka upozornení	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Názvy nástrojov majú predponu podľa oblasti (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), vďaka čomu sa prepisy ľahko prehľadávajú.

Pripnutie toolsetov pomocou `?toolsets=`#

Niektorí klienti zle zvládajú vnorené volanie run_tool a niekedy chcete úzkeho agenta, ktorý vidí len jednu oblasť. Pridajte parameter dotazu k URL pripojenia:

text

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

Pomenované toolsety sa potom inzerujú natívne v tools/list, vedľa základnej sady. all inzeruje všetko, čím sa vzdáte úspor kontextu, takže ho používajte len s klientmi, ktorí robia vlastné vyhľadávanie nástrojov. Neznáme názvy sa ignorujú namiesto odmietnutia, takže ak sa oblasť neobjaví, skontrolujte pravopis. Výber je pevný počas života pripojenia; žiadny nástroj ho nemôže uprostred konverzie rozšíriť.

Stránky, polia a limity#

Stránky po 25 riadkoch. Každý nástroj, ktorý vracia zoznam riadkov, vráti predvolene 25, najviac 500 na volanie. Keď existuje viac riadkov, odpoveď obsahuje blok paging s has_more a hodnotou, ktorú treba odovzdať pri ďalšom volaní (natívny offset alebo stránka, alebo next_cursor).
fields. Nástroje, ktoré vracajú jeden zoznam riadkov, prijímajú pole fields, aby vrátili len stĺpce, ktoré potrebujete. Stĺpec, ktorý riadky nemajú, sa odmietne, nie ignoruje.
Žiadny argument workspaceu. Workspace je určený vašimi prihlasovacími údajmi, takže žiadny nástroj neprijíma id workspaceu. Takmer každý nástroj potrebuje domain_id z list_domains.
Hodinový limit. Volania nástrojov sa počítajú na workspace za hodinu (pozrite si pripojenie). Vypisovanie nástrojov a čítanie skills je zadarmo; skrytý nástroj zavolaný cez read_tool alebo run_tool sa počíta raz.

Súvisiace#

Playbook skills Ktoré nástroje volať a v akom poradí pri skutočných otázkach. Recepty Prompty, ktoré tieto nástroje uvedú do práce.