Utilizzo di Google Gemini con IBM App Connect Enterprise

Google Gemini è una famiglia di modelli di intelligenza artificiale multimodale che elaborano tipi di dati come testo, codice, audio, immagini e video.

I passaggi seguenti mostrano come connettersi a un account Google Gemini e configurare un nodo di richiesta Google Gemini utilizzando il rilevamento dei connettori.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso che contenga un nodo " Google " di Gemini Request.
2. Selezionare il nodo Google Gemini Request nel flusso per visualizzare le proprietà del nodo nell'editor.
3. Nella scheda Basic, fare clic su Launch Connector Discovery.
   Viene visualizzato un pannello in cui si specifica il nome del progetto di policy e i dettagli del vault da utilizzare durante la ricerca del connettore.
4. Specificare i dettagli del progetto di policy e del vault da utilizzare durante il rilevamento dei connettori:
   1. Nel campo Progetto di criteri, specificare il progetto di criteri utilizzato per memorizzare i criteri creati durante la ricerca dei connettori.
      In alternativa, è possibile creare un nuovo progetto di criteri facendo clic su Nuovo e specificando il nome del nuovo progetto di criteri. Quindi, fare clic su Fine.
   2. Specificare il vault da utilizzare durante la scoperta del connettore. Per impostazione predefinita, le credenziali utilizzate durante l'individuazione del connettore vengono archiviate in un archivio di directory esterno, ovvero un archivio App Connect Enterprise che può essere utilizzato da qualsiasi server di integrazione. In alternativa, è possibile memorizzare le credenziali in un vault del server di integrazione, che viene creato nella directory di lavoro del server di integrazione e può essere utilizzato solo da quello specifico server di integrazione.
      Per specificare il vault da utilizzare per la memorizzazione delle credenziali, completare i passaggi della sezione Utilizzo della procedura guidata di rilevamento del connettore di uno dei seguenti argomenti:

      • Configurazione di un vault di directory esterno
      • Configurazione di un vault del server di integrazione
   3. Nel campo Chiave del vault, inserire la chiave del vault utilizzata per accedere alle credenziali memorizzate nel vault. La chiave del vault deve essere lunga almeno 8 caratteri.
   4. Opzionale: Per impostazione predefinita, la posizione e la chiave del vault specificate vengono salvate come preferenze nel Toolkit, in modo che i valori siano preimpostati all'avvio di Connector Discovery. Se non si desidera salvare le preferenze, deselezionare Salva nelle preferenze del vault.
