Consulta i connettori supportati per Application Integration.

Creare integrazioni con Gemini Code Assist

Gemini Code Assist è un collaboratore basato sull'AI in Google Cloud che fornisce assistenza a utenti di tutti i livelli di competenza dove ne hanno bisogno. In Application Integration, Gemini Code Assist può aiutarti a:

• Creare integrazioni
• Configurare le attività del connettore in un'integrazione
• Configurare le attività di chiamata API REST in un'integrazione
• Aggiungere condizioni di confine e altre attività a un'integrazione
• Configurare le attività JavaScript
• Genera descrizione dell'integrazione

Per informazioni dettagliate su Gemini for Google Cloud, consulta la panoramica di Gemini for Google Cloud.

Prima di iniziare

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.
   

   Vai ad Application Integration

   L'immagine seguente mostra la pagina di Application Integration:

   

   1. Nella sezione Utilizza l'AI per creare le tue integrazioni, fai clic su Esplora.
   2. Nel riquadro Gemini in Application Integration visualizzato, fai clic su Abilita servizio per attivare l'API Gemini for Google Cloud.

      Per informazioni sull'attivazione di Gemini Code Assist in un progetto Google Cloud, consulta Configurare Gemini Code Assist per un progetto.

2. Configura Application Integration nel tuo progetto Google Cloud. Per ulteriori informazioni, vedi Configurare l'integrazione delle applicazioni.
3. Se prevedi di creare un'integrazione utilizzando i connettori, assicurati di configurare le connessioni desiderate nel tuo progetto Google Cloud.
4. Se prevedi di creare un'integrazione utilizzando le API di Apigee API Hub in un progetto host, assicurati di aver eseguito il provisioning dell'hub API nel tuo progetto e che l'account di servizio Application Integration abbia il ruolo richiesto per accedere alle API nell'altro progetto.

Nota: Gemini fornisce consigli o suggerimenti per le tue integrazioni in base ai connettori e all'hub API utilizzando le connessioni configurate in Connettori di integrazione e le API in Apigee API Hub. Se non hai configurato connessioni o API nel tuo progetto, Gemini potrebbe non fornire consigli o suggerimenti basati su connettori e API.

Ruoli obbligatori

• Per ottenere le autorizzazioni necessarie per utilizzare Gemini, chiedi all'amministratore di concederti il ruolo IAM Utente Gemini for Google Cloud (roles/cloudaicompanion.user) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

  Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

• Se prevedi di creare un'integrazione con Apigee API Hub, assicurati di disporre del ruolo Visualizzatore di Cloud API Hub (roles/apigeeregistry.viewer) nel progetto che contiene le API.
• Se prevedi di creare un'integrazione con Integration Connectors, assicurati di disporre del ruolo Visualizzatore connettori (roles/connectors.viewer) nel progetto.

Attività e trigger supportati

Gemini può aiutarti ad aggiungere le seguenti attività e attivatori:

Trigger

Tasks

Attivazione API Trigger Cloud Pub/Sub Trigger Salesforce Jira Cloud ServiceNow Zendesk Attivazione Cloud Scheduler

Attività di Data Mapper Attività di approvazione Sospendi attività Attività JavaScript Funzioni Cloud Run Attività timer Restituire un'attività Attività Invia email Attività dei connettori Attività di chiamata endpoint REST Document AI - Attività di elaborazione Gemini ti aiuta anche a creare le seguenti attività di flusso di controllo, ma non può generare sottointegrazioni: Attività per ogni loop Attività per singola parallela Attività durante il loop Attività di integrazione chiamate

Creare un'integrazione

Gemini ti aiuta a creare e sviluppare integrazioni utilizzando come input le tue frasi in linguaggio naturale (o prompt). In questo modo puoi creare e sviluppare integrazioni da semplici a complesse rapidamente e con configurazioni manuali minime.

Fornisci a Gemini un breve prompt o una descrizione del flusso di integrazione che intendi creare e Gemini suggerirà uno o più flussi di integrazione per aiutarti a iniziare.

Per creare un'integrazione utilizzando Gemini:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Fai clic su spark Aiutami a creare. Viene visualizzato il riquadro Crea integrazione con Gemini.

   In alternativa, nella pagina Crea integrazione, crea una nuova integrazione e poi nell'editor di integrazione fai clic su pen_spark Crea flussi di integrazione con Gemini per utilizzare Gemini.



1. Se vuoi selezionare un modello di prompt, scegline uno tra i Modelli di prompt di esempio. In caso contrario, inserisci un prompt per consentire a Gemini di generare le integrazioni. Per scoprire come scrivere prompt migliori, consulta Scrivere prompt migliori.

   Ad esempio, supponiamo che tu abbia aggiunto il seguente prompt: Crea un'integrazione che recuperi un problema JIRA e poi crei il ticket Zendesk.

