Astreus

Modelos

Informações sobre modelos de projeto e configurações comuns. Aprenda os padrões de configuração, as APIs e os exemplos práticos necessários para criar...

Informações sobre modelos de projeto e configurações comuns.

Projeto Padrão

Ao executar create-astreus-agent, você obtém uma configuração interativa que gera um projeto com base nas suas escolhas.

npx create-astreus-agent my-agent

O projeto gerado inclui tudo que você precisa para começar.

Estrutura do Projeto Gerado

my-agent/
├── src/
│   └── index.ts      # Ponto de entrada principal com configuração do agente
├── package.json      # Dependências e scripts
├── tsconfig.json     # Configuração do TypeScript (se selecionado)
├── .env.example      # Modelo de variáveis de ambiente
├── .gitignore        # Regras de ignore do Git
└── README.md         # Documentação do projeto

Scripts do Package.json

{
  "scripts": {
    "dev": "tsx src/index.ts",
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

Configurações Comuns

Agente de Chat Básico

Selecione apenas o recurso Memória para um agente conversacional simples:

? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◯ Knowledge (RAG)
  ◯ Graph Workflows
  ◯ Sub-Agents
  ◯ Custom Plugins
  ◯ MCP Integration

Agente com RAG Habilitado

Selecione Memória e Conhecimento para respostas com base em documentos:

? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◉ Knowledge (RAG) - Document ingestion and retrieval
  ◯ Graph Workflows
  ◯ Sub-Agents
  ◯ Custom Plugins
  ◯ MCP Integration

Agente Completo

Selecione todos os recursos para o máximo de capacidades:

? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◉ Knowledge (RAG) - Document ingestion and retrieval
  ◉ Graph Workflows - DAG-based task orchestration
  ◉ Sub-Agents - Multi-agent coordination
  ◉ Custom Plugins - Extensible tool system
  ◉ MCP Integration - Model Context Protocol support

Configuração Específica por Provedor

OpenAI

Modelo padrão: gpt-4o

.env.example gerado:

OPENAI_API_KEY=your-api-key-here

Anthropic (Claude)

Modelo padrão: claude-sonnet-4-20250514

.env.example gerado:

ANTHROPIC_API_KEY=your-api-key-here

Google (Gemini)

Modelo padrão: gemini-2.0-flash

.env.example gerado:

GEMINI_API_KEY=your-api-key-here

Ollama (Local)

Modelo padrão: llama3

.env.example gerado:

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

Múltiplos Provedores

.env.example gerado:

# 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

Comparação de Recursos

RecursoCaso de Uso
MemóriaLembrar preferências do usuário, histórico de conversas
ConhecimentoPerguntas e respostas de documentação, assistentes de pesquisa
GrafoFluxos de trabalho de múltiplas etapas, pipelines
Sub-AgentesTarefas especializadas, processamento paralelo
PluginsFerramentas personalizadas, integrações de API
MCPEcossistema padronizado de ferramentas

Próximos Passos

Depois de criar seu projeto:

cd my-agent
npm install
cp .env.example .env
# Edite o .env com suas chaves de API
npm run dev

Consulte Configuração para detalhes da configuração do ambiente.

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