a13nDocs

核心概念

选择 agent、交换消息、处理待办并继续对话。

通过 Console 或 Service SDK,让 agent 汇报项目进展。本页用这次对话介绍 Service 的核心概念。Harness 和 Harness UI 的用法见选择使用方式。

选择 agent

管理员授予你某个工作空间的角色。工作空间中包含团队的 agent、其他资源和对话。你在组织和工作空间中的角色决定了可以使用或修改哪些内容。

一个 agent 由模型、指令和工具组成。指令示例:“总结项目进展,并引用所使用的信息”。

组成部分在 agent 工作中的作用
模型理解请求,生成回复或工具调用
工具查找任务、读取文件或执行其他已配置的操作
连接通过 MCP 或应用账号访问外部工具
环境为工具提供文件访问和命令执行能力
记忆保存项目决策,让 agent 在不同对话中读取和更新

先配置模型和指令。让 agent 查询实际进展前,先添加能读取项目数据的工具或连接。工具与连接介绍了配置方法。

开始对话

发送:“总结项目状态,并列出接下来的两个任务。”

在 Console 中选择 agent 并发送消息。在应用中,通过 SDK 开始对话。

回复和工具活动会随进度显示。agent 工作时,可以补充说明或停止执行。兼容的补充说明会在下一次模型请求时加入当前运行,其他消息继续排队。

回答问题或审批工具调用

在对话卡片中回答问题、批准或拒绝工具调用,完成所有待处理项后选择提交回应。应用负责收集答案,准备好后提交完整的恢复批次。

稍后继续

打开会话列表,选择继续对话,再问“我应该先做哪个任务?”。应用向返回的线程发送后续消息。断开连接后,agent 仍会继续工作,Service 会保存历史。排查问题时,选择检查执行。

信息用途
线程历史继续当前线程
记忆在不同对话之间保存和检索信息
环境文件保存文档和工具使用的其他工作文件

要跨对话共享决策,在当前线程或 agent 默认配置中添加记忆。环境的存储方式和生命周期决定了工作文件可以保留多久。

需要时再了解执行细节

会话(session) 包含相关的 线程(thread),每个线程有独立的历史和收件箱。一次 运行(run) 使用 agent 的模型和工具处理输入。执行尝试(attempt) 是运行的一次实际执行;恢复时会开始新的尝试。

Console 的 Debug 视图展示这些执行细节。补充说明可以加入正在进行的运行,回答等待中的请求则会创建后继运行。

修改配置会创建不可变的 修订版本,可在 版本 中查看。新消息使用默认版本,也可以指定其他版本。正在执行的运行和审批后继续的运行沿用原版本。

接下来,可以在 Console 中试用 agent,或连接你的应用。修订版本选择和执行细节请参阅Agent、线程与运行。

本页目录