Gestire le azioni

Puoi aggiungere azioni durante la creazione del datastore o in un secondo momento. Questa pagina fornisce i passaggi per aggiungere nuove azioni dopo la creazione del datastore e gestire l'elenco delle azioni.

Aggiungi azioni

Console

Per aggiungere nuove azioni al datastore:

1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona un datastore a tua scelta.

4. Dal menu di navigazione, seleziona Azioni.

5. Nella pagina Azioni:

   1. Se non sono state aggiunte azioni durante la creazione del datastore, fai clic su Attiva azioni. Poi, nella pagina Attiva azioni , per aggiungere nuove azioni:
      • Per un datastore federato:
        1. Seleziona le azioni dall'elenco.
        2. Fai clic su Attiva azioni.
      • Per un datastore di importazione:
        1. Espandi la sezione Impostazioni di autenticazione e fornisci i dettagli di autenticazione.
           1. Fai clic su Accedi e accedi al datastore per verificare il tuo account.
           2. Fai clic su Continua.
        2. (Facoltativo) Espandi le Impostazioni avanzate e fornisci i dettagli necessari.
        3. Seleziona le azioni da attivare.
        4. Fai clic su Attiva azioni.
   2. Per aggiungere altre azioni all'elenco esistente:
      1. Seleziona le azioni dall'elenco.
      2. Fai clic su Attiva azioni.

6. Per eseguire una nuova autenticazione utilizzando credenziali diverse da quelle utilizzate per la creazione del datastore:

   1. Fai clic su Esegui una nuova autenticazione nella pagina Azioni.
   2. Fornisci i dettagli di autenticazione.
   3. Fai clic su Accedi per autorizzare Gemini Enterprise ad accedere al datastore.
   4. Fai clic su Aggiorna per aggiornare i nuovi dettagli di autenticazione.

7. Per visualizzare o modificare i parametri del datastore per le azioni:

   1. Fai clic su Visualizza/Modifica parametri per modificare i dettagli specifici del connettore. Ad esempio, per Microsoft Outlook, SharePoint, OneDrive, fornisci l'ID tenant.
   2. Fai clic su Salva per aggiornare i dettagli dei parametri.

Visualizza azioni

Console

Per visualizzare l'elenco delle azioni per un datastore:

1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona il datastore a tua scelta.

4. Dal menu di navigazione, seleziona Azioni. Le azioni che hai attivato durante la creazione del datastore vengono visualizzate come tabella nella pagina Azioni.

Disabilita azioni

Console

Per disabilitare le azioni:

1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona il datastore a tua scelta.

4. Seleziona Azioni dal menu di navigazione.

5. Seleziona le azioni da disabilitare dalla tabella.

6. Fai clic su Disabilita azioni.

Gestisci azioni personalizzate

Anteprima privata: la funzionalità delle azioni personalizzate è in anteprima privata. Per utilizzare questa funzionalità, devi essere nella lista consentita. Per essere aggiunto alla lista consentita, contatta il tuo team dedicato all'account o il team di vendita.

Gemini Enterprise supporta campi ed entità personalizzati per consentire la ricerca e le azioni avanzate nei datastore. Dopo aver creato un datastore, puoi recuperare le operazioni disponibili dall'origine dati e selezionare quelle da esporre come azioni. Per ottimizzare le prestazioni, puoi anche perfezionare le descrizioni di ogni azione e dei relativi campi per il modello di AI.

Puoi utilizzare queste azioni personalizzate in aggiunta alle azioni predefinite fornite da Gemini Enterprise. Per visualizzare le azioni offerte per impostazione predefinita, vedi Azioni supportate.

Puoi configurare campi e azioni personalizzati nei seguenti modi:

• Entità personalizzate: genera azioni personalizzate dalle entità personalizzate definite nel datastore e perfeziona le descrizioni di azioni e campi.
• Campi personalizzati: modifica le azioni standard esistenti descrivendo come devono essere compilati i campi personalizzati.

Prima di iniziare

Prima di tentare di ricaricare le azioni nella Google Cloud console, assicurati che le entità e le operazioni personalizzate siano configurate ed esposte dalle origini dati di terze parti remote.

Configura azioni personalizzate in base a entità personalizzate

Puoi generare automaticamente un nuovo set di azioni personalizzate in base alle entità personalizzate definite nel datastore connesso.

Per generare e attivare azioni personalizzate:

1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona un datastore.

4. Nel menu di navigazione, fai clic su Azioni.

5. Nella pagina Azioni, fai clic su Ricarica azioni personalizzate per generare l'elenco delle azioni.

   Nota: la prima volta che esegui questa azione, potrebbe esserti chiesto di completare un flusso di consenso OAuth. In questo modo, vengono concesse le autorizzazioni necessarie per recuperare l'elenco delle azioni personalizzate disponibili per il tuo account amministratore.

6. Esamina le azioni personalizzate rilevate automaticamente nell'elenco delle azioni. Per impostazione predefinita, tutte le azioni appena generate sono contrassegnate come Disattivate.

7. Seleziona le azioni personalizzate che vuoi rendere disponibili.

   Nota: puoi selezionare e attivare fino a 100 azioni.

8. Fai clic su Attiva azioni. Lo stato è contrassegnato come Attivato per le azioni selezionate.

9. Fai clic su Salva.

10. (Facoltativo) Per migliorare l'esperienza utente, arricchisci le descrizioni di azioni e campi nella specifica:

    1. Nella pagina Azioni, seleziona un'azione di cui vuoi modificare la specifica.
    2. Fai clic su Scarica specifica per scaricare il file JSON della specifica.
    3. Apri il file JSON scaricato in un editor di testo e modifica le descrizioni e i tipi di dati in inputSchema. Ad esempio, puoi aggiungere un'istruzione come "Imposta sempre il valore predefinito su 10" alla descrizione di un parametro.
    4. Nella Google Cloud console, fai clic su Carica specifica per caricare il file JSON aggiornato. Il file di specifica viene convalidato per verificare la presenza di errori di sintassi di base.
    5. Fai clic su Salva.

Configura campi personalizzati per azioni standard

Per alcuni datastore, le azioni standard vengono fornite automaticamente e il supporto dei campi personalizzati è attivato per impostazione predefinita durante la creazione del datastore. Tuttavia, puoi definire in modo esplicito come il modello deve gestire campi personalizzati specifici modificando la specifica dello strumento.

Per aggiornare un'azione standard con definizioni di campi personalizzati:

1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Seleziona un datastore.

4. Nel menu di navigazione, fai clic su Azioni.

5. Fai clic su Gestisci specifica.

6. Seleziona lo strumento o l'azione standard che vuoi aggiornare.

7. Fai clic su Scarica specifica per scaricare il file JSON della specifica.

8. Apri il file JSON scaricato in un editor di testo e aggiungi le definizioni, le descrizioni e i tipi di dati dei campi personalizzati a inputSchema.

9. Nella Google Cloud console, fai clic su Carica specifica per caricare il file JSON aggiornato. Il file di specifica viene convalidato per verificare la presenza di errori di sintassi di base.

10. Fai clic su Salva.

Limitazioni

Se il token di aggiornamento scade, l'attivazione delle azioni personalizzate potrebbe non riuscire con un errore oppure le azioni potrebbero non essere visualizzate come attivate. Per risolvere il problema, ricarica la pagina Azioni o autorizza di nuovo l'app connessa per aggiornare il token.