智能体（Agents）

智能体（Agent）是拥有人设、工具和知识的"数字员工"。你可以创建多个 Agent，在对话中用 @名字 召唤，也可以让多个 Agent 协作完成复杂任务。

版本：个人版与企业版均支持。多智能体投票（MoA）编排企业版默认开启，个人版默认关闭。

创建一个 Agent

1. 进入「Agent 工坊」→ 新建 Agent
2. 填写：
   • 名称（如「代码助手」）
   • 人设提示词（System Prompt，如「你是一个擅长 Go 的全栈工程师」）
   • 工具（可选，限定该 Agent 能用哪些工具）
   • 知识库绑定（可选）
3. 保存后在对话中 @代码助手 <任务> 即可调用

Agent 的数据模型包含：ID / 名称 / 系统提示词 / 工具列表 / 状态 / 模型 / 来源（系统内置 or 用户自定义）/ 启用开关 / 温度 / MaxTokens。

人设（Persona）

人设由四个文件共同构成：SOUL.md / RULES.md / IDENTITY.md / USER.md，由系统拼装为最终 System Prompt（超长会截断，缺失有回退）。

多智能体协作（MoA）

当任务较复杂时，可启用 Mixture-of-Agents（MoA） 投票编排：

• 多种策略：majority（多数投票）/ best（最优）/ ensemble（集成）/ two_phase（两阶段）
• 父 Agent 负责拆解计划（decomposer），由子 Agent 并行执行（subagent_executor），最后汇总
• 企业版默认开启；个人版需设置 LYNCORE_MOA_ENABLED=true 开启

A2A 协议（Agent-to-Agent）

Lyncore 同时是 A2A 的 Server 与 Client，可与其他遵循 A2A 协议的智能体互操作：

• 暴露能力卡：GET /.well-known/agent.json
• 任务接口：POST /a2a/tasks/send、POST /a2a/tasks/sendSubscribe、GET /a2a/tasks/:id/status、DELETE /a2a/tasks/:id
• 在配置中通过 a2a_agents 段登记外部 Agent，注册为可调用工具

A2A 为个人版与企业版共有能力。

管理接口

方法	路径	说明
POST	/api/v1/agents	创建 Agent
GET	/api/v1/agents	列出 Agent
PUT	/api/v1/agents/:id	更新 Agent
DELETE	/api/v1/agents/:id	删除 Agent
POST	/api/v1/agents/:id/run	运行 Agent

提示

• 给 Agent 明确的工具白名单，避免它误调高风险工具
• 把常用资料绑进知识库，让 Agent 的回答更贴合你的上下文
• 用 @ 精确召唤特定 Agent，避免主对话被无关上下文干扰