跳转到内容
搜索文档

公共端点设置

最后更新 查看 MarkdownAgent 设置

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

可用端点

每个 AI Search 实例可以暴露三个公共端点:

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

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

公共 URL 格式

启用后,公共端点可通过以下地址访问:

https://<hash>.search.ai.cloudflare.com/<endpoint>

<hash> 是实例的唯一公共端点标识符。

例如:

  • https://abc123.search.ai.cloudflare.com/mcp
  • https://abc123.search.ai.cloudflare.com/chat/completions
  • https://abc123.search.ai.cloudflare.com/search

启用与禁用公共端点

你可以分别启用或禁用每个公共端点:

  1. 登录你的 Cloudflare 账户,并前往 AI SearchGo to AI Search ↗
  2. 选择你的 AI Search 实例。
  3. 前往 Settings(设置) > Public Endpoints(公共端点)
  4. 打开 Public Endpoints(公共端点) 开关以启用该功能,然后按需分别打开或关闭各个端点。

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

速率限制

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

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

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

CORS 配置

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

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

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

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

工具描述

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.

安全注意事项

  • 公共端点不需要认证。
  • 建议启用速率限制以防滥用。
  • 使用 CORS 规则将访问限制到特定域名。
  • 通过仪表板分析监控使用情况。

相关

  • UI snippets - 使用公共端点,向网站添加预构建的搜索与聊天组件。

这篇文档对您有帮助吗?