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à e gestire la disponibilità dei modelli per la tua organizzazione.

Prima di iniziare

Assicurati di avere quanto segue:

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

  • Versioni supportate: per accedere agli strumenti per sviluppatori AI, gli utenti devono avere un abbonamento alla versione Gemini Enterprise Standard, Plus o con pagamento a consumo di Gemini Enterprise.

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

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

    • API Gemini Enterprise (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 Google Cloud console, il sistema controlla la configurazione del progetto e abilita automaticamente queste API richieste, se non le hai già abilitate.

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 con pagamento a consumo: gli strumenti per sviluppatori AI sono abilitati per impostazione predefinita nella località in cui hai acquistato l'abbonamento, se sono supportati per quella località o regione.

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

Per abilitare manualmente gli strumenti per sviluppatori AI per un abbonamento Gemini Enterprise esistente:

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

    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à e Disponibilità del modello.

Configurare le 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.

Gestire 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 cartelle di lavoro ed eseguono i comandi del terminale negli spazi di lavoro per sviluppatori.

Impostazione Descrizione Stato predefinito
Al di fuori della policy di accesso ai file Specifica il livello di autorizzazione dell'agente per l'accesso ai file al di fuori di delle cartelle di lavoro designate. Sono disponibili le seguenti opzioni:
  • Nega: impedisce all'agente di accedere ai file al di fuori delle cartelle di lavoro.
  • Chiedi sempre: chiede all'utente l'autorizzazione prima che l' agente acceda ai file al di fuori delle cartelle di lavoro.
  • Consenti: consente all'agente di accedere ai file al di fuori delle sue cartelle di lavoro senza chiedere l'autorizzazione.
 Nega
Modalità di esecuzione automatica del terminale Attiva questa impostazione per consentire agli agenti di eseguire automaticamente i comandi del terminale per semplificare i workflow in più passaggi. Sono disponibili le seguenti opzioni:
  • Richiedi revisione: chiede all'utente l'approvazione prima di eseguire qualsiasi comando del terminale.
  • Procedi in sandbox: esegue automaticamente i comandi in un ambiente sicuro e isolato.
  • Procedi sempre: esegue automaticamente i comandi nell'ambiente corrente senza chiedere l'autorizzazione.
 Procedi sempre
Modalità sandbox Attiva questa impostazione per limitare gli strumenti dell'agente a una sandbox locale sicura e isolata sandbox. Disabilitato

Gestire l'accesso web esterno

Se la tua policy di sicurezza richiede il controllo dell'accesso degli agenti ai siti web esterni per impedire l'esfiltrazione di dati, queste impostazioni ti consentono di limitare l'accesso al browser o di limitarlo a un elenco di URL consentiti.

Impostazione Descrizione Stato predefinito
Accesso al browser Attiva questa impostazione per controllare l'accesso web esterno. In questo modo viene impedita l'esfiltrazione dei dati e vengono definiti i confini dell'organizzazione. Disabilitato
URL consentiti Specifica un elenco di URL consentiti a cui l'agente può accedere nel browser. Quando è configurato, il sistema blocca tutti gli altri URL.

Questa impostazione si applica solo all'agente del browser Antigravity. Puoi eseguire l'agente del browser in Antigravity digitando il /browser comando nella casella di chat.

 Nessuno. Per impostazione predefinita, nessun URL è bloccato.
Modalità di esecuzione automatica di JavaScript del browser Attiva questa impostazione per consentire agli agenti di eseguire JavaScript per supportare attività avanzate di programmazione e test basate sul web. Sono disponibili le seguenti opzioni:
  • Disabilitato: impedisce all'agente di eseguire JavaScript.
  • Richiedi revisione: chiede all'utente l'approvazione prima che l' agente esegua JavaScript.
  • Consentito: consente all'agente di eseguire automaticamente JavaScript automaticamente.
 Disabilitato

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 ulteriori origini dati e strumenti.

Impostazione Descrizione Stato predefinito
Server MCP Attiva questa impostazione per gestire l'accesso ai server Model Context Protocol (MCP) per estendere in modo sicuro il contesto dei dati dell'AI. Disabilitato
Configurazione server consentita Questa impostazione consente agli amministratori di definire configurazioni server specifiche per l'accesso ai server MCP. Gli amministratori definiscono la lista consentita come oggetto JSON con configurazioni per i server MCP locali e remoti. L'interfaccia utente fornisce la convalida in tempo reale per i seguenti campi:
  • Server MCP locali (local_servers):
    • id (stringa): l'identificatore univoco del server MCP.
    • command (stringa, facoltativa): il comando per eseguire il server MCP locale. Se specificato, sostituisce la configurazione locale dell'utente.
    • args (array di stringhe, facoltativo): gli argomenti passati al comando. Se specificati, sostituiscono la configurazione locale dell'utente.
  • Server MCP remoti (remote_servers):
    • id (stringa): l'identificatore univoco del server MCP.
    • url (stringa, facoltativa): l'URL endpoint del server MCP remoto. Obbligatorio per i server remoti personalizzati e facoltativo per i server remoti preconfigurati.

Configurazione di esempio

{
  "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"
      }
    ]
  }
}
Non configurata

Configurare le impostazioni di conformità

Se la tua organizzazione opera in un settore regolamentato o ha policy interne specifiche, potresti dover mantenere i log di controllo delle interazioni con l'AI per la 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.

Impostazione Descrizione Stato predefinito
Logging di prompt e risposte Attiva questa impostazione per registrare le interazioni tra gli sviluppatori e l'AI per calcolare le metriche di utilizzo e mantenere una traccia di audit per le revisioni di sicurezza Il sistema archivia i log in modo sicuro all'interno del progetto della tua organizzazione e Google non vi accede mai per l'addestramento dei modelli o la revisione umana. Disabilitato
Logging dei metadati Attiva questa impostazione per registrare i metadati del prodotto per aiutarti a monitorare l'utilizzo e l'analisi in tutta l'organizzazione. Il sistema archivia i log in modo sicuro all'interno del progetto della tua organizzazione e Google non vi accede mai ai log per l'addestramento dei modelli o la revisione umana. Disabilitato

Configurare la disponibilità del modello

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

Considerazioni chiave prima di configurare i modelli

Prima di configurare i modelli, tieni presente quanto segue:

  • Allineamento delle policy:l'abilitazione 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 di anteprima e il modello Gemini 3 Pro Image sono disponibili solo nella regione global. Pertanto, non supportano la residenza dei dati (DRZ) o gli impegni di elaborazione regionale di machine learning (ML) nelle multi-regioni Stati Uniti o UE. Per saperne di più, consulta Residenza dei dati per le versioni Gemini Enterprise Standard e Plus e Gemini Notebook.

  • Informative sulla fatturazione:Antigravity utilizza Gemini Flash Lite per le attività in background e Gemini 3 Pro Image per la generazione di immagini. L'utilizzo di questi modelli può comportare addebiti di fatturazione. Per saperne di più, consulta Visualizzare i costi.

Configurare i modelli autorizzati

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

Impostazione Descrizione Stato predefinito
Modelli autorizzati Antigravity Attiva questa impostazione per specificare quali modelli di AI sono autorizzati a utilizzare lo strumento Antigravity all'interno del progetto. Negli strumenti per sviluppatori AI di Gemini Enterprise sono disponibili solo i modelli creati da Google. Per saperne di più sui modelli supportati, consulta la colonna Enterprise nell' elenco dei modelli supportati.