Leçon 1 sur 3 · 10 minutes

Appeler des outils

Décrivez vos fonctions, exécutez les appels demandés par le modèle et renvoyez les résultats jusqu’à ce qu’il réponde.

Décrivez vos fonctions dans tools, et le modèle répond par un appel à l’une d’elles, par exemple une recherche en base de données, au lieu de deviner. Le modèle n’exécute jamais rien lui-même : votre application exécute la fonction et renvoie le résultat, puis le modèle rédige la réponse finale.

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "messages": [
      { "role": "user", "content": "What is the weather in London?" }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get current weather by city",
          "parameters": {
            "type": "object",
            "properties": {
              "city": { "type": "string" }
            },
            "required": ["city"]
          }
        }
      }
    ]
  }'

Sur Chat Completions, la réponse a finish_reason: "tool_calls" et une liste tool_calls sur le message de l’assistant, chaque appel avec un id, un name de fonction et des arguments sous forme de chaîne JSON. Exécutez chaque appel, puis envoyez une requête de suivi qui reprend la conversation, le message de l’assistant sans modification, et un message role: "tool" par appel, associé par tool_call_id. Renvoyez aussi tools. Le modèle répond ou appelle un autre outil, et vous recommencez. Sur /v1/responses, l’appel est un élément function_call et votre résultat un élément function_call_output avec le même call_id ; sur /v1/messages, ce sont des blocs tool_use et tool_result.

tool_choice détermine si le modèle peut appeler des outils : none pour du texte seulement, auto (ou rien) pour laisser le modèle décider, required pour forcer un appel, ou un objet qui nomme un outil. Définissez parallel_tool_calls à false quand vos outils doivent s’exécuter un par un.

Traitez chaque appel comme une entrée non fiable. Vérifiez le nom de l’outil par rapport à une liste d’autorisation, rejetez les noms inconnus et validez les arguments analysés avant toute exécution. Si la validation échoue, n’exécutez pas l’outil : renvoyez une courte erreur comme résultat de l’outil et laissez le modèle réessayer. Avec stream: true, rassemblez tous les fragments d’arguments avant l’analyse. Les outils dont le type commence par phaseo:, comme phaseo:web_search ou phaseo:datetime, s’exécutent côté Phaseo : vous obtenez la réponse finale sans écrire d’exécuteur. Ces outils serveur sont en Bêta.

Vérifiez votre compréhension

Le modèle renvoie un appel à delete_user avec {"id": "42"}. Votre application ne définit que get_weather. Que doit faire votre code ?

Mettez-le en pratique

Votre bot d’assistance appelle get_order puis répond. La boucle d’un collègue n’envoie que le message role: "tool" dans la requête de suivi, et le fournisseur la rejette. Que manque-t-il ?

Afficher la réponse

La requête de suivi doit reprendre la conversation, puis le message de l’assistant avec ses tool_calls sans modification, puis un message role: "tool" par appel avec le tool_call_id correspondant. Renvoyez aussi tools. Un résultat d’outil sans appel qui le précède ne correspond à rien.

À retenir

Le modèle demande, votre application valide et exécute l’appel, et vous renvoyez le résultat avec l’ID de l’appel jusqu’à ce que le modèle donne une réponse finale.

Liens utiles

La progression est enregistrée dans ce navigateur.

Dernière vérification le 17 novembre 2026