oracle/agent-spec

解決的問題

Agent Spec 是一種可移植、平台無關的設定語言，旨在以高保真度描述 AI 代理與代理系統。它透過允許開發者以標準化方式定義代理與工作流程，解決框架鎖定問題，使這些定義能在不同代理框架之間輕鬆遷移。

如何運作

本專案提供一組用於建構代理的觀念性物件與元件規格，包含其屬性與語意。重點聚焦於兩個主要的可執行元件：對話型代理（如 ReAct 代理）與結構化、基於工作流程的流程。

為實現此目標，專案提供 Python SDK（PyAgentSpec），允許使用者建構符合規範的代理，並序列化/反序列化為 JSON 或 YAML。要實際執行這些設定，需使用 Runtime Adapter 將 Agent Spec 表示轉換為目標代理框架（如 LangGraph、AutoGen 或 CrewAI）的具體需求。

適用對象

希望在不同 LLM 提供者與代理框架之間保持可移植性的代理系統開發者，以及需要一種標準化方式來序列化代理設定的使用者。

主要亮點

• 平台無關：將代理定義與執行環境解耦。
• 序列化支援：原生支援將代理匯出為 JSON/YAML 格式。
• 多框架支援：包含 LangGraph、AutoGen、CrewAI 等主流框架的適配器。
• LMM 提供者彈性：支援多種 LLM 設定，包括 OCI Gen AI、OpenAI 與 Ollama。