Configuração

Variáveis de ambiente e opções de configuração para o seu projeto de agente Astreus. Aprenda os padrões de configuração, as APIs e os exemplos práticos...

Variáveis de ambiente e opções de configuração para o seu projeto de agente Astreus.

Configuração do Ambiente

Após criar seu projeto, copie o arquivo de ambiente de exemplo:

cp .env.example .env

Em seguida, edite o .env com sua configuração.

Configuração Específica por Provedor

O .env.example gerado depende do provedor selecionado:

OpenAI

OPENAI_API_KEY=your-api-key-here

Anthropic

ANTHROPIC_API_KEY=your-api-key-here

Google Gemini

GEMINI_API_KEY=your-api-key-here

Ollama

# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434

Múltiplos Provedores

# Add API keys for providers you want to use
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
GEMINI_API_KEY=your-gemini-key

Configuração Completa

Para implantações em produção, pode ser necessária configuração adicional:

# ===== LLM PROVIDERS API KEYS =====

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here      # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key     # Optional

# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here      # Optional

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here         # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key        # Optional

# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434

# ===== DATABASE CONFIGURATION =====

# Main Application Database (Agents, Memory, Tasks, etc.)
DB_URL=sqlite://./astreus.db

# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db

# ===== KNOWLEDGE/RAG SYSTEM =====

# Knowledge Vector Database (PostgreSQL with pgvector required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db

# ===== APPLICATION SETTINGS =====

NODE_ENV=development       # development | production | test
LOG_LEVEL=info             # debug | info | warn | error | silent

# ===== DATABASE ENCRYPTION =====

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

Configuração de Banco de Dados

SQLite (Desenvolvimento)

Padrão e sem configuração para desenvolvimento:

DB_URL=sqlite://./astreus.db

PostgreSQL (Produção)

Recomendado para implantações em produção:

DB_URL=postgresql://user:password@localhost:5432/astreus_db

Banco de Dados de Conhecimento

Necessário para recursos de RAG. Deve ser PostgreSQL com pgvector:

KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

Configurando o pgvector

Usando Docker:

# docker-compose.yml
services:
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_USER: astreus
      POSTGRES_PASSWORD: password
      POSTGRES_DB: knowledge_db
    ports:
      - "5432:5432"

docker-compose up -d

Segurança

Chaves de Criptografia

Gere uma chave de criptografia segura:

openssl rand -hex 32

Adicione ao seu ambiente:

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm

Checklist de Produção

Use PostgreSQL em vez de SQLite
Ative a criptografia
Defina NODE_ENV=production
Use LOG_LEVEL=warn ou error
Armazene segredos no ambiente, não em arquivos
Use um gerenciador de segredos (Vault, AWS Secrets, etc.)

Modelos Padrão por Provedor

Provedor	Modelo Padrão
OpenAI	`gpt-4o`
Anthropic	`claude-sonnet-4-20250514`
Google	`gemini-2.0-flash`
Ollama	`llama3`

Última atualização: 6 de julho de 2026

Nesta seção

Introdução

Estruture novos projetos de agentes de IA Astreus com boas práticas e padrões sensatos. Configure seu agente de forma interativa com os recursos que você...

Início Rápido

Crie seu primeiro projeto de agente Astreus em menos de 5 minutos. Aprenda os padrões de configuração, as APIs e os exemplos práticos necessários para criar...

Recursos

Explicação detalhada de cada recurso que você pode incluir ao estruturar um novo agente. Aprenda os padrões de configuração, as APIs e os exemplos práticos...

Modelos