管理你的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），僅供參考