Prerequisiti e Distribuzione guidata

1. Crea una sottoscrizione Azure dedicata

• Apri Azure Sottoscrizioni e crea una sottoscrizione di proprietà del cliente esclusivamente per RapidClaw. Assegnale un nome chiaro, ad esempio RapidClaw Produzione o RapidClaw Pilot.
• Conferma che la sottoscrizione sia attiva e che tu possa creare risorse Azure e una registrazione applicativa. Chiedi aiuto all'amministratore Azure se necessario.
• La persona che esegue Setup diventa il primo amministratore di Command Center.
• Imposta un avviso di budget sulla sottoscrizione. Prepara un budget mensile e un'email di notifica per Setup. Gli avvisi ti notificano; non bloccano la spesa.

2. Scegli una regione supportata

• Australia East
• East US 2
• South India
• Sweden Central
• West US 3

Utilizza la stessa sottoscrizione e regione per i controlli e le richieste di seguito. Setup verifica la disponibilità reale di VM, rete, modelli e embedding prima della distribuzione.

3. Registra i provider di risorse

Registra prima Microsoft.Compute affinché Setup possa leggere la quota VM. La registrazione richiede il permesso a livello di sottoscrizione /register/action, incluso in Contributor e Owner. Servono comunque i permessi di distribuzione elencati nel passaggio 1.

Portale Azure: Apri la sottoscrizione > Impostazioni > Provider di risorse. Registra i provider mancanti dall'elenco sottostante; salta quelli già registrati.

Alternativa CLI: In Azure Cloud Shell o in una sessione CLI Azure autenticata, sostituisci <subscription-id> con l'ID della tua sottoscrizione RapidClaw:

az provider register --namespace Microsoft.Compute --subscription <subscription-id>
az provider show --namespace Microsoft.Compute --subscription <subscription-id> --query registrationState --output tsv

Ripeti per gli altri provider mancanti, sostituendo Microsoft.Compute con ogni namespace. Attendi Registered prima di proseguire. La registrazione abilita un servizio; non crea risorse runtime né garantisce la quota. Può aggiungere un'applicazione gestita da Microsoft al tuo tenant. Linee guida di registrazione di Microsoft.

4. Controlla la quota della famiglia VM

RapidClaw utilizza una Standard_D2as_v6 VM. La tua regione necessita di almeno 2 vCPU disponibili sia in Standard DASv6 Family vCPUs che in Total Regional vCPUs.

1. Apri la tua sottoscrizione Azure > Utilizzo + quote.
2. Filtra per Compute e per la regione selezionata.
3. Per entrambe le voci di quota, conferma che limite - utilizzo attuale sia almeno 2.
4. Se una delle due è insufficiente, richiedi un aumento o verifica un'altra regione supportata.

Voci di quota mancanti? Controlla la registrazione di Microsoft.Compute, i filtri su sottoscrizione e regione e i tuoi accessi. Quota sufficiente non garantisce la capacità della VM. Guida alla quota vCPU di Microsoft.

5. Richiedi la quota Microsoft Foundry

Non è necessario creare prima un progetto Foundry o una risorsa Azure AI; RapidClaw creerà le proprie durante la distribuzione. La quota dei modelli è separata dalla quota delle VM.

Apri il modulo di richiesta quota di Microsoft.

1. Campi 1-8: inserisci nome, email aziendale, ragione sociale e indirizzo.
2. Campo 9 (Subscription Id): inserisci l'ID della sottoscrizione RapidClaw dedicata, non l'ID del tenant.
3. Campo 10 (Justification): adatta il testo suggerito in basso in base alla tua distribuzione e utilizzo previsto.
4. Campi 11-16: utilizza la tabella sottostante. Se Microsoft cambia la numerazione, corrispondi ai nomi dei campi.

Selezioni consigliate per il modulo

Se Setup segnala una quota di embedding mancante, invia una richiesta separata per text-embedding-3-small: 10 kTPM nella stessa sottoscrizione e regione, utilizzando il tipo di distribuzione richiesto da Setup. In entrambe le richieste, includi anche la quota già allocata ad altri carichi di lavoro per assicurare che ne resti abbastanza per RapidClaw.

Invia la richiesta e attendi la risposta di Microsoft. Se viene offerta un'altra regione o modello, verifica che sia supportata da RapidClaw prima di accettare. Dopo l'approvazione, esegui nuovamente il controllo prerequisiti di Setup nella stessa sottoscrizione e regione.

La quota è un limite di velocità, non consumo prepagato né un tetto di spesa. Azure addebita i token utilizzati. Guida alla quota di Microsoft.

6. Esegui Setup

Una volta superati tutti i controlli dei prerequisiti, la distribuzione richiede normalmente circa 20 minuti. Setup viene eseguito sul server e può recuperare l'avanzamento se aggiorni la pagina o effettui nuovamente l'accesso.

1. Connetti: Effettua l'accesso, crea o recupera la registrazione applicativa, valida il tuo diritto e seleziona la sottoscrizione.
2. Distribuisci: Seleziona la regione, supera i controlli sui prerequisiti, imposta il budget e l'email di allerta, e approvvigiona le risorse Azure.
3. OpenClaw: Installa il runtime extended-stable verificato e i servizi RapidClaw.
4. Agenti: Installa agenti, skill, pianificazioni, policies ed estensione del prodotto.
5. Teams: Pubblica il pacchetto Teams specifico del tenant e verifica la connessione.
6. Command Center: Verifica la salute del runtime e accedi all'esperienza dell'amministratore.

Cosa viene distribuito

Dopo la distribuzione

• Controlla runtime, modelli, connettori, Teams, sottoscrizione, memoria, utilizzo e stato in Command Center.
• Revisiona agenti, skill, policies e i pacchetti agente specifici per prodotto. Lascia le pianificazioni disattivate finché non hai chiaro ambito, strumenti, consegna e approvazioni.
• Monitora la spesa tramite gli avvisi di costo Azure e Usage & Costs in Command Center.

Risoluzione dei problemi nel passaggio Distribuisci

Messaggio di quota famiglia VM

"Standard_D2as_v6 non è disponibile con sufficiente quota di core della famiglia in <regione>."

1. Verifica che Microsoft.Compute sia Registered nella sottoscrizione selezionata in Setup. Un provider non registrato può provocare questo messaggio.
2. Verifica che sia la quota della famiglia VM sia quella regionale totale abbiano almeno 2 vCPU disponibili. Richiedi un aumento se necessario.
3. Se entrambe le quote sono sufficienti, controlla la disponibilità della dimensione VM e l'errore dettagliato di Azure.

Microsoft.Compute non è registrato

Registra Microsoft.Compute nella sottoscrizione indicata da Setup, attendi Registered e riprova. Poi risolvi eventuali errori separati su quota o capacità.

La dimensione della VM non è disponibile nella regione

Scegli un'altra regione supportata dove siano disponibili VM, quota, modelli e embedding. Per mantenere la tua regione originale, segui le linee guida sulla disponibilità SKU di Microsoft. Un aumento di quota da solo non risolve l'indisponibilità di capacità VM.