跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

公共端点设置

最后更新 查看 MarkdownAgent 设置

配置公共端点,可直接向用户暴露你的 AI Search 实例,而无需认证。这样你可以将 AI Search 功能分享给外部用户,或集成到面向公众的应用中。

你可以在单个实例或整个 namespace 上启用公共端点,后者会在多个实例之间搜索并合并结果。本页内容同时适用于两者。仅适用于 namespace 的内容(例如选择端点可以到达哪些实例)请参阅 Namespace 公共端点。

可用端点

实例或 namespace 可以暴露三个公共端点:

端点 说明
/mcp 面向 AI 智能体的 Model Context Protocol 端点
/chat/completions 兼容 OpenAI 的 chat completion 端点
/search 返回相关分块的搜索端点

有关如何使用这些端点的详情,请参阅 公共端点用法。

公共 URL 格式

启用端点时,Cloudflare 会生成主机名。它不是实例或 namespace 名称。

主机名 服务对象
<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com 单个实例。
ns-<NAMESPACE_ENDPOINT_ID>.search.ai.cloudflare.com namespace,并在多个实例之间搜索。

例如:

  • 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 实例或 namespace。
  3. 前往 Settings(设置) > Public Endpoints(公共端点)。
  4. 打开 Public Endpoints(公共端点) 开关以启用该功能,然后按需分别打开或关闭各个端点。

每个端点都有独立的配置面板,便于精细控制。

要通过 API 启用 namespace 端点,请参阅 Namespace 公共端点。

速率限制

配置速率限制以控制所有公共端点的使用量:

设置 说明 默认值
Requests per period 允许的最大请求数 120
Time period 速率限制的时间窗口 1 minute
Period type 速率限制技术:fixed 或 sliding fixed

速率限制适用于该 AI Search 实例上所有已启用的公共端点。

CORS 配置

默认启用跨源资源共享(CORS),以支持基于浏览器的应用。

默认允许的源取决于数据源类型:

  • 网站数据源:源域名会自动添加为允许的源。
  • 其他数据源:默认允许所有源(*)。

你可以在 Public Endpoints(公共端点) 设置中,通过向 Authorized hosts(授权主机) 添加特定主机名来自定义允许的源。

工具描述

Tool Description(工具描述) 字段允许你自定义 MCP 客户端如何描述你的 AI Search 实例。默认描述为 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。
  • 通过仪表板分析监控使用情况。

相关

UI snippets

向网站添加预构建的搜索与聊天组件。

这篇文档对您有帮助吗?