Template
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-agentIl 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 progettoScript 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 IntegrationAgente 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 IntegrationAgente 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 supportConfigurazione specifica per provider#
OpenAI#
Modello predefinito: gpt-4o
.env.example generato:
OPENAI_API_KEY=your-api-key-hereAnthropic (Claude)#
Modello predefinito: claude-sonnet-5
.env.example generato:
ANTHROPIC_API_KEY=your-api-key-hereGoogle (Gemini)#
Modello predefinito: gemini-2.0-flash
.env.example generato:
GEMINI_API_KEY=your-api-key-hereOllama (locale)#
Modello predefinito: llama3
.env.example generato:
# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434Più 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-keyConfronto 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 devConsulta Configurazione per l'impostazione dettagliata dell'ambiente.