Google ADK搭建基于Kimi K3的智能體詳細(xì)過程
Google Agent Development Kit (ADK) 是 Google 于 2025年4月發(fā)布的一個開源、以代碼為核心的框架,旨在幫助開發(fā)者構(gòu)建、評估和部署復(fù)雜的AI智能體(Agent)及多智能體系統(tǒng)[1][2]。因為一些特殊原因,筆者并不想訪問外網(wǎng)的大語言模型。國內(nèi)的模型很多,但是到目前為止,通過檢索的資料和測試,通過Google ADK訪問Kimi K3模型成功。過程非常曲折,但是結(jié)果很好。也可以通過同樣的方法,對搭建基于其他模型的智能體。在這篇文章中,將中間的過程介紹如下:
一、安裝Google ADK庫
pip install google-adk
二、創(chuàng)建項目的目錄層次結(jié)構(gòu)
創(chuàng)建一個目錄結(jié)構(gòu):
multi_tool_agent |-
|-.env
|- _ init _.py
|- agent.py
1.1 定義.env
.env定義一些必備的環(huán)境變量的配置文件。因為需要訪問kimi-k3模型,該文件的內(nèi)容如下:
# 設(shè)置kimi官方開放平臺申請API密鑰 MOONSHOT_API_KEY="你的kimi-k3模型的API密鑰" # 設(shè)置訪問的模型的基址 MOONSHOT_API_BASE="https://api.moonshot.cn/v1"
1.2 _ _ init _ _.py
from . import agent
二、在agent.py文件中調(diào)用kimi-k3模型
2.1 配置LiteLlm
import os
import litellm
# LiteLLM 配置
# 禁用遠(yuǎn)程成本映射獲取(避免網(wǎng)絡(luò)問題)
litellm.local_model_cost_map = True
# 禁用遠(yuǎn)程成本映射獲?。ū苊饩W(wǎng)絡(luò)問題)
os.environ["LITELLM_LOCAL_MODEL_COST_MAP"] = "True"
# 設(shè)置 LiteLLM 日志級別為 ERROR(避免過多日志輸出)
os.environ["LITELLM_LOG"] = "ERROR"
# 設(shè)置 LiteLLM 請求超時時間為 60 秒(避免網(wǎng)絡(luò)問題)
os.environ["LITELLM_REQUEST_TIMEOUT"] = "60"
# 為 LiteLLM 添加一個“非官方/自定義”kimi-k3模型的配置
# 注冊 kimi-k3 模型成本
litellm.model_cost = litellm.model_cost or {}
litellm.model_cost["moonshot/kimi-k3"] = {
"input_cost_per_token": 0.000001,
"output_cost_per_token": 0.000002,
"litellm_provider": "openai",
"mode": "chat",
"supports_system_messages": True,
"supports_function_calls": True,
}
print("自定義LiteLLM 配置完成")2.2 導(dǎo)入Google ADK庫和配置環(huán)境變量
# 利用load_dotenv加載當(dāng)前目錄的.env文件的環(huán)境變量 from dotenv import load_dotenv load_dotenv() # 導(dǎo)入google adk的相關(guān)庫 from google.adk.models.lite_llm import LiteLlm from google.adk.tools import FunctionTool from google.adk.agents import Agent
2.3 定義函數(shù)工具
使用標(biāo)注@FuntionTool標(biāo)注函數(shù)工具
@FunctionTool
def get_weather(city: str) -> dict:
"""
獲取指定城市的天氣信息.
Args:
city (str): 城市名稱.
Returns:
dict: 狀態(tài)和結(jié)果或錯誤的信息.
"""
if city == "南昌":
return {
"status": "success",
"report": (
"今天南昌的天氣是晴朗,最高氣溫為35攝氏度。"
" 天氣炎熱,請注意防暑降溫。"
),
}
else:
return {
"status": "error",
"error_message": f"沒有找到 '{city}' 的天氣信息。",
}此處定義一個工具,獲取指定城市的天氣,這是一個模擬的操作。
2.4 創(chuàng)建智能體
# 創(chuàng)建LiteLlm模型對象
model = LiteLlm(
model="moonshot/kimi-k3",
temperature=1,
max_tokens=2048,
extra_params={
"api_base": os.getenv("MOONSHOT_API_BASE"),
"api_key": os.getenv("MOONSHOT_API_KEY"),
}
)
# 創(chuàng)建智能體
root_agent = Agent(
name="weather_assistant",
model=model,
instruction="你是一個有幫助的助手。需要時使用get_weather工具獲取天氣信息。",
description="一個獲取天氣信息的助手。",
tools=[get_weather]
)三、利用adk web在網(wǎng)頁中測試連接是否成功
啟動終端,進(jìn)入目錄multi_tool_agent的上級目錄。下圖是在上級目錄中調(diào)用tree命令,顯示當(dāng)前目錄的所有下級目錄:

