Agents

Agents 将 AI 助手带入工作区。你在源码中编写指令与边界；运行时与宿主完成其余工作。

配置 Agent

两个源文件配置 Agent： src/+agents.md —— 每次 Agent 回合的系统消息 —— 以及位于 src/envoys/+<name>.ts

// src/+agents.md
What the collections mean, what the business does, and the house rules
for tone and escalation. This is the system message of every agent turn.

提示词由网页聊天与每个 envoy 共享。每个 envoy 在其上追加自己的 task ，并命名其行动所依据的 policies ——范围与能力来自这些声明，绝不来自按 Agent 罗列的数据清单。

两道门

同一个 Agent 循环在两道门后运行：

• 网页聊天——已登录用户以自己的账户行动
• envoy——envoy 主体在其声明的策略下行动

Envoy

通过 envoy 以 Telegram 或 WhatsApp 触达 Agent——每个声明其传输、受众、行动所依据的策略以及自己的任务。

工具

Agent 通过工具行动，分三层：

• 内置工具 ——每个 bolt 随附，始终可用
• 自定义工具 ——defineAgentTool 声明，每个工具一个文件，位于 src/capabilities/tools/
• 宿主工具 ——策略点名的可信宿主进程操作，外加用于会话内委派的沙箱工具（除非 envoy 禁用）。

技能

放入 src/capabilities/skills/<name>/+skill.md 文件——每个目录一个 markdown 文件——为 Agent 提供持久领域知识；技能只有在策略点名时才会进入回合。