Guide : Exécuter Votre Premier Outil

Ce guide montre comment tirer parti des outils d’UBIK pour effectuer des tâches complexes. Vous apprendrez à lister les outils disponibles, à en exécuter un avec les entrées requises, puis à interroger les résultats de l’exécution.

Lister les Outils Disponibles

D’abord, voyons quels outils sont disponibles. Nous pouvons obtenir une liste de tous les outils qui nous sont accessibles en effectuant une requête GET vers l’endpoint /tools.

curl -X GET "https://app.ubik-agent.com/api/v1/tools" \
     -H "X-API-KEY: VOTRE_CLE_API"

La réponse sera une liste paginée d’outils. Pour ce guide, supposons que nous voulons utiliser un outil nommé “Extracteur de Données Financières”. Trouvez-le dans la liste et copiez son id.

Exécuter l'Outil

Maintenant, nous allons démarrer l’outil en effectuant une requête POST vers l’endpoint /tools/{tool_id}/execute. Vous aurez besoin de l’id de l’étape précédente. Dans le corps de la requête, nous fournirons les inputs requis par l’outil.

curl -X POST "https://app.ubik-agent.com/api/v1/tools/VOTRE_ID_OUTIL/execute" \
     -H "X-API-KEY: VOTRE_CLE_API" \
     -H "Content-Type: application/json" \
     -d '{
          "inputs": {
            "document_id": "VOTRE_ID_DOCUMENT",
            "data_points": ["revenue", "net_income", "ebitda"]
          }
        }'

L’API répondra avec un statut 202 Accepted, indiquant que la tâche a été reçue. Le corps de la réponse contient un execution_id et une details_url. Nous utiliserons cette URL pour obtenir le résultat final.

Vérifier le Résultat de l'Exécution

Comme l’outil s’exécute de manière asynchrone, nous devons interroger la details_url pour vérifier le résultat final. Vous devrez vérifier cet endpoint périodiquement jusqu’à ce que le status passe à completed ou failed.

curl -X GET "https://app.ubik-agent.com/api/v1/tool-executions/VOTRE_ID_EXECUTION" \
     -H "X-API-KEY: VOTRE_CLE_API"

Une fois que le statut est completed, le champ outputs contiendra les données extraites par l’outil.

Pour une expérience plus réactive et en temps réel, vous pouvez streamer les événements au lieu de faire du polling. Consultez notre guide sur l’Obtention de Résultats en Temps Réel avec SSE.

Vous savez maintenant comment découvrir et exécuter des outils puissants et pré-construits pour automatiser des séquences d’actions complexes avec l’API UBIK.

Pour commencer