Covonaut：基于Go语言开发的开源AI智能体框架

Covonaut是什么

Covonaut 是一款基于Go语言开发的AI Agent生产级开发框架，项目核心代码以纯Go标准库实现，追求轻量化、可上生产环境的智能体开发底座。

该框架完整实现大模型调用、工具调用系统、多智能体通信、会话持久化、图编排工作流、前端交互协议等全套Agent能力。开发者无需从零搭建Agent底层逻辑，可以直接基于Covonaut快速构建本地、私有化部署的AI智能体、多Agent协作系统、AI后端服务与终端AI应用。项目核心包为agentcore，最低要求Go 1.25及以上编译环境，编译输出独立单二进制文件，部署简单便捷。

功能特色

1. 完整Agent运行内核：自带Agent主执行循环，支持LLM流式对话、工具调用闭环、上下文自动压缩、请求退避重试、结构化输出强制校验，原生支持模型思考推理配置、图文多模态消息输入输出。

2. 强大工具生态：内置文件读写、Shell命令、网页浏览器、代码执行等常用工具；支持自定义工具、参数Schema校验、执行钩子、黑白名单权限管控；原生兼容MCP（Model Context Protocol）协议，可以接入外部MCP服务作为Agent工具。

3. 多智能体互联互通：实现A2A Agent‑to‑Agent协议，兼容Google ADK标准，支持本地与远程Agent委派、任务转交、智能体发现；搭配ACP会话管理协议，管理Agent实例完整生命周期。

4. 双层任务编排引擎：提供Graph图引擎（DAG有向无环图、Pregel状态循环图）以及Workflow流水线编排；支持并行执行、条件分支、循环任务，可导出Mermaid流程图用于调试。

5. 会话持久化存储：采用分支式JSONL会话存储，支持对话会话分叉、历史回溯、消息压缩、版本迁移，适配HTTP服务线程会话管理。

6. 前后端交互协议套件：AGUI流式事件协议实现Agent运行状态实时推送到Web前端；A2UI声明式UI协议，允许Agent动态渲染表单、仪表盘，完成Agent驱动前端页面交互。

7. 多模型统一抽象层：一套接口兼容OpenAI兼容接口、Claude、Gemini、Bedrock、通义千问、DeepSeek等主流大模型，统一封装Token计数、流式分片、工具调用、多模态处理。

8. 双交付形态开箱即用：内置HTTP Server服务可直接对外提供Chat API；自研无依赖TUI终端交互界面，可直接运行控制台AI聊天程序。

9. 生产级可靠性能力：事件总线全链路观测、生命周期拦截钩子实现安全校验、审计日志、限流；支持多模型故障容灾、大工具执行结果落盘存储、任务中断重试。

10. 插件扩展体系：统一Extension扩展接口，可自定义工具、钩子、系统提示注入，自动读取AGENTS.md、.cursorrules规则文件。

技术细节

• 开发语言与依赖：主体使用Go开发，agentcore核心模块几乎零第三方依赖，仅WebSocket模块引入少量外部依赖，编译输出单静态二进制，适合容器、私有化部署，协议全部自研或兼容行业公开标准，没有重型中间件强制依赖。

• 核心模块划分

1. agentcore：Agent核心引擎，整个框架最关键底座，实现Agent循环、工具系统、事件总线、钩子拦截、结构化输出、多模态消息。

2. provider：大模型适配抽象层，屏蔽各大LLM服务商API差异。

3. graph / workflow：任务编排，DAG适合无循环并行任务，Pregel状态图适合带循环、条件跳转复杂智能体任务。

4. session：分支式会话存储，JSONL持久化，支持会话分支、回溯。

5. server：HTTP后端服务，提供SSE流式对话API、会话线程CRUD接口。

6. tui：Elm架构自研终端UI，差分渲染，实现交互式控制台Agent。

7. 协议层：A2A、ACP、AGUI、A2UI、MCP桥接，完成Agent与Agent、Agent与工具、Agent与前端全部通信。

• 执行模型：Runnable通用抽象，统一同步执行、流式输出、批量收集、数据转换四种执行模式，接口自动互相适配。

