Astreus

Plantillas

Información sobre plantillas de proyecto y configuraciones habituales. Aprende los patrones de configuración, las APIs y los ejemplos prácticos necesarios...

Información sobre plantillas de proyecto y configuraciones habituales.

Proyecto predeterminado

Cuando ejecutas create-astreus-agent, obtienes una configuración interactiva que genera un proyecto según tus selecciones.

npx create-astreus-agent my-agent

El proyecto generado incluye todo lo necesario para empezar.

Estructura del proyecto generado

my-agent/
├── src/
│   └── index.ts      # Punto de entrada principal con la configuración del agente
├── package.json      # Dependencias y scripts
├── tsconfig.json     # Configuración de TypeScript (si se seleccionó TypeScript)
├── .env.example      # Plantilla de variables de entorno
├── .gitignore        # Reglas de git ignore
└── README.md         # Documentación del proyecto

Scripts de Package.json

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

Configuraciones habituales

Agente de chat básico

Selecciona solo la función Memory para un agente conversacional sencillo:

? 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 con RAG habilitado

Selecciona Memory y Knowledge para respuestas basadas en 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 con todas las funciones

Selecciona todas las funciones para obtener las máximas 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

Configuración específica por proveedor

OpenAI

Modelo predeterminado: gpt-4o

.env.example generado:

OPENAI_API_KEY=your-api-key-here

Anthropic (Claude)

Modelo predeterminado: claude-sonnet-4-20250514

.env.example generado:

ANTHROPIC_API_KEY=your-api-key-here

Google (Gemini)

Modelo predeterminado: gemini-2.0-flash

.env.example generado:

GEMINI_API_KEY=your-api-key-here

Ollama (local)

Modelo predeterminado: llama3

.env.example generado:

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

Múltiples proveedores

.env.example generado:

# 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

Comparación de funciones

FunciónCaso de uso
MemoryRecordar preferencias del usuario, historial de conversación
KnowledgePreguntas y respuestas sobre documentación, asistentes de investigación
GraphFlujos de trabajo de varios pasos, pipelines
Sub-AgentsTareas especializadas, procesamiento en paralelo
PluginsHerramientas personalizadas, integraciones con APIs
MCPEcosistema de herramientas estandarizado

Próximos pasos

Después de crear tu proyecto:

cd my-agent
npm install
cp .env.example .env
# Edit .env with your API keys
npm run dev

Consulta Configuración para conocer los detalles de la configuración del entorno.

Última actualización: 6 de julio de 2026