Toolset e strumenti

Il server MCP di AmICited registra più di 300 strumenti, uno per tutto ciò che la dashboard può fare. Consegnare tutte queste definizioni a un modello a ogni richiesta consumerebbe una larga parte del suo contesto prima ancora che inizi a lavorare, e i modelli scelgono peggio gli strumenti da un elenco molto lungo. Per questo il server li rivela in modo progressivo: il tuo client vede un elenco breve e l’agente cerca il resto quando gli serve.

Non devi gestire nulla di tutto questo. Gli agenti seguono lo schema da soli, guidati dalle istruzioni del server e dalla skill using-amicited. Questa pagina spiega cosa stanno facendo, così puoi leggere una trascrizione oppure restringere di proposito la superficie.

Cosa vede il tuo client#

tools/list pubblicizza un piccolo insieme fisso:

Poiché questo elenco non cambia mai durante una conversazione, la cache del prompt del client resta valida, il che mantiene le sessioni lunghe veloci ed economiche.

Trova, ispeziona, esegui#

Ogni altro strumento si raggiunge in tre passaggi:

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 ordina gli strumenti per nome, descrizione e toolset. Funziona meglio con la domanda in parole semplici (“is the site down”, “customer lifetime value”) piuttosto che con un nome ricordato a metà. Passa toolset con una query vuota per sfogliare un’area e aumenta offset per scorrerne una grande.
• describe_tool restituisce lo schema reale degli argomenti e il tipo dello strumento. Gli agenti dovrebbero sempre chiamarlo prima di eseguire uno strumento, perché alcuni strumenti accettano argomenti piatti e altri un oggetto query annidato.
• read_tool esegue gli strumenti di tipo read: letture gratuite e ripetibili dei tuoi dati. Rifiuta qualsiasi altra cosa, ed è per questo che è contrassegnato come di sola lettura e che i client prudenti (ad esempio Codex con le approvazioni disattivate) possono usarlo senza fermarsi a chiedere.
• run_tool esegue tutto, compresi gli altri tre tipi:

Uno strumento non pubblicizzato non è meno protetto. Ogni strumento controlla da sé permessi, limiti del piano e crediti, e run_tool applica il controllo di scrittura dello strumento di destinazione, quindi un token di sola lettura non può raggiungere una scrittura passando da lì.

I dodici toolset#

Ogni strumento appartiene esattamente a un toolset. Gli agenti li usano per decidere dove cercare e tu puoi usarli per fissare un’area (vedi sotto).

I nomi degli strumenti hanno come prefisso l’area (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), il che rende le trascrizioni facili da scorrere.

Fissare i toolset con ?toolsets=#

Alcuni client gestiscono male una chiamata run_tool annidata, e a volte vuoi un agente ristretto che veda solo un’area. Aggiungi un parametro di query all’URL della connessione:

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

I toolset indicati vengono allora pubblicizzati in modo nativo in tools/list, accanto all’insieme di base. all pubblicizza tutto, rinunciando al risparmio di contesto, quindi usalo solo con client che fanno una propria ricerca degli strumenti. I nomi sconosciuti vengono ignorati e non rifiutati, quindi controlla l’ortografia se un’area non compare. La selezione è fissa per tutta la durata della connessione; nessuno strumento può ampliarla a metà conversazione.

Pagine, campi e limiti#

• Pagine da 25 righe. Ogni strumento che restituisce un elenco di righe ne restituisce 25 per impostazione predefinita, fino a un massimo di 500 per chiamata. Quando esistono più righe, la risposta include un blocco paging con has_more e il valore da passare alla chiamata successiva (un offset o una pagina nativi, oppure un next_cursor).
• fields. Gli strumenti che restituiscono un solo elenco di righe accettano un array fields per restituire solo le colonne che ti servono. Una colonna che le righe non hanno viene rifiutata, non ignorata.
• Nessun argomento workspace. Il workspace è fissato dalla tua credenziale, quindi nessuno strumento accetta un id di workspace. Quasi ogni strumento richiede invece un domain_id da list_domains.
• Tetto orario. Le chiamate agli strumenti vengono contate per workspace all’ora (vedi connetti). L’elenco degli strumenti e la lettura delle skill sono gratuiti; uno strumento nascosto raggiunto tramite read_tool o run_tool conta una volta.

Correlati#