Skip to content

[Feature]: 补充面向用户的 OctoBus 集成 Quick Start 文档 #80

Description

@632661265flynn-dotcom

Problem

agent-compose 已经支持和 OctoBus 的能力集集成,但目前相关文档更偏设计说明。

对新用户来说,不太容易理解 agent-compose、OctoBus、Capability Gateway、capset、CAP_GRPC_LISTENCAP_GRPC_TARGET、会话能力注入之间的关系,也不容易知道最小可用配置应该怎么操作。

Proposal

建议增加一篇面向用户的 OctoBus 集成快速开始文档,覆盖从本地启动到验证能力可用的完整路径。

可以包括:

  • 如何本地启动 agent-compose 和 OctoBus
  • agent-compose 需要配置哪些环境变量,尤其是 CAP_GRPC_LISTENCAP_GRPC_TARGET
  • 如何在设置页配置 Capability Gateway
  • 如何确认 OctoBus 的 capset 已经能被 agent-compose 读取
  • 创建会话或智能体时如何绑定 capset
  • 如何确认会话里已经注入能力配置
  • 一个最小验证示例,例如看到 capset 并成功调用一个简单能力

Alternatives considered

目前的设计文档能说明内部实现,但不是面向新用户的操作教程。

用户也可以通过阅读代码、设计文档和历史 issue 自行推断配置方式,但首次接入成本比较高。

Additional context

这个文档可以帮助用户更快理解 agent-compose 和 OctoBus 的预期配合方式,也能减少 Capability Gateway 配置、CAP_GRPC_TARGET、能力集绑定和会话注入相关的重复问题。

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions