Configurare le impostazioni degli strumenti per sviluppatori AI

Utilizza la pagina delle impostazioni degli strumenti per sviluppatori AI in Gemini Enterprise per configurare gli strumenti per sviluppatori, applicare i controlli di sicurezza e conformità, attivare o disattivare le funzionalità di Google Antigravity e gestire la disponibilità dei modelli per la tua organizzazione.

Prima di iniziare

Assicurati di disporre di quanto segue:

• Account di fatturazione Cloud mensile non automatica: per utilizzare gli strumenti per sviluppatori AI, la fatturazione Cloud deve essere abilitata nel tuo progetto. Gli strumenti per sviluppatori AI sono disponibili solo per gli account con fatturazione. Per saperne di più, consulta Tipi di account di fatturazione Cloud.

• Versioni supportate: per accedere agli strumenti per sviluppatori AI, gli utenti devono disporre di un abbonamento alla versione Gemini Enterprise Standard, Plus, Standard Emerging Market o Pagamento a consumo.

• Regioni supportate: per ulteriori informazioni sulla disponibilità regionale e sulle limitazioni delle funzionalità, consulta Residenza dei dati per le versioni Gemini Enterprise Standard e Plus e Gemini Notebook.

• Ruoli richiesti: devi disporre del ruolo Gemini Enterprise Admin (roles/discoveryengine.agentspaceAdmin) per configurare le impostazioni degli strumenti per sviluppatori AI.

• API obbligatorie: nel progetto devono essere abilitate le seguenti API:

  • API Discovery Engine (discoveryengine.googleapis.com): fornisce servizi di piattaforma di base, controlli di sicurezza e conformità e gestione delle impostazioni per Gemini Enterprise.

  • API Business AI Code (businessaicode.googleapis.com): fornisce la generazione di codice basata sull'AI per Antigravity in Gemini Enterprise. Devi abilitare questa API nel tuo progetto per consentire alle entità autorizzate di raggiungere il servizio dal tuo progetto.

  Quando attivi l'opzione Strumenti per sviluppatori AI nella console Google Cloud , il sistema controlla la configurazione del progetto e abilita automaticamente queste API richieste, se non l'hai già fatto.

Attivare gli strumenti per sviluppatori AI

La disponibilità degli strumenti per sviluppatori AI dipende dal tipo di abbonamento a Gemini Enterprise:

• Nuovi abbonamenti Standard, Plus o pagamento a consumo: gli strumenti per sviluppatori AI sono attivati per impostazione predefinita nella località in cui hai acquistato l'abbonamento, se sono supportati per quella località o regione.

• Abbonamenti esistenti: un amministratore deve attivare manualmente gli strumenti per sviluppatori AI nella console Google Cloud per ogni località per attivare gli strumenti per gli utenti con licenza.

Per attivare manualmente gli strumenti per sviluppatori AI per un abbonamento Gemini Enterprise esistente, segui questi passaggi:

1. Nella console Google Cloud , vai a Gemini Enterprise.

   Vai a Gemini Enterprise

2. Fai clic su Impostazioni e seleziona la scheda Strumenti per sviluppatori AI.

3. Attiva l'opzione Strumenti per sviluppatori AI.

4. Configura le impostazioni nelle sezioni Sicurezza, Conformità, Funzionalità e Disponibilità del modello.

Configurazione delle impostazioni di sicurezza

In qualità di amministratore, puoi impedire l'esposizione non autorizzata dei dati nelle interfacce per sviluppatori. Utilizza le impostazioni in questa sezione per limitare l'accesso a origini esterne e gestire le autorizzazioni di esecuzione automatica. Ad esempio, puoi applicare policy di sicurezza obbligatorie per impedire agli utenti di ignorare le regole di sicurezza e richiedere l'approvazione prima che gli agenti AI eseguano comandi del terminale o selezionino link.

Gestisci le policy di sicurezza

Puoi configurare le policy di sicurezza per controllare il modo in cui gli agenti AI accedono ai file locali al di fuori delle loro cartelle di lavoro ed eseguono i comandi del terminale negli spazi di lavoro degli sviluppatori.

Gestire l'accesso web esterno

Se la tua norma di sicurezza richiede il controllo dell'accesso dell'agente a siti web esterni per impedire l&#39esfiltrazione di datii, queste impostazioni ti consentono di limitare l'accesso al browser o di limitarlo a un elenco di URL consentiti.

Gestire Model Context Protocol (MCP)

Puoi configurare l'accesso ai server Model Context Protocol (MCP), che consente agli agenti AI di accedere in modo sicuro a strumenti e origini dati aggiuntivi.

{
  "mcpServers": {
    "local_servers": [
      {
        "id": "gopls-mcp-server",
        "command": "go",
        "args": [
          "run",
          "golang.org/x/tools/gopls@latest",
          "mcp"
        ]
      }
    ],
    "remote_servers": [
      {
        "id": "bigquery"
      },
      {
        "id": "custom-remote-server",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }
}

Configurare le impostazioni di conformità

Se la tua organizzazione opera in un settore regolamentato o ha policy interne specifiche, potresti dover conservare gli audit log delle interazioni con l'AI per motivi di conformità. Le impostazioni di questa sezione ti consentono di configurare le policy di logging e conservazione dei dati per soddisfare i requisiti legali e normativi.

Configura le impostazioni delle funzionalità

Alcune funzionalità di Antigravity offrono funzionalità multi-agente avanzate per aiutare gli sviluppatori ad affrontare attività complesse. Poiché queste funzionalità possono aumentare l'utilizzo e i costi dei token, utilizza le impostazioni di questa sezione per controllare l'accesso degli utenti della tua organizzazione. Per accedere alle funzionalità attivate, gli utenti devono utilizzare l'app Antigravity versione 2.18.0 o successive oppure l'interfaccia a riga di comando Antigravity versione 1.2.10 o successive.

Per attivare o disattivare una funzionalità, segui questi passaggi:

1. Nella console Google Cloud , vai a Gemini Enterprise.

   Gemini Enterprise

2. Fai clic su Impostazioni e seleziona la scheda Strumenti di sviluppo dell'AI.

3. Nella sezione Funzionalità, fai clic su Modifica.

4. Attiva o disattiva l'opzione per ogni funzionalità.

   Impostazione	Descrizione	Stato predefinito
   Comando /boost	Attiva questa impostazione per consentire agli utenti di eseguire una gerarchia di multi-agenti a più livelli per risolvere problemi algoritmici complessi e attività di debug approfondite. Per saperne di più, consulta Potenzia il deep reasoning.	Abilitato
   Comando /teamwork-preview	Attiva questa impostazione per consentire agli utenti di eseguire il deployment di un framework coordinato di subagenti autonomi per eseguire progetti su larga scala e a lungo termine (anteprima). Per saperne di più, consulta Team di agenti Teamwork.	Abilitato

5. Fai clic su Salva.

Configura la disponibilità del modello

Utilizza le impostazioni di questa sezione per autorizzare modelli di AI specifici e gestire i livelli di accesso. In questo modo, gli sviluppatori utilizzano solo modelli di AI conformi alle norme di sicurezza e di utilizzo della tua organizzazione. Ad esempio, puoi concedere agli sviluppatori l'accesso ai modelli di anteprima per gli esperimenti o limitare l'utilizzo degli strumenti solo ai modelli autorizzati.

Considerazioni principali prima di configurare i modelli

Prima di configurare i modelli, tieni presente quanto segue:

• Allineamento delle policy: l'attivazione di un modello in Gemini Enterprise non sostituisce le policy dell'organizzazione di Gemini Enterprise Agent Platform. Per evitare che le richieste con pagamento a consumo che superano la quota standard non vadano a buon fine, assicurati che i modelli consentiti corrispondano su entrambe le piattaforme.

• Residenza dei dati: i modelli in anteprima e il modello Gemini 3 Pro Image sono disponibili solo nella regione global. Pertanto, non supportano gli impegni di elaborazione regionale di residenza dei dati (DRZ) o machine learning (ML) nelle multiregioni USA o UE.

• Inferenza dei modelli di terze parti e gestione dei dati: i modelli di terze parti sono disponibili solo dopo che un amministratore li ha attivati e ha accettato i termini del provider. Quando uno sviluppatore seleziona un modello di terze parti abilitato, Gemini Enterprise invia il prompt e il contesto del codice necessario per la richiesta al modello, con la stessa elaborazione e le stesse protezioni dei modelli Gemini. I prompt e le risposte non vengono utilizzati per addestrare i modelli. L'inferenza di modelli di terze parti è disponibile nelle località global, us e eu. Le regioni all'interno di un paese non sono supportate. Per visualizzare l'elenco dei paesi e delle regioni che possono accedere al modello, consulta Paesi e regioni supportati di Anthropic. Per saperne di più sulla residenza dei dati, consulta Residenza dei dati per Gemini Enterprise versioni Standard e Plus e Gemini Notebook.

• Esecuzione ibrida e informative sulla fatturazione: i modelli Gemini utilizzano i crediti dei posti delle edizioni in pool della tua organizzazione, mentre i modelli di terze parti abilitati dall'amministratore vengono fatturati come utilizzo con pagamento a consumo sul tuo account di fatturazione Cloud. Quando uno sviluppatore seleziona un modello di terze parti abilitato (ad esempio Anthropic Claude Opus 5.5 o Anthropic Claude Sonnet 5.5) per le attività principali di ragionamento, pianificazione, orchestrazione degli strumenti e generazione di codice, Antigravity continua a utilizzare modelli Gemini leggeri in background per il coordinamento lato client, ad esempio la gestione del contesto e i riepiloghi, e Gemini 3 Pro Image per la generazione di immagini. L'utilizzo di questi modelli può comportare dei costi. Per saperne di più, consulta Quote e superamenti e Monitorare l'utilizzo dei token del modello di terze parti.

Configura i modelli autorizzati

Puoi configurare i modelli autorizzati per controllare quali modelli di AI sono disponibili per i tuoi strumenti per sviluppatori AI.

L'impostazione Modelli autorizzati Antigravity funziona come una lista consentita:

• Selezione predefinita (vuoto): quando il campo è vuoto, sono consentiti tutti i modelli Gemini supportati. I modelli Google appena rilasciati diventano automaticamente disponibili per gli utenti con licenza.
• Elenco di modelli personalizzati: quando selezioni uno o più modelli specifici, sono consentiti solo i modelli selezionati. I modelli non selezionati e quelli appena rilasciati non sono disponibili per gli sviluppatori finché un amministratore non li seleziona manualmente.

Per configurare i modelli autorizzati:

1. Nella console Google Cloud , vai a Gemini Enterprise.

   Vai a Gemini Enterprise

2. Fai clic su Impostazioni e poi seleziona la scheda Strumenti per sviluppatori di AI.

3. Nella sezione Disponibilità del modello, fai clic su Modifica.

4. Nel campo Modelli autorizzati Antigravity, seleziona i modelli che vuoi consentire. Per consentire tutti i modelli supportati, lascia vuoto il campo.

5. Fai clic su Salva.

Modelli supportati

Gli strumenti per sviluppatori AI (app Antigravity, Antigravity CLI e Antigravity per IDE) supportano i seguenti modelli Gemini e modelli partner. Un utente con licenza è uno sviluppatore a cui è stata assegnata una licenza utente Gemini Enterprise attiva (Standard, Plus o Pay-as-you-go). Per saperne di più, consulta Gestisci le licenze.

Per informazioni sulle quote e sui crediti delle versioni in pool, consulta Quote e superamenti e Configura i superamenti. Per i prezzi dei modelli di terze parti, consulta gli SKU di fatturazione Cloud per Anthropic Claude Opus 5.5 e Anthropic Claude Sonnet 5.5.

Livello di ragionamento per i modelli di terze parti

Gli sviluppatori possono utilizzare Anthropic Claude Opus 5.5 e Anthropic Claude Sonnet 5.5 con un livello di ragionamento Basso, Medio, Alto o Massimo. Ogni livello viene visualizzato come una voce separata nel menu dei modelli, ad esempio Anthropic Claude Opus 5.5 (Alto). Medio è l'impostazione predefinita. Quando attivi un modello di terze parti, tutti i suoi livelli di ragionamento sono disponibili per gli sviluppatori. Non puoi limitare i singoli livelli di ragionamento.

Attiva o disattiva i modelli di terze parti

I modelli di terze parti vengono fatturati in base all'utilizzo con pagamento a consumo e richiedono eccedenze. Prima di attivare un modello di terze parti, attiva gli addebiti per superamento. Se i costi aggiuntivi vengono disattivati in un secondo momento, gli sviluppatori non possono utilizzare modelli di terze parti finché non vengono riattivati. Per controllare i costi, puoi impostare un limite di spesa mensile per il tuo progetto. Il limite si applica a tutti i modelli, inclusi quelli di terze parti.

Per attivare o gestire modelli di terze parti (come Anthropic Claude Opus 5.5 e Anthropic Claude Sonnet 5.5) nella console Google Cloud :

1. Nella console Google Cloud , vai a Gemini Enterprise.

   Vai a Gemini Enterprise

2. Fai clic su Impostazioni, quindi seleziona la scheda Strumenti per sviluppatori AI.

3. Nell'impostazione Modelli autorizzati Antigravity, attiva l'opzione per il modello di terze parti che vuoi abilitare.

4. Nella finestra di dialogo incorporata dei Termini di servizio visualizzata, leggi e accetta i termini di terze parti.

Se disattivi un modello di terze parti, gli sviluppatori perderanno l'accesso poco dopo.

Se il fornitore del modello limita l'accesso a un modello di terze parti per la tua organizzazione, gli sviluppatori non possono utilizzarlo. Per risolvere il problema, contatta l'assistenza Google Cloud.

Per istruzioni per gli sviluppatori su come accedere ad Antigravity e selezionare i modelli, consulta la documentazione di Antigravity Enterprise.

Considerazioni sulla sicurezza per i modelli di terze parti

I modelli di AI, inclusi quelli di terze parti, possono seguire le istruzioni nascoste nei contenuti che elaborano, come file, pagine web o output di strumenti. Questo fenomeno è noto come prompt injection. Antigravity fornisce le seguenti protezioni quando gli sviluppatori utilizzano modelli di terze parti:

• Attivazione da parte dell'amministratore:i modelli di terze parti sono disattivati per impostazione predefinita. Gli sviluppatori possono utilizzare un modello di terze parti solo dopo che un amministratore lo ha abilitato.
• Protezioni di sicurezza del fornitore:i modelli di terze parti includono le protezioni di sicurezza integrate del fornitore. Per saperne di più, consulta Sicurezza di Claude.
• Le tue policy di sicurezza: le policy di sicurezza e le impostazioni di accesso web esterno che configuri si applicano agli agenti indipendentemente dal modello selezionato da uno sviluppatore.

Best practice

• Abilita solo i modelli di terze parti necessari agli sviluppatori.
• Imposta Modalità di esecuzione automatica del terminale su Richiedi revisione o Procedi nella sandbox, in modo che gli sviluppatori approvino i comandi prima che vengano eseguiti.
• Mantieni l'opzione Al di fuori della policy di accesso ai file impostata su Nega.
• Attiva l'accesso al browser e limita gli agenti a un elenco di URL consentiti.
• Attiva la modalità sandbox per i progetti che utilizzano codice, dipendenze o contenuti web non attendibili.
• Incoraggia gli sviluppatori a esaminare i comandi e le modifiche al codice proposti dagli agenti prima di approvarli.
• Imposta un limite di spesa mensile per il tuo progetto.

Passaggi successivi

• Monitorare l'utilizzo dei token del modello di terze parti
• Visualizzare le metriche degli strumenti per sviluppatori di AI
• Crea ruoli personalizzati per gli strumenti per sviluppatori AI
• Disattivare gli strumenti per sviluppatori AI