Documentation
Référence de l’APISe connecter

Appels d’outils

Envoyez les définitions de fonctions uniquement à un modèle dont les métadonnées du catalogue mentionnent explicitement la prise en charge des outils.

Définir un outil

Requête de chat
{
  "model": "YOUR_APPROVED_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "What is the weather in Paris?"
    }
  ],
  "max_tokens": 256,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Look up weather for a city",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string"
            }
          },
          "required": [
            "city"
          ]
        }
      }
    }
  ],
  "tool_choice": "auto"
}

Exécuter la boucle d’outils

  1. Lisez les tool_calls de l’assistant dans la réponse.
  2. Validez la fonction et les arguments demandés dans votre propre application.
  3. Obtenez les autorisations requises pour l’action, puis exécutez l’outil.
  4. Renvoyez le résultat de l’outil avec le tool_call_id correspondant.

La passerelle relaie les définitions d’outils et les résultats. Elle n’exécute pas les outils. Traitez les sorties du modèle et les arguments d’outils comme des entrées non fiables.

Erreurs de capacité

Un modèle dont la prise en charge des outils n’est pas vérifiée renvoie une erreur unsupported_capability si des outils ou des messages d’outil sont fournis. Consultez le catalogue avant d’activer le mode outils d’un client.