创建第一个 Agent
这篇文章带你走完从零创建一个 Agent 的完整流程：新建 → 名片编辑 → 聊天式训练 → 配置大脑（技能 / 知识 / 应用）→ 发布 → 数据复盘。
1. 新建 Agent
在「我的Agent」页面，点击搜索框右侧的「新建Agent」按钮。一个新 Agent 卡片会出现在列表中，初始状态：技能 0、知识库 0、应用 0，简介显示「暂无简介」。
点击卡片进入 Agent 详情页，开始配置。
2. 编辑名片
进入详情页后，默认展示「名片」tab。这是 Agent 的对外展示面：
你可以做的事情：
- 编辑名片 — 点击「编辑名片」按钮，修改 Agent 名称和简介描述
- 更换头像 — 点击「更换头像」按钮，为 Agent 设置一个有辨识度的头像
- 预览对话入口 — 名片页下方是「开始对话」区域，展示 Agent 发布后用户扫码对话的入口（微信小程序二维码 / 网页链接）
3. 进入创造区，聊天式训练
切换到「创造」tab，这里是 Agent 的核心训练区。页面内有双 tab：
| Tab | 用途 |
|---|---|
| 训练（默认选中） | 聊天式对话训练，通过自然语言告诉 Agent 它该做什么 |
| 测试 | 在不发布的情况下测试 Agent 的表现 |
在训练界面底部输入框中，用自然语言描述你想要的 Agent：
"我想创建一个帮助我管理飞书文档的助手，它能自动汇总每周的会议纪要并生成周报。"
输入框 placeholder 提示：「描述你想创建的Agent，并提出技能要求～（回车发送，Shift+回车换行）」。你还可以通过「上传附件」按钮上传文件作为训练素材。
Agent 会根据你的描述逐步学习，对话历史支持滚动浏览，每条消息附带时间戳和可展开/折叠的工具调用记录。
4. 配置智能体大脑
Agent 详情页左侧导航栏中的「智能体大脑」是一个可展开的菜单，包含四个核心配置项：
| 配置项 | 解决什么 | 操作 |
|---|---|---|
| 技能 | Agent 能做什么——给它装上可执行的方法 | 从技能列表中选择安装 |
| 知识 | Agent 知道什么——给它提供参考资料 | 上传文档、添加知识库 |
| 应用 | Agent 连什么——接入第三方服务 | 配置连接器（如飞书、GitHub 等） |
| 设置 | Agent 的基础参数 | 调整模型、权限等 |
你可以通过智能体大脑的展开菜单逐项配置，也可以通过导航栏中的「技能」「知识」「应用」「设置」快捷链接直接跳转。
⚠️ 训练区的配置会直接影响 Agent 的行为。修改大脑配置后，建议切换到「测试」tab 验证效果，再决定是否发布。
5. 发布 Agent
配置就绪后，点击左侧导航栏底部的「立即发布」按钮（已发布过的 Agent 显示为「发布新版本」）。
发布流程：
- 点击「立即发布」，按钮变为「发布中…」（禁用状态）
- 右上角通知显示「已开始发布」
- 发布完成后，侧边栏 Agent 名称下方显示「已发布」状态
发布后，回到「名片」tab，你会看到：
- 微信小程序二维码 — 用户扫码即可开始对话
- 网页链接 — 生成网页版对话入口（需进一步确认）
- 体验版 QR toggle — 默认关闭，开启后可生成体验版二维码
- 「更换二维码」按钮 — 更换展示的二维码图片
⚠️ 发布行为在 staging 环境为即时操作。公开发布 vs 私有发布的选择及不可撤销警告在当前环境中未观察到（可能仅在正式版或特定条件下出现），相关流程需进一步确认。
6. 查看数据复盘
发布之后，通过 Agent 详情页的「数据管理」追踪 Agent 的使用情况。页面展示近 30 天数据，分为三个模块：
| 模块 | 包含指标 | 说明 |
|---|---|---|
| 使用情况 | 消息数、对话数、用户数 | Agent 被使用的规模 |
| 留存与口碑 | 回访率、满意度 | 用户是否愿意继续用 |
| 支出 | 消耗积分 | Agent 运行的成本 |
每个指标为可点击卡片，无数据时显示 0 或 "—"。
此外，OpenHex 还提供了全局数据看板「我的数据」(详情见数据看板)，可切换 7 天 / 30 天 / 本月时间范围，查看所有 Agent 的汇总数据和排行榜。
下一步
- Agent（智能体） — 深入理解 Agent 的设计理念和结构
- 技能（Skills） — 了解如何为 Agent 选择最合适的技能
- 发布 Agent — 掌握发布策略和数据分析方法