Source: https://aiprimetech.io/de/docs/api-reference/tool-use/

[Startseite](/de/) / [Dokumentation](/de/docs/) / Tool-Nutzung und Funktionsaufrufe 

# Tool-Nutzung und Funktionsaufrufe 

Lassen Sie ein Modell Ihre Funktionen aufrufen — die Anfrageschleife, beide Formate und die Fehler, die Tokens kosten. 

 Seite kopieren [ Als Markdown anzeigen](/de/docs/api-reference/tool-use.md) [ ChatGPT fragen](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/tool-use.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ In Claude fragen](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/tool-use.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

Durch Tool-Nutzung kann das Modell Sie auffordern, eine Funktion auszuführen, und anschließend mit dem Ergebnis fortfahren. Dieser Mechanismus steckt hinter jedem Coding-Agenten. 

## Der Ablauf 
- Sie senden messages zusammen mit tools zur Beschreibung der verfügbaren Möglichkeiten.
- Das Modell antwortet mit einem stop_reason: tool_use und ein tool_use Block, der das Tool und seine Argumente angibt.
- Sie führen es aus — das Gateway führt Ihren Code niemals aus.
- Sie senden den gesamten Verlauf zusammen mit einem tool_result Block zurück.
- Das Modell erstellt seine endgültige Antwort oder fordert ein weiteres Tool an. 

## Tools definieren (Messages-Format) 

```
Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "tools": [{
    "name": "get_weather",
    "description": "Current weather for a city. Use when the user asks about weather.",
    "input_schema": {
      "type": "object",
      "properties": {"city": {"type": "string", "description": "City name"}},
      "required": ["city"]
    }
  }],
  "messages": [{"role": "user", "content": "Weather in Paris?"}]
}
```

## Ein Ergebnis zurückgeben 

```
Copy{
  "role": "user",
  "content": [{
    "type": "tool_result",
    "tool_use_id": "toolu_01ABC...",
    "content": "18C, light rain"
  }]
}
```

tool_result wird in einer Nachricht mit der Rolle eingefügt userund tool_use_id muss exakt mit der ID aus der Anfrage des Modells übereinstimmen. Nicht übereinstimmende IDs werden als ungültige Anfrage zurückgewiesen. 

## OpenAI-Format 

Das /v1/chat/completions Endpunkt verwendet das OpenAI- tools / tool_calls Format stattdessen, wobei Ergebnisse als Nachrichten mit der Rolle zurückgegeben werden tool. 

## Was die Tool-Nutzung kostet 
- Definitionen werden bei jedem Durchlauf erneut gesendet. Zwanzig ausführliche Tool-Schemas können den Großteil Ihrer Eingabe-Tokens ausmachen, bevor die Unterhaltung überhaupt beginnt.
- Ergebnisse werden zum Kontext. Wenn ein Tool 200 Zeilen mit JSON zurückgibt, werden alle davon in die nächste Anfrage und jede weitere Anfrage aufgenommen.
- Jeder Durchlauf ist ein kostenpflichtiger Aufruf. Eine Aufgabe mit fünf Tools erfordert mindestens sechs Anfragen.
- Begrenzen Sie die Länge der Tool-Ausgabe und fassen Sie sie vor der Rückgabe zusammen. Ein Ergebnis auf das zu kürzen, was das Modell tatsächlich benötigt, ist in den meisten Agentenschleifen die wirksamste Änderung. 

Tool-Schemas bleiben über mehrere Durchläufe hinweg unverändert und eignen sich daher gut als [Prompt-Caching](/de/docs/guides/prompt-caching/) Kandidat neben dem System-Prompt. 

[Messages APIGrundlegende Referenz](/de/docs/api-reference/messages/)[KostenkontrolleWofür Agenten Tokens verbrauchen](/de/docs/guides/cost-control/)[MCP-ServerFertige Tools für Claude Code](/de/docs/guides/mcp-servers/) 

[ZurückAnfragelimits](/de/docs/api-reference/rate-limits/)[WeiterBildverständnis und Bildeingabe](/de/docs/api-reference/vision/)