术语表

本页定义 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 内部实现一致性的关键机制。

Hook

Agent 运行时的生命周期扩展点。Hook 监听特定事件（如 pre_turn、turn_complete、pre_tool_call 等），在事件触发时执行自定义逻辑。支持 15 种事件类型，覆盖会话、对话轮次、工具调用、记忆处理和自动化运行的完整生命周期。Hook 按优先级排序执行，支持串行和并行两种模式。详见 Hook 系统。

Knowledge

Agent 记忆系统中的知识点。通过 Learning 过程从外部来源（URL、文件、文件夹）提取，包含内容、分类、重要度、标签和适用场景等结构化信息。Agent 在对话前通过内置 Hook 自动检索相关知识并注入上下文，提升回答质量。

Learning

将外部信息源导入 Agent 记忆系统的过程。支持三种来源类型：URL（网页）、File（单个文件）和 Folder（目录）。Learning 会解析源内容、提取结构化知识点（Knowledge），并存入向量数据库供后续检索使用。

Checkpoint

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

Sandbox

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