Configuration d'Argos
La configuration d'Argos se fait à deux niveaux :
- les variables d'environnement couvrent uniquement l'infrastructure et les secrets d'amorçage ;
- tout le reste se règle dans le dashboard (Paramètres). Les modifications s'appliquent à chaud, sans redémarrage.
📑 Table des matières
- Variables d'environnement
- Connexion au dashboard (OAuth Devana)
- Odin et Zeus
- Réglages du dashboard
- Rôles des utilisateurs
Variables d'environnement
Argos (API et workers)
| Variable | Obligatoire | Défaut | Description |
|---|---|---|---|
DATABASE_URL | Oui | — | PostgreSQL (base argos), ex. postgresql://argos:***@postgres:5432/argos |
ENCRYPTION_KEY | Oui | — | Chiffrement des secrets stockés (mots de passe SharePoint, keytabs, clés LLM). 32 caractères minimum, à sauvegarder |
REDIS_URL | Oui | redis://localhost:6379 | Redis dédié, base 0 (partagée avec Odin et Zeus), ex. redis://argos-redis:6379/0 |
Le rôle d'un conteneur est fixé par sa commande : api, worker ou migrate (migrations de la base). Sans commande, le conteneur exécute l'API et les workers dans le même processus, ce qui convient à une petite installation.
Dashboard
| Variable | Défaut | Description |
|---|---|---|
SERVEUR_URL | http://serveur-api:4000 | URL interne de l'API Argos |
PORT | 3100 | Port d'écoute HTTP |
Certificats d'autorité internes
- Certificat d'autorité interne pour SharePoint : collez-le (PEM) dans la connexion SharePoint, sans désactiver la vérification TLS.
- Certificats pour d'autres services, par exemple un fournisseur LLM interne : montez le fichier dans le conteneur et renseignez
NODE_EXTRA_CA_CERTS.
Connexion au dashboard (OAuth Devana)
Les utilisateurs se connectent au dashboard avec leur compte Devana (OAuth). Pour l'activer :
- Sur votre plateforme Devana, créez un client OAuth pour Argos :
- URI de redirection :
<PUBLIC_URL>/auth/callback(ex.https://argos.example.com/auth/callback) ; - portées : prénom, nom et email (
FIRST_NAME,LAST_NAME,EMAIL).
- URI de redirection :
- Renseignez
DEVANA_API_URL,DEVANA_CLIENT_IDetDEVANA_CLIENT_SECRET.
Le fonctionnement d'OAuth sur Devana est décrit dans Documentation OAuth.
Accès au dashboard (Paramètres › Utilisateurs › Connexion au dashboard) :
- domaines email autorisés ;
- rôle attribué aux nouveaux utilisateurs ;
- durée des sessions.
Le premier utilisateur connecté, et ceux listés dans BOOTSTRAP_ADMIN_EMAILS, deviennent administrateurs.
Le serveur MCP n'utilise pas cette connexion : les agents s'authentifient avec des clés API dédiées (voir Serveur MCP).
Odin et Zeus
Odin (extraction du contenu) et Zeus (analyse des fichiers et vision) forment une instance dédiée à Argos. Ils partagent le Redis d'Argos (base 0) et son bucket S3.
Odin
| Variable | Valeur |
|---|---|
DATABASE_URL | Base odin, ex. postgresql://argos:***@postgres:5432/odin |
REDIS_HOST / REDIS_PORT / REDIS_PASSWORD | Redis d'Argos |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY, S3_SECRET_KEY | Identiques à Argos (même bucket) |
PORT / HOST | 3009 / URL interne d'Odin, ex. |
Zeus
| Variable | Valeur |
|---|---|
REDIS_HOST / REDIS_PORT / REDIS_PASSWORD | Redis d'Argos |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY, S3_SECRET_KEY | Identiques à Argos (même bucket) |
LLM_VISION_API_URL, LLM_VISION_API_KEY, LLM_VISION_MODEL | Modèle de vision, API compatible OpenAI. Il décrit les images et lit les pages scannées |
BULLMQ_CONCURRENCY | Fichiers analysés en parallèle (défaut 4) |
Sans clé de vision, Zeus traite les documents textuels ; seules les images et les pages scannées restent sans description.
Si Redis ou le bucket ne sont pas ceux d'Argos, alignez-les dans Paramètres › Traitement & Odin › Odin (adresse Redis, bucket lu par Odin).
Réglages du dashboard
| Page | Réglages |
|---|---|
| Traitement & Odin | Pipeline : pause, documents traités simultanément (rapide / lent), tentatives, démarrage du traitement lent, plages horaires du traitement lent, priorité aux demandes des utilisateurs. Synchronisation : taille des lots, jobs simultanés, taille max des fichiers. Graphe et recherche sémantique. Rétention des journaux |
| Modèles (LLM) | Fournisseurs (API compatible OpenAI, cloud ou auto-hébergée) et rôles : extraction du graphe, embeddings, vision |
| Kerberos | Realm, KDC, principal et keytab du compte de service SharePoint (voir Connexions SharePoint) |
| Serveur MCP | Outils exposés, instructions transmises aux agents, limites de réponse, espaces MCP, clés API, journal des appels (voir Serveur MCP) |
| Utilisateurs | Rôles des utilisateurs, accès au dashboard |
| Système | État des services (base, Redis, stockage, Odin) et points d'intégration |
Chaque réglage complexe est documenté par une info-bulle dans le dashboard.
Rôles des utilisateurs
| Rôle | Droits |
|---|---|
| Lecteur | Consultation : vue d'ensemble, métriques, documents, graphe, traitements |
| Opérateur | + synchronisations, relances, retraitements, banc de test MCP |
| Administrateur | + connexions SharePoint, secrets, Kerberos, modèles LLM, paramètres, utilisateurs, espaces MCP |