Использование инструментов с Claude

Claude способен взаимодействовать с инструментами и функциями, позволяя расширить его возможности для выполнения более широкого спектра задач.

Вот пример того, как предоставить инструменты Claude с помощью Messages API:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in San Francisco?"
      }
    ]
  }'

Как работает использование инструментов

Claude поддерживает два типа инструментов:

1. Клиентские инструменты: Инструменты, которые выполняются в ваших системах, включая:

   • Пользовательские инструменты, которые вы создаёте и реализуете
   • Определённые Anthropic инструменты, такие как компьютерное использование и текстовый редактор, которые требуют реализации на клиенте

2. Серверные инструменты: Инструменты, которые выполняются на серверах Anthropic, такие как инструменты веб-поиск и веб-выборка. Эти инструменты должны быть указаны в запросе API, но не требуют реализации с вашей стороны.

Клиентские инструменты

Интегрируйте клиентские инструменты с Claude в следующие шаги:

Примечание: Шаги 3 и 4 являются необязательными. Для некоторых рабочих процессов запрос Claude на использование инструмента (шаг 2) может быть всем, что вам нужно, без отправки результатов обратно Claude.

Серверные инструменты

Серверные инструменты следуют другому рабочему процессу:

Использование инструментов MCP с Claude

Если вы создаёте приложение, которое использует Model Context Protocol (MCP), вы можете использовать инструменты с серверов MCP непосредственно с Messages API Claude. Определения инструментов MCP используют формат схемы, который похож на формат инструментов Claude. Вам просто нужно переименовать inputSchema на input_schema.

Преобразование инструментов MCP в формат Claude

Когда вы создаёте клиент MCP и вызываете list_tools() на сервере MCP, вы получите определения инструментов с полем inputSchema. Чтобы использовать эти инструменты с Claude, преобразуйте их в формат Claude:

from mcp import ClientSession

async def get_claude_tools(mcp_session: ClientSession):
    """Convert MCP tools to Claude's tool format."""
    mcp_tools = await mcp_session.list_tools()

    claude_tools = []
    for tool in mcp_tools.tools:
        claude_tools.append({
            "name": tool.name,
            "description": tool.description or "",
            "input_schema": tool.inputSchema  # Rename inputSchema to input_schema
        })

    return claude_tools

Затем передайте эти преобразованные инструменты Claude:

import anthropic

client = anthropic.Anthropic()
claude_tools = await get_claude_tools(mcp_session)

response = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    tools=claude_tools,
    messages=[{"role": "user", "content": "What tools do you have available?"}]
)

Когда Claude ответит с блоком tool_use, выполните инструмент на вашем сервере MCP, используя call_tool(), и верните результат Claude в блоке tool_result.

Для полного руководства по созданию клиентов MCP см. Создание клиента MCP.

Примеры использования инструментов

Вот несколько примеров кода, демонстрирующих различные паттерны и методы использования инструментов. Для краткости инструменты простые, а описания инструментов короче, чем было бы идеально для обеспечения наилучшей производительности.

Ценообразование

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

The additional tokens from tool use come from:

• The tools parameter in API requests (tool names, descriptions, and schemas)
• tool_use content blocks in API requests and responses
• tool_result content blocks in API requests

When you use tools, we also automatically include a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

Обратитесь к нашей таблице обзора моделей для получения текущих цен за модель.

Когда вы отправляете запрос с использованием инструментов, как и любой другой запрос API, ответ будет выводить как входные, так и выходные количества токенов как часть сообщаемых метрик usage.

Следующие шаги

Изучите наш репозиторий готовых к внедрению примеров кода использования инструментов в наших кулинарных книгах: