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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/jin-boagentao.svg)](https://yunodb.com/tools/jin-boagentao?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/jin-boagentao?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/jin-boagentao.svg" alt="Featured on YunoDB" height="20"></a>