Claude возвращает stop_reason: "tool_use", а в content появляется блок tool_use с id, name, input. Вы выполняете функцию и продолжаете тот же диалог, добавив сообщение role: "user" с блоком tool_result.
import anthropic
client = anthropic.Anthropic()
tools = [
{
"name": "get_weather",
"description": "Get current weather for a city. Use when the user asks about weather.",
"input_schema": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"units": {"type": "string", "enum": ["celsius", "fahrenheit"]}
},
"required": ["city"]
}
}
]
messages = [{"role": "user", "content": "What's the weather in Paris?"}]
response = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
tools=tools,
messages=messages,
)
if response.stop_reason == "tool_use":
tool_block = next(b for b in response.content if b.type == "tool_use")
result = run_weather(tool_block.input["city"]) # ваш код
messages.append({"role": "assistant", "content": response.content})
messages.append({
"role": "user",
"content": [{
"type": "tool_result",
"tool_use_id": tool_block.id,
"content": result,
}],
})
final = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
tools=tools,
messages=messages,
)
print(final.content[0].text)
Ключевой момент: вы возвращаете весь response.content ассистента (он может содержать текст + несколько tool_use блоков), а каждый tool_result ссылается на tool_use_id.
Параллельные вызовы
Claude может в одном ответе запросить несколько инструментов сразу. Тогда в content будет несколько tool_use блоков. Вы обязаны вернуть tool_result для каждого id в одном пользовательском сообщении, иначе API отклонит запрос.
tool_choice={"type": "tool", "name": "get_weather"} # обязательно этот инструмент
tool_choice={"type": "any"} # любой, но точно инструмент
tool_choice={"type": "auto"} # по умолчанию: модель решает
tool_choice: "any"/"tool" отключает текстовый ответ — полезно для extraction-задач, где вы хотите строго структурированный JSON. Ошибку из функции возвращайте как tool_result с "is_error": true — Claude попробует исправиться.