使用 xAgent 完成第一个任务
开始前
- 已有 xAgent 账号和可用服务地址：直接登录会话界面，不需要自己安装服务器或创建智能体。
- 还没有服务：请由管理员完成安装与初始化及模型验证。
- 准备一份不含密码、密钥或真实敏感资料的小文件。下面的会议案例是练习示例，不代表已经执行的业务结果。
从提交到验收
- 打开会话界面，选择一个已有会话或新建一个任务会话。
- 粘贴目标；涉及文件时先上传材料，并在消息中明确文件名或使用界面插入的文件引用。
- 提交后查看消息和工具执行状态。遇到补充问题先补材料；遇到审批先检查目标、参数和影响，再决定是否同意。
- 完成后打开实际文件预览，核对内容，再下载或继续修改。只出现文件名或“已完成”的文字不等于文件已经保存。
- 验收通过后再决定是否外发。练习任务不需要连接外部账号，也不需要为了省事放宽审批规则。
基本用法
描述任务时，可以先使用下面的结构化模板：
目标：
输入材料：
必须遵守的约束：
输出格式：
结果保存位置：
不需要机械填写每一项。任务越复杂，越应该明确材料范围、限制条件和结果形式。
一个适合新手的任务可以这样写：
请把这段需求整理成待办清单，按“必须 / 应该 / 可选”分组，最后给出一个 Markdown 表格。
如果任务涉及文件，先上传文件或把文件放到工作区，再说明要处理哪个文件：
请阅读我刚上传的会议记录，整理决策、待办、负责人和截止时间，并保存为 Markdown。
提交后关注三件事：
- xAgent 是否请求补充材料。
- 是否出现需要确认的工具调用或权限请求。
- 最终结果是直接回复，还是保存到了工作区产物中。
如果结果不符合预期，继续在同一个页面中补充要求，例如“保留原始表述”“增加风险列”“把结果保存成 CSV”。
完整案例：整理会议记录
输入
上传一份名为 meeting-notes.md 的会议记录，其中包含讨论内容、决定、负责人和时间要求。也可以先将下面的虚构内容保存成同名文件：
示例会议：新版本测试准备
决定：先向测试用户开放，再根据反馈扩大范围。
张三负责在 7 月 18 日前整理测试问题清单。
发布范围需要进一步确认，负责人和截止日期尚未确定。
风险：部分问题还没有复现步骤。
任务
请读取 meeting-notes.md，提取会议决定、待办事项、负责人、截止时间和风险项。
生成一份便于阅读的 Markdown 总结，并把待办事项同时保存为 CSV。
信息不明确时请标记为“待确认”，不要自行补充。
执行时需要确认
- xAgent 是否读取了正确的文件。
- 是否保留了原文中能够确认的负责人和日期。
- 信息缺失时是否明确标记，而不是自行猜测。
- 最终是否同时生成 Markdown 和 CSV 文件。
输出
工作区中可以得到：
meeting-summary.md
meeting-actions.csv
meeting-summary.md 的内容可以类似：
## 会议决定
- 新版本先向测试用户开放，再根据反馈扩大范围。
## 待办事项
| 待办 | 负责人 | 截止时间 | 风险 |
| --- | --- | --- | --- |
| 整理测试问题清单 | 张三 | 7 月 18 日 | 部分问题缺少复现步骤 |
| 确认发布范围 | 待确认 | 待确认 | 需要负责人补充 |
这个案例的验收标准很明确：来源文件正确、关键信息可追溯、缺失内容没有被编造，并且两个结果文件都已保存。
卡住时先看什么
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 无法发送或没有可用模型 | 管理员是否完成初始化，当前模型是否可用 | 模型配置 |
| 提示找不到文件 | 文件是否上传成功、是否在当前会话可访问范围内 | 工作区文件 |
| 一直等待确认 | 是否存在待处理审批，或任务正在等你补充信息 | 审批与安全边界 |
| 回复有结果但没有文件 | 是否明确要求保存，实际写入是否成功 | 任务与交付 |