pydantic/pydantic-ai

解決的問題

Pydantic AI 是一個專為建構生產級 AI 代理而設計的 Python SDK，具備嚴格的型別與可擴展性。它透過確保輸入、輸出與工具呼叫在端對端過程中皆經過驗證與型別化，消除 LLM 應用開發中的「感覺導向」模式，從而減少執行時錯誤並提升開發者體驗。

工作原理

此框架提供一個型別化的代理迴圈，可透過簡單的字串識別碼在不同模型提供者（如 OpenAI、Anthropic、Google 等）之間輕鬆切換模型。它採用「能力」系統，將工具、指示與模型設定打包為可重用的單元。與 Pydantic 深度整合，支援結構化輸出與相依性注入，並透過 Temporal、DBOS 與 Prefect 等引擎支援持久執行，確保代理能承受重啟並處理長時間執行的任務。

適用對象

適合希望從簡單提示詞躍升至複雜、型別化的 AI 代理的 Python 開發者，這些代理可整合至 Web 前端、終端、語音會話或背景佇列中。

主要特色

• 模型無關性：透過單一 API 與故障轉移、成本監控網關，支援幾乎所有主要模型提供者。
• 端對端型別化：使用 Pydantic 實現結構化輸出、型別化工具與相依性注入，可在撰寫時捕獲錯誤。
• 持久執行：原生支援 Temporal、DBOS 與 Prefect，使代理可執行數日並抵禦故障。
• 多接口支援：單一代理定義可部署為 CLI、Web 聊天或即時語音助理。
• 可組合能力：將工具與指示打包為可重用單元，並提供專用「Harness」以滿足複雜需求（如程式碼代理）。
• 可觀測性：透過 Pydantic Logfire 原生支援 OpenTelemetry，實現即時除錯與追蹤。