sunagent

SunAgent 是一个开源项目，旨在通过从第一原理实现模块化、独立于提供商的运行时来揭示现代 AI 代理架构的神秘面纱。该项目不是将代理视为黑盒应用程序，而是专注于使可靠、长期自主工作流程成为可能的底层机制，包括代理循环、工具调用、上下文管理、内存、规划和执行运行时。 该仓库的结构旨在促进学习和实验。`src` 目录包含核心模块化实现，其中每个组件都设计为独立且可重用的模块。`docs` 文件夹提供了设计文档和对工程权衡的技术解释。为了便于实际应用，`harnesses` 目录提供了声明式 YAML 配置文件，用于定义代理设置而无需更改代码，并支持继承以便于迭代变体。`evaluation` 目录包含基准任务定义和结果记录，用于比较不同代理配置的性能。 主要功能包括一个独立于提供商的事件流 RunTrace，用于记录生命周期、LLM 和工具事件，以实现可观察性和调试。该项目支持 OpenAI 兼容的聊天完成 API，允许与各种模型提供商集成。学习路线图概述了未来在流式输出、多代理协作和外部工具协议（如 MCP）等领域的实验。SunAgent 适用于对理解、测试和构建可信代理系统感兴趣的工程师、开发人员和研究人员。