使用指南

您无需 API 密钥即可开始：系统已包含一个托管模型，免费版智能体可自动在平台的共享池上运行。如果您的套餐允许使用自己的提供商，请前往 连接 → 提供商，选择 Anthropic、OpenAI 或其他支持的提供商，并粘贴您从该提供商仪表板获取的 API 密钥。在保存密钥前，系统会通过一次真实的（不计费）调用来验证其有效性，并对其进行静态加密。一旦显示为 ACTIVE，您的智能体将使用此密钥，而非托管池。

之后，自然的构建顺序是：创建一个智能体（构建 → 智能体），在演练场（测试 → 演练场）中私下试用，然后将其接入工作流以实现多步自动化，或直接连接到渠道（WhatsApp、Telegram、电子邮件），以便真人可以与其对话。

任何要求输入系统提示或描述的字段——例如智能体的系统提示、知识集合的描述等——其标签旁边都有一个小的 ✨ 询问 AI 按钮。点击它，用一句话描述您的需求（例如“一个处理退款和订单状态的支持智能体”），它就会使用您已激活的 LLM 提供商来起草文本。任何内容都不会自动应用——您始终需要审查建议，然后自行点击使用此项，或点击重新生成再试一次。

一个智能体就是一个 AI 人格：包含一个系统提示、一个 LLM 提供商/模型，以及可选的知识库和受限的工具集。您可以从模板（支持分流、研究助理等）开始，以预填充合理的系统提示，或者从头开始并使用“询问 AI”来起草一个。

工具访问权限和知识访问权限都是白名单：留空表示“无限制”（智能体可以使用您租户当前可用的任何东西），或勾选特定项目以将智能体限制为只能使用这些。这对于任何面向客户的应用都很重要——您通常不希望公共支持机器人能够访问所有内部工具。

上传 .md、PDF、Word、图片 (OCR) 或音频/视频 (转录) 文件，它们将被分块并嵌入到可搜索的向量存储中。集合是您可以嵌套并将智能体限定范围的文件夹——例如，一个“退货政策”集合只有某些智能体可以搜索，而一个“公共 FAQ”集合则每个智能体都可以使用。

只有在创建智能体时勾选了“附加知识库”（或稍后从“智能体”页面开启），智能体才会搜索其知识库，并且仅在其知识访问白名单允许的集合范围内搜索。

用于多步自动化的可视化画布：拖动节点（触发器、智能体、知识搜索、条件、输出、设备控制等）并连接它们。每个节点都会调用其背后的真实服务——一次工作流运行会真正调用您的智能体，真正搜索您的知识库，真正发送 WhatsApp 消息。

工作流可以通过三种方式启动：手动（“运行”按钮）、按计划（cron 表达式，例如“每天早上 8 点”），或通过您可以从任何外部系统调用的 webhook URL。每次运行都会在该工作流的“运行”标签页下被逐步记录，包括智能体节点在此过程中进行的每一次工具调用。

一个模型上下文协议服务器和内置工具的市场，智能体可以在对话中调用这些工具（网页搜索、数据库、文件系统、您自己的自定义脚本...）。启用您想要可用的工具，然后从每个智能体的工具访问编辑器中限定哪些智能体可以使用它们。在此处禁用一个服务器会立即将其从所有智能体的可用工具中移除，即使是之前已勾选它的智能体。

在管理 → 渠道下：通过 Twilio（快速沙盒设置，每条消息收取少量费用）或直接通过 Meta 自己的 WhatsApp Business Platform（无中间商费用，但设置更复杂——需要您自己的 Meta 应用、系统用户令牌和应用密钥）连接 WhatsApp。如果两者都已配置，将自动使用直接的 Meta 连接。

当一个新手机号首次发来消息时，它会显示在待处理的发件人配对下，需要经过批准，您的智能体才能与其进行实时对话——这可以防止陌生人向您的号码发送消息时默认进入无人监管的 AI 对话。

从“设备”页面将一部手机（Android 或 iOS）与您的租户配对，工作流的设备控制节点便可以对其进行点击、输入、打开应用或截图。Android 通过其无障碍服务支持完全自动化；而 iOS 受限于苹果自身的沙盒机制，仅能打开应用——请参阅移动 SDK 的 CONSTRAINTS.md 文件，了解各平台能做什么和不能做的完整、坦诚的分析。

用户：邀请团队成员并分配角色（只有租户管理员可以更改角色或凭据）。审批是人工介入的收件箱——任何被您的护栏策略标记为需要签批的操作（例如，智能体即将发送一条 WhatsApp 消息）都会在此等待，直到被批准或拒绝。审计日志是您的租户中由人或智能体执行的每一项重要操作的完整、只可追加的记录。

"No active providers yet" when creating an agent - you should not see this on a new account: every new account runs on the platform's hosted pool for its first 3 months, and the Free plan does after that. It appears once you are on a paid plan using your own provider - activate one under Connect → Providers.

“询问 AI”按钮报错 - 原因同上。只有当您的账户脱离托管池且没有自己的活跃提供商时，才会出现此问题。

待处理的 WhatsApp/Telegram 发件人一直收不到回复 - 请检查“管理 → 渠道”中是否有等待您批准的配对。

某个工具未对智能体显示 - 请确认它已在“MCP 工具”下启用，并且该智能体的工具访问列表要么包含它，要么为空（无限制）。