Lektion 1 von 3 · 10 Minuten

Tools aufrufen

Beschreibe deine Funktionen, führe die Aufrufe aus, die das Modell anfordert, und sende die Ergebnisse zurück, bis es antwortet.

Beschreibe deine Funktionen in tools, dann antwortet das Modell mit einem Aufruf einer dieser Funktionen, etwa einer Datenbankabfrage, statt zu raten. Das Modell führt selbst nie etwas aus: Deine App führt die Funktion aus und sendet das Ergebnis zurück, und das Modell schreibt dann die endgültige Antwort.

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"]
          }
        }
      }
    ]
  }'

Bei Chat Completions hat die Antwort finish_reason: "tool_calls" und eine Liste tool_calls an der Assistant-Nachricht, jeweils mit einer id, einem Funktionsnamen name und arguments als JSON-String. Führe jeden Aufruf aus und sende dann eine Folgeanfrage, die die Unterhaltung wiederholt, die Assistant-Nachricht unverändert enthält und pro Aufruf eine Nachricht mit role: "tool", zugeordnet über tool_call_id. Sende tools erneut mit. Das Modell antwortet dann oder ruft ein weiteres Tool auf, und du wiederholst den Ablauf. Bei /v1/responses ist der Aufruf ein Element function_call und dein Ergebnis ein Element function_call_output mit derselben call_id; bei /v1/messages sind es die Blöcke tool_use und tool_result.

tool_choice steuert, ob das Modell Tools aufrufen darf: none nur für Text, auto (oder weglassen), damit das Modell entscheidet, required, um einen Aufruf zu erzwingen, oder ein Objekt, das ein bestimmtes Tool nennt. Setze parallel_tool_calls auf false, wenn deine Tools nacheinander laufen müssen.

Behandle jeden Aufruf als nicht vertrauenswürdige Eingabe. Prüfe den Tool-Namen gegen eine Zulassungsliste, lehne unbekannte Namen ab und validiere die geparsten Argumente, bevor etwas läuft. Schlägt die Validierung fehl, führe das Tool nicht aus: Sende einen kurzen Fehler als Tool-Ergebnis und lass das Modell es erneut versuchen. Mit stream: true sammelst du alle Argument-Deltas, bevor du parst. Tools, deren Typ mit phaseo: beginnt, etwa phaseo:web_search oder phaseo:datetime, laufen bei Phaseo, sodass du die endgültige Antwort bekommst, ohne selbst einen Executor zu schreiben. Diese Server-Tools sind in der Beta.

Prüfe dein Verständnis

Das Modell gibt einen Aufruf von delete_user mit {"id": "42"} zurück. Deine App definiert nur get_weather. Was sollte dein Code tun?

Wende es an

Dein Support-Bot ruft get_order auf und antwortet dann. Die Schleife eines Kollegen sendet in der Folgeanfrage nur die Nachricht mit role: "tool", und der Anbieter lehnt sie ab. Was fehlt?

Antwort anzeigen

Die Folgeanfrage muss die Unterhaltung wiederholen, dann die Assistant-Nachricht mit ihren tool_calls unverändert, dann pro Aufruf eine Nachricht mit role: "tool" und der passenden tool_call_id. Sende auch tools erneut mit. Ein Tool-Ergebnis ohne vorherigen Aufruf hat nichts, dem es zugeordnet werden kann.

Das Wichtigste

Das Modell fragt, deine App validiert und führt den Aufruf aus, und du sendest das Ergebnis mit der ID des Aufrufs zurück, bis das Modell eine endgültige Antwort gibt.

Weiterführende Links

Dein Fortschritt wird in diesem Browser gespeichert.

Zuletzt geprüft am 17. November 2026