AI-agenter (MCP)

Toolsets og værktøjer

Hvordan AmICited MCP-serveren udstiller over 300 værktøjer uden at oversvømme din agents kontekst: et lille annonceret sæt, fire meta-værktøjer til at finde og køre resten og tolv toolsets.

Åbn i ChatGPT Åbn i Claude

AmICited MCP-serveren registrerer over 300 værktøjer, ét for alt, hvad dashboardet kan. Hvis alle de definitioner blev afleveret til en model ved hver anmodning, ville det bruge en stor del af dens kontekst, før den nåede at gøre noget, og modeller vælger værktøjer dårligere fra en meget lang liste. Derfor afslører serveren dem gradvist: din klient ser en kort liste, og agenten slår resten op, når den har brug for dem.

Du behøver ikke styre noget af dette. Agenter følger mønstret af sig selv, guidet af serverens instruktioner og using-amicited-skillen. Denne side forklarer, hvad de gør, så du kan læse en transskription eller bevidst indsnævre fladen.

Hvad din klient ser#

tools/list annoncerer et lille, fast sæt:

Værktøj	Hvad det bruges til
`list_domains`	Domænerne i workspacet, med de id’er, alle andre værktøjer kræver
`list_prompts`	Sporede prompts for et domæne
`list_competitors`	Sporede konkurrenter for et domæne
`list_tags`	Prompttags for et domæne
`prompt_analytics`	De primære tal for AI-synlighed
`report_link`	Et fungerende link til enhver rapport eller indstillingsside i appen
`list_toolsets`	De tolv produktområder, én linje hver, med antal værktøjer
`search_tools`	Find et værktøj ud fra det, du vil gøre
`describe_tool`	Læs ét værktøjs fulde inputskema
`read_tool`	Kør et skrivebeskyttet værktøj ved navn
`run_tool`	Kør ethvert værktøj ved navn, inklusive skrivninger og kreditforbrugende værktøjer

Fordi denne liste aldrig ændres under en samtale, forbliver klientens promptcache gyldig, hvilket holder lange sessioner hurtige og billige.

Find, inspicér, kør#

Alle andre værktøjer nås i tre trin:

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 rangerer værktøjer efter navn, beskrivelse og toolset. Det virker bedst med spørgsmålet i almindelige ord (“is the site down”, “customer lifetime value”) frem for et halvt husket navn. Angiv toolset med en tom forespørgsel for at gennemse ét område, og hæv offset for at bladre gennem et stort.
describe_tool returnerer det rigtige argumentskema og værktøjets type. Agenter bør altid kalde det, før de kører et værktøj, fordi nogle værktøjer tager flade argumenter og andre et indlejret query-objekt.
read_tool kører værktøjer, hvis type er read: gratis, gentagelige læsninger af dine egne data. Det afviser alt andet, og derfor er det markeret som skrivebeskyttet, og derfor kan forsigtige klienter (for eksempel Codex med godkendelser slået fra) bruge det uden at stoppe op og spørge.
run_tool kører alt, inklusive de tre andre typer:

Type	Betydning
`read`	Læser dit workspaces data. Gratis.
`external`	Kalder en tredjeparts-API (Google, Bing, Meta, OpenAI, dataudbydere) eller koster kreditter
`write`	Opretter eller redigerer workspace-data. Kræver scope `amicited:write`
`destructive`	Sletter data eller starter og stopper reelt annoncebudget

Et værktøj, der ikke er annonceret, er ikke mindre beskyttet. Hvert værktøj tjekker selv tilladelser, plangrænser og kreditter, og run_tool anvender målværktøjets egen skrivekontrol, så et skrivebeskyttet token ikke kan nå en skrivning gennem det.

De tolv toolsets#

Hvert værktøj hører til præcis ét toolset. Agenter bruger dem til at afgøre, hvor de skal søge, og du kan bruge dem til at fastlåse et område (se nedenfor).

Toolset	Hvad det dækker	Eksempelværktøjer
`domains`	Domæner, konkurrenter og tags: de id’er, alle andre toolsets tager	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Sporede prompts og deres svar: opret, planlæg, læs svar, fan-outs, dækning	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Hvor domænet optræder i AI-svar: målinger over tid, citerede kilder, Share of Voice, semantiske kort	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console og Bing Webmaster Tools: forespørgsler, sider, indeksdækning, sitemaps, URL-indsendelse	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Rapportering fra Google Ads, Microsoft Ads, Meta og LinkedIn: forbrug, kampagner, søgeord, søgetermer, sand ROAS	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: læs performance, og opret eller redigér kampagner, annoncegrupper, kreativer og konverteringssporing	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Lagerbygget organisk analyse: movers, striking distance, CTR- og citationshuller, kannibalisering, index bloat	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	Ecommerce-analyse: omsætning og margin, produkter, kunder, kohorter og LTV, segmenter, omkostningsinput	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Monitorer, heartbeats, hændelser, SLA-rapporter, vedligeholdelsesvinduer, statussider	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	AI-artikler, annotationer og interne linkregler for en forbundet butik	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Sitesundhed for AI-agenter: agenttilgængelighed, llms.txt-gennemgang, Web Vitals, friskhed, site audit, backlinks	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Forbundne dataplatforme, synkroniseringsstatus, importer og notifikationsindbakken	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Værktøjsnavne har præfiks efter område (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), hvilket gør transskriptioner lette at skimme.

Fastlåsning af toolsets med `?toolsets=`#

Nogle klienter håndterer et indlejret run_tool-kald dårligt, og nogle gange vil du have en smal agent, der kun ser ét område. Tilføj en forespørgselsparameter til forbindelses-URL’en:

text

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

De navngivne toolsets annonceres derefter native i tools/list ved siden af kernesættet. all annoncerer alt, hvilket opgiver kontekstbesparelsen, så brug det kun med klienter, der laver deres egen værktøjssøgning. Ukendte navne ignoreres frem for afvises, så tjek stavningen, hvis et område ikke vises. Valget er fast for forbindelsens levetid; intet værktøj kan udvide det midt i en samtale.

Sider, felter og grænser#

Sider på 25 rækker. Hvert værktøj, der returnerer en liste af rækker, returnerer som standard 25, op til maksimalt 500 pr. kald. Når der findes flere rækker, indeholder svaret en paging-blok med has_more og den værdi, der skal sendes i næste kald (en native offset eller side, eller en next_cursor).
fields. Værktøjer, der returnerer én liste af rækker, accepterer et fields-array for kun at returnere de kolonner, du har brug for. En kolonne, rækkerne ikke har, afvises, ikke ignoreres.
Intet workspace-argument. Workspacet er fastlagt af din legitimation, så intet værktøj accepterer et workspace-id. Næsten alle værktøjer kræver dog et domain_id fra list_domains.
Timelig grænse. Værktøjskald tælles pr. workspace pr. time (se forbind). Opremsning af værktøjer og læsning af skills er gratis; et skjult værktøj, der nås via read_tool eller run_tool, tæller én gang.

Relateret#

Playbook-skills Hvilke værktøjer der skal kaldes, i hvilken rækkefølge, til rigtige spørgsmål. Opskrifter Prompts, der sætter disse værktøjer i arbejde.