Problem
agent-compose 已经支持和 OctoBus 的能力集集成,但目前相关文档更偏设计说明。
对新用户来说,不太容易理解 agent-compose、OctoBus、Capability Gateway、capset、CAP_GRPC_LISTEN、CAP_GRPC_TARGET、会话能力注入之间的关系,也不容易知道最小可用配置应该怎么操作。
Proposal
建议增加一篇面向用户的 OctoBus 集成快速开始文档,覆盖从本地启动到验证能力可用的完整路径。
可以包括:
- 如何本地启动 agent-compose 和 OctoBus
- agent-compose 需要配置哪些环境变量,尤其是
CAP_GRPC_LISTEN 和 CAP_GRPC_TARGET
- 如何在设置页配置 Capability Gateway
- 如何确认 OctoBus 的 capset 已经能被 agent-compose 读取
- 创建会话或智能体时如何绑定 capset
- 如何确认会话里已经注入能力配置
- 一个最小验证示例,例如看到 capset 并成功调用一个简单能力
Alternatives considered
目前的设计文档能说明内部实现,但不是面向新用户的操作教程。
用户也可以通过阅读代码、设计文档和历史 issue 自行推断配置方式,但首次接入成本比较高。
Additional context
这个文档可以帮助用户更快理解 agent-compose 和 OctoBus 的预期配合方式,也能减少 Capability Gateway 配置、CAP_GRPC_TARGET、能力集绑定和会话注入相关的重复问题。
Problem
agent-compose 已经支持和 OctoBus 的能力集集成,但目前相关文档更偏设计说明。
对新用户来说,不太容易理解 agent-compose、OctoBus、Capability Gateway、capset、
CAP_GRPC_LISTEN、CAP_GRPC_TARGET、会话能力注入之间的关系,也不容易知道最小可用配置应该怎么操作。Proposal
建议增加一篇面向用户的 OctoBus 集成快速开始文档,覆盖从本地启动到验证能力可用的完整路径。
可以包括:
CAP_GRPC_LISTEN和CAP_GRPC_TARGETAlternatives considered
目前的设计文档能说明内部实现,但不是面向新用户的操作教程。
用户也可以通过阅读代码、设计文档和历史 issue 自行推断配置方式,但首次接入成本比较高。
Additional context
这个文档可以帮助用户更快理解 agent-compose 和 OctoBus 的预期配合方式,也能减少 Capability Gateway 配置、
CAP_GRPC_TARGET、能力集绑定和会话注入相关的重复问题。