圖1 顯示當(dāng)前目錄的所有下級目錄
然后調(diào)用命令:
adk web
啟動adk web,使得可以通過http://127.0.0.1:8000訪問智能體。運行結(jié)果如下所示:

圖2 調(diào)用adk web
然后啟動瀏覽器,在瀏覽器中輸入“http://127.0.0.1:8000”,運行結(jié)果如下所示:

圖3 啟動成功
分別在紅色箭頭所指的消息輸入框中輸入“南昌的天氣”和“南京的天氣”,這是kimi-k3調(diào)用工具get_weather得到不同的調(diào)用結(jié)果,運行結(jié)果如下圖所示:

圖4 運行結(jié)果
參考文獻(xiàn)
- “Agent Development Kit: Making it easy to build multi agent applications” https://developers.googleblog.com/en/agent-development-kit-easy-to-build-multi-agent-applications [EB/OL]
- “DeepWiki google/adk-python Overview”
- https://deepwiki.com/google/adk-python/1-overview[EB/OL]
到此這篇關(guān)于Google ADK搭建基于Kimi K3的智能體的文章就介紹到這了,更多相關(guān)Google ADK庫內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Google ADK搭建基于Kimi K3的智能體詳細(xì)過程
Google ADK 原生僅支持 Google 系模型(Gemini)及標(biāo)準(zhǔn) OpenAI 協(xié)議接口,無法直接“內(nèi)置”Kimi K3,本文介紹Google ADK搭建基于Kimi K3的智能體,感興趣的朋友一起看看吧2026-07-23
macOS下安裝CC-Switch并配置Codex 教程(最新2026.6)
macOS 下先通過 Homebrew 安裝 CC-Switch,啟動后添加第三方服務(wù)商并開啟路由,再重啟終端運行 codex 即可生效;若需桌面端插件功能,CC-Switch 僅支持 CLI 流,桌面端需改2026-07-22
AI Agent Context 壓縮策略選型核心在于根據(jù)任務(wù)連續(xù)性、信息敏感度與成本約束,在“無損外部化(Offload)”、“有損摘要(Summarize)”、“規(guī)則修剪(Prune)”與“結(jié)構(gòu)2026-07-21
AI Coding減少Token 消耗的8 種實測有效的省錢方法
減少 AI Coding 的 Token 消耗,核心是"只投喂必要的上下文",文中通過示例介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著2026-07-09
Codex訂閱怎么選?Free、Plus、Pro區(qū)別是什么?2026最新購買指南
想知道Codex訂閱怎么選?Free、Go、Plus、Pro和Business到底有什么區(qū)別?本文結(jié)合2026最新購買方案和真實開發(fā)測試,幫你算清各版本額度、支付比和性價比,直接告訴你哪個套餐2026-07-07
Codex刪除會話、歷史聊天和解決Codex啟動卡頓問題教程
很多網(wǎng)友會出現(xiàn)Codex啟動越來越慢的問題,甚至是啟動卡頓,本文就來詳細(xì)的介紹一下Codex刪除會話、歷史聊天和解決Codex啟動卡頓問題教程,感興趣的可以了解一下2026-07-07
本文主要介紹了Codex 桌面版上手:從安裝到實踐,親手跑通一個猜數(shù)字小游戲,學(xué)會把需求說清楚,Codex就能自動創(chuàng)建、修改、迭代代碼,讓你快速把想法變成可運行的項目2026-07-06
Qoder添加使用自定義模型deepseek,小米mimo,智普的實現(xiàn)
這篇文章主要介紹了Qoder添加使用自定義模型deepseek,小米mimo,智普的實現(xiàn),文中通過圖文示例介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友2026-07-03
這篇文章主要介紹了Gemini CLI中使用Gemini3.0的方法步驟,文中通過圖文示例介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一2026-07-03
很多編程場景都在使用 Gemini CLI 來完成,但是總覺得有點束縛,GeminiCLI自定義命令妙用提升工作流效率,通過自定義命令實現(xiàn)靈活的系統(tǒng)提示詞,支持復(fù)雜邏輯與Shell聯(lián)動,感興2026-07-02










