Agent 配置
wesgine Agent 管理:注册、多实例、工具白名单、Skill 过滤与认知配置。
Agent API
HTTP 端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /agents | 列出 Agent |
| POST | /agents | 注册/更新 Agent |
| GET | /agents/{aid} | 获取单个 Agent |
| DELETE | /agents/{aid} | 删除 Agent |
SDK API
cell.Agents().Register(ctx, AgentConfig{...})
cell.Agents().Get(ctx, agentID)
cell.Agents().List(ctx)
cell.Agents().Delete(ctx, agentID)
AgentConfig 主要字段
| 字段 | 说明 |
|---|---|
ID | Agent 唯一标识 |
Name | 显示名称 |
SystemPrompt | 系统提示词 |
Model | 默认模型 |
Skills | Skill 白名单过滤器 |
Tools | 工具白名单 |
MaxTurns | 最大轮次 |
Temperature | 模型温度 |
Agent 是 Cell 内次级隔离
Agent 与 Cell 的关系:
Cell(物理隔离域)
└── Agent A(独立认知配置)
└── Agent B(独立认知配置)
└── Agent C(独立认知配置)
共享 vs 独立
| 共享(Cell 级) | 独立(Agent 级) |
|---|---|
| 物理资源 | prompt |
| Memory 存储 | tool ACL |
| Knowledge 语料 | model 选择 |
| Provider 池 | Skills 白名单 |
命名空间
agent://X/*:Agent X 私有cell://*:Cell 内共享
Skill 过滤
AgentConfig{
Skills: nil, // nil = 全量
Skills: []string{}, // 空 = 无
Skills: []string{"code-review", "test-engineering"}, // 白名单
}
双层白名单
Cell DisabledEngineSkills × Agent Skills → AND 生效
Cell 级禁用的 Skill,即使 Agent 允许,也不可见。
Tool 白名单
Agent 可限制可用的工具集:
AgentConfig{
Tools: []string{"read", "grep", "exec"}, // 仅这些工具可用
}
多 Agent 场景
一个 Cell 可注册多个 Agent,每个 Agent 独立配置。
典型场景:
agent-legal:合同审查 Agent(只读工具、法律 Skill)agent-research:判例检索 Agent(搜索工具、研究 Skill)agent-assist:通用助手 Agent(全量工具)
Run 指定 Agent
cell.Runtime().Run(ctx, AppRunRequest{
AgentID: "agent-legal",
Actor: "alice",
...
})
Agent Memory 命名空间
Agent 级记忆存在 agent:// 命名空间内:
| 命名空间 | 可见性 |
|---|---|
agent://legal/* | 仅 agent-legal |
agent://legal/shared | agent-legal 内共享通道 |
cell://* | 全 Cell 共享 |
相关文档
- CellSpec 总览 →
cellspec-overview.md - Skill 系统 →
skill-system.md - Memory 层模型 →
memory-layer-model.md