2. Fai clic su Genera.
   Nota: Gemini suggerisce uno o più flussi di integrazione che soddisfano il tuo prompt:

   • Se hai attivato API Hub e Integration Connectors e hai soddisfatto tutti i prerequisiti, i consigli conterranno le attività Endpoint REST di chiamata e Connettori.
   • Se nella tua integrazione è presente un requisito di mappatura dei dati, Gemini può anche suggerire un'attività di mappatura dei dati. Quando confermi la richiesta, l'attività di mappatura dei dati viene sostituita da un'attività JavaScript.

   Il seguente diagramma mostra il riquadro Crea un'integrazione con Gemini con i suggerimenti forniti da Gemini:

   

   Utilizza i pulsanti Precedente e Avanti per visualizzare i suggerimenti forniti.

3. Se vuoi modificare il nome dell'integrazione suggerito, puoi aggiornare il campo Nome integrazione.
   Nota: il nome dell'integrazione deve essere univoco nel progetto Google Cloud.
4. Seleziona una regione per l'integrazione. Se il progetto ha una sola regione di provisioning, il campo Regione è impostato su questa regione.
   Nota: l'elenco Regione mostra le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
5. Se vuoi modificare il prompt, fai clic su Modifica prompt.
6. Per accettare un suggerimento per il flusso di integrazione, fai clic su Conferma. Application Integration mostra l'avanzamento dei passaggi per la creazione dell'integrazione. Le integrazioni create utilizzando Gemini sostituiscono eventuali elementi e variabili di integrazione esistenti.

   

Consigli contestuali

Puoi utilizzare Gemini per fornire consigli contestuali per le tue integrazioni esistenti. Gemini può aiutarti a fornire consigli per la configurazione dei connettori appropriati al contesto in base al flusso logico dell'integrazione esistente. Se un collegamento nell'integrazione ha più di 1000 entità, il connettore non è incluso nei consigli di Gemini. Per altre limitazioni, vedi Limitazioni.

Configura le attività del connettore

Gemini può aiutarti a fornire consigli per la configurazione dei connettori appropriati al contesto in base al flusso logico dell'integrazione esistente. Se un collegamento nell'integrazione ha più di 1000 entità, il connettore non è incluso nei consigli di Gemini. Per altre limitazioni, vedi Limitazioni.

Puoi configurare il connettore con le sostituzioni consigliate da Gemini oppure interagire con Gemini (utilizzando i prompt) e chiedere i suggerimenti di configurazione che ti interessano.

Per configurare un'attività del connettore nell'integrazione utilizzando Gemini, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente per aprirla nell'editor integrazioni.
4. Nella barra di navigazione, fai clic sul pulsante di attivazione/disattivazione Nuova visualizzazione della tela (anteprima) in modo che sia attiva. Poi, utilizza la tela per creare il flusso di lavoro di integrazione.
5. Per un'attività del connettore, fai clic su Altre azioni e poi su Configura attività.

   Viene visualizzato un menu popup, simile all'immagine seguente, che mostra una serie di consigli di Gemini.

   Nota: Gemini può consigliare l'attività dei connettori per le attività di chiamata endpoint REST e viceversa.

   

6. Gemini consiglia automaticamente uno o più sostituti o alternative pertinenti al flusso logico dell'integrazione. Puoi utilizzare l'input del prompt per interagire con Gemini e perfezionare o rigenerare i consigli suggeriti, se vuoi.

7. Seleziona una delle sostituzioni o modifiche consigliate da accettare. Gemini configura l'attività del connettore selezionata.

Configura le attività di chiamata dell'API REST

Se nel tuo progetto hai attivato API Hub, Gemini in Application Integration può aiutarti a fornire attività di chiamata endpoint REST appropriate al contesto e consigli di configurazione delle attività in base al flusso logico della tua integrazione esistente. Puoi utilizzare questi consigli per sostituire direttamente le attività esistenti o modificarle senza dover seguire una procedura di configurazione manuale.

Puoi sostituire direttamente un'attività esistente o una configurazione di attività con le sostituzioni consigliate da Gemini oppure puoi interagire con Gemini (utilizzando i prompt) e chiedere i suggerimenti per le attività che ti interessano.

