Toolsets et outils

Le serveur MCP AmICited enregistre plus de 300 outils, un pour tout ce que le tableau de bord peut faire. Remettre toutes ces définitions à un modèle à chaque requête consommerait une grande part de son contexte avant qu’il ait commencé à travailler, et les modèles choisissent moins bien les outils dans une très longue liste. Le serveur les dévoile donc progressivement : votre client voit une liste courte, et l’agent cherche le reste quand il en a besoin.

Vous n’avez rien à gérer. Les agents suivent ce schéma d’eux-mêmes, guidés par les instructions du serveur et le skill using-amicited. Cette page explique ce qu’ils font pour que vous puissiez lire une transcription, ou restreindre volontairement la surface.

Ce que voit votre client#

tools/list annonce un petit ensemble fixe :

Comme cette liste ne change jamais au cours d’une conversation, le cache de prompt du client reste valide, ce qui garde les longues sessions rapides et peu coûteuses.

Trouver, inspecter, exécuter#

Tout autre outil s’atteint en trois étapes :

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 classe les outils par nom, description et toolset. Il fonctionne mieux avec la question en mots simples (« is the site down », « customer lifetime value ») qu’avec un nom à moitié retenu. Passez toolset avec une requête vide pour parcourir un domaine, et augmentez offset pour paginer dans un grand domaine.
• describe_tool renvoie le vrai schéma d’arguments et le type de l’outil. Les agents doivent toujours l’appeler avant d’exécuter un outil, car certains outils prennent des arguments à plat et d’autres un objet query imbriqué.
• read_tool exécute les outils de type read : des lectures gratuites et répétables de vos propres données. Il refuse tout le reste, ce qui explique qu’il soit marqué en lecture seule et que des clients prudents (par exemple Codex avec les approbations désactivées) puissent l’utiliser sans s’arrêter pour demander.
• run_tool exécute tout, y compris les trois autres types :

Un outil qui n’est pas annoncé n’est pas moins protégé. Chaque outil vérifie lui-même les permissions, les limites de l’offre et les crédits, et run_tool applique la vérification d’écriture propre à l’outil cible : un jeton en lecture seule ne peut donc pas atteindre une écriture par ce biais.

Les douze toolsets#

Chaque outil appartient à exactement un toolset. Les agents s’en servent pour décider où chercher, et vous pouvez vous en servir pour épingler un domaine (voir plus bas).

Les noms d’outils sont préfixés par domaine (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), ce qui rend les transcriptions faciles à parcourir.

Épingler des toolsets avec ?toolsets=#

Certains clients gèrent mal un appel run_tool imbriqué, et vous voulez parfois un agent restreint qui ne voit qu’un seul domaine. Ajoutez un paramètre de requête à l’URL de connexion :

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

Les toolsets nommés sont alors annoncés nativement dans tools/list, à côté de l’ensemble de base. all annonce tout, ce qui renonce aux économies de contexte : ne l’utilisez qu’avec des clients qui font leur propre recherche d’outils. Les noms inconnus sont ignorés plutôt que rejetés : vérifiez donc l’orthographe si un domaine n’apparaît pas. La sélection est fixée pour toute la durée de la connexion ; aucun outil ne peut l’élargir en cours de conversation.

Pages, champs et limites#

• Pages de 25 lignes. Tout outil qui renvoie une liste de lignes en renvoie 25 par défaut, jusqu’à 500 par appel. Quand il existe d’autres lignes, la réponse inclut un bloc paging avec has_more et la valeur à passer au prochain appel (un offset ou une page natifs, ou un next_cursor).
• fields. Les outils qui renvoient une liste de lignes acceptent un tableau fields pour ne renvoyer que les colonnes dont vous avez besoin. Une colonne que les lignes n’ont pas est refusée, pas ignorée.
• Pas d’argument d’espace de travail. L’espace de travail est fixé par votre identifiant : aucun outil n’accepte donc d’identifiant d’espace de travail. Presque tous les outils ont besoin d’un domain_id issu de list_domains.
• Plafond horaire. Les appels d’outils sont comptés par espace de travail et par heure (voir connexion). Lister les outils et lire les skills est gratuit ; un outil masqué atteint via read_tool ou run_tool compte une fois.

À lire aussi#