agentao
本地優先、受治理的 AI 代理執行環境,適用於 Python — 可嵌入您的應用程式,或作為 CLI 或 ACP 伺服器執行。內建權限管理、MCP、記憶體與稽核重播功能。
agentao 是什麼?
本地優先、受治理的 AI 代理執行環境,適用於 Python — 可嵌入您的應用程式,或作為 CLI 或 ACP 伺服器執行。內建權限管理、MCP、記憶體與稽核重播功能。
agentao 概覽
這是什麼
Agentao 是一個以本地優先、受治理的 AI 代理執行環境,專為 Python 設計。它可以嵌入到應用程式中、以 CLI 執行,或作為 ACP 伺服器使用。執行環境內建權限管理、MCP、記憶體與稽核重播功能。其名稱結合了「Agent」(能力)與「Tao」(治理),反映了圍繞約束、連線與可觀測性的設計理念。
主要功能
- 治理:工具確認、四種權限模式(唯讀、工作區寫入、完整存取、計劃模式)以及 macOS sandbox 支援。
- 記憶體:基於 SQLite 的持久記憶體,支援使用者與專案範圍、自動召回,以及透過 jieba 進行中文分詞。
- 通訊協定:MCP(stdio、Streamable HTTP、SSE)用於工具,ACP(stdio JSON-RPC)用於完整代理。
- 技能:從
skills/目錄自動發現,可透過agentao skill install owner/repo[:path][@ref]從 GitHub 安裝。 - 子代理:內建
codebase-investigator與generalist,以及可在.agentao/agents/.md中定義的自訂代理。 - 重播與輸出:JSONL 工作階段記錄儲存在
.agentao/replays/下,支援 Markdown 切換與/copy複製上一則回覆。 - 嵌入:
Agentao(...)建構子,提供events()串流、active_permissions()、能力注入與 ACP Pydantic 結構。
使用情境
- 將受治理的代理嵌入 Python 應用程式,並完全控制輸入與權限。
- 執行互動式代理 CLI,支援斜線指令、計劃模式與記憶體檢視。
- 將 Agentao 作為 ACP 伺服器使用,以遠端管理代理工作階段。
- 在本地優先的環境中開發與測試自訂技能、工具與子代理。
快速開始
bashpip install agentao``````pythonfrom pathlib import Pathfrom agentao import Agentaofrom agentao.llm import LLMClientfrom agentao.transport import NullTransportwith Agentao( working_directory=Path('/tmp/agent-run-1'), llm_client=LLMClient( api_key='sk-...', base_url='https://api.openai.com/v1', model='gpt-5.4', ), transport=NullTransport(),) as agent: reply = agent.chat('Summarize today's logs.') print(reply)若使用 CLI,請安裝 [cli] 擴充並設定必要的環境變數(OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL)。完整說明請參閱儲存庫的 README。
授權與價格
本專案採用 MIT 授權條款。為開放原始碼,未提及價格。
內容整理自該專案公開的 README 與儲存庫資訊。