Представляем API веб-поиска через AI Gateway02.10.2026 16:28

Интересный факт: когда вы используете агента, которому нужно получить актуальную веб-страницу, он обычно просто угадывает её URL, а затем вызывает инструмент curl. Поэтому иногда при загрузке страниц из интернета можно увидеть ошибку 404 Not Found: она возникает, если агент неправильно угадал URL нужной информации. Как нетрудно догадаться, постоянно наугад подбирать URL — не самый эффективный подход.

Есть способ получше. Что, если агент сможет искать информацию в интернете так же, как люди начинают с запроса в поисковике, когда им что-то нужно? Именно для этого и нужен веб-поиск: он позволяет агентам находить в интернете релевантные данные и формировать ответы на основе актуальной информации.

Сегодня мы объявляем о партнёрстве Cloudflare с провайдерами веб-поиска, которое позволит получать ответы на основе актуальной информации через AI Gateway. Мы запускаем эту возможность вместе с нашими партнёрами Ceramic.ai, Exa и Linkup.

Что можно делать с помощью Web Search API?

Качество работы моделей ИИ зависит от контекста, который вы им предоставляете. Обычно модели обучают, а затем фиксируют в определённый момент времени: они опираются только на информацию, существовавшую до даты окончания обучения. Поэтому им непросто обсуждать недавние события, меняющиеся API или быстро развивающиеся новости.

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

Например, если ваш агент разрабатывает приложения с помощью инструментов для разработчиков Cloudflare, он может пропустить новые продукты и функции, которые мы выпускаем на этой Неделе дня рождения! Веб-поиск поможет находить самые свежие документы и сведения о выпусках — так вы сможете создавать приложения быстрее и эффективнее.

Новый уровень отраслевых стандартов веб-поиска

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

Краулер провайдера веб-поиска должен соответствовать опубликованным Cloudflare требованиям к «проверенным ботам», описанным в нашей документации для разработчиков, а ответы веб-поиска должны содержать ссылку на страницу, откуда был получен контент. Эти правила способствуют созданию справедливого интернета и позволяют авторам самим решать, как использовать свои данные.

Мы очень рады сделать ещё один шаг к тому, чтобы задать стандарт ответственного поведения краулеров в интернете, и особенно гордимся партнёрами по веб-поиску, которые приняли этот вызов и вместе с нами поддерживают эти стандарты. Используя веб-поиск Cloudflare, вы получаете доступ к результатам операторов, которые стремятся сделать интернет лучше: они обеспечивают прозрачность, контроль и наглядность, указывают своих краулеров, соблюдают robots.txt и предоставляют источники результатов поиска.

Использование Web Search API через AI Gateway

AI Gateway от Cloudflare — это основная точка интеграции нашего нового продукта Web Search API. AI Gateway задуман как плоскость управления вашими приложениями: в него уже встроены средства наблюдаемости, единая система выставления счетов, безопасность и управление доступом. Веб-поиск отлично вписывается в эту концепцию: вы можете оплачивать его запросы кредитами AI Gateway, собирать журналы и данные о запросах, а также управлять доступом к разным провайдерам веб-поиска.

Запросы отображаются в обычных журналах наблюдаемости AI Gateway, а поисковые запросы списываются с баланса кредитов AI Gateway. Мы будем указывать партнёров, поддерживающих Zero Data Retention (ZDR), чтобы вы знали, что ваши данные не сохраняются. Кроме того, веб-поиск доступен напрямую по опубликованным тарифам API наших партнёров — без дополнительной наценки. Подробнее — в документации для разработчиков по веб-поиску.

Мы также поддерживаем Bring-Your-Own-Key (BYOK) для провайдеров веб-поиска, как и для провайдеров инференса моделей. Благодаря этому вы можете использовать существующую организационную инфраструктуру и начать работу с AI Gateway и веб-поиском всего за несколько простых шагов.

Прямой REST API

Если вы отправляете HTTP-запросы из уже существующего серверного приложения, мобильного приложения или внешнего сервиса, можно обращаться к веб-поиску напрямую через стандартную конечную точку REST. Просто передайте токен аутентификации AI Gateway, укажите предпочтительного провайдера в теле запроса — и получите результаты веб-поиска.

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \
  --request POST \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "What are some fun things to do in Salt Lake City as fall approaches?",
    "provider": "ceramic",
    "limit": 5,
    "options": {
      "gateway": { "id": "default" }
    }
  }'

Привязки Workers

Разработчикам, которые создают приложения непосредственно на Cloudflare Workers, достаточно добавить одну строку кода. У нас также есть отдельная привязка Worker, с помощью которой ваш агент сможет выполнять веб-поиск:

const response = await env.AI.websearch({
  gatewayId: "default",
  query: "What are some fun things to do in Salt Lake City as fall approaches?",
  provider: "exa",
  limit: 5,
})

const results = await response.json()

Скоро: инструменты сервера

Мы активно разрабатываем встроенные инструменты сервера непосредственно в AI Gateway. Скоро вам не придётся самостоятельно определять инструменты: они будут встроены в нашу плоскость управления, чтобы вы могли больше времени уделять разработке, а не настройке инфраструктуры. Веб-поиск станет одним из первых инструментов в нашем серверном наборе, и мы с нетерпением ждём, когда вы его опробуете.

Но если вы уже сейчас хотите самостоятельно организовать веб-поиск как серверный инструмент, это легко сделать с помощью следующего фрагмента кода Worker:

const completion = await env.AI.run(
  "@cf/google/gemma-4-26b-a4b-it",
  {
    messages: [{ role: "user", content: "What happened in the last Cloudflare Birthday Week in 2025?" }],
    tools: [{
      type: "function",
      function: {
        name: "web_search",
        description: "Search the web for current information.",
        parameters: {
          type: "object",
          properties: { query: { type: "string" } },
          required: ["query"],
        },
      },
    }],
  },
  { gateway: { id: "default" } },
)

const toolCall = completion.tool_calls?.[0]

if (toolCall?.name === "web_search") {
  const response = await env.AI.websearch({
    gatewayId: "default",
    query: toolCall.arguments.query,
    limit: 5,
  })

  const searchResults = await response.json()
  const finalResponse = await env.AI.run(
    model,
    {
      messages: [
        { role: "user", content: prompt },
        {
          role: "tool",
          name: "web_search",
          content: JSON.stringify(searchResults),
        },
      ],
    },
    { gateway: { id: "default" } },
  )
}

Попробуйте уже сегодня!

Мы рады добавить веб-поиск на нашу платформу и сделать это вместе с замечательными партнёрами, которые задают пример ответственного отношения к интернету. Попробуйте новые инструменты веб-поиска через AI Gateway, отдельный REST API и другие интерфейсы, которые появятся в будущем. Начните с нашей документации для разработчиков уже сегодня или опробуйте поиск в AI Playground, используя аккаунт и ключ AI Gateway.

© Cloudflare Blog