构建您的智能体
智能体
智能体是可嵌入的单元——包含角色设定、提示词、知识、主题、规则—— 在客户网站上运行。本页涵盖创建、配置、发布和回滚智能体。
创建智能体
从客户应用：/app/agents → 新建智能体。
系统会要求您输入名称和默认语言。其他所有项都有合理的默认值，
您可以稍后进行调整。
注册时，我们还会自动创建一个以您的域名命名的入门智能体。 您可以自由重命名、复制或删除它。
智能体记录
每个智能体都有这些可编辑字段：
| 字段 | 作用 |
|---|---|
name | 仪表板中的显示名称。不向访客展示。 |
language_default | BCP-47 / ISO 639 代码，用于固定智能体的回复语言。选择从 lang/*.json 自动发现的任何区域设置（开箱即用 132 种；en/es/fr/tr 完全翻译，其他有 UI 界面翻译）。当访客的 Accept-Language 不匹配时使用——智能体也可以按对话覆盖。空值 = 跟随访客的浏览器区域设置。 |
persona | JSON：{ name, tone }。语气直接放入系统提示词中。 |
theme | 小部件颜色、圆角、位置、启动器标签。 |
system_prompt | 可选覆盖。附加到内置提示词——不会替换安全/RAG 指令。 |
guardrails | JSON：{ avoid: [topics], max_chars }。 |
starter_prompts | 首次打开时输入框上方显示的 chips，最多 6 个。每个 80 字符。 |
confidence_threshold | 0–1。低于此分数（重新排名后），智能体会说"我不知道"而不是猜测。 |
allowed_origins | 小部件可以加载的严格 scheme://host 来源列表。 |
auto_index_visited_pages | 如果开启，访客访问的页面会被排队进行爬取和索引。 |
置信度阈值
检索器对每个片段与访客的问题进行评分。低于
confidence_threshold 的任何内容都会被丢弃。如果少于两个
片段幸存，答案将被标记为 low_confidence，智能体会诚实地
回答它不知道——并且系统会排队一个"知识缺口"条目供您审查。
默认值针对每个提供商进行了调整：
- Cloudflare bge-base-en-v1.5 嵌入——默认
0.5。余弦分数比 OpenAI 的低，所以标准更低。 - OpenAI text-embedding-3-small ——默认
0.78。如果您切换提供商，请在注册时设置。
草稿 → 已发布
编辑智能体永远不会影响实时访客。小部件运行时从名为
agent_version 的快照读取。点击 发布
将当前状态写入新版本，并将智能体的 published_version_id
指向它。
版本是不可变的。要回滚，请打开智能体的历史记录并点击以前版本的 回滚 —— 这只是更新指针。不会删除任何内容。
嵌入智能体
智能体的设置页面显示一行安装代码片段，其中嵌入了您的
data-agent-id。小部件 URL 包含一个缓存清除哈希，
每当包重建时都会变化，因此客户不会卡在过时的版本上。
详见 安装代码片段。
每个工作区的多个智能体
您可以运行任意数量的智能体——一个用于营销，一个用于帮助中心， 一个用于应用内升级流程等。每个都有自己的知识库、角色设定和嵌入代码片段。 对话和潜在客户保持在与处理它们的智能体范围内。