Outil

Propre à OrkyvoToutes les offresSous-bloc d'agent IA

Expose un bloc (requête HTTP, nœud installé, serveurs) à l'agent comme un outil, avec des paramètres fixes, des expressions ou fournis par l'IA.

Outilse relie à l'entrée « Outils » d'un agent

Fonctionnement

La configuration du bloc est figée au démarrage de l'agent. Les contraintes d'organisation, d'environnement, de connexion et de cible restent imposées par le serveur : le modèle ne fournit que les paramètres déclarés.

Paramètres

Paramètre	Type	Détail
Nom de l'outilobligatoire	texte	Lettres, chiffres, _ et -. Transmis au modèle.
Description pour le modèleobligatoire	texte long	Quand et pourquoi utiliser cet outil.
Bloc exécutéobligatoire	bloc outil	—
Paramètres fournis par l'IA	paramètres de l'IA	Utilisables dans les champs du bloc avec {{ $fromAI.cle }}. Validés par schéma avant toute exécution ; jamais interprétés comme des expressions.
Délai d'exécution (secondes)	nombre	—
Effet de l'outil	choix	Une écriture dans un environnement protégé exige toujours une approbation humaine. Valeurs : Lecture seule, Écriture (modifie quelque chose).
Approbation humaine	choix	Valeurs : Selon l'environnement (écritures en environnement protégé), Toujours avant l'exécution, Jamais (refusé pour une écriture en environnement protégé).
Délai d'approbation (minutes)selon les autres paramètres	nombre	Sans décision, l'appel expire et n'est jamais exécuté.
Appels maximum par passage de l'agent	nombre	—
Taille maximale du résultat transmis au modèle (Ko)	nombre	Au-delà, le résultat est tronqué et le modèle en est informé.
Résultat en mode simulation	JSON	Renvoyé au modèle lors d'un test en simulation, signalé comme simulé. Facultatif.

Données reçues et renvoyées

EntréeAucune (ressource de l'agent).
SortieAucune (ressource de l'agent) ; le résultat est renvoyé au modèle.

Erreurs

Arguments invalides, outil non autorisé, approbation refusée ou expirée, échec du bloc.

Exemple

Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.

Paramètres de l'exemple (JSON)Ouvrir l'éditeur

{
  "toolName": "meteo",
  "toolDescription": "Température d'une ville",
  "aiParams": [
    {
      "id": "p1",
      "key": "ville",
      "type": "string",
      "description": "Ville",
      "required": true
    }
  ]
}