sunagent

SunAgent é um projeto de código aberto projetado para desmistificar arquiteturas modernas de Agentes AI, implementando um runtime modular e independente de provedor a partir de princípios básicos. Em vez de tratar agentes como aplicativos de caixa preta, o projeto se concentra nos mecanismos subjacentes que permitem workflows autônomos confiáveis e de longa duração, incluindo o Loop do Agente, Chamadas de Ferramenta, Gerenciamento de Contexto, Memória, Planejamento e Runtime de Execução. O repositório é estruturado para facilitar o aprendizado e a experimentação. O diretório `src` contém a implementação modular central, onde cada componente é projetado como um módulo independente e reutilizável. A pasta `docs` fornece documentos de design e explicações técnicas sobre as compensações de engenharia envolvidas. Para aplicação prática, o diretório `harnesses` oferece arquivos de configuração YAML declarativos para definir setups de agentes sem alterações de código, suportando herança para fácil iteração em variantes. O diretório `evaluation` contém definições de tarefas de benchmark e registros de resultados para comparar configurações de agentes ao longo do tempo. Recursos principais incluem um stream de eventos independente de provedor chamado RunTrace, que registra eventos de ciclo de vida, LLM e ferramenta para observabilidade e depuração. O projeto suporta APIs de Chat Completions compatíveis com OpenAI, permitindo integração com vários provedores de modelos. Um roteiro de aprendizado descreve experimentos futuros em áreas como saída de streaming, colaboração entre agentes e protocolos de ferramentas externas como MCP. SunAgent é destinado a engenheiros, desenvolvedores e pesquisadores interessados em entender, testar e construir sistemas de agentes confiáveis.