Aller au contenu principal

Référence des outils intégrés

Les outils intégrés sont les opérations choisies pendant un tour modèle. Dashboard → Tools donne le catalogue actif de référence : source, ensemble, définition native et limites.

Outils principaux de fichiers et terminal​

OutilEnsembleUsage
readfileLit un fichier texte ou une plage
lsfileListe un répertoire
findfileRecherche des chemins
grepfileRecherche du contenu
writefileCrée ou remplace un fichier
editfileModifie du texte ciblé
bashterminalExécute une commande dans le répertoire actif
processterminalInteragit avec les processus d’arrière-plan suivis

read, write, edit, grep, find, ls, bash et process géré s’exécutent directement. Les fichiers changent via edit ou write ; l’extension redondante apply_patch a été supprimée. Les processus restent isolés à leur conversation propriétaire.

Limites d’image du modèle​

Un modèle peut définir input_limits.images.resize dans providers[].models[]. Les champs maxWidth, maxHeight, maxBytes et jpegQuality sont des entiers positifs, qualité JPEG de 100 maximum. maxBytes compte après encodage base64. Omettre le réglage conserve les défauts sans ajouter d’entrées à la configuration.

Pour lire une image, read utilise les limites du modèle sélectionné.

Avant d’envoyer des résultats d’outils, Anyy retraite leurs images selon le modèle actuel. Pour un virtuel, il utilise le modèle réellement appelé pour la dernière réponse réussie s’il existe au catalogue, sinon la sélection. Le modèle d’une future réponse ne détermine pas ces limites.

Anyy peut redimensionner l’image montrée au modèle en préservant le retour structuré destiné à Codemode. C’est la valeur retournée par l’outil ; read peut l’avoir déjà redimensionnée. Si le traitement d’image d’un outil ordinaire échoue, Anyy garde l’original. read peut au contraire retourner un avis d’omission s’il ne peut respecter la taille.

Le redimensionnement utilise le codec Photon intégré ; BMP devient PNG. Aucun exécutable externe n’est requis. Les défauts sont 2000 × 2000 pixels, 4,5 Mio après base64 et qualité JPEG 80.

Disponibilité des utilitaires de recherche​

grep local utilise ripgrep (rg) ; find, fd. Anyy cherche d’abord dans bin/ du profil, puis son PATH avec --version. Un utilitaire géré est choisi par existence sans cette sonde ; la sonde PATH peut retourner un code de sortie non nul si la commande a démarré. find préfère fd à fdfind.

Sans utilitaire, Anyy peut télécharger l’archive de plateforme depuis la version GitHub officielle et la conserver dans <PROFILE_HOME>/bin/. Les redirections de page choisissent la version, sauf fd sur macOS Intel figé à 10.3.0. Acquisition et extraction sont en Go ; rg/fd restent des exécutables locaux séparés sans exigence Node.js.

Définissez ANYY_OFFLINE à 1, true ou yes dans le processus exécutant localement pour désactiver l’acquisition ; les mots ignorent la casse. Les utilitaires existants restent utilisables. Android omet aussi cette acquisition. La recherche de version a un budget réseau total de 10 secondes ; le téléchargement, 120 secondes. Chacun tente au maximum trois requêtes immédiates, sans réessayer le transfert d’un corps de réponse.

grep résout/acquiert l’utilitaire avant de vérifier le chemin ; un chemin absent peut donc déclencher l’acquisition. Sans utilitaire, l’erreur est ripgrep (rg) is not available and could not be downloaded ou fd is not available and could not be downloaded, même hors ligne. Ce libellé ne signifie pas qu’une requête réseau a eu lieu.

Les autres environnements d’exécution ont leur propre résolution.

Sessions, mémoire et tâches​

OutilEnsembleUsage
session_searchsessionsRecherche les anciennes sessions du profil dans le périmètre courant
tool_result_readcoreLit un fragment borné de preuve de résultat stocké
memorymemoryAjoute, remplace ou retire des entrées durables USER.md/MEMORY.md
task_createtasksCrée une tâche durable
task_listtasksListe et filtre
task_updatetasksModifie champs ou état
task_completetasksTermine avec note facultative

memory sert aux faits et préférences durables, sans notes temporaires, références copiées ou secrets.

Automatisations et messagerie​

OutilsEnsembleUsage
automation_list, automation_historyautomationInspecte planifications et historique
automation_create, automation_update, automation_delete, automation_runautomationGère ou déclenche les travaux
messaging_statusmessagingInspecte les routes disponibles
notify_usermessagingNotifie par la route actuelle
send_messagemessagingLivre message/pièce via un canal compatible
message_receiptmessagingInspecte les reçus

La livraison dépend des comptes, du périmètre de conversation, des règles et capacités d’adaptateur.

Fichiers et médias générés​

OutilEnsembleDisponibilité
artifact_list, artifact_inspect, artifact_pin, artifact_exportartifactService de fichiers actif
image_generatemedia_generationGénération configurée
text_to_speechttsRoute TTS configurée

artifact_export transmet un fichier ordinaire relatif au Workspace comme pièce temporaire sans déplacer ni supprimer la source.

Web​

OutilEnsembleUsage
web_searchwebRecherche publique via le fournisseur configuré
web_fetchwebRécupère le contenu lisible d’une URL HTTP(S) publique
web_extractwebExtrait des contenus publics en résultats structurés

Skills et délégation​

OutilEnsembleUsage
skill_manageskillsGère paquets et révisions du profil actif, propre à Anyy
delegate_tasksubagentsExécute une ou plusieurs tâches enfants bornées
background_jobsubagentsLance un travail indépendant
subagent_list, subagent_history, subagent_cancelsubagentsInspecte ou arrête les enfants

Découverte et lecture des Skills utilisent catalogue et lecteurs read/bash, Codemode compris. Sans lecteur, aucun catalogue modèle. Il n’existe pas d’enregistrements intégrés skills_list/skill_view séparés. L’évaluation automatique hérite des outils, choix et exclusions de la conversation parente.

skill_manage installe uniquement un chemin ZIP local sans télécharger de paquet ni installer de répertoire.

skill_manage est la capacité d’écriture gérée Anyy avec révisions et restauration. Elle ne remplace pas la lecture partagée et n’accorde pas d’outils supplémentaires. Dashboard et CLI restent disponibles. Consultez Skills.

OutilActivation initialeUsage
codemodeDésactivéeJavaScript brut avec outils appelables et stockage local à la branche
tool_searchDésactivéeTrouve les outils différés/Codemode inactifs et les charge à la requête suivante

Ils utilisent le contexte de session réel. La sélection de noms les active ; codemode.mode du profil choisit ensuite on ou only. only change la visibilité en préservant outils appelables et déclarations. Ce n’est ni un mode de rôle ni une option CLI supplémentaire. Consultez Codemode, Recherche d’outils et Options de conversation.

Si le modèle natif déclare compat.supportsOpenAIGrammarTools et que son fournisseur accepte cette voie, Codemode envoie JavaScript comme entrée brute au lieu d’une chaîne code échappée JSON. Les autres utilisent JSON ordinaire. Validation, exécution et forme canonique enregistrée restent identiques sans réglage supplémentaire.

Outils MCP​

Les serveurs activés apportent définitions natives et métadonnées exposure/toolExposure ordonnées sans exiger groupe mcp-NAME ni activation par liste d’inclusion. Les noms exacts viennent du catalogue actuel. Les noms distants et visibles Anyy diffèrent : espace de noms serveur, caractères normalisés et suffixe si longueur/collision. mcp call utilise l’original SERVER_ID.TOOL_NAME ; les scripts, l’identifiant découvert.

Outil partagé de ressourcesUsage
list_mcp_resourcesListe une page serveur ou collecte les listes admissibles
list_mcp_resource_templatesListe les modèles URI avec même serveur/curseur
read_mcp_resourceLit avec server et uri

Ces définitions dépendent de serveurs activés annonçant les ressources et d’une exposition de base non cachée. Leur exposition partagée suit direct, puis codemode, puis deferred ; retirer la capacité masque les définitions. Elles remplacent les outils ressources/prompts par serveur. tools.resources et tools.prompts sont rejetés. Consultez Entrées et résultats.

Les outils distants s’exécutent directement dans le périmètre admis, écritures externes comprises. Les méthodes de prompts restent des API client sans outils modèle générés. Consultez Intégration MCP pour transport, authentification, ressources et récupération.

Résultats d’outils et contexte​

Texte modèle, affichage Dashboard et retour programmatique peuvent différer. Un schéma de sortie décrit la valeur Codemode sans garantir sa copie entière au contexte. bash retourne par exemple output, truncated, exit_code et wall_time_seconds ; un code de sortie non nul peut résoudre l’objet. MCP utilise son enveloppe avec isError et structuredContent facultatif. Inspectez avant de considérer une résolution réussie.

Anyy borne les projections, protège les identifiants connus et enregistre la complétude des preuves. Un résultat raccourci ne prouve pas un corps complet stocké. projected conserve une projection bornée ; artifact pointe vers son fichier. Seule une preuve inspectable peut être lue intégralement avec tool_result_read. Limites d’outil, enveloppe finale et budget global s’appliquent séparément ; augmenter l’une ne supprime pas les autres.

Utilisez tool_result_read avec le details_ref ou raw_ref logique exact retourné, jamais un chemin hôte :

{"ref":"tr_example","offset":0,"limit":12000}

Décalages et limites comptent les caractères. La limite est 12000 par défaut, 48000 maximum ; l’enveloppe peut encore réduire le fragment et signaler envelope_clamped:true. Poursuivez depuis next_offset jusqu’à eof ; la sortie inclut aussi total_chars, source_tool, content_type et storage_kind.

Les jetons originaux se résolvent dans leur exécution actuelle. Les références canoniques durables explicites peuvent lire une preuve inspectable plus ancienne de la même session. Hors session : out_of_scope ; référence mal formée/ambiguë : invalid_ref ; absente : not_found ; corps complet indisponible/incomplet : not_available. Le lecteur ne reconstruit pas les preuves depuis un aperçu. Livraison et réouverture sont décrites dans Fichiers et livrables.

Services externes​

Les enveloppes génériques non connectées email_* et calendar_* ont été supprimées. Le vrai canal Email reste. Les outils externes de courrier/calendrier exigent un service séparé tel que MCP.

Visibilité et autorisation​

Un outil visible peut rester indisponible faute d’identifiants, de service sain, de sélection profil/session ou de périmètre.

Le catalogue actif fait autorité

Cette page décrit les groupes stables. Dashboard → Tools et le catalogue de session reflètent services facultatifs, MCP et configuration de la version active.

Consultez Ensembles d’outils, Fichiers et terminal.