SuperAPI AI 工具集

ag2-network-tools-and-views

智能体与模型

查看项目

更新于 10-15 19:49

技能介绍

用途:本技能面向 AG2 Network 的智能体/客户端侧(与 hub 侧的 ag2-network-governance 相对),用于塑造 LLM 能看到什么频道内容(视图)以及能执行哪些动作。前置要求:先阅读 ag2-network-quickstart,需了解 Hub.open、HubClient.register、频道生命周期及 agent_client.open(...)/channel.send(...)。

主要能力:智能体每轮的工具列表由两路组成。插件工具:默认 attach_plugin=True 时,NetworkPlugin 向 agent.tools 注入五个与频道无关的动词——peers/channels/tasks/context/delegate。适配器工具:频道适配器每轮通过 adapter.tools_for(client, metadata, state, participant_id) 提供频道专属工具,默认处理器解析并合并进 agent.ask(tools=...)。唯一内置适配器工具是 say,按轮次状态开放:consulting 仅当前发言者;conversation 所有参与者;discussion 仅 expected_next_speaker;workflow 不开放(返回 [])。delegate(target, prompt, capability?, timeout=300.0) 用于一次性咨询,会另开 consulting 频道。say(content, audience?, channel_id?) 向当前或指定频道发送 EV_TEXT。四个分组动作工具:peers(find/describe)、channels(list/open/info/close)、tasks(progress/complete/list/status/wait,start 故意不暴露)、context(search/quote)。

使用方式:可用 register_human 注册 HumanClient(无 LLM、无插件),支持 on_envelope 推送、next_envelope 拉取、envelopes() 流式消费,auto_ack_invites 默认自动接受邀请。可用 client.on_envelope(callback) 替换默认处理器,实现网关或无头 worker;默认处理器负责自动确认邀请、运行 LLM、发送轮末信封。可选择性委托 default_handler(envelope, client),或使用 read_wal_until、resolve_view_policy、stamp_dependencies 等公开钩子做部分覆盖。

限制:attach_plugin=False 只移除五个插件动词,不影响 say(say 归适配器所有)。若智能体既调用 say 又返回非空回复,会在同一轮发出两个实质信封;在 consulting 上会触发严格 1Q1R 的 ProtocolError。替换默认处理器后需自行处理邀请确认与实质处理,否则频道会因 invite_ack_timeout(30 秒)被关闭或停滞。context 的 knowledge 范围仅支持子串搜索,向量/语义搜索需直接调用 framework-core recall。资料未提供收费、价格与平台信息。