5. Fare clic su Launch Discovery per avviare la procedura guidata di rilevamento del connettore Google Gemini.
   Viene visualizzata la finestra Scoperta connettore. Se sono disponibili connessioni (account) a Google Gemini, viene visualizzato un elenco di tali connessioni. Se non ci sono connessioni esistenti, lo stato del connettore Google Gemini viene visualizzato come Not connected.
   • Se sono disponibili una o più connessioni (account) Google Gemini, completare i passaggi seguenti:
     1. Selezionare la connessione (account) che si desidera utilizzare facendo clic su di essa.
     2. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire sull'oggetto. Ad esempio, per recuperare gli elementi da Google Gemini, fare clic su Modelli e poi su Recupera tutti i modelli.
   • Se non ci sono connessioni (account) esistenti, completare i passaggi seguenti:
     1. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire sull'oggetto. Ad esempio, per recuperare i modelli da Google Gemini, fare clic su Modelli e poi su Recupera tutti i modelli.
     2. Fare clic su Connetti per visualizzare un menu da cui selezionare uno dei seguenti tipi di autorizzazione:
        • Fornire le credenziali da utilizzare a App Connect (OAUTH di base)
        • Fornire le credenziali per l'utilizzo di App Connect (API KEY)
     3. Se hai selezionato Fornisci credenziali per App Connect da utilizzare (MTLS) come tipo di autorizzazione, inserisci i seguenti dettagli:
        • Server URL : URL per il server API che effettua le chiamate di runtime.
        • ID client dell'applicazione : L'ID univoco che identifica la vostra applicazione quando richiede l'accesso ai dati e alle API di Google.
        • Application client secret : la chiave segreta che autentica l'applicazione quando richiede l'accesso ai dati e alle API di Google.
        • Token di accesso : Una chiave temporanea che consente all'applicazione di accedere in modo sicuro ai dati o a funzioni specifiche. Viene generato dall'ID client dell'applicazione e dal segreto del client.
        • Token di aggiornamento : Il token di aggiornamento utilizzato per ottenere un nuovo token di accesso quando quello attuale scade. Viene generato dall'ID client dell'applicazione e dal segreto del client.
        • Nome proxy : selezionare o specificare il nome del proxy che si desidera App Connect utilizzare per inoltrare le chiamate del connettore. Questo campo è richiesto solo se le chiamate devono passare attraverso un proxy. Quando si utilizza il Toolkit " IBM App Connect Enterprise ", il nome del proxy deve essere specificato nel formato: {PolicyProjectName}:HTTPProxyPolicyName
     4. Se si è selezionato Fornire le credenziali per l'utilizzo di App Connect (API KEY) come tipo di autorizzazione, inserire i seguenti dettagli:
        • Server URL : URL per il server API che effettua le chiamate di runtime.
        • Chiave API : La chiave API utilizzata per autenticare le richieste all'API di Google Gemini.
        • Nome proxy : selezionare o specificare il nome del proxy che si desidera App Connect utilizzare per inoltrare le chiamate del connettore. Questo campo è richiesto solo se le chiamate devono passare attraverso un proxy. Quando si utilizza il Toolkit " IBM App Connect Enterprise ", il nome del proxy deve essere specificato nel formato: {PolicyProjectName}:HTTPProxyPolicyName
     5. Fare clic su Connetti.

     Per informazioni su come ottenere i dettagli di connessione per Google Gemini, consultare la sezione "Come utilizzare IBM® App Connect con Google Gemini" nella documentazione sulla Continuous Delivery (CD) di IBM App Connect in containers.

6. Impostare le proprietà del connettore richieste nella procedura guidata.
   È inoltre possibile impostare proprietà che specificano il numero massimo di record da recuperare e l'azione da intraprendere se tale limite viene superato.
7. Una volta terminato di specificare le proprietà nella procedura guidata Connector Discovery, fare clic su Salva.
   Le credenziali utilizzate per connettersi a Google Gemini sono memorizzate nel vault, mentre gli altri dettagli di connessione sono salvati nella policy Google Gemini. I valori delle proprietà impostate nella procedura guidata vengono restituiti al nodo Gemini Request dell' Google, presente nel Toolkit dell' IBM App Connect Enterprise.
8. Una volta terminata la scoperta e salvati i valori delle proprietà, uscire dalla procedura guidata di scoperta del connettore facendo clic sulla X nell'angolo superiore destro della finestra o premendo Alt+F4.
9. Torna alla modifica del nodo " Google " (Richiesta Gemini) nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore impostate nella procedura guidata Connector Discovery (al punto 6 ) sono ora visibili sul nodo Google Gemini Request nell'editor delle proprietà. La scheda Base mostra i valori delle proprietà Azione e Oggetto impostate nella procedura guidata. Ad esempio, se nella procedura guidata è stata selezionata l'opzione Modelli > Recupera tutti i modelli, nella scheda Base del nodo saranno visibili le seguenti proprietà:

   • Azione - getV1Models
   • Oggetto - GetModels_model

   I valori delle proprietà Azione e Oggetto sono visualizzati in sola lettura. Se si desidera modificare questi valori, è possibile farlo facendo nuovamente clic su Avvia Connector Discovery e impostando i nuovi valori nella procedura guidata di Connector Discovery.

   La proprietà Schema base name specifica il nome base dei file di schema che descrivono il formato dei messaggi di richiesta e risposta inviati e ricevuti dal connettore Google Gemini. Il nome di base dello schema viene impostato automaticamente la prima volta che si esegue il discovery per il nodo e si basa sul nome del flusso e del nodo corrente. Se si imposta manualmente questa proprietà prima di eseguire il discovery per la prima volta, viene utilizzato il valore impostato. Se si rinominano gli schemi dopo la scoperta, è necessario modificare questa proprietà in modo che corrisponda al nome di base dello schema utilizzato dagli schemi rinominati nel progetto. Se si modifica questa proprietà dopo l'individuazione, è necessario rinominare i nomi degli schemi in modo che corrispondano o eseguire nuovamente l'individuazione.

   A seconda dell'azione selezionata durante l'individuazione, la procedura guidata di individuazione del connettore genera uno schema di richiesta e uno schema di risposta, oppure solo uno schema di risposta. Uno schema di richiesta viene generato solo se l'azione e l'oggetto selezionati richiedono un messaggio di richiesta. Lo schema di richiesta generato viene utilizzato per la validazione del messaggio di richiesta. Se l'azione era RETRIEVE o DELETE, il connettore restituisce solo lo schema di risposta.

   I file di schema generati vengono aggiunti al progetto e possono essere utilizzati da un nodo di mappatura per trasformare i dati di input o di output. Il nome completo del file dello schema deriva dal nome di base dello schema (ad esempio gen/googlegemini.Google_Gemini_Request), con il suffisso response.schema.json o request.schema.json. È possibile aprire lo schema facendo clic su Apri schema richiesta o Apri schema risposta.

10. Verificare che le impostazioni delle proprietà del nodo Google Gemini Request siano corrette e salvare il flusso di messaggi.
11. Nella scheda Connessione del nodo Richiesta Google Gemini, la proprietà Criterio mostra il nome del criterio che contiene i dettagli dell'identità di sicurezza da utilizzare per la connessione. La polizza è di tipo Google Gemini.
    Per ulteriori informazioni, consultare la Google politica Gemini.
12. Opzionale: Impostare la proprietà Timeout nella scheda Connection per specificare il tempo (in secondi) in cui il nodo attende che Google Gemini elabori l'operazione.
13. La scheda Filtro del nodo Richiesta di Google Gemini contiene proprietà che controllano il modo in cui il flusso di messaggi seleziona i dati. I valori iniziali di queste proprietà sono presi dai valori delle proprietà impostate per il connettore Google Gemini nella procedura guidata di individuazione dei connettori, comprese le proprietà delle opzioni di filtro e le condizioni specificate (come descritto al punto 6 ). Quindi, se si torna alla procedura guidata di rilevamento del connettore e si modificano i valori delle proprietà (aggiungendo nuove condizioni, ad esempio), gli aggiornamenti si riflettono nelle proprietà impostate sul nodo.

    Le proprietà delle opzioni del filtro controllano gli oggetti su cui intervenire quando viene eseguito il nodo di richiesta Google Gemini. Le proprietà Limite filtro controllano il numero massimo di elementi da recuperare e l'azione da intraprendere se il limite viene superato.

    È possibile modificare i valori facendo clic su Modifica accanto al valore da modificare nella sezione Opzioni filtro e cambiando i valori delle proprietà impostate nella sezione Limite filtro.

    I valori delle proprietà possono essere valori di testo o espressioni ESQL o XPATH risolte dal contenuto del messaggio passato al nodo di richiesta Google Gemini durante la sua esecuzione.

14. Nella scheda Request (Richiesta), impostare la proprietà Data location (Posizione dati) per specificare la posizione nell'albero dei messaggi in arrivo che contiene i dati dell'oggetto da creare in Google Gemini. Questi dati costituiscono la richiesta inviata dal nodo di richiesta Google Gemini al sistema Google Gemini.
15. Nella scheda Risultato, impostare la proprietà Posizione dei dati di output per specificare la posizione nell'albero dei messaggi di output per contenere i dati del record creato in Google Gemini.
16. Per impostazione predefinita, i messaggi di richiesta sono convalidati rispetto allo schema di richiesta generato durante la scoperta del connettore. È possibile disattivare la convalida della richiesta o modificare le impostazioni di convalida utilizzando le proprietà di convalida del nodo Richiesta di Google Gemini.
17. Salvare il flusso di messaggi.