IA (Claude / OpenAI / Gemini)
L’IA d’AppArch se configure une seule fois pour toute l’installation, par l’opérateur de l’installation. Les espaces de travail ne peuvent pas ajouter leur propre clé, et il n’y a pas d’entrée IA sous Integrations.
Configuration
Section intitulée « Configuration »Ouvrez Administration → Settings → Assistant (/management/settings/assistant) et définissez :
- Provider - Anthropic (Claude), OpenAI ou Google (Gemini). Un seul fournisseur à la fois.
- API key - la propre clé de l’opérateur ; le fournisseur facture l’usage à ce compte.
- Models on offer - tous les modèles que cette installation peut utiliser. Le premier est le modèle par défaut. S’il y en a plusieurs, les utilisateurs choisissent par question dans l’onglet Ask d’Archito.
- Offer the assistant to users - active l’onglet Ask d’Archito.
- Allow fix suggestions on findings - un interrupteur séparé, car chaque proposition envoie un constat au fournisseur.
- Token budgets - plafonds journaliers et hebdomadaires facultatifs, par espace de travail et pour toute l’installation.
Tout est désactivé par défaut. Ni l’assistant ni les propositions de correction ne peuvent être activés tant que l’opérateur n’a pas accepté, sur la même page, l’accord de traitement par l’IA.
La clé d’API est chiffrée avec la clé maîtresse de l’installation. Une fois enregistrée, elle n’est plus jamais affichée - seuls ses quatre derniers caractères le sont.
Ce qui l’utilise
Section intitulée « Ce qui l’utilise »| Fonction | Activée par | Ce qui est envoyé au fournisseur |
|---|---|---|
| Proposition de correction sur les constats ArchPilot et ArchScan | Opérateur : Allow fix suggestions | Clé de règle, sévérité, chemin du fichier et ligne, message du constat et suggestion propre à l’analyseur |
| Onglet Archito → Ask | Opérateur : Offer the assistant | La question et les chiffres utilisés pour y répondre (noms de projets, nombres de constats, totaux d’analyse) |
| Verdicts IA sur les commentaires de revue de MR | Espace de travail : paramètres ArchPilot, sur option ; requiert l’un des deux interrupteurs de l’opérateur | Les commentaires de revue en attente à classer |
| Générateur MD, mode IA | Opérateur : Allow fix suggestions | Les faits du projet, le brouillon issu du modèle et une tranche superficielle du dépôt : description, topics, liste racine, quelques fichiers manifestes (par ex. package.json, *.csproj, go.mod, tronqués) et le README existant |
Aucune n’envoie le dépôt dans son ensemble. Ce que voient les utilisateurs : Archito, l’assistant.
Propositions de correction
Section intitulée « Propositions de correction »- La réponse est rédigée dans la langue du panneau du lecteur (turc, anglais, allemand, français, espagnol, russe, arabe, azerbaïdjanais ; toute autre langue retombe sur l’anglais), avec le modèle par défaut.
- Chaque réponse est enregistrée avec le constat, avec le fournisseur, le modèle, les jetons d’entrée et de sortie et la langue. La personne suivante qui ouvre le même constat voit la réponse enregistrée, sans nouvelle dépense de jetons. La régénérer est une action délibérée.
Générateur MD
Section intitulée « Générateur MD »Sans IA, le générateur MD fonctionne en mode modèle (anglais uniquement). Voir Générateur MD.
- Limite de débit : au plus 30 appels IA par espace de travail et par minute, toutes fonctions confondues. Le compteur est dans Redis ; si Redis est injoignable, la limite ne s’applique pas.
- Budgets de jetons : par espace de travail par jour et par semaine, et pour l’installation par jour et par semaine.
0signifie aucune limite. Le jour se réinitialise à minuit UTC, la semaine le lundi. Le plafond de l’installation l’emporte toujours. Les budgets comptent l’onglet Ask et la classification des commentaires de revue.
L’Api appelle le fournisseur directement :
https://api.anthropic.comhttps://api.openai.comhttps://generativelanguage.googleapis.com
Il n’y a pas de relais hébergé par AppArch. Sur un réseau isolé, laissez l’IA désactivée - elle n’a rien à joindre.