Configuration

Variables d'environnement et options de configuration pour votre projet d'agent Astreus. Découvrez les schémas de configuration, les API et les exemples...

Variables d'environnement et options de configuration pour votre projet d'agent Astreus.

Configuration de l'environnement

Après avoir créé votre projet, copiez le fichier d'environnement exemple :

cp .env.example .env

Puis éditez .env avec votre configuration.

Configuration spécifique au fournisseur

Le fichier .env.example généré dépend du fournisseur que vous avez sélectionné :

OpenAI

OPENAI_API_KEY=your-api-key-here

Anthropic

ANTHROPIC_API_KEY=your-api-key-here

Google Gemini

GEMINI_API_KEY=your-api-key-here

Ollama

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

Plusieurs fournisseurs

# 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

Configuration complète

Pour les déploiements en production, une configuration supplémentaire peut être nécessaire :

# ===== LLM PROVIDERS API KEYS =====

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here      # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key     # Optional

# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here      # Optional

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here         # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key        # Optional

# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434

# ===== DATABASE CONFIGURATION =====

# Main Application Database (Agents, Memory, Tasks, etc.)
DB_URL=sqlite://./astreus.db

# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db

# ===== KNOWLEDGE/RAG SYSTEM =====

# Knowledge Vector Database (PostgreSQL with pgvector required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db

# ===== APPLICATION SETTINGS =====

NODE_ENV=development       # development | production | test
LOG_LEVEL=info             # debug | info | warn | error | silent

# ===== DATABASE ENCRYPTION =====

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

Configuration de la base de données

SQLite (Développement)

Par défaut et sans configuration pour le développement :

DB_URL=sqlite://./astreus.db

PostgreSQL (Production)

Recommandé pour les déploiements en production :

DB_URL=postgresql://user:password@localhost:5432/astreus_db

Base de données de connaissances

Requis pour les fonctionnalités RAG. Doit être PostgreSQL avec pgvector :

KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

Configuration de pgvector

Avec Docker :

# docker-compose.yml
services:
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_USER: astreus
      POSTGRES_PASSWORD: password
      POSTGRES_DB: knowledge_db
    ports:
      - "5432:5432"

docker-compose up -d

Sécurité

Clés de chiffrement

Générez une clé de chiffrement sécurisée :

openssl rand -hex 32

Ajoutez-la à votre environnement :

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm

Checklist de production

Utiliser PostgreSQL au lieu de SQLite
Activer le chiffrement
Définir NODE_ENV=production
Utiliser LOG_LEVEL=warn ou error
Stocker les secrets dans l'environnement, pas dans des fichiers
Utiliser un gestionnaire de secrets (Vault, AWS Secrets, etc.)

Modèles par défaut par fournisseur

Fournisseur	Modèle par défaut
OpenAI	`gpt-4o`
Anthropic	`claude-sonnet-4-20250514`
Google	`gemini-2.0-flash`
Ollama	`llama3`

Dernière mise à jour : 6 juillet 2026

Dans cette section

Introduction

Créez des projets d'agent Astreus AI avec les meilleures pratiques et des paramètres par défaut sensés. Configurez votre agent de manière interactive avec...

Démarrage rapide

Créez votre premier projet d'agent Astreus en moins de 5 minutes. Découvrez les schémas de configuration, les API et les exemples pratiques nécessaires pour...

Fonctionnalités

Explication détaillée de chaque fonctionnalité que vous pouvez inclure lors de la création d'un nouvel agent.

Modèles