Per iniziare

Questa guida porta una struttura da zero a una prima richiesta funzionante in tre passaggi, poi mostra come verificare che abbia funzionato.

Prima di iniziare

• Devi essere un Organisation Administrator. Model Router è disponibile solo per gli Organisation Administrator, nelle strutture Technology Stack.
• Seleziona la struttura che vuoi configurare con il selettore della struttura nella barra degli strumenti principale del Performance Hub.
• Assicurati di avere una carta di pagamento memorizzata per la struttura o preparati ad aggiungerne una. Le ricariche vengono addebitate sulla carta di pagamento memorizzata; se non ce n'è nessuna, la pagina Balance & Top-up mostra "No card on file." con un link Add payment details.

Passaggio 1: attiva Model Router

Apri Model Router dal menu principale (nel gruppo AI Modules & Agents). Se il modulo non è ancora stato attivato per questa struttura, vedrai la pagina Welcome to Model Router:

"Offri alla tua azienda l'accesso prepagato a un catalogo di modelli AI leader attraverso un unico endpoint compatibile con OpenAI. I tuoi AI Agents di Performance Hub si collegano automaticamente e puoi creare chiavi API per integrare gli stessi modelli nel tuo software, con limiti di spesa e visibilità completa sull'utilizzo."

Figura 1: la pagina Welcome to Model Router che una struttura vede prima che il modulo venga attivato

La pagina ha tre pulsanti: Enable Model Router, Read the documentation (che apre questa documentazione) ed Explore first without enabling. Sotto di essi, tre passaggi descrivono la configurazione:

Ogni passaggio ha anche un link Learn more.

Fai clic su Enable Model Router (o Enable module) per attivare il modulo.

L'elenco di controllo della configurazione

Dopo aver attivato il modulo, un banner con l'elenco di controllo della configurazione compare nella parte superiore di Model Router finché la configurazione non è completata. Si intitola Finish setting up Model Router e mostra una stima del tempo (ad es. ~3 min left), quanti passaggi sono stati completati (ad es. 2 of 3 complete) e un pulsante Resume che espande l'elenco completo. Ogni passaggio ha Review (o Review again) e Learn more; Collapse lo comprime di nuovo. Quando manca un solo passaggio, il sottotitolo espanso riporta "Just one step to go before AI requests start flowing. Steps can be done in any order."

Figura 2: il banner dell'elenco di controllo della configurazione, visibile finché la configurazione non è completata

I passaggi obbligatori sono Add a billing card, Top up your balance e Connect an agent or create an API key. I passaggi facoltativi (Set spend limits, Turn on auto top-up e Verify your first request) possono essere ignorati con Skip for now.

Passaggio 2: effettua la prima ricarica

Vai a Budgets & Limits → Balance & Top-up.

Figura 3: la scheda Top up balance (importi predefiniti, importo, carta memorizzata) e la scheda Auto top-up

1. Nella scheda Top up balance, scegli un importo predefinito ($25, $50, $100, $250, $500, $1000) o digita un importo. "Minimum top-up is $10."
2. Controlla la carta memorizzata mostrata sotto l'importo (ad es. "Amex ending 0005 · exp 06/29"). Usa Edit payment details se deve essere aggiornata.
3. Fai clic su Top up $–.––. In caso di esito positivo vedrai "Top-up successful. Your balance has been credited." Le ricariche compaiono immediatamente nel saldo.

Consigliato: nella scheda Auto top-up, attiva Enable auto top-up, imposta When balance is below e Top up by (anche in questo caso minimo $10) e fai clic su Save changes. La tua carta verrà quindi addebitata automaticamente ogni volta che il saldo scende sotto la soglia, così l'inferenza non si interrompe mai inaspettatamente. Per i dettagli vedi Budget e ricariche.

Passaggio 3: invia la tua prima richiesta

Scegli il percorso adatto al tuo caso:

Se hai AI Agents o Workflows

Non c'è nulla da configurare: i dispositivi Agente AI associati a questa struttura si connettono automaticamente e anche i Workflows possono connettersi. Apri Settings (ingranaggio) → Service Access & API Keys e verifica che il tuo agente compaia in Connected Services con stato Online. Vedi Connected Services.

Se stai connettendo il tuo software

1. Apri Settings (ingranaggio) → Service Access & API Keys e fai clic su Create key. Copia il segreto dalla finestra di dialogo "Copy your API key": "This is the only time the full key is shown. Store it somewhere safe."
2. Usa il Base URL e la richiesta di esempio mostrati nella scheda Connecting to the API nella stessa pagina. Un test minimo:

curl https://app.performancehub.co/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'

Vedi Connettere la tua applicazione per esempi in Python e TypeScript.

Passaggio 4: verifica

Apri la scheda Logs. La tua richiesta di prova dovrebbe comparire in pochi istanti, con il modello, il conteggio dei token, il costo, la velocità e lo stato success. In caso contrario, vedi Risoluzione dei problemi.

Passaggi successivi consigliati

• Imposta limiti di spesa: Budgets & Limits → Spend Limits. Un tetto mensile è una rete di sicurezza sensata; vedi Budget e ricariche.
• Esamina il catalogo dei modelli: Settings → Models. Tutti i modelli sono attivati per impostazione predefinita; usa i preset rapidi per restringere la selezione se hai preferenze riguardo a fornitori o budget. Vedi Models.
• Valuta i guardrail: Settings → Guardrails per il mascheramento dei dati personali, l'oscuramento dei segreti e la protezione dalla prompt injection. Nessuno è attivato per impostazione predefinita. Vedi Guardrails.