← Обзор / ai-search / configuration / retrieval

Настройки публичной конечной точки

Настройте публичные конечные точки, чтобы открыть прямой доступ к экземпляру AI Search для пользователей без необходимости аутентификации. Это позволяет делиться функциональностью AI Search с внешними пользователями или интегрировать её в публичные приложения.

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

Экземпляр или пространство имён могут открывать три публичные конечные точки:

Подробнее об использовании этих конечных точек см. в Использование публичной конечной точки.

Cloudflare создаёт имя хоста при включении эндпойнта. Это не имя экземпляра и не имя пространства имён.

Например:

• https://abc123.search.ai.cloudflare.com/search
• https://ns-abc123.search.ai.cloudflare.com/search

Идентификатор создаётся при первом включении эндпойнта и никогда не ротируется. При отключении эндпойнта идентификатор сохраняется, поэтому при повторном включении используется тот же URL.

Вы также можете предоставлять эти же эндпойнты с имени хоста, которым вы владеете, например https://search.example.com/search. См. Пользовательские домены.

Вы можете включать и отключать каждую публичную конечную точку независимо друг от друга:

1. Войдите в свой аккаунт Cloudflare и перейдите в AI Search. Перейдите в AI Search ↗
2. Выберите свой экземпляр AI Search или пространство имён.
3. Перейдите в Настройки > Публичные конечные точки.
4. Включите переключатель Публичные конечные точки чтобы включить эту функцию, а затем по необходимости включайте или выключайте отдельные эндпойнты.

У каждой конечной точки есть собственная панель настройки для детального управления.

Чтобы включить конечную точку пространства имён через API, см. Публичные конечные точки пространства имён.

Настройте ограничения скорости запросов, чтобы контролировать использование по всем публичным конечным точкам:

Ограничения скорости запросов действуют для всех включённых публичных конечных точек экземпляра AI Search.

Совместное использование ресурсов между источниками (CORS) включено по умолчанию для поддержки приложений на основе браузера.

Разрешённые источники по умолчанию зависят от типа источника данных:

• Источники данных «Сайт»: Исходный домен автоматически добавляется в качестве разрешённого origin.
• Другие источники данных: Все origin (*) разрешены по умолчанию.

Вы можете настроить разрешённые origin в Публичные конечные точки настройки, добавив определённые имена хостов в Авторизованные хосты.

Описание инструмента поле позволяет настроить, как ваш экземпляр AI Search описывается MCP-клиентам. Значение по умолчанию: Finds exactly what you're looking for. Это описание помогает AI-агентам понять, какой контент доступен и когда использовать ваш инструмент поиска. Хорошее описание инструмента должно объяснять, какой тип контента индексируется и на какие вопросы он может отвечать.

Например:

Search the Acme product documentation for information about
installation, configuration, API references, and troubleshooting
guides. Use this tool when users ask questions about how to set up
or use Acme products.

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

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

Если вы оставите эндпойнт открытым:

• Индексируйте только тот контент, который можно безопасно сделать общедоступным.
• Задайте лимит скорости и таким образом ограничить злоупотребления.
• Отключите конечные точки, которые не используете, например /mcp.
• Отслеживайте использование через аналитику dashboard.