Agent Runner API

API para execução de agentes de IA utilizando o Google ADK.

Estrutura do Projeto

src/
├── api/          # Endpoints da API
├── core/         # Lógica central do negócio
├── models/       # Modelos de dados
├── schemas/      # Schemas Pydantic para validação
├── utils/        # Utilitários
├── config/       # Configurações
└── services/     # Serviços externos

Requisitos

Python 3.8+
PostgreSQL
OpenAI API Key

Instalação

Clone o repositório:

git clone <url-do-repositorio>
cd a2a-saas

Crie um ambiente virtual:

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# ou
.venv\Scripts\activate  # Windows

Instale as dependências:

pip install -r requirements.txt

Configure as variáveis de ambiente:

cp .env.example .env
# Edite o arquivo .env com suas configurações

Executando o Projeto

uvicorn src.main:app --reload

A API estará disponível em http://localhost:8000

Documentação da API

A documentação interativa da API está disponível em:

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

Logs

Os logs são armazenados no diretório logs/ com o seguinte formato:

{nome_do_logger}_{data}.log

Contribuindo

Faça um fork do projeto
Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
Commit suas mudanças (git commit -m 'Add some AmazingFeature')
Push para a branch (git push origin feature/AmazingFeature)
Abra um Pull Request

1.6 KiB Raw Blame History