AI Agents Framework — 一份 YAML 定義任意代理

概述

AI Agents Framework 是一個以 Rust 撰寫的開源框架,核心理念是「一份 YAML = 任意代理」。開發者只需撰寫一份 YAML 規範,即可定義並執行具備身分、記憶、行為結構與工具呼叫能力的 AI 代理。

主要能力

• YAML 驅動定義:透過單份 YAML 規範宣告代理,支援 --agent 參數指定代理,並提供 --dry-config-check 在不選擇情境、不建構提供者、不寫入報告的情況下驗證套件與引用的代理。
• 工具呼叫:代理可在單輪對話中發起工具呼叫,AgentResponse 結構包含最終文字內容與可選的工具呼叫清單。
• 串流回應:支援 AgentStreamEvent 事件流,包括 Chunk 與 Final 事件,便於即時觀察輸出。
• 記憶與工作階段:支援儲存與列出工作階段,提供上下文管理器中的 {{ context.<key> }} 模板取值。
• 可觀測性:提供 ObservabilityConfig 與 ObservabilityManager,支援工具啟動、錯誤等事件回呼。
• CLI 執行:可透過 ai-agents-cli run agent 從命令列執行代理,並支援 RUST_LOG 日誌層級控制。
• 模型整合:支援將 num_ctx、num_gpu、keep_alive 等欄位合併進 Ollama 請求主體。

適用對象

面向開源貢獻者、AI 代理建構者與 Rust 開發者。學習曲線為中等,採用免費模式,並提供公開 API 與 GitHub 儲存庫。