Инструменты

Инструмент советника

Объедините более быструю модель исполнителя с более интеллектуальной моделью советника, которая обеспечивает стратегическое руководство во время генерации.

Инструмент советника позволяет более быстрой, менее дорогостоящей модели исполнителя консультироваться с более интеллектуальной моделью советника во время генерации для получения стратегического руководства. Советник читает полный диалог, создает план или корректировку курса (обычно 400–700 текстовых токенов, 1400–1800 токенов всего, включая мышление), и исполнитель продолжает выполнение задачи.

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

Инструмент советника находится в бета-версии. Включите заголовок бета-версии advisor-tool-2026-03-01 в ваши запросы. Чтобы запросить доступ или поделиться отзывом, свяжитесь с вашей командой аккаунта Anthropic.

This feature is eligible for Zero Data Retention (ZDR). When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.

Когда его использовать

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

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

Результаты зависят от задачи. Оцените на своей собственной рабочей нагрузке.

Was this page helpful?

Модели исполнителя	Модели советника
Claude Haiku 4.5 (`claude-haiku-4-5-20251001`)	Claude Opus 4.7 (`claude-opus-4-7`)
Claude Sonnet 4.6 (`claude-sonnet-4-6`)	Claude Opus 4.7 (`claude-opus-4-7`)
Claude Opus 4.6 (`claude-opus-4-6`)	Claude Opus 4.7 (`claude-opus-4-7`)
Claude Opus 4.7 (`claude-opus-4-7`)	Claude Opus 4.7 (`claude-opus-4-7`)

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=4096,
    betas=["advisor-tool-2026-03-01"],
    tools=[
        {
            "type": "advisor_20260301",
            "name": "advisor",
            "model": "claude-opus-4-7",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": "Build a concurrent worker pool in Go with graceful shutdown.",
        }
    ],
)

print(response)

Параметр	Тип	По умолчанию	Описание
`type`	string	обязательно	Должно быть `"advisor_20260301"`.
`name`	string	обязательно	Должно быть `"advisor"`.
`model`	string	обязательно	ID модели советника, например `"claude-opus-4-7"`. Выставляется счет по ставкам этой модели для подвывода.
`max_uses`	integer	неограниченно	Максимальное количество вызовов советника, разрешенных в одном запросе. Когда исполнитель достигает этого лимита, дальнейшие вызовы советника возвращают `advisor_tool_result` с `error_code: "max_uses_exceeded"` и исполнитель продолжает без дальнейшего совета. Это лимит на запрос, а не на разговор; см. Контроль стоимости для ограничений на уровне разговора.
`caching`	object \| null	`null` (выключено)	Включает кэширование подсказок для собственного транскрипта советника во время вызовов в одном разговоре. См. Кэширование подсказок советника.

{
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Let me consult the advisor on this."
    },
    {
      "type": "server_tool_use",
      "id": "srvtoolu_abc123",
      "name": "advisor",
      "input": {}
    },
    {
      "type": "advisor_tool_result",
      "tool_use_id": "srvtoolu_abc123",
      "content": {
        "type": "advisor_result",
        "text": "Use a channel-based coordination pattern. The tricky part is draining in-flight work during shutdown: close the input channel first, then wait on a WaitGroup..."
      }
    },
    {
      "type": "text",
      "text": "Here's the implementation. I'm using a channel-based coordination pattern to avoid writer starvation..."
    }
  ]
}

Вариант	Поля	Возвращается когда
`advisor_result`	`text`	Модель советника возвращает простой текст (например, Claude Opus 4.7).
`advisor_redacted_result`	`encrypted_content`	Модель советника возвращает зашифрованный вывод.

`error_code`	Значение
`max_uses_exceeded`	Запрос достиг лимита `max_uses`, установленного в определении инструмента. Дальнейшие вызовы советника в одном запросе возвращают эту ошибку.
`too_many_requests`	Подвывод советника был ограничен по скорости.
`overloaded`	Подвывод советника столкнулся с ограничениями емкости.
`prompt_too_long`	Транскрипт превысил контекстное окно модели советника.
`execution_time_exceeded`	Подвывод советника истек по времени.
`unavailable`	Любой другой отказ советника.

import anthropic

client = anthropic.Anthropic()

tools = [
    {
        "type": "advisor_20260301",
        "name": "advisor",
        "model": "claude-opus-4-7",
    }
]

messages = [
    {
        "role": "user",
        "content": "Build a concurrent worker pool in Go with graceful shutdown.",
    }
]

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=4096,
    betas=["advisor-tool-2026-03-01"],
    tools=tools,
    messages=messages,
)

# Append the full response content, including any advisor_tool_result blocks
messages.append({"role": "assistant", "content": response.content})

# Continue the conversation
messages.append({"role": "user", "content": "Now add a max-in-flight limit of 10."})

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=4096,
    betas=["advisor-tool-2026-03-01"],
    tools=tools,
    messages=messages,
)

{
  "usage": {
    "input_tokens": 412,
    "cache_read_input_tokens": 0,
    "cache_creation_input_tokens": 0,
    "output_tokens": 531,
    "iterations": [
      {
        "type": "message",
        "input_tokens": 412,
        "cache_read_input_tokens": 0,
        "cache_creation_input_tokens": 0,
        "output_tokens": 89
      },
      {
        "type": "advisor_message",
        "model": "claude-opus-4-7",
        "input_tokens": 823,
        "cache_read_input_tokens": 0,
        "cache_creation_input_tokens": 0,
        "output_tokens": 1612
      },
      {
        "type": "message",
        "input_tokens": 1348,
        "cache_read_input_tokens": 412,
        "cache_creation_input_tokens": 0,
        "output_tokens": 442
      }
    ]
  }
}

tools = [
    {
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 5,
    },
    {
        "type": "advisor_20260301",
        "name": "advisor",
        "model": "claude-opus-4-7",
    },
    {
        "name": "run_bash",
        "description": "Run a bash command",
        "input_schema": {
            "type": "object",
            "properties": {"command": {"type": "string"}},
        },
    },
]

Функция	Взаимодействие
Пакетная обработка	Поддерживается. `usage.iterations` сообщается за элемент.
Подсчет токенов	Возвращает только входные токены первой итерации исполнителя. Для приблизительной оценки советника вызовите `count_tokens` с `model`, установленным на модель советника и теми же сообщениями.
Редактирование контекста	`clear_tool_uses` еще не полностью совместим с блоками инструмента советника; полная поддержка планируется для последующего выпуска. С `clear_thinking` см. предупреждение о кэшировании выше.
`pause_turn`	Зависающий вызов советника завершает ответ с `stop_reason: "pause_turn"` и блоком `server_tool_use` как последний блок контента. Советник выполняется при возобновлении. См. Инструменты сервера.

You have access to an `advisor` tool backed by a stronger reviewer model. It takes NO parameters — when you call advisor(), your entire conversation history is automatically forwarded. They see the task, every tool call you've made, every result you've seen.

Call advisor BEFORE substantive work — before writing, before committing to an interpretation, before building on an assumption. If the task requires orientation first (finding files, fetching a source, seeing what's there), do that, then call advisor. Orientation is not substantive work. Writing, editing, and declaring an answer are.

Also call advisor:
- When you believe the task is complete. BEFORE this call, make your deliverable durable: write the file, save the result, commit the change. The advisor call takes time; if the session ends during it, a durable result persists and an unwritten one doesn't.
- When stuck — errors recurring, approach not converging, results that don't fit.
- When considering a change of approach.

On tasks longer than a few steps, call advisor at least once before committing to an approach and once before declaring done. On short reactive tasks where the next action is dictated by tool output you just read, you don't need to keep calling — the advisor adds most of its value on the first call, before the approach crystallizes.

Give the advice serious weight. If you follow a step and it fails empirically, or you have primary-source evidence that contradicts a specific claim (the file says X, the paper states Y), adapt. A passing self-test is not evidence the advice is wrong — it's evidence your test doesn't check what the advice is checking.

If you've already retrieved data pointing one way and the advisor points another: don't silently switch. Surface the conflict in one more advisor call — "I found X, you suggest Y, which constraint breaks the tie?" The advisor saw your evidence but may have underweighted it; a reconcile call is cheaper than committing to the wrong branch.

Инструмент советника

Когда его использовать

Инструмент советника

Когда его использовать

Совместимость моделей

Доступность платформы

Быстрый старт

Как это работает

Параметры инструмента

Структура ответа

Успешный вызов советника

Варианты результатов

Результаты ошибок

Многооборотные разговоры

Потоковая передача

Использование и выставление счетов

Кэширование подсказок советника

Кэширование на стороне исполнителя

Кэширование на стороне советника

Комбинирование с другими инструментами

Лучшие практики

Подсказки для задач кодирования и агентов

Предлагаемая системная подсказка для задач кодирования

Сокращение длины вывода советника

Сопряжение с параметрами усилий

Контроль стоимости

Ограничения