Creare estensioni Vertex AI

Questa pagina si applica ad Apigee e Apigee hybrid.

Questo argomento spiega come creare estensioni Vertex AI in API Hub.

Che cos'è un'estensione Vertex AI?

Le estensioni di Vertex AI consentono ai modelli linguistici di grandi dimensioni (LLM) di connettersi a dati e azioni del mondo reale tramite API. Le estensioni elaborano le query degli utenti e comunicano con i modelli linguistici di grandi dimensioni (LLM) per eseguire operazioni per conto di un'applicazione, ad esempio un'app di chat.

Ad esempio, supponiamo di creare un'estensione Vertex AI per un'API di noleggio auto e che questa estensione sia collegata a un'applicazione di chat. Quando un utente chiede all'applicazione di noleggiare un'auto, l'AI generativa comprende il contesto della domanda e chiama l'API di estensione per noleggiare un'auto.

Figura 1. Estensione Vertex AI collegata a un'app di chat per l'assistenza clienti.

Per saperne di più sulle estensioni di Vertex AI, consulta la Panoramica delle estensioni.

L'hub API semplifica la creazione di estensioni Vertex AI

L'hub API semplifica il processo di creazione di un'estensione Vertex AI utilizzando i metadati dell'hub API esistenti. I dati chiave utilizzati dall'hub API per creare un'estensione sono una specifica dell'API e un deployment, che, comodamente, sono già convalidati dall'hub API. La specifica fornisce le operazioni dell'API all'estensione e il deployment fornisce l'endpoint del server dell'API.

Crea un'estensione Vertex AI

Per creare un'estensione Vertex AI in API Hub:

Console

Per creare un'estensione:

1. Nella console Google Cloud, vai alla pagina API in API Hub.

   Vai ad API Hub
2. Individua l'API a cui vuoi aggiungere un'estensione. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la Ricerca per trovare un'API.
3. Fai clic sull'API per visualizzarne la pagina dei dettagli.
4. Fai clic su Crea estensione Vertex.
5. Specifica i dettagli dell'estensione nel modulo Crea un'estensione Vertex:
   • Nome dell'estensione : (obbligatorio) devi fornire un nome per l'estensione.
   • Descrizione: (obbligatorio) aggiungi una descrizione dell'estensione.
   • Versione: (obbligatorio) seleziona una versione dell'API.
   • File di specifiche: (obbligatorio) se una specifica è collegata alla versione dell'API, viene compilata automaticamente in questo campo. Consulta Gestire le specifiche dell'API.
     L'estensione Vertex AI supporta solo i file di specifiche OpenAPI in formato YAML. La dimensione massima del file delle specifiche è 1 MB.
   • Deployment: (obbligatorio) se un deployment è collegato alla versione dell'API, viene compilato automaticamente in questo campo. Vedi Gestire i deployment.
     Nota: poiché le estensioni Vertex supportano un solo endpoint server per specifica, non possiamo consentire i deployment con più endpoint server. Se un deployment contiene più endpoint, ne scegliamo uno.
     Nota: l'unica configurazione di autenticazione supportata per un'estensione Vertex è Nessuna autenticazione.
6. Fai clic su Crea estensione. Se aggiungi l'estensione alla versione predefinita, questa verrà visualizzata nella sezione Estensioni della pagina dei dettagli dell'API. Se hai aggiunto l'estensione a un'altra versione, dovrai visualizzare la pagina dei dettagli della versione per vedere l'estensione elencata.

Elenca le estensioni Vertex AI

Questa sezione spiega come elencare le estensioni dei vertici.

Console

Per visualizzare tutte le estensioni associate a un'API registrata nella console:

1. Nella console Google Cloud, vai alla pagina Hub API.

   Vai all'hub API
2. Fai clic su API.
3. Individua l'API che vuoi esaminare. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la Ricerca per trovare un'API.
4. Seleziona un'API.
5. Le estensioni aggiunte alla versione predefinita sono elencate nella sezione Estensioni della pagina dei dettagli dell'API. Se un'estensione è stata aggiunta a un'altra versione, dovrai visualizzare la pagina dei dettagli della versione per visualizzarla.

Visualizzare i dettagli dell'estensione Vertex AI

Questa sezione spiega come ottenere i dettagli di un'estensione Vertex AI.

Console

Per visualizzare i dettagli dell'estensione Vertex AI nella console:

1. Nella console Google Cloud, vai alla pagina Hub API.

   Vai ad API Hub
2. Fai clic su API.
3. Individua l'API che vuoi esaminare. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la Ricerca per trovare un'API.
4. Seleziona un'API.
5. Tutte le estensioni aggiunte alla versione predefinita sono elencate nella sezione Estensioni della pagina dei dettagli dell'API. Se un'estensione è stata aggiunta a un'altra versione, dovrai visualizzare la pagina dei dettagli della versione per visualizzarla. Nella tabella Estensioni vertice, fai clic su un'estensione per visualizzarne la pagina dei dettagli.

Eliminare un'estensione Vertex AI

Questa sezione spiega come eliminare un'estensione Vertex.

Console

Per eliminare un'estensione:

1. Nella console Google Cloud, vai alla pagina Hub API.

   Vai ad API Hub
2. Fai clic su API.
3. Individua l'API che include l'estensione che vuoi eliminare. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco di API. Se necessario, utilizza la Ricerca per trovare un'API.
4. Seleziona un'API.
5. Individua l'estensione da eliminare. Le estensioni aggiunte alla versione predefinita sono elencate nella sezione Estensioni della pagina dei dettagli dell'API. Se un'estensione è stata aggiunta a un'altra versione, dovrai visualizzare la pagina dei dettagli della versione per visualizzarla.
6. Nel menu Azioni (lato destro della riga contenente l'estensione), fai clic su Elimina.