

適合讀者
- 想讓模型連接業務函數的開發者
- 正在學習 Agent 基礎的讀者
這篇文章解決什麼問題?
模型只能生成文本,無法可靠執行查詢、計算或業務動作。
核心概念解釋
- 工具定義
- 參數 schema
- 函數路由
- 結果回填
- mock 數據
實戰步驟
- 定義可調用工具
- 讓模型決定是否調用
- 執行本地函數
- 把工具結果交給模型生成最終回答
Python 代碼示例
本文配套 demo 會生成在:
cd examples/llm-guides/013_tool_calling_weather
python demo.py
示例代碼遵循兩個原則:
- 從
OPENAI_API_KEY讀取密鑰,不在代碼裡寫死。 - 沒有 API Key 時自動進入 mock 模式,方便先理解流程。
核心調用方式可以簡化成下面這樣:
import os
api_key = os.getenv("OPENAI_API_KEY")
if not api_key:
print("未配置 OPENAI_API_KEY,进入 mock 模式。")
else:
# 真实项目中在这里初始化 SDK 客户端并发起请求。
print("已读取 OPENAI_API_KEY,可以调用模型。")
常見坑
- 只跑通 Demo 就直接發佈,缺少錯誤處理、日誌和人工審核。
- 把 API Key、真實路徑、賬號或業務數據寫進文章和代碼。
- 沒有區分 mock 示例和真實線上環境,導致讀者複製後無法復現。
- 引用 API 或框架能力時沒有核對官方文檔,版本變化後容易誤導讀者。
總結
- 這篇文章圍繞「大模型使用指南 13:Function Calling 實戰:讓模型調用本地 Python 函數」解決一個具體工程問題:模型只能生成文本,無法可靠執行查詢、計算或業務動作。
- 實踐時優先保證可復現、可回滾、可人工審核,不要只追求一次性生成效果。
- 涉及模型能力、API 參數和第三方框架時,發佈前需要重新核對官方文檔。
CSDN 標籤
Function Calling、Tool Calling、大模型、Python、Agent
公眾號摘要
通過本地函數調用例子,講清模型從“會說”到“會用工具”的關鍵一步。
知乎標題變體
- Function Calling 到底解決什麼問題?
- 如何讓大模型調用自己的 Python 函數?
- Tool Calling 和普通 Prompt 有什麼區別?
參考資料與延伸閱讀
- OpenAI 官方文檔:以你實際使用的模型、SDK 和賬號權限為準。
- Python 官方文檔:環境變量、虛擬環境和異常處理部分。
- 相關框架官方文檔:LangChain、LlamaIndex、Haystack、向量數據庫等按文章主題選擇。