Aller au contenu principal

Outil

Execute un outil enregistre dans le registre d'outils du workspace. Permet d'appeler des fonctions personnalisees ou des outils predefinis.

Parametres

ParametreTypeRequisVariableDescription
toolNametexteOuiNonNom de l'outil du ToolRegistry a executer (ex: semantic_query, entity_lookup, http_request, graph_neighbors).
inputobjetNonNonEntrees canoniques de l'outil. Chaque cle correspond a un parametre du ToolSpec et sa valeur est un BlockValue.
inputMappingslisteNonNonCompatibilite legacy uniquement. Convertir vers input lors de la sauvegarde ou de l'execution.
timeoutMsnombreNonNonDelai d'expiration en millisecondes pour l'execution de l'outil.
retryOnErroroui/nonNonNonRetenter automatiquement l'outil en cas d'erreur. (Defaut: false)
maxRetriesnombreNonNonNombre maximum de tentatives en cas d'erreur. (Defaut: 1, min 1, max 10)
outputVariabletexteNonNonNom de la variable de sortie contenant le resultat de l'outil.

Sortie

Variable de sortie : toolResult

{
"result": "..."
}

Exemple

Appeler un outil de geocodage.

Entree :

{"toolName": "geocode", "address": "12 rue Victor Hugo, Paris"}

Sortie :

{"result": {"lat": 48.8566, "lon": 2.3522}}
Astuce

{{toolResult.result}} contient la sortie de l'outil. La structure depend de l'outil execute. Consultez la documentation de chaque outil.