Eigener KI-Anbieter

Archyl bietet KI-Funktionen für Architektur-Discovery, ADR-Parsing, Chat, Insights und verwaltete Agenten. Standardmäßig laufen all diese auf einem von Archyl verwalteten Modell. Organisationen, die bereits eine Beziehung zu einem KI-Anbieter haben — aus Compliance-, Vertrags- oder Datenresidenzgründen — können jede KI-Anfrage über ihren eigenen Anbieter mit ihren eigenen Anmeldedaten leiten.

Wenn BYO Provider aktiviert ist:

Jede KI-Funktion wird über den von Ihnen konfigurierten Anbieter geleitet
Die Archyl-Kontingenterzwingung (Chat-Anfragen, KI-Discovery, Agent-Läufe) wird übersprungen — Ihr Anbieter rechnet die Tokennutzung direkt mit Ihnen ab
Die Modellauswahl pro Funktion erlaubt das Mischen von Modellen (z. B. Claude Sonnet für Chat, Claude Opus für Discovery)

Dies ist eine Einstellung auf Organisationsebene; nur Organisationsadministratoren können sie konfigurieren.

Unterstützte Anbieter

Anbieter	Beschreibung	Standardmodell
OpenAI	Direkte OpenAI-API auf `api.openai.com`	`gpt-5.6-luna`
Anthropic	Direkte Anthropic Messages-API (Claude)	`claude-sonnet-4-6`
Google	Google Generative Language-API (Gemini)	`gemini-2.0-flash`
AWS Bedrock	Bedrock Converse-API — deckt Anthropic Claude, Mistral, Llama, Titan, Cohere ab	`anthropic.claude-sonnet-4-20250514-v1:0`
OpenAI-kompatibel	Jeder Endpoint, der das OpenAI Chat Completions-Format spricht — Azure OpenAI, GitHub Models, OpenRouter, Mistral La Plateforme, Groq, Together AI, Fireworks, DeepInfra, vLLM, llama.cpp usw.	(anbieterspezifisch)

Der OpenAI-kompatible Adapter ist eine einzige Konfiguration, die eine lange Liste von Anbietern abdeckt. Sie liefern eine Basis-URL und einen API-Schlüssel, und Archyl spricht mit dem Endpoint, als wäre es OpenAI.

Konfiguration

Schritt 1 — Öffnen Sie den KI-Tab

Gehen Sie zu Organisationseinstellungen → KI. Der Tab ist nur für Administratoren sichtbar.

Schritt 2 — Wählen Sie einen Anbieter

Wählen Sie eine der fünf Anbieterkarten. Jede Karte hat ihre eigenen Anforderungen an die Anmeldedaten:

OpenAI / Anthropic / Google — nur API-Schlüssel
OpenAI-kompatibel — API-Schlüssel + Basis-URL (z. B. https://api.openrouter.ai/api/v1, https://api.mistral.ai/v1, https://models.github.ai/inference)
AWS Bedrock — Anmeldedaten im Format <access_key_id>:<secret_access_key> (mit optionalem :<session_token>-Suffix für STS-Anmeldedaten), plus eine AWS-Region (z. B. us-east-1)

Schritt 3 — Modelle pro Funktion konfigurieren (optional)

Jede KI-Funktion kann ein anderes Modell verwenden. Lassen Sie ein Feld leer, um auf den Standardwert des Anbieters zurückzugreifen.

Funktion	Beschreibung
Chat	Streaming-Chat-Assistent
Discovery	Repo-weite KI-Discovery — benötigt zuverlässige JSON-Ausgabe
Strukturanalyse	Discovery-Phase 1 (System + Container)
Beziehungsverfeinerung	Discovery-Phase 3 (containerübergreifende Verbindungen)
ADR-Parsing	Extrahiert strukturierte Felder aus ADR-Markdown
Dateianalyse	Detaildurchlauf pro Datei
Dokumenttitel-Generierung	Stapelgenerierung von Titeln für die Dokumentation
Insights	KI-generierte Architektur-Insights
Verwaltete Agenten	Modell, das von verwalteten Agenten-Läufen verwendet wird (siehe Verwaltete Agenten)

Verwenden Sie die genaue Modell-ID, wie vom Anbieter veröffentlicht (claude-opus-4-5, gpt-4o, mistral-large-latest, anthropic.claude-sonnet-4-20250514-v1:0 usw.). Archyl reicht sie direkt durch.

Schritt 4 — Verbindung testen

Klicken Sie auf Verbindung testen. Archyl gibt eine minimale Completion gegen den konfigurierten Anbieter mit Ihren Anmeldedaten aus. Ein grünes Häkchen bestätigt, dass die Anmeldedaten funktionieren; ein Fehler zeigt die Antwort des Anbieters an, sodass Sie die Konfiguration vor dem Speichern korrigieren können.

Schritt 5 — Aktivieren und speichern

Aktivieren Sie BYO-Anbieter für diese Organisation aktivieren und klicken Sie auf Einstellungen speichern. Die nächste KI-Anfrage von irgendjemandem in der Organisation — Chat, Discovery, Agent-Lauf, ADR-Import — wird über Ihren Anbieter geleitet.

Kontingentverhalten

Wenn BYO Provider deaktiviert ist (Standard), wird die KI-Nutzung gegen das monatliche Kontingent Ihres Abonnements gezählt:

KI-Discovery-Operationen
Chat-Anfragen
Verwaltete Agenten-Läufe

Wenn BYO Provider aktiviert ist, werden alle drei Kontingente für die Organisation umgangen. Sie zahlen Ihren Anbieter direkt für die verwendeten Tokens; Archyl begrenzt diese Funktionen nicht mehr. Ihr sitzbasiertes Abonnement gilt weiterhin für alles andere (Kollaborationsfunktionen, Team-Limits usw.).

Die Umgehung tritt sofort in Kraft, wenn Sie den Schalter aktivieren, und wird sofort rückgängig gemacht, wenn Sie ihn deaktivieren.

Sicherheit

API-Schlüssel werden im Ruhezustand mit AES-256-GCM und dem Plattform-Verschlüsselungsschlüssel verschlüsselt. Sie werden nie in API-Antworten zurückgegeben — sobald gespeichert, zeigt die UI •••••••• zusammen mit einer „Schlüssel gespeichert"-Anzeige, und der Schlüssel wird nur in-process entschlüsselt, wenn eine KI-Anfrage gestellt werden muss.

Um einen vorhandenen Schlüssel zu ersetzen, geben Sie den neuen Wert ein und speichern. Um ihn vollständig zu löschen, klicken Sie auf Konfiguration entfernen, was die Zeile löscht und die Organisation auf die plattformverwaltete KI zurücksetzt.

Nur Organisationsadministratoren können diese Einstellungen lesen oder ändern. Mitglieder verwenden KI-Funktionen weiterhin transparent — die Weiterleitung ist für sie unsichtbar.

Verwaltete Agenten

Wenn BYO Provider aktiviert ist, laufen verwaltete Agenten-Läufe vollständig auf Ihrem Anbieter und mit Ihren Anmeldedaten. Das eigene Modell von Archyl wird nie als Fallback verwendet.

Anbieter	Verwaltete Agenten	Modell
Anthropic	Unterstützt	Modell unter Verwaltete Agenten, sonst `claude-sonnet-4-6`
AWS Bedrock	Unterstützt (Anthropic-Claude-Modelle)	Modell unter Verwaltete Agenten, sonst `anthropic.claude-sonnet-4-20250514-v1:0`; regionsübergreifende Profile wie `eu.anthropic.claude-sonnet-4-5-20250929-v1:0` funktionieren ebenfalls
OpenAI	Unterstützt	Modell unter Verwaltete Agenten, sonst `gpt-5.6-luna`
OpenAI-kompatibel	Unterstützt, wenn der Endpoint die OpenAI Responses-API implementiert	Modell unter Verwaltete Agenten — Pflichtangabe, es gibt keinen Standardwert
Google	Noch nicht unterstützt	—

Kann der Anbieter keine Agenten ausführen oder ist für einen OpenAI-kompatiblen Endpoint kein Modell gesetzt, schlägt der Start eines Laufs mit einer eindeutigen Meldung fehl, statt auf einem Modell zu laufen, das Sie nicht gewählt haben.

Fehlerbehebung

„Verbindung testen" schlägt mit 401 / 403 fehl. Überprüfen Sie erneut, dass der Schlüssel korrekt ohne umgebende Leerzeichen eingefügt wurde. Stellen Sie für Bedrock sicher, dass das Format <access_key_id>:<secret_access_key> (durch Doppelpunkt getrennt) ist und die Region einer Region entspricht, in der das Modell in Ihrem AWS-Konto aktiviert wurde.

„baseUrl is required for openai_compatible provider". Das Basis-URL-Feld ist für den OpenAI-kompatiblen Adapter obligatorisch. Es sollte auf die Wurzel der API zeigen, z. B. https://api.openrouter.ai/api/v1 — ohne /chat/completions am Ende.

Discovery gibt ungültiges JSON zurück. Die Prompts von Archyl sind auf den strikten JSON-Modus von OpenAI abgestimmt. Einige Anbieter/Modelle geben JSON innerhalb von Markdown-Code-Fences zurück oder fügen Kommentare hinzu. Wechseln Sie zu einem Modell mit hoher Zuverlässigkeit im JSON-Modus (z. B. gpt-4o, claude-sonnet-4-6, gemini-2.0-flash) speziell für die Funktionen Discovery, Strukturanalyse und Beziehungsverfeinerung — Chat und andere Funktionen sind toleranter.

Chat funktioniert, aber Discovery scheitert auf Bedrock. Einige Bedrock-Modell-IDs erfordern Provisioned Throughput oder spezifische cross-regionale Inferenzprofile. Überprüfen Sie, dass das Modell für Ihr Konto in der Bedrock-Konsole aktiviert ist und dass die gewählte Region mit der Verfügbarkeit des Modells übereinstimmt.