
ADK-TS
IQ AI · 程式設計
ADK-TS 是一款以 TypeScript 打造的開源框架,用來建立人工智慧代理。它支援多家 LLM 供應商,內建工具、工作階段與記憶,一行程式碼就能啟動你的第一個代理。

關於 ADK-TS
About
ADK-TS 是什麼
ADK-TS 是一套用 TypeScript 建立人工智慧代理的框架,而 TypeScript 正是許多網頁與 Node.js 開發者每天都在用的語言。作為 TypeScript 人工智慧代理框架,它鎖定的是偏好用程式碼定義代理、而非在視覺化面板裡設定的人。IQ AI 以 MIT 授權把它當開源專案維護,因此你可以讀原始碼、分支出去,或把它放進商業產品裡,都不必付授權費。
這套框架處理代理開發中那些往往淪為一堆黏著程式碼的環節。它提供不受供應商綁定的模型存取、用來串接外部服務的工具系統,以及能跨多輪保留脈絡的工作階段管理。你不必自己把這些接起來,只要描述一個代理,剩下的推理迴圈交給框架跑。
它最大的限制,是為寫程式的人而設計。沒有給非技術使用者的拖放式建構器,文件也仍標示為進行中的工作,部分章節並不完整。如果你不碰 TypeScript 或 JavaScript,能得到的幫助很快就會變少。
快速上手
- 用
npm install -g @iqai/adk-cli全域安裝 CLI,接著執行adk建立專案;或者在現有應用裡用npm install @iqai/adk加入套件。 - 在
.env檔裡設定 API 金鑰。Google Gemini 只要GOOGLE_API_KEY;其他供應商各自用自己的金鑰。 - 用 AgentBuilder API 或單純的
LlmAgent定義一個代理,並指定模型名稱。 - 任務需要時再接上工具、工作階段服務或子代理,然後執行代理並讀取回應。
產品資訊
快速了解 ADK-TS 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 把人工智慧功能做進網頁應用的 TypeScript 與 Node.js 開發者:這套框架說他們的語言,一行 npm install 就能進到既有專案。
- 想要有型別的代理邏輯、而非提示詞腳本的全端工程師:模型、工具與工作階段都帶型別定義。
- 需要更換 LLM 供應商的團隊:同一套 API 把 Gemini、OpenAI、Anthropic 與 OpenRouter 當成可互換的後端。
任務
- 打造具備持久記憶的聊天機器人與助理:工作階段會保存訊息歷史,讓脈絡跨輪延續。
- 把多個代理串成流程:工作流程代理以循序、平行或迴圈方式執行步驟。
- 把代理接到外部資料與服務:工具系統與 MCP 支援能引入搜尋、檔案與第三方 API。
情境
- 用一個下午做出代理的原型:一行 AgentBuilder 呼叫就能讓代理跑起來,不必先寫基礎設施。
- 架一個會標註來源的研究助理:結合網頁搜尋工具、檔案操作,以及要求標示所見來源的指令。
- 把代理部署到 Node.js 服務或無伺服器函式:Node.js 能跑的地方都能上線,並用 OpenTelemetry 追蹤做可觀測性。
主要功能
用 AgentBuilder 一行寫出代理
AgentBuilder API 用一次串接呼叫就建立可運作的代理,接著直接向它提問。AgentBuilder.withModel("gemini-2.5-flash").ask(...) 會直接回傳模型的回答,很適合在投入完整架構之前先驗證想法。之後你可以用同一個建構器加上工作階段、工具與子代理。
支援多模型供應商
ADK-TS 預設採用 Google Gemini,但把其他供應商視為同等重要。你可以把模型名稱當字串傳入,讓框架自動判斷供應商;或者用 Vercel AI SDK 的模型實例做更深的整合。OpenAI、Anthropic、Groq、Mistral 以及 OpenRouter 的模型目錄,都靠同一份代理程式碼連上。
可擴充的工具系統與 MCP
工具讓代理能夠行動,而不只是對話。你用宣告式結構描述自訂工具,模型才知道何時該呼叫、該怎麼呼叫。Model Context Protocol 的支援更進一步,讓代理接上區塊鏈、市場數據、訊息傳遞與檔案等外部 MCP 伺服器,或者你也能從範本自己建一個伺服器。
工作階段與持久記憶
每段對話都跑在一個 Session 物件裡,追蹤訊息歷史與可變狀態。工作階段帶強型別,並隨著對話自動建立、載入與儲存。這麼一來,代理記得住先前的輪次,你不必寫儲存邏輯,後端也能挑最適合自己應用的。
多代理工作流程
工作流程代理把多個專職代理組成一套系統。循序流程把工作從一個代理交到下一個,平行流程讓代理同時執行,迴圈流程則重複到條件成立為止。研究、分析、摘要這條流程,幾個建構器呼叫就搞定。
串流與可觀測性
代理可以逐詞元串流回應,適合互動式聊天與即時介面。在正式環境方面,ADK-TS 內建 OpenTelemetry 追蹤,讓你能跟著代理的步驟走,看清時間與詞元花在哪裡。當代理走出展示階段,這份可觀測性就變得重要。
優缺點
優點
- 模型、工具與工作階段全面帶型別,編輯器能在執行前就抓到錯誤。
- 不受供應商綁定的設計避開鎖定,換 LLM 不必重寫代理邏輯。
- 內建工作階段、記憶、串流與追蹤,而不是把它們當外掛。
- MIT 授權加上 npm 套件,讓個人與企業的採用成本都很低。
缺點
- 只為寫程式的人而做,沒有給不寫 TypeScript 使用者的視覺化建構器。
- 文件仍標示為進行中的工作,因此部分章節並不完整。
- 預設你熟悉 TypeScript 與 Node.js 工具鏈,對初學者來說門檻偏高。
- 執行代理仍需自備 LLM API 金鑰,因此有一筆按用量計的費用要編進預算。
常見問題
ADK-TS 用來以 TypeScript 建立人工智慧代理。開發者拿它做聊天機器人、研究助理、內容流程,以及任何需要代理呼叫工具、記住脈絡或與其他代理協作的任務。
相關內容
探索與 ADK-TS 相關的工具、技能與文章。
ADK-TS 替代方案
Forefront
Forefront · 程式設計Forefront 是一個用來打造開源 AI 的網頁平台。你可以用自己的資料微調主流的開源語言模型、評估它們的表現,再透過 API 執行,或匯出後自行架設。想要封閉式平台的便利、卻堅持要自己擁有模型與資料的開發者,就是這裡的目標客群。
Startkit
StartKit.AI · 程式設計Startkit 是一套用來打造 AI SaaS 與 AI 包裝產品的樣板。可以把它想成一個 AI 新創樣板,把枯燥的部分都先接好了:驗證、Stripe 與 Lemon Squeezy 付款、用量限制、交易型電子郵件,以及一套能與 OpenAI、Anthropic、Groq 或 Llama 溝通的 AI API 啟動套件。你複製儲存庫、設定價格,然後專心在產品中使用者真正願意付費的部分。它建構於 React 與 Tailwind 之上的 Next.js,所以大部分的樣板程式碼對你來說並不陌生。
Testim
Tricentis · 程式設計Testim 是專為網頁、行動與 Salesforce 應用程式打造的 AI 測試自動化平台,用來建立並執行端到端測試。它靠機器學習在介面變動時維持測試穩定,團隊因此少花時間修補壞掉的定位器。對於一款今天就能開始使用的自動化測試工具來說,這表現不算差。你透過在瀏覽器錄製動作來建立測試,需要更多控制時再補上 JavaScript。對忙碌的 QA 團隊來說,這是個可靠的選擇。
