快速开始
用一个真实任务跑通项目、Agent、客户端执行与结果回写。
适用范围AIBoard Server + Client · 持续更新
开始前检查
你需要一个可访问的 AIBoard 组织、至少一个项目,以及已经登录同一组织的 AIBoard Client。首次练习请选择不包含生产凭据、客户隐私或不可逆操作的任务。
第一步:建立项目边界
创建项目后补全项目目标、交付范围、明确不在本次范围内的内容、主要风险和待确认问题。项目边界是后续检索、工具授权与结果验收的依据,不能只写一句宽泛目标。
一个合格的练习目标可以是:
阅读当前工程中的接口定义和测试结果,找出失败用例对应的代码路径,形成一份修复建议;未经确认不得修改生产配置或提交代码。
第二步:选择任务上下文
把当前工程、需求卡、相关文档和测试证据加入任务。确认每项来源都能追溯到原文件、卡片或系统记录。不要为了“让 Agent 知道更多”而把整个组织资料全部放入上下文。
第三步:让 Agent 制定计划
发起任务后先检查计划是否包含:输入确认、执行步骤、验证方式、回写目标和风险节点。需要调用外部系统、修改文件、执行命令或写入数据库的步骤,应明确工具与审批边界。
第四步:在客户端执行
客户端收到任务后,只在当前工作区和当前用户权限内执行。遇到跨目录访问、外部命令、生产接口或凭据租约时,按组织策略进入确认。执行过程中保留关键日志、差异和产物,不要只提交一句“已完成”。
第五步:验收与沉淀
回到项目检查结果是否满足验收标准,来源和执行证据是否完整。把稳定、可复现的方法提炼为 Skill 或 Workflow;一次性的环境路径、客户名称和临时凭据不能进入通用能力包。
完成标准
- 目标、边界与验收标准清晰。
- Agent 使用的来源可以追溯。
- 高风险动作经过确认。
- 结果和证据已回写到正确项目对象。
- 至少识别出一项可以复用的方法,或明确说明为什么本次不适合复用。