Dopo aver soddisfatto tutti i prerequisiti, per sostituire o modificare un'attività esistente nell'integrazione utilizzando Gemini, svolgi i seguenti passaggi:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente per aprirla nell'editor integrazioni.
4. Nella barra di navigazione, fai clic sul pulsante di attivazione/disattivazione Nuova visualizzazione della tela (anteprima) in modo che sia attiva. Poi, utilizza la tela per creare il flusso di lavoro di integrazione.
5. Nel riquadro dell'editor di integrazione, seleziona l'attività da sostituire o modificare.
6. Fai clic su Altre azioni e poi su Configura attività.

   Viene visualizzato un menu popup, simile all'immagine seguente, che mostra una serie di consigli di Gemini.

   Nota: Gemini può consigliare l'attività dei connettori per le attività di chiamata endpoint REST e viceversa.

   

7. Gemini consiglia automaticamente uno o più sostituti o alternative pertinenti al flusso logico dell'integrazione. Puoi utilizzare l'input del prompt per interagire con Gemini e perfezionare o rigenerare i consigli suggeriti, se vuoi.

8. Seleziona una delle sostituzioni o delle modifiche consigliate da accettare.

   Gemini sostituisce direttamente l'attività selezionata o la modifica senza configurazioni aggiuntive.

Aggiungi condizioni di confine e accoda altre attività

Puoi utilizzare Gemini per aggiungere nuove attività e condizioni di confine al flusso di integrazione esistente.

Per aggiungere una condizione di confine o per aggiungere nuove attività all'integrazione utilizzando Gemini, segui questi passaggi:

1. In Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente per aprirla nell'editor integrazioni.
4. Nella barra di navigazione, fai clic sul pulsante di attivazione/disattivazione Nuova visualizzazione della tela (anteprima) in modo che sia attiva. Poi, utilizza la tela per creare il flusso di lavoro di integrazione.
5. Nell'editor di integrazione, seleziona l'edge a cui vuoi aggiungere la condizione di edge o da cui vuoi aggiungere una nuova attività.
6. Fai clic su Altre azioni e poi su Crea ramo.

   Viene visualizzato un menu popup, simile all'immagine seguente, che ti chiede di fornire un input.

   

7. Inserisci il prompt specificando la condizione di confine che vuoi aggiungere o l'attività aggiuntiva da accodare.

   Ecco un prompt di esempio che puoi utilizzare:

         If order qty>100, send an email

   Per scoprire come scrivere prompt migliori, consulta Scrivere prompt migliori.

8. Fai clic su pen_spark Crea.

Gemini inserisce automaticamente le condizioni di confine qualificate e configura le attività aggiuntive dal confine selezionato nell'integrazione esistente.

9. Fai clic su Conferma per accettare le inserzioni e le aggiunte suggerite.

   Se non ti piacciono le inserzioni o le aggiunte suggerite, fai clic su Annulla .

Configurare le attività JavaScript

Puoi utilizzare Gemini per configurare le attività JavaScript nell'integrazione. Gemini può aiutarti a fornire consigli per la configurazione delle attività JavaScript appropriati al contesto in base al flusso logico dell'integrazione esistente. Puoi utilizzare questi consigli per sostituire direttamente le attività esistenti o modificarle senza dover seguire una procedura di configurazione manuale.

Aggiungere un'attività JavaScript

L'attività JavaScript ti consente di scrivere snippet di codice JavaScript personalizzati per l'integrazione. Per aggiungere gli snippet di codice utilizzando Gemini:

1. In Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Crea un'integrazione o selezionane una esistente per aprirla nell'editor dell'integrazione.
4. Fai clic e posiziona l'elemento JavaScript nell'editor di integrazione.
5. Fai clic sull'elemento JavaScript nella canvas per visualizzare il riquadro di configurazione dell'attività JavaScript.
6. Fai clic su spark Script con Gemini. Si apre il riquadro Script con Gemini. Poi:
   1. Se vuoi selezionare un modello di prompt, scegline uno tra i Modelli di prompt di esempio. In caso contrario, inserisci un prompt per consentire a Gemini di generare il codice JavaScript. Per scoprire come scrivere prompt migliori, consulta Scrivere prompt migliori.

      Supponiamo che tu voglia elaborare un ordine di un cliente. L'integrazione contiene le variabili customer e item. Per creare un ordine, puoi inserire un prompt simile al seguente:

      Create order using customer and items.
      

      

   2. Fai clic su Genera.

      Gemini suggerisce uno o più snippet di codice che soddisfano i requisiti del prompt. Utilizza i pulsanti Precedente e Avanti per visualizzare i suggerimenti forniti.

   3. Per aggiungere lo snippet di codice suggerito all'attività JavaScript, fai clic su Conferma. Lo snippet di codice viene visualizzato nel campo Editor JavaScript.

Modificare un'attività JavaScript

L'attività JavaScript ti consente di scrivere snippet di codice JavaScript personalizzati per l'integrazione. Per aggiungere gli snippet di codice utilizzando Gemini:

