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