管理你的AI代理花名冊openai-assistant-swarm allAssistants與getAssistants便捷方法完全指南【免費(fèi)下載鏈接】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 增強(qiáng)庫它把你賬戶里所有 AI AssistantAI 代理變成一支可隨時調(diào)度的蜂群。本指南帶你快速掌握其中兩個最實用的便捷方法allAssistants()一鍵獲取全部 AI 代理以及getAssistants()按 ID 并發(fā)批量獲取指定代理——從此告別繁瑣的分頁拉取和逐個請求。為什么需要統(tǒng)一的 AI 代理花名冊 想象一下你在 OpenAI 平臺創(chuàng)建了十幾個 AI Assistant——天氣助手、股票助手、客服助手、代碼助手……當(dāng)你想在代碼里盤點(diǎn)這些代理時原生 API 有兩個痛點(diǎn)分頁拉取麻煩assistants.list()一次最多返回一頁想看全量得自己寫循環(huán)翻頁逐個獲取低效想拿 10 個指定 Assistant只能串行調(diào) 10 次retrieve()耗時翻倍openai-assistant-swarm把這兩件事封裝成了兩個一行代碼的方法內(nèi)部自動處理分頁與并發(fā)。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 }); // 擴(kuò)展 SDK客戶端將擁有 beta.assistants.swarm 命名空間 EnableSwarmAbilities(OpenAIClient, { debug: true, // 開啟調(diào)試日志便于新手觀察內(nèi)部過程 }); // 初始化自動創(chuàng)建/更新 Swarm 管理器代理 await OpenAIClient.beta.assistants.swarm.init();??新手注意必須先調(diào)用swarm.init()再使用allAssistants()/getAssistants()否則會被拋出requires .init()錯誤見 src/manager/index.ts 中的isReady()檢查。allAssistants一鍵獲取賬戶內(nèi)全部 AI Assistant這是最基礎(chǔ)也最常用的方法——一次調(diào)用返回當(dāng)前 OpenAI 賬戶下所有Assistant 對象數(shù)組const allAssistants await OpenAIClient.beta.assistants.swarm.allAssistants(); console.log(Found ${allAssistants.length} assistants for this OpenAI Account);它背后的_allAssistants()工具函數(shù)位于 src/utils/index.ts會自動按每頁 100 條循環(huán)翻頁直到?jīng)]有下一頁把所有頁的結(jié)果拍平合并成一個數(shù)組自動過濾掉 Swarm Manager 自身——它只是內(nèi)部調(diào)度員不該出現(xiàn)在你的業(yè)務(wù)花名冊里拿到數(shù)組后你可以自由篩選、打印、建立本地索引const pirates allAssistants.filter(a a.name.includes(Pirate)); console.log(pirates.map(a a.id));getAssistants按 ID 并發(fā)批量獲取指定代理當(dāng)你已經(jīng)知道一批 Assistant ID比如存在配置表里原生 API 逼你一個接一個地retrieve()。而getAssistants()會把所有請求并發(fā)扇出速度遠(yuǎn)超串行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 會被自動忽略不會報錯中斷三個貼心細(xì)節(jié)容錯無效或已刪除的 ID 靜默丟棄不拋異常過濾同樣不會返回 Swarm Manager 本身通配捷徑ID 列表里只要包含特殊值any方法會直接短路為返回全部代理見 src/utils/index.ts 中_getAssistants的any分支allAssistants vs getAssistants一張表看懂怎么選對比維度allAssistants()getAssistants(ids)適用場景盤點(diǎn)、審計、動態(tài)發(fā)現(xiàn)代理已知 ID 的定向批量獲取請求方式自動分頁拉全量按 ID 并發(fā)扇出性能特點(diǎn)代理越多耗時略增ID 越多越體現(xiàn)并發(fā)優(yōu)勢無效 ID 處理不涉及自動過濾不報錯是否含 Swarm Manager? 已排除? 已排除簡單記不知道有誰 →allAssistants()知道是誰 →getAssistants()。進(jìn)階玩法讓花名冊為智能調(diào)度服務(wù)這兩個便捷方法不只是查詢工具它們還是delegateWithPrompt()的底層引擎。當(dāng)你只希望某些代理參與任務(wù)分派時傳入 ID 子集swarm 內(nèi)部會先調(diào)用getAssistants()縮小代理范圍再讓 Swarm Manager 在其中智能挑選// 只允許兩個代理參與本次任務(wù)分派 await OpenAIClient.beta.assistants.swarm.delegateWithPrompt( 紐約現(xiàn)在天氣如何今天哪只股票表現(xiàn)最好, [asst_weather_bot, asst_stock_bot] ); // Swarm Manager 會自動把天氣任務(wù)派給天氣助手、股票任務(wù)派給股票助手 // 而你的海盜機(jī)器人則會被安全地排除在外也就是說先用allAssistants()摸清家底再用getAssistants()圈定陣容最后交給 swarm 自動并行執(zhí)行——這就是完整的 AI 代理團(tuán)隊工作流。常見問題FAQQ為什么列表里看不到我創(chuàng)建的 Swarm ManagerA這是刻意設(shè)計。Manager 是庫內(nèi)部維護(hù)的調(diào)度代理兩個方法都會自動把它排除避免干擾你的業(yè)務(wù)邏輯。Q我刪除了一個 Assistant 后還能查到嗎A不能。getAssistants()遇到已刪除的 ID 會直接跳過返回結(jié)果只包含真實存在的代理。Q不想要這個 Swarm Manager 了怎么辦A調(diào)用await OpenAIClient.beta.assistants.swarm.cleanup()它會從你的賬戶中干凈移除該管理器。Q完整可運(yùn)行示例在哪里看A倉庫的 examples/index.mjs 演示了初始化、allAssistants()、getAssistants()和事件監(jiān)聽的完整用法是絕佳的新手參考。寫在最后openai-assistant-swarm用兩個輕量方法把 OpenAI Assistant API 最繁瑣的盤點(diǎn)與檢索工作變成了兩行代碼。無論是為多代理系統(tǒng)建立索引還是為任務(wù)分派圈定候選陣容allAssistants()與getAssistants()都是你 AI 代理花名冊管理的第一選擇。【免費(fèi)下載鏈接】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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考