Relay To Agent

在任意OpenAI兼容API上中继消息给AI代理

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Relay To Agent。
它的用途是:在任意OpenAI兼容API上中继消息给AI代理
完整的 Skill 内容见:https://321skill.com/skills/relay-to-agent-x-7/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'列出所有AI代理,然后向代理2发送消息“今天天气如何”,并重置代理1的会话。' 它会依次调用`agent list`获取列表,`send --agent 代理2 --message "今天天气如何"`,最后`reset --agent 代理1`,并在终端输出每个操作的响应结果。

介绍

【解决什么问题】当您需要同时与多个AI代理(如不同的GPT模型、本地部署的LLM等)进行多轮对话时,手动切换和管理会话上下文非常繁琐。Relay To Agent 提供统一的接口,让您像操作消息队列一样向任意兼容OpenAI API的代理发送消息,并自动维护每个代理的会话历史,无需关心底层API差异。

【怎么用】安装后,您可以通过命令行或API调用:列出所有已配置的AI代理(如agents list)、向指定代理发送消息(如send --agent my-bot --message "你好")、重置某个代理的会话(如reset --agent my-bot)。每个代理的对话历史会被自动保存,下次发送消息时自动关联上下文。支持通过环境变量或配置文件管理多个代理的API密钥和基础URL。

【适合谁】本工具特别适合需要同时管理多个AI模型(如不同版本GPT、开源模型、企业私有模型)的开发者、智能体开发者、后端工程师,以及需要在自动化工作流中与多个AI代理交互的运维和测试人员。也适合在本地开发和测试多代理协作场景。

【使用建议】建议先通过list命令确认代理状态,再发送消息。对于生产环境,注意为每个代理设置合理的会话超时时间,避免历史记录无限增长。如果代理返回错误,请检查API密钥和端点配置是否正确。默认使用JSON格式输出,可配合jq等工具解析结果。

核心特点

绝大多数中继工具仅转发单次请求,而Relay To Agent内置完整的会话管理(创建、持久化、重置),并支持同时维护多个独立代理的对话上下文,无需额外编写状态管理代码。

注意事项

不适合需要实时流式传输(如SSE)或低延迟响应的场景,也不支持非OpenAI兼容的API协议。

常见问题

如何添加新的AI代理?

通过配置文件(如config.yaml)或环境变量设置代理名称、API基础URL和API密钥,然后运行`agent add`命令注册。

支持重置单个代理的会话吗?

支持,使用`reset --agent 代理名`即可清空该代理的对话历史,开始全新对话。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/relay-to-agent-x-7/raw/index.md 读取 Relay To Agent 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。