• 安全设计：工具黑白名单、链式拦截钩子、工具入参Schema校验、Shell命令管控，避免高危指令执行，适配私有化安全要求。

• 可观测：事件总线输出全生命周期事件，包括token流、工具调用开始结束、会话变更，方便做日志、监控、调试。

应用场景

1. 私有化AI Agent后端服务：企业内网部署智能体服务，不依赖SaaS平台，构建知识库问答、自动化业务处理Agent。

2. 多智能体协作系统：搭建专家Agent集群，不同Agent负责代码、文档、数据分析，通过A2A协议互相委派任务。

3. 本地终端AI助手：基于内置TUI快速开发命令行AI工具，本地执行文件操作、脚本处理。

4. 复杂业务工作流自动化：利用Graph+Workflow编排，处理带有条件判断、循环、并行的复杂业务自动化任务。

5. MCP工具集成平台：对接各类MCP服务，把第三方工具统一接入Go开发的AI业务系统。

6. AI产品底层内核：作为自研AI产品底层框架，对外提供HTTP聊天接口，上层对接Web前端，利用A2UI实现Agent驱动动态表单页面。

使用方法

环境要求

Go 1.25 或更高版本

1. 安装依赖

go get github.com/covoyage/covonaut/agentcore

2. 快速构建基础Agent

导入agentcore以及对应模型provider，初始化Agent实例，配置大模型密钥，注册工具，调用Run方法执行任务；可以开启流式事件总线监听输出思考与工具调用事件。

3. 使用HTTP服务模式

引用server模块，启动内置HTTP服务，通过thread_id管理会话线程，调用接口进行对话，SSE获取流式返回。

4. 使用TUI终端交互

运行项目examples内TUI示例代码，直接启动终端交互式聊天程序。

5. 编排复杂任务

引入graph或者workflow包，定义节点、条件分支、并行任务，构建DAG或者Pregel状态图，调用Runner执行。

6. 接入MCP外部工具

使用内置MCP桥接模块，加载stdio/SSE模式MCP服务，自动转换为框架可用工具集合。

完整可运行示例参考仓库examples目录。

竞品对比

常见问题解答

Q：Covonaut适合做什么，不适合做什么？

A：Covonaut适合Go技术栈下构建私有化、生产可用AI Agent服务、多智能体系统、终端AI助手。不适合快速做简单的Prompt调用；简单大模型问答场景直接调用LLM API会更轻量。

Q：必须Go1.25才能使用吗，低版本Go能否编译？

A：项目明确最低要求Go1.25，低Go版本会出现语法与标准库API不兼容，不建议降级使用。

Q：Covonaut是否支持私有化本地大模型？

A：支持，只要模型兼容OpenAI接口规范，在provider配置自定义API地址即可接入本地大模型。

Q：A2A协议只能和Covonaut的Agent互通吗？

A：A2A兼容Google ADK标准，可以和遵循该协议规范的其他Agent系统互相通信。

Q：如何限制Agent高危Shell命令执行？

A：框架工具系统支持命令黑白名单，同时可以注册生命周期拦截钩子，在工具执行前校验指令，拦截危险操作。

Q：会话JSONL文件可以直接手动修改吗？

A：不建议手动修改会话存储文件，修改错误会导致会话加载失败；如果需要回溯历史，优先使用框架内置会话分支、回溯API。

Q：可以混合使用MCP工具和框架自定义工具吗？

A：可以，MCP桥接导入的外部工具和自定义工具会合并到Agent工具集，还支持工具名称前缀隔离避免冲突。

相关链接

• GitHub仓库：https://github.com/covoyage/covonaut

总结

Covonaut补齐了Go语言生态面向生产环境的AI Agent完整框架短板，以纯Go轻量化实现为基础，整合Agent运行内核、工具系统、MCP桥接、多智能体通信、图编排引擎、会话持久化、HTTP与TUI多端交付全套能力，兼顾私有化部署安全要求与丰富扩展能力，为Go开发者构建智能体应用提供一套完整的底层解决方案。