安裝
Use ADK with your preferred language適合誰
這份技能適合要用一套開源、程式碼優先的工具來建構、評測和部署複雜 AI 代理的人。官方名稱是 Agent Development Kit(ADK)。它也適合已經有偏好程式語言、準備按官方「首選語言」入口開始的人。原文寫明可用你偏好的語言使用 ADK,但沒有在這段裡給出具體語言位址。
它不適合把本倉庫當成一條安裝命令。這裡是文件倉庫。ADK 雖為 Gemini 和 Google 生態優化,但被寫成模型無關、部署無關,並相容其他框架。若你只想先讀文件、還不想容器化部署,不要一上來就上 Cloud Run 或 GKE。
官方倉庫見 https://github.com/google/adk-docs 請按該頁已寫出的說明操作,不要編造未出現的安裝器或文件位址。
3 分鐘完成第一次嘗試
只走官方文件這一條路徑:先選定你偏好的語言,再在官方說明裡找對應入門,而不是執行未出現的裝包命令。
前置條件:你能開啟官方文件倉庫,並已有一種準備使用的語言。第一次不要部署,不要把金鑰寫進對話。
安裝位置:開啟 https://github.com/google/adk-docs 按「可用偏好語言使用 ADK」去找官方入門。原文沒有寫出 pip 或 npm 命令,不要補。
低風險任務:讓代理只讀歸納三件事——它是程式碼優先工具包;雖優化 Gemini 與 Google 生態,但是模型無關、部署無關;並且提供與 AI 程式碼編輯器相容的優化文件上下文。不要讓它編造文件檔位址,也不要讓它部署到 Cloud Run、GKE 或 Agent Runtime。
成功訊號:你能指出下一步必須回到官方文件、用自己的語言入門,並且沒有執行編造的安裝命令。若代理給出未出現的網址或包名,停住。
使用案例
案例一:用自己熟悉的語言開始做代理。原文寫明可以使用偏好語言。適合先選定語言、再只開啟官方入門頁的人。具體語言路徑若沒有出現在目前說明裡,就停在倉庫目錄對照,不要編造 get-started 位址。
案例二:給 AI 程式碼編輯器提供優化文件上下文。原文寫明 ADK 提供與 AI 程式碼編輯器相容的優化文件上下文,用來加快開發。適合已經在用編輯器、只想先確認「應載入官方優化文件、而不是隨便貼一篇部落格」的人。檔名和位址原文沒有列出時,不要編造。
使用邊界
本倉庫是文件,不是安裝器。不要把未出現的套件管理命令寫進主路徑。能力涵蓋建構、評測和部署;部署側只寫到可容器化並放到 Cloud Run 或 GKE,或用 Agent Runtime 擴展。這些都有副作用,不能當作第一次嘗試。
它為 Gemini 和 Google 生態優化,但官方同時寫明模型無關、部署無關、並相容其他框架。不要寫成「只能用 Gemini」。優化文件上下文相容 AI 程式碼編輯器,但沒有用戶端名單。官方頁面是 https://github.com/google/adk-docs 若代理建議的位址或命令與該頁不一致,以該頁為準。