1. In Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione che contiene l'attività JavaScript.
4. Fai clic e posiziona l'elemento JavaScript nell'editor di integrazione.
5. Fai clic sull'elemento JavaScript nella canvas per visualizzare il riquadro di configurazione dell'attività JavaScript.
6. Fai clic su Apri editor di script. Viene visualizzata la pagina Editor di attività JavaScript.
7. Fai clic su spark Utilizza Gemini per modificare e comprendere lo script > Modifica script. Viene visualizzato il riquadro Modifica script con Gemini. Poi:
   1. Se vuoi selezionare un modello di prompt, scegline uno tra i Modelli di prompt di esempio. In caso contrario, inserisci un prompt per consentire a Gemini di generare codice JavaScript. Per scoprire come scrivere prompt migliori, consulta Scrivere prompt migliori.

      Supponiamo che tu voglia eseguire il log nell'ordine quando il costo dell'ordine è superiore a 100. Dopodiché, puoi inserire un prompt simile al seguente:

            Log in the order when the cost is greater than 100.
            

      

   2. Fai clic su Genera.

      Gemini suggerisce uno o più snippet di codice che soddisfano i requisiti del prompt. Utilizza i pulsanti Precedente e Avanti per visualizzare i suggerimenti forniti.

   3. Per aggiungere gli aggiornamenti suggeriti allo snippet di codice nell'attività JavaScript, fai clic su Conferma. Lo snippet di codice aggiornato viene visualizzato nel campo Editor JavaScript.

Informazioni sull'attività JavaScript

Gemini può aiutarti a comprendere lo snippet di codice nell'attività JavaScript. Per farlo, segui questi passaggi:

1. Nell'integrazione, fai clic sull'elemento JavaScript nel riquadro per visualizzare il riquadro di configurazione dell'attività JavaScript.
2. Nel riquadro di configurazione dell'attività, fai clic su Apri editor di script. Viene visualizzato il riquadro Editor di script. Poi:
   1. Fai clic su spark > info_spark Aiutami a capire.

      Se vuoi comprendere una parte del codice, puoi selezionare la parte dello snippet che ti interessa e fare clic su spark > info_spark Aiutami a capire.

      Viene visualizzato il riquadro Gemini:

      

   2. Nel riquadro Gemini, inserisci un prompt per consentire a Gemini di comprendere lo snippet di codice. Per scoprire come scrivere prompt migliori, consulta Scrivere prompt migliori.

Generare la descrizione dell'integrazione

La funzionalità di descrizione dell'integrazione disponibile in Gemini nell'Application Integration fornisce un riepilogo descrittivo dell'integrazione che hai creato nell'editor integrazioni. Il riepilogo della descrizione dell'integrazione viene generato in linguaggio semplice e può aiutarti a comprendere il caso d'uso complessivo dell'integrazione, l'orchestrazione sottostante e il contesto aziendale, che potrebbero essere difficili da valutare a causa della struttura o della complessità di un'integrazione.

Per generare un riepilogo della descrizione dell'integrazione utilizzando Gemini, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente per aprirla nell'editor integrazioni.
4. Nella barra degli strumenti dell'editor di integrazione, fai clic su (Riepilogo integrazione). Viene visualizzata la pagina dei dettagli dell'integrazione.
5. Nella pagina dei dettagli dell'integrazione, fai clic su Aiutami con la descrizione.

   Gemini analizza l'integrazione nell'editor di integrazione e genera una descrizione di riepilogo dettagliata simile all'immagine seguente.

   

6. Fai clic su Fine per accettare la descrizione dell'integrazione generata.

   Verifica e convalida l'integrazione (incluse le variabili) prima di eseguirla.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Limitazioni

Gemini in Application Integration è soggetto alle seguenti limitazioni:

• Se il collegamento nell'integrazione ha più di 1000 entità, il connettore non è incluso nei consigli di Gemini.
• L'Application Integration supporta la residenza dei dati. Le integrazioni create utilizzando Gemini supportano la residenza dei dati. Non memorizziamo dati quali prompt e risposte di Gemini. Solo i dati in uso e in transito per la generazione utilizzando Gemini non supportano la residenza dei dati.

Invia il tuo feedback

Puoi ricevere assistenza o fornire feedback contestuali durante l'utilizzo di Gemini per creare l'integrazione. Queste informazioni ci aiutano a migliorare Gemini.

Passaggi successivi

• Scopri come scrivere prompt migliori.
• Scopri come testare e pubblicare un'integrazione.
• Scopri in che modo Gemini for Google Cloud utilizza i tuoi dati.
• Scopri di più sulla panoramica di Gemini per Google Cloud.