管理你的AI代理花名册openai-assistant-swarm allAssistants与getAssistants便捷方法完全指南【免费下载链接】openai-assistant-swarmIntroducing the Assistant Swarm. An extension to the OpenAI Node SDK to automatically delegate work to any assistant you create in OpenAi through one united interface and manager. Now you can delegate work to a swarm of assistant all specialized with specific tasks you define.项目地址: https://gitcode.com/gh_mirrors/op/openai-assistant-swarmopenai-assistant-swarm 是一个 OpenAI Node SDK 增强库它把你账户里所有 AI AssistantAI 代理变成一支可随时调度的蜂群。本指南带你快速掌握其中两个最实用的便捷方法allAssistants()一键获取全部 AI 代理以及getAssistants()按 ID 并发批量获取指定代理——从此告别繁琐的分页拉取和逐个请求。为什么需要统一的 AI 代理花名册 想象一下你在 OpenAI 平台创建了十几个 AI Assistant——天气助手、股票助手、客服助手、代码助手……当你想在代码里盘点这些代理时原生 API 有两个痛点分页拉取麻烦assistants.list()一次最多返回一页想看全量得自己写循环翻页逐个获取低效想拿 10 个指定 Assistant只能串行调 10 次retrieve()耗时翻倍openai-assistant-swarm把这两件事封装成了两个一行代码的方法内部自动处理分页与并发。30 秒上手安装与初始化 swarm第一步先装好 OpenAI SDK 和本库yarn add openai mintplex-labs/openai-assistant-swarm第二步用EnableSwarmAbilities为客户端装上蜂群超能力并初始化import OpenAI from openai; import { EnableSwarmAbilities } from mintplex-labs/openai-assistant-swarm; const OpenAIClient new OpenAI({ apiKey: process.env.OPEN_AI_KEY }); // 扩展 SDK客户端将拥有 beta.assistants.swarm 命名空间 EnableSwarmAbilities(OpenAIClient, { debug: true, // 开启调试日志便于新手观察内部过程 }); // 初始化自动创建/更新 Swarm 管理器代理 await OpenAIClient.beta.assistants.swarm.init();⚠️新手注意必须先调用swarm.init()再使用allAssistants()/getAssistants()否则会被抛出requires .init()错误见 src/manager/index.ts 中的isReady()检查。allAssistants一键获取账户内全部 AI Assistant这是最基础也最常用的方法——一次调用返回当前 OpenAI 账户下所有Assistant 对象数组const allAssistants await OpenAIClient.beta.assistants.swarm.allAssistants(); console.log(Found ${allAssistants.length} assistants for this OpenAI Account);它背后的_allAssistants()工具函数位于 src/utils/index.ts会自动按每页 100 条循环翻页直到没有下一页把所有页的结果拍平合并成一个数组自动过滤掉 Swarm Manager 自身——它只是内部调度员不该出现在你的业务花名册里拿到数组后你可以自由筛选、打印、建立本地索引const pirates allAssistants.filter(a a.name.includes(Pirate)); console.log(pirates.map(a a.id));getAssistants按 ID 并发批量获取指定代理当你已经知道一批 Assistant ID比如存在配置表里原生 API 逼你一个接一个地retrieve()。而getAssistants()会把所有请求并发扇出速度远超串行const assistantIds [ asst_customer_success, asst_lead_pirate_manager, asst_that_was_deleted, // 故意混入一个无效 ID ]; const specificAssistants await OpenAIClient.beta.assistants.swarm.getAssistants(assistantIds); console.log(Found ${specificAssistants.length} assistants from ${assistantIds.length} ids given.); // 只会打印 2无效/已删除的 ID 会被自动忽略不会报错中断三个贴心细节容错无效或已删除的 ID 静默丢弃不抛异常过滤同样不会返回 Swarm Manager 本身通配捷径ID 列表里只要包含特殊值any方法会直接短路为返回全部代理见 src/utils/index.ts 中_getAssistants的any分支allAssistants vs getAssistants一张表看懂怎么选对比维度allAssistants()getAssistants(ids)适用场景盘点、审计、动态发现代理已知 ID 的定向批量获取请求方式自动分页拉全量按 ID 并发扇出性能特点代理越多耗时略增ID 越多越体现并发优势无效 ID 处理不涉及自动过滤不报错是否含 Swarm Manager❌ 已排除❌ 已排除简单记不知道有谁 →allAssistants()知道是谁 →getAssistants()。进阶玩法让花名册为智能调度服务这两个便捷方法不只是查询工具它们还是delegateWithPrompt()的底层引擎。当你只希望某些代理参与任务分派时传入 ID 子集swarm 内部会先调用getAssistants()缩小代理范围再让 Swarm Manager 在其中智能挑选// 只允许两个代理参与本次任务分派 await OpenAIClient.beta.assistants.swarm.delegateWithPrompt( 纽约现在天气如何今天哪只股票表现最好, [asst_weather_bot, asst_stock_bot] ); // Swarm Manager 会自动把天气任务派给天气助手、股票任务派给股票助手 // 而你的海盗机器人则会被安全地排除在外也就是说先用allAssistants()摸清家底再用getAssistants()圈定阵容最后交给 swarm 自动并行执行——这就是完整的 AI 代理团队工作流。常见问题FAQQ为什么列表里看不到我创建的 Swarm ManagerA这是刻意设计。Manager 是库内部维护的调度代理两个方法都会自动把它排除避免干扰你的业务逻辑。Q我删除了一个 Assistant 后还能查到吗A不能。getAssistants()遇到已删除的 ID 会直接跳过返回结果只包含真实存在的代理。Q不想要这个 Swarm Manager 了怎么办A调用await OpenAIClient.beta.assistants.swarm.cleanup()它会从你的账户中干净移除该管理器。Q完整可运行示例在哪里看A仓库的 examples/index.mjs 演示了初始化、allAssistants()、getAssistants()和事件监听的完整用法是绝佳的新手参考。写在最后openai-assistant-swarm用两个轻量方法把 OpenAI Assistant API 最繁琐的盘点与检索工作变成了两行代码。无论是为多代理系统建立索引还是为任务分派圈定候选阵容allAssistants()与getAssistants()都是你 AI 代理花名册管理的第一选择。【免费下载链接】openai-assistant-swarmIntroducing the Assistant Swarm. An extension to the OpenAI Node SDK to automatically delegate work to any assistant you create in OpenAi through one united interface and manager. Now you can delegate work to a swarm of assistant all specialized with specific tasks you define.项目地址: https://gitcode.com/gh_mirrors/op/openai-assistant-swarm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考