术语表

本页定义 Workova 文档中出现的核心概念。当您在其他文档中遇到不确定的术语时，可以回到这里查阅。

---

Agent

执行任务的 AI 助理实体。每个 Agent 拥有独立的配置，包括模型选择、系统提示词、技能绑定和工具权限。Agent 是 Workova 中所有任务执行的主体。

Conversation

一次具体的对话或任务过程。一个 Agent 可以参与多个 Conversation。Conversation 是消息和交互的容器。

Run

某次 Agent 的真实执行过程。Run 强调状态流转（running → paused → completed / failed / canceled）、事件序列和执行结果。一个 Conversation 内可以包含多个 Run。

Workflow

将一组步骤固定下来、可重复运行的自动化流程。Workflow 由桌面端执行，支持启动、等待、控制、快照等操作。

Automation

让任务在特定条件下自动触发的能力。Automation 定义触发器和目标（Agent 或 Workflow），当条件满足时自动发起 Run。

Skill

可复用的本地能力块。技能通过 SKILL.md 文件（含 frontmatter）定义，经扫描和校验后绑定到 Agent。技能比插件更轻量，适合封装特定场景的操作指南或工具配置。

Tool

Agent 调用的具体能力入口。内置工具（如 fs.read、shell.exec）由 runtime 提供，MCP 动态工具由外部服务注册。每个工具受权限和审批策略约束。

MCP

Model Context Protocol，一种将外部工具和上下文能力接入 Workova 的标准化协议。支持 stdio 和 HTTP 两种传输方式。MCP 服务器注册后，其工具以 mcp.<server_id>.<tool> 的形式供 Agent 调用。

Plugin

扩展 Workova 能力的插件机制。插件通过 plugin.manifest 定义，比技能更完整，支持命令定义、权限声明、入口点配置等。当前支持三种类型：

类型	适用场景
tool	命令型、本地工具型扩展
channel	渠道连接、消息收发、Webhook 适配
skill	技能桥接兼容或技能类扩展

Command Contract

命令的标准化定义。Command Contract 约束命令的输入、输出和边界，使 GUI、CLI 和 runtime 共享同一套能力描述。这是 Workova 内部实现一致性的关键机制。

Checkpoint

运行时恢复点。Checkpoint 保存 Run 的完整状态快照（包括 metadata、conversation slice、tool state 等），支持状态回滚（restore）和继续执行（resume）。简单理解：Checkpoint 是任务执行的存档点，出错时可以从这里重来。

Sandbox

Agent 工具执行的安全隔离环境。支持三种模式：trusted（完全信任）、workspace（限制在工作区范围，默认）、strict（强拦截危险操作）。简单理解：Sandbox 控制 Agent 能访问哪些系统资源，防止误操作。