创建第一个智能体并完成基础验证
本教程创建一个只使用模型和系统提示词的智能体模板，再创建一个智能体实例，并在 Playground 中完成第一次对话。这是基础运行检查，用于确认模型凭证、智能体模板、智能体实例和 Playground 链路可用。本教程不接入企业资料或业务系统。获得回复不表示智能体已经具备处理真实业务任务所需的知识或工具；完成本教程后，还需要继续完成一个可验收的业务场景。
开始前，请先确认访问权限和使用前提。至少需要进入普通控制台，并有一个可以选择模型的模型凭证。
按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。
准备模型凭证
如果租户中已经有可用的模型凭证，可以直接进入下一步。
打开 凭证管理。
也可以从控制台左侧导航进入 凭证管理。
单击 新建凭证。
填写 凭证名称、API Key 和 Base URL。
单击 获取模型列表，确认平台可以读取可用模型。
按需选择 默认模型，然后选择 创建凭证。
警告
模型凭证包含可用于访问模型服务的密钥。只向需要配置智能体的人员开放凭证管理权限，不要在提示词、描述或渠道消息中粘贴 API Key。
创建智能体模板
如果从控制台首页开始，选择 创建智能体 会进入本流程。该快捷入口创建可复用的智能体模板。要运行、测试或接入渠道，还需要创建智能体实例。
打开创建智能体模板页面。
也可以打开 智能体模板，再选择 创建智能体模板。
在 模板名称 中输入便于团队识别的名称，例如
基础验证助手。在 模型凭证 中选择刚才准备的凭证。
在 模型 中选择一个模型。
在 系统提示词 中输入：
language-text你是一个基础验证助手。回答要简洁、准确。 当请求缺少必要信息时，向用户提问，不要猜测。保持沙箱、MCP、记忆库、知识库、技能组和渠道配置为空，并单击 创建智能体模板。
警告
创建智能体实例前必须已经存在一个智能体模板。实例创建页面只允许选择已有模板。这个要求只适用于智能体模板；只使用模型的第一个智能体模板仍不要求提前创建沙箱、MCP、记忆库、知识库或技能组模板。
创建智能体实例
打开创建智能体实例页面。
也可以打开 智能体实例，再选择 创建实例。
在 智能体模板 中选择刚创建的智能体模板。
输入 实例名称，例如
基础验证助手-dev。如果页面出现可配置参数，确认其值适合当前测试环境。
选择 创建实例。
智能体实例是实际运行、保存会话并被 API 或渠道调用的对象。智能体模板仍可用于创建其他智能体实例。
在 Playground 中试运行
- 打开刚创建的智能体实例。
- 选择 Playground。
- 等待连接状态变为 已连接。
- 发送：
我的订单还没有收到，帮我看一下。确认智能体先询问订单号，而不是编造订单状态。再发送一个包含测试订单号的消息，确认连续对话可以使用同一会话上下文。
如果连接没有成功，先检查智能体实例是否显示为 运行中，再刷新 Playground。参见排查智能体实例运行问题。
确认基础验证结果
完成教程后，应能确认：
- 智能体模板 中存在一个模型和提示词配置。
- 智能体实例 中存在一个对应的运行实例。
- Playground 可以建立连接并返回回复。
- 创建第一个智能体模板不依赖任何能力模板或能力实例。
- 智能体实例来自前一步已经创建的智能体模板。
完成一个可验收的业务场景
确认智能体实例能在 Playground 中建立连接、按提示词回复并保持多轮对话后，基础验证已经完成。继续选择一个可以明确验收的结果；无需一次添加所有能力：
- 推荐起点：根据固定资料回答问题，并通过 Trace 确认实际发生检索。该路径不依赖外部业务 API 或渠道应用，参见构建可追溯的企业知识助手。
- 让业务调用方执行自定义工具，并把真实结果交还智能体：参见构建可调用业务系统的工单助手。
- 让每位飞书用户按需获得自己的智能体实例：参见构建按用户开通的飞书助手。
- 让业务后端通过 API 使用：参见通过 API 调用智能体。
- 让飞书或 QQ 用户使用：参见通过渠道提供智能体。
- 接入自有消息系统：参见通过 WebSocket 接入智能体。
想先比较三种场景时，参见选择一个场景实战。尚未确定交付方式时，参见按目标选择下一步。准备生产上线前，参见将智能体投入生产。