> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/ia-et-api/outils.md).

# Outils

Un outil est un parcours réutilisable qui reçoit des options et renvoie un résultat. Depuis **Outils**, créez un outil, décrivez clairement ce qu’il fait, ajoutez des options et reliez les blocs jusqu’à [Renvoyer un résultat](/reference/blocs/return-tool-result.md).

![Page Outils](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-ac66665297de6820fedaaab6e18d62efb74cb03f%2Foutils.png?alt=media)

* **Contenu** est argument de l’appel. Demandez une seule valeur précise et décrivez le format attendu.
* **Contenu configuré** est rempli dans [Demander à l’IA](/reference/blocs/ask-ai.md) ou [Utiliser un outil](/reference/blocs/use-tool.md). Cette valeur peut venir d’une variable du parcours, par exemple l’ID du demandeur.
* **Appel manuel** : sélectionnez l’outil et renseignez ses options.
* **Appel suggéré par l’IA** : sélectionnez les outils autorisés dans la demande IA puis transmettez sa sortie au bloc qui exécute l’appel.
* **Résultat** : le texte et l’erreur sont accessibles depuis les variables du bloc appelant. La branche En cas d’erreur de l’outil peut produire un résultat de secours.

Un parcours peut exécuter jusqu’à **10 appels d’outils** et effectuer jusqu’à **3 tentatives d’action Discord d’administration via des outils**. Les compteurs s’appliquent à l’exécution entière, y compris les tours de boucle. Les actions d’administration via un outil exigent une interaction humaine Discord et ne peuvent pas être lancées depuis un événement automatique. Un outil ne peut pas lui-même demander des outils au modèle. Les blocs sensibles restent soumis aux contraintes du moteur, aux permissions du bot et aux règles que vous ajoutez pour le demandeur.

[Créer un outil IA](/tutoriels/outil-ia.md) · [Système agentique](/ia-et-api/agentique.md)
