Porta il tuo provider di IA

Archyl include funzioni IA per scoperta di architettura, parsing ADR, chat, insights e agenti gestiti. Per default, tutto questo gira su un modello gestito da Archyl. Le organizzazioni che hanno una relazione esistente con un provider IA — per ragioni di compliance, contrattuali o di residenza dei dati — possono instradare ogni richiesta IA tramite il proprio provider con le proprie credenziali.

Quando BYO Provider è attivato:

• Ogni funzione IA viene instradata tramite il provider che configuri
• L'applicazione delle quote di Archyl (query chat, scoperta IA, esecuzioni agenti) viene saltata — il tuo provider ti fattura direttamente l'uso dei token
• La selezione di modello per funzione ti permette di mescolare modelli (es. Claude Sonnet per chat, Claude Opus per scoperta)

È un'impostazione a livello di organizzazione; solo gli amministratori dell'organizzazione possono configurarla.

Provider supportati

L'adattatore compatibile OpenAI è una singola configurazione che copre una lunga lista di provider. Fornisci un URL di base e una chiave API, e Archyl parla con l'endpoint come se fosse OpenAI.

Configurazione

Passo 1 — Apri la tab IA

Vai a Impostazioni dell'organizzazione → IA. La tab è visibile solo agli amministratori.

Passo 2 — Scegli un provider

Seleziona una delle cinque carte di provider. Ogni carta ha i propri requisiti di credenziali:

• OpenAI / Anthropic / Google — solo chiave API
• Compatibile OpenAI — chiave API + URL di base (es. https://api.openrouter.ai/api/v1, https://api.mistral.ai/v1, https://models.github.ai/inference)
• AWS Bedrock — credenziali nel formato <access_key_id>:<secret_access_key> (con suffisso opzionale :<session_token> per credenziali STS), più una regione AWS (es. us-east-1)

Passo 3 — Configura modelli per funzione (opzionale)

Ogni funzione IA può usare un modello diverso. Lascia un campo vuoto per ricadere sul default del provider.

Usa l'identificatore esatto del modello come pubblicato dal provider (claude-opus-4-5, gpt-4o, mistral-large-latest, anthropic.claude-sonnet-4-20250514-v1:0, ecc.). Archyl lo passa direttamente.

Passo 4 — Prova la connessione

Clicca su Prova connessione. Archyl emette una completion minima contro il provider configurato con le tue credenziali. Una spunta verde conferma che le credenziali funzionano; un errore mostra la risposta del provider in modo che tu possa correggere la configurazione prima di salvare.

Passo 5 — Abilita e salva

Spunta Abilita provider BYO per questa organizzazione e clicca Salva impostazioni. La prossima richiesta IA da chiunque nell'organizzazione — chat, scoperta, esecuzione agente, importazione ADR — verrà instradata tramite il tuo provider.

Comportamento delle quote

Quando BYO Provider è disattivato (default), l'uso IA conta contro la quota mensile del tuo abbonamento:

• Operazioni di scoperta IA
• Query chat
• Esecuzioni di agenti gestiti

Quando BYO Provider è attivato, tutte e tre le quote sono bypassate per l'organizzazione. Paghi il tuo provider direttamente per i token usati; Archyl non limita più queste funzioni. Il tuo abbonamento per posto si applica ancora a tutto il resto (funzioni di collaborazione, limiti di team, ecc.).

Il bypass ha effetto immediato quando attivi il toggle e si inverte immediatamente quando lo disattivi.

Sicurezza

Le chiavi API sono cifrate a riposo usando AES-256-GCM con la chiave di cifratura della piattaforma. Non vengono mai restituite nelle risposte API — una volta memorizzate, la UI mostra •••••••• insieme a un indicatore "chiave memorizzata", e la chiave viene decifrata solo in-process quando deve essere fatta una richiesta IA.

Per sostituire una chiave esistente, digita il nuovo valore e salva. Per cancellarla del tutto, clicca Rimuovi configurazione, che elimina la riga e riporta l'organizzazione all'IA gestita dalla piattaforma.

Solo gli amministratori dell'organizzazione possono leggere o modificare queste impostazioni. I membri continuano a usare le funzioni IA in modo trasparente — l'instradamento è invisibile per loro.

Agenti gestiti

Quando BYO Provider è attivato, le esecuzioni di agenti gestiti girano interamente sul tuo provider, con le tue credenziali. Il modello di Archyl non viene mai usato come ripiego.

Se il provider non può eseguire agenti, o non è impostato alcun modello per un endpoint compatibile OpenAI, l'avvio di un'esecuzione fallisce con un messaggio esplicito invece di girare su un modello che non hai scelto.

Risoluzione dei problemi

"Prova connessione" fallisce con 401 / 403. Ricontrolla che la chiave sia incollata correttamente senza spazi attorno. Per Bedrock, assicurati che il formato sia <access_key_id>:<secret_access_key> (separati da due punti) e che la regione corrisponda a una regione dove il modello è stato abilitato nel tuo account AWS.

"baseUrl is required for openai_compatible provider". Il campo URL di base è obbligatorio per l'adattatore compatibile OpenAI. Dovrebbe puntare alla radice dell'API, es. https://api.openrouter.ai/api/v1 — senza /chat/completions alla fine.

La scoperta restituisce JSON non valido. I prompt di Archyl sono ottimizzati per il modo JSON stretto di OpenAI. Alcuni provider/modelli restituiscono JSON dentro fence di codice markdown o aggiungono commenti. Passa a un modello con forte affidabilità del modo JSON (es. gpt-4o, claude-sonnet-4-6, gemini-2.0-flash) specificamente per le funzioni Scoperta, Analisi struttura e Rifinimento relazioni — chat e altre funzioni sono più permissive.

La chat funziona ma la scoperta fallisce su Bedrock. Alcuni ID di modelli Bedrock richiedono Provisioned Throughput o specifici profili di inferenza cross-regione. Verifica che il modello sia abilitato per il tuo account nella console Bedrock e che la regione scelta corrisponda alla disponibilità del modello.

Funzioni correlate

• Scoperta IA — usa il tuo provider configurato quando BYO è attivato
• Esecuzioni di agenti gestiti — girano sul tuo provider Anthropic, Bedrock, OpenAI o compatibile OpenAI