Template

Informazioni sui template di progetto e sulle configurazioni comuni. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare...

Informazioni sui template di progetto e sulle configurazioni comuni.

Progetto predefinito

Quando esegui create-astreus-agent, ottieni una configurazione interattiva che genera un progetto in base alle tue scelte.

npx create-astreus-agent my-agent

Il progetto generato include tutto ciò di cui hai bisogno per iniziare.

Struttura del progetto generato

my-agent/
├── src/
│   └── index.ts      # Punto di ingresso principale con la configurazione dell'agente
├── package.json      # Dipendenze e script
├── tsconfig.json     # Configurazione TypeScript (se TypeScript è selezionato)
├── .env.example      # Modello delle variabili d'ambiente
├── .gitignore        # Regole di Git ignore
└── README.md         # Documentazione del progetto

Script di Package.json

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

Configurazioni comuni

Agente di chat di base

Seleziona solo la funzionalità Memoria per un semplice agente conversazionale:

? 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 abilitato al RAG

Seleziona Memoria e Conoscenza per risposte consapevoli dei documenti:

? 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

Seleziona tutte le funzionalità per il massimo delle capacità:

? 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

Configurazione specifica per provider

OpenAI

Modello predefinito: gpt-4o

.env.example generato:

OPENAI_API_KEY=your-api-key-here

Anthropic (Claude)

Modello predefinito: claude-sonnet-4-20250514

.env.example generato:

ANTHROPIC_API_KEY=your-api-key-here

Google (Gemini)

Modello predefinito: gemini-2.0-flash

.env.example generato:

GEMINI_API_KEY=your-api-key-here

Ollama (locale)

Modello predefinito: llama3

.env.example generato:

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

Più provider

.env.example generato:

# 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

Confronto delle funzionalità

Funzionalità	Caso d'uso
Memoria	Ricordare le preferenze dell'utente, la cronologia delle conversazioni
Conoscenza	Domande e risposte sulla documentazione, assistenti di ricerca
Grafo	Flussi di lavoro multi-step, pipeline
Sub-Agent	Attività specializzate, elaborazione parallela
Plugin	Strumenti personalizzati, integrazioni API
MCP	Ecosistema di strumenti standardizzato

Prossimi passi

Dopo aver creato il tuo progetto:

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

Consulta Configurazione per l'impostazione dettagliata dell'ambiente.

Ultimo aggiornamento: 6 luglio 2026

In questa sezione

Introduzione

Crea nuovi progetti di agenti AI Astreus con best practice e valori predefiniti sensati. Configura il tuo agente in modo interattivo con le funzionalità di...

Avvio rapido

Crea il tuo primo progetto di agente Astreus in meno di 5 minuti. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare...

Funzionalità

Configurazione