Vorlagen

Informationen zu Projektvorlagen und gängigen Konfigurationen.

Standardprojekt#

Wenn du create-astreus-agent ausführst, erhältst du ein interaktives Setup, das basierend auf deinen Auswahlen ein Projekt generiert.

bash
npx create-astreus-agent my-agent

Das generierte Projekt enthält alles, was du für den Einstieg brauchst.

Generierte Projektstruktur#

text
my-agent/
├── src/
│   └── index.ts      # Haupteinstiegspunkt mit Agenten-Setup
├── package.json      # Abhängigkeiten und Skripte
├── tsconfig.json     # TypeScript-Konfiguration (falls TypeScript ausgewählt)
├── .env.example      # Vorlage für Umgebungsvariablen
├── .gitignore        # Git-Ignore-Regeln
└── README.md         # Projektdokumentation

Package.json-Skripte#

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

Gängige Konfigurationen#

Einfacher Chat-Agent#

Wähle nur die Memory-Funktion für einen einfachen konversationellen Agenten:

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

RAG-fähiger Agent#

Wähle Memory und Knowledge für dokumentenbewusste Antworten:

text
? 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

Vollausgestatteter Agent#

Wähle alle Funktionen für maximale Fähigkeiten:

text
? 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

Anbieterspezifisches Setup#

OpenAI#

Standardmodell: gpt-4o

Generierte .env.example:

text
OPENAI_API_KEY=your-api-key-here

Anthropic (Claude)#

Standardmodell: claude-sonnet-5

Generierte .env.example:

text
ANTHROPIC_API_KEY=your-api-key-here

Google (Gemini)#

Standardmodell: gemini-2.0-flash

Generierte .env.example:

text
GEMINI_API_KEY=your-api-key-here

Ollama (lokal)#

Standardmodell: llama3

Generierte .env.example:

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

Mehrere Anbieter#

Generierte .env.example:

text
# 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

Funktionsvergleich#

FunktionAnwendungsfall
MemoryMerken von Nutzerpräferenzen, Gesprächsverlauf
KnowledgeDokumentations-Q&A, Recherche-Assistenten
GraphMehrstufige Workflows, Pipelines
Sub-AgentsSpezialisierte Aufgaben, parallele Verarbeitung
PluginsIndividuelle Tools, API-Integrationen
MCPStandardisiertes Tool-Ökosystem

Nächste Schritte#

Nach der Erstellung deines Projekts:

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

Siehe Konfiguration für eine detaillierte Umgebungseinrichtung.