AI-agenter (MCP)

Verktygsuppsättningar och verktyg

Hur AmICited MCP-servern exponerar över 300 verktyg utan att översvämma din agents kontext: en liten annonserad uppsättning, fyra metaverktyg för att hitta och köra resten och tolv verktygsuppsättningar.

Öppna i ChatGPT Öppna i Claude

AmICited MCP-servern registrerar över 300 verktyg, ett för allt som instrumentpanelen kan göra. Att ge en modell alla dessa definitioner vid varje begäran skulle använda en stor del av dess kontext innan den hunnit göra något arbete, och modeller väljer verktyg sämre ur en mycket lång lista. Därför avslöjar servern dem gradvis: din klient ser en kort lista, och agenten slår upp resten när den behöver dem.

Du behöver inte hantera något av detta. Agenter följer mönstret på egen hand, vägledda av serverns instruktioner och färdigheten using-amicited. Den här sidan förklarar vad de gör så att du kan läsa en transkription, eller avsiktligt begränsa ytan.

Vad din klient ser#

tools/list annonserar en liten, fast uppsättning:

Verktyg	Vad det är till för
`list_domains`	Domänerna i arbetsytan, med de id som varje annat verktyg behöver
`list_prompts`	Spårade prompts för en domän
`list_competitors`	Spårade konkurrenter för en domän
`list_tags`	Prompttaggar för en domän
`prompt_analytics`	De viktigaste siffrorna för AI-synlighet
`report_link`	En fungerande länk till valfri rapport eller inställningssida i appen
`list_toolsets`	De tolv produktområdena, en rad vardera, med antal verktyg
`search_tools`	Hitta ett verktyg utifrån vad du vill göra
`describe_tool`	Läs ett verktygs fullständiga indataschema
`read_tool`	Kör ett skrivskyddat verktyg med namn
`run_tool`	Kör vilket verktyg som helst med namn, inklusive skrivåtgärder och verktyg som förbrukar krediter

Eftersom den här listan aldrig ändras under en konversation förblir klientens promptcache giltig, vilket håller långa sessioner snabba och billiga.

Hitta, granska, köra#

Varje annat verktyg nås i tre steg:

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 rangordnar verktyg efter namn, beskrivning och verktygsuppsättning. Det fungerar bäst med frågan i vanliga ord (“ligger webbplatsen nere”, “kunders livstidsvärde”) snarare än ett halvt ihågkommet namn. Ange toolset med en tom fråga för att bläddra i ett område, och höj offset för att bläddra igenom ett stort.
describe_tool returnerar det verkliga argumentschemat och verktygets typ. Agenter bör alltid anropa det innan de kör ett verktyg, eftersom vissa verktyg tar platta argument och andra ett kapslat query-objekt.
read_tool kör verktyg vars typ är read: gratis, upprepningsbara läsningar av dina egna data. Det nekar allt annat, vilket är skälet till att det är markerat som skrivskyddat och varför försiktiga klienter (till exempel Codex med godkännanden avstängda) kan använda det utan att stanna och fråga.
run_tool kör allt, inklusive de tre andra typerna:

Typ	Betydelse
`read`	Läser din arbetsytas data. Gratis.
`external`	Anropar ett tredjeparts-API (Google, Bing, Meta, OpenAI, dataleverantörer) eller kostar krediter
`write`	Skapar eller redigerar arbetsytans data. Kräver behörigheten `amicited:write`
`destructive`	Raderar data, eller startar och stoppar verkliga annonsutgifter

Ett verktyg som inte annonseras är inte mindre skyddat. Varje verktyg kontrollerar själv behörigheter, plangränser och krediter, och run_tool tillämpar målverktygets egen skrivkontroll, så en skrivskyddad token kan inte nå en skrivåtgärd via det.

De tolv verktygsuppsättningarna#

Varje verktyg hör till exakt en verktygsuppsättning. Agenter använder dem för att avgöra var de ska söka, och du kan använda dem för att fästa ett område (se nedan).

Verktygsuppsättning	Vad den omfattar	Exempelverktyg
`domains`	Domäner, konkurrenter och taggar: de id som varje annan verktygsuppsättning tar	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Spårade prompts och deras svar: skapa, schemalägga, läsa svar, fan-outs, teckning	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Var domänen syns i AI-svar: mått över tid, citerade källor, Share of Voice, semantiska kartor	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console och Bing Webmaster Tools: frågor, sidor, indextäckning, webbplatskartor, URL-inlämning	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Rapportering för Google Ads, Microsoft Ads, Meta och LinkedIn: utgifter, kampanjer, sökord, söktermer, sann ROAS	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: läs prestanda, och skapa eller redigera kampanjer, annonsgrupper, annonsmaterial och konverteringsspårning	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Analys av organisk sök byggd i datalagret: förflyttningar, striking distance, CTR- och citeringsluckor, kannibalisering, indexuppblåsning	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	E-handelsanalys: intäkter och marginal, produkter, kunder, kohorter och LTV, segment, kostnadsunderlag	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Övervakare, heartbeats, incidenter, SLA-rapporter, underhållsfönster, statussidor	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	AI-artiklar, anteckningar och regler för intern länkning för en ansluten butik	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Webbplatsens hälsa för AI-agenter: agenttillgänglighet, granskning av llms.txt, Web Vitals, aktualitet, webbplatsrevision, bakåtlänkar	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Anslutna dataplattformar, synkroniseringsstatus, importer och aviseringsinkorgen	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Verktygsnamn har prefix efter område (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), vilket gör transkriptioner lätta att skumma.

Att fästa verktygsuppsättningar med `?toolsets=`#

Vissa klienter hanterar ett kapslat run_tool-anrop dåligt, och ibland vill du ha en smal agent som bara ser ett område. Lägg till en frågeparameter i anslutnings-URL:en:

text

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

De namngivna verktygsuppsättningarna annonseras då nativt i tools/list, bredvid kärnuppsättningen. all annonserar allt, vilket ger upp kontextbesparingen, så använd det bara med klienter som gör sin egen verktygssökning. Okända namn ignoreras i stället för att avvisas, så kontrollera stavningen om ett område inte visas. Urvalet är fast under hela anslutningens livstid; inget verktyg kan vidga det mitt i en konversation.

Sidor, fält och gränser#

Sidor om 25 rader. Varje verktyg som returnerar en lista med rader returnerar 25 som standard, upp till högst 500 per anrop. När fler rader finns innehåller svaret ett paging-block med has_more och värdet att skicka i nästa anrop (en nativ offset eller sida, eller en next_cursor).
fields. Verktyg som returnerar en lista med rader accepterar en fields-array för att bara returnera de kolumner du behöver. En kolumn som raderna inte har nekas, ignoreras inte.
Inget argument för arbetsyta. Arbetsytan fastställs av dina inloggningsuppgifter, så inget verktyg accepterar ett arbetsyte-id. Nästan varje verktyg behöver ett domain_id från list_domains.
Timgräns. Verktygsanrop räknas per arbetsyta och timme (se anslut). Att lista verktyg och läsa färdigheter är gratis; ett dolt verktyg som nås via read_tool eller run_tool räknas en gång.

Relaterat#

Playbook-färdigheter Vilka verktyg som ska anropas, i vilken ordning, för verkliga frågor. Recept Prompts som sätter dessa verktyg i arbete.