Recherche d’outils
tool_search permet au modèle de trouver les outils admissibles enregistrés avec une exposition différée/Codemode, mais absents de ses déclarations actives. Un catalogue indirect reste ainsi accessible sans inclure tous les schémas dans chaque requête. La recherche n’exécute pas les outils trouvés.
Activer la découverte
tool_search est enregistré mais inactif par défaut. Sélectionnez-le explicitement, par exemple :
anyy --tools '+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'
Pour changer explicitement la sélection d’une session existante, celle-ci doit être inactive et sans entrée en attente. Les règles + partent des valeurs par défaut du profil ; elles n’écrivent pas la configuration et ne modifient pas progressivement la liste active actuelle de la session reprise. Consultez la sélection de conversation.
L’exposition différée MCP peut aussi activer automatiquement la recherche d’outils selon les règles de sélection actuelles. Les exclusions explicites et restrictions d’outils imposées par la session parente priment. Codemode et recherche d’outils sont indépendants ; désactiver Codemode ne désactive pas un tool_search actif autorisé. Aucun formulaire Dashboard distinct ne configure la recherche d’outils.
Rechercher et utiliser un résultat
Demandez à Anyy la capacité nécessaire, par exemple :
Find the configured documentation-search tool. Inspect its inputs, then use it to find the release notes.
L’outil du modèle accepte :
{"query":"documentation search","limit":3}
query est une chaîne obligatoire non vide. limit est un entier positif facultatif, égal à 8 par défaut. La recherche classe le catalogue admissible selon les noms, descriptions, schémas d’entrée et métadonnées d’espace de noms. Utilisez des termes précis de la tâche ou le nom du serveur ; l’absence de résultat est normale.
Les outils inactifs correspondants sont ajoutés aux noms actifs de la session, en conservant les noms existants. Le résultat identifie les outils chargés, également dans details.loaded. Leurs déclarations deviennent disponibles à la prochaine requête au modèle, après le retour du résultat de recherche dans la boucle. Une requête déjà préparée n’acquiert pas de schéma sur place. Le modèle peut ensuite appeler l’outil correctement avec la déclaration reçue ; les contrôles ordinaires de périmètre, d’authentification et de validation s’appliquent toujours.
Seuls les outils inactifs différés/Codemode sont recherchés. Les outils actifs, directs uniquement, cachés et les déclarations réservées au modèle sont exclus. La recherche ne réactive pas un serveur désactivé, ne crée pas d’outil non enregistré et n’élargit pas les accès du parent. Un serveur configuré peut ne pas encore avoir de catalogue actif utilisable ; inspectez sa connexion si rien de pertinent n’apparaît.
Relation avec Codemode
| Mécanisme | Effet |
|---|---|
tool_search du modèle | Charge les correspondances comme déclarations actives pour la requête suivante |
searchTools(query, options) de Codemode | Recherche dans l’instantané actuel appelable par script sans activer de déclarations |
describeTool(name) de Codemode | Lit une déclaration actuelle sans l’appeler |
Un outil MCP appelable peut donc être utilisé dans Codemode sans devenir d’abord une déclaration directe du modèle. Utilisez les noms et schémas retournés, car les noms distants peuvent être normalisés ou recevoir un suffixe de collision. Consultez Codemode et Exposition MCP.
Si la recherche ne trouve rien
Vérifiez le profil, l’activation et la disponibilité du serveur, exposure/toolExposure ordonné, les exclusions de la session et les restrictions d’outils imposées par la session parente. Appelez un outil déjà actif via sa déclaration existante au lieu de le rechercher. Un outil caché exige une modification intentionnelle de la configuration ; changer la requête ne l’expose pas.