O que agent-config faz?
Sistema Operacional Universal para Agentes de IA — habilidades auditadas, regras de governança, estado reproduzível. Um contrato, todo agente hospedeiro.
Visão Geral
O event4u-app/agent-config é um pacote de configuração que centraliza a definição de habilidades, regras de governança e estado reproduzível para agentes de IA. Ele atua como um contrato único que pode ser consumido por diferentes agentes hospedeiros, como Claude Code, Cursor e Codex, garantindo consistência e segurança em todo o ecossistema.
Principais Características
- Habilidades Auditadas: Todas as habilidades são verificadas e aprovadas, garantindo que apenas ações seguras e controladas sejam executadas.
- Regras de Governança: Define políticas claras sobre o que o agente pode ou não fazer, incluindo limites de acesso a recursos e permissões.
- Estado Reproduzível: O estado do agente pode ser salvo e restaurado, permitindo a reprodução de comportamentos e depuração de problemas.
- Contrato Único: Um único arquivo de configuração que serve como fonte de verdade para todos os agentes do ecossistema.
Como Usar
Para utilizar este pacote, você deve importá-lo em seu agente hospedeiro e configurar as variáveis de ambiente necessárias.
from event4u_agent_config import AgentConfig
config = AgentConfig()
config.load()
# Agora o agente está configurado com as habilidades e regras definidas
Variáveis de Ambiente
| Variável | Descrição | Padrão |
|---|---|---|
AGENT_CONFIG_PATH | Caminho para o arquivo de configuração | ./config.yaml |
AGENT_LOG_LEVEL | Nível de log do agente | INFO |
AGENT_STATE_DIR | Diretório para armazenar estado | ./state |
Estrutura do Repositório
.
├── src/
│ └── agent_config/
│ ├── __init__.py
│ ├── core.py
│ ├── skills.py
│ └── governance.py
├── config/
│ └── default.yaml
├── tests/
│ └── test_core.py
├── README.md
└── LICENSE
Exemplo de Configuração
# config/default.yaml
skills:
- name: "code-review"
audit: true
permissions:
- "read"
- "write"
governance:
rules:
- "no-delete": true
-