Zum Inhalt springen

KI (Claude / OpenAI / Gemini)

KI wird in AppArch einmal für die ganze Installation konfiguriert, vom Betreiber der Installation. Workspaces können keinen eigenen Schlüssel hinterlegen, und unter Integrations gibt es keinen KI-Eintrag.

Öffnen Sie Administration → Settings → Assistant (/management/settings/assistant) und legen Sie fest:

  • Provider - Anthropic (Claude), OpenAI oder Google (Gemini). Jeweils ein Anbieter.
  • API key - der eigene Schlüssel des Betreibers; der Anbieter rechnet die Nutzung mit diesem Konto ab.
  • Models on offer - alle Modelle, die diese Installation nutzen darf. Das erste ist der Standard. Bei mehr als einem wählen Nutzer im Ask-Tab von Archito pro Frage.
  • Offer the assistant to users - schaltet den Ask-Tab von Archito ein.
  • Allow fix suggestions on findings - ein eigener Schalter, weil jeder Vorschlag einen Befund an den Anbieter sendet.
  • Token budgets - optionale Tages- und Wochenobergrenzen, pro Workspace und für die ganze Installation.

Alles ist standardmäßig aus. Weder der Assistent noch Lösungsvorschläge lassen sich einschalten, bevor der Betreiber auf derselben Seite die Vereinbarung zur KI-Verarbeitung akzeptiert hat.

Der API-Schlüssel wird mit dem Master-Schlüssel der Installation verschlüsselt. Nach dem Speichern wird er nie wieder angezeigt - nur seine letzten vier Zeichen.

FunktionEingeschaltet vonWas an den Anbieter geht
Lösungsvorschlag zu ArchPilot- und ArchScan-BefundenBetreiber: Allow fix suggestionsRegelschlüssel, Schweregrad, Dateipfad und Zeile, Befundtext und der eigene Vorschlag des Analysers
Archito → Ask-TabBetreiber: Offer the assistantDie Frage und die Zahlen zur Antwort (Projektnamen, Befundzahlen, Scan-Summen)
KI-Urteile zu MR-Review-KommentarenWorkspace: ArchPilot-Einstellungen, Opt-in; braucht einen der beiden Betreiber-SchalterDie noch nicht bewerteten Review-Kommentare, die klassifiziert werden
MD-Generator, KI-ModusBetreiber: Allow fix suggestionsProjektfakten, der erzeugte Vorlagenentwurf und ein flacher Ausschnitt des Repositorys: Beschreibung, Topics, Wurzelverzeichnis, einige Manifest-Dateien (z. B. package.json, *.csproj, go.mod, gekürzt) und die vorhandene README

Keine davon sendet das Repository als Ganzes. Wie der Assistent für Nutzer aussieht: Archito, der Assistent.

  • Die Antwort wird in der Panel-Sprache des Lesers geschrieben (Türkisch, Englisch, Deutsch, Französisch, Spanisch, Russisch, Arabisch, Aserbaidschanisch; alles andere fällt auf Englisch zurück), mit dem Standardmodell.
  • Jede Antwort wird mit dem Befund gespeichert, mit Anbieter, Modell, Eingabe- und Ausgabe-Tokens und Sprache. Wer denselben Befund später öffnet, sieht die gespeicherte Antwort, ohne dass erneut Tokens verbraucht werden. Neu erzeugen ist eine bewusste Aktion.

Ohne KI arbeitet der MD-Generator im Vorlagenmodus (nur Englisch). Siehe MD-Generator.

  • Ratenlimit: höchstens 30 KI-Aufrufe pro Workspace und Minute über alle Funktionen. Der Zähler liegt in Redis; ist Redis nicht erreichbar, greift das Limit nicht.
  • Token-Budgets: pro Workspace pro Tag und pro Woche, für die Installation pro Tag und pro Woche. 0 bedeutet kein Limit. Der Tag beginnt um Mitternacht UTC, die Woche am Montag. Die Obergrenze der Installation hat immer Vorrang. Budgets zählen den Ask-Tab und die Klassifizierung von Review-Kommentaren.

Die Api ruft den Anbieter direkt auf:

  • https://api.anthropic.com
  • https://api.openai.com
  • https://generativelanguage.googleapis.com

Es gibt kein von AppArch betriebenes Relay. In einem isolierten Netz lassen Sie KI ausgeschaltet - es gibt nichts, was sie erreichen könnte.