Кратко
Стандартная Claude-группа в APIYI направляет запросы к официальной AWS Claude (Amazon Bedrock), а сам AWS не поддерживает нативный веб-поиск Claude — это ограничение архитектуры Bedrock, а не проблема настройки шлюза. Чтобы получить доступ к вебу, у вас есть два варианта:Почему это не поддерживается в группе по умолчанию?
web_search / web_fetch Claude — это server-side tools: поиск выполняется собственной серверной инфраструктурой Anthropic. AWS Bedrock предоставляет только model inference и не имеет такого search backend, поэтому интерфейс Bedrock отклоняет эти tools на уровне валидации. В whitelist типов tool у Bedrock входят только client-side tools:
mcp_servers) тоже является server-side функцией и не поддерживается в группе по умолчанию.
Вариант 1: бета-группа ClaudeOfficial (нативный web_search)
APIYI предлагает бета-группу под названием ClaudeOfficial (прямой официальный канал Anthropic), которая поддерживает нативные инструменты Claudeweb_search / web_fetch.
- Как включить: обратитесь в службу поддержки, чтобы ваш ключ был добавлен в группу ClaudeOfficial
- Примечание о стабильности: это бета-группа, и она менее стабильна, чем группа по умолчанию — для важных нагрузок подготовьте запасной вариант (в качестве такого варианта хорошо подходит Option 2)
Пример запроса
Необязательные параметры:
max_uses (ограничивает число поисков), allowed_domains / blocked_domains (фильтрация по домену).
Как проверить, что поиск действительно был выполнен
Успешный ответ содержит блокиserver_tool_use и web_search_tool_result в content, с цитатами в тексте ответа и полем-счетчиком в usage:
text, а в usage нет server_tool_use, запрос не дошел до канала, поддерживающего поиск.
Тарификация
- Названия инструментов:
web_search,web_fetch - web_search: $10 / 1,000 searches ($0.01 за поиск, считается по
usage.server_tool_use.web_search_requests— один ответ может вызвать несколько поисков) плюс обычная плата за token; неудачные поиски не тарифицируются - web_fetch: платы за вызов нет; полученный контент тарифицируется как входные token
- Ориентировочная стоимость одного вопрос-ответа с web (sonnet): примерно $0.02–0.08
Вариант 2: Пользовательский инструмент поиска (работает в группе по умолчанию, рекомендуется для production)
Группа по умолчанию (Bedrock) полностью поддерживает стандартный вызов функций (пользовательские инструменты). Определите инструмент поиска, заставьте ваш клиент выполнять фактический поиск (через Search API, например Tavily / Brave / Serper / Bing), и передавайте результаты обратно модели. В ходе тестирования Claude активно вызывает инструмент, переписывает запросы как на китайском, так и на английском, и выдает ответы с источниками после нескольких раундов поиска.Полный пример (Python)
Справка по стоимости
- Комиссии за token модели: один вопрос-ответ с несколькими раундами поиска использует примерно 10k входных + 1–2k выходных token (около $0.05 на sonnet)
- Комиссии за Search API: бесплатный уровень Tavily — 1,000 вызовов/месяц (платный — примерно $0.008 за вызов), Brave — $3 / 1,000 вызовов; это того же порядка, что и официальный web_search
- Преимущества: не зависящие от канала, контролируемые и кэшируемые источники поиска, а также сохранение стабильности и преимуществ тарификации кэша у группы по умолчанию
Расширенно: источники поиска MCP
Если вы уже используете экосистему MCP (например, Tavily MCP, Brave MCP), подключитесь к MCP server на стороне клиента и преобразуйте его tools в пользовательские инструменты, показанные выше — принцип идентичен. Примечание: передача параметраmcp_servers напрямую в запросе (server-side MCP) недоступна для группы по умолчанию.
FAQ
Q: Я отправил инструмент web_search в группу по умолчанию и не получил ошибки — значит, он поддерживается? A: Нет. Группа по умолчанию корректно обрабатывает серверные инструменты (игнорирует их); запрос возвращает 200, но поиск не выполняется. Чтобы проверить: посмотрите, содержит ли ответcontent блоки server_tool_use и есть ли у usage поле server_tool_use.web_search_requests — если нет, поиск не был выполнен.
Q: А что насчет передачи параметра mcp_servers?
A: Тоже не поддерживается (это также серверная функция Anthropic). Важно: в этом случае модель может сгенерировать в теле ответа правдоподобный текст «результат инструмента» — это галлюцинация, а не реальные данные. Не полагайтесь на него.
Q: Как выбрать между двумя вариантами?
A: Для production выбирайте Вариант 2 (стабильный и управляемый). Если вам нужно нативное качество поиска Anthropic, формат цитирования или вы не хотите строить собственный поиск, обратитесь в службу поддержки, чтобы включить бета-группу ClaudeOfficial — и держите готовый резервный вариант.
Связанные документы
Claude API Basics
Каналы, список моделей, настройка и основы тарификации
Claude Prompt Caching
Многораундовый поиск вопросов и ответов хорошо сочетается с кэшированием для значительного снижения затрат