crea estensioni Vertex AI

Questa pagina si applica a Apigee e Apigee ibrido.

Anteprima - Apigee API hub

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questo argomento spiega come creare estensioni Vertex AI nell'hub API.

Che cos'è un'estensione di Vertex AI?

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

Ad esempio, supponi di creare un'estensione di Vertex AI per un'API di autonoleggio 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.

Per saperne di più sulle estensioni di Vertex AI, consulta la Panoramica sull'AI generativa su Vertex AI.

L'hub API semplifica la creazione delle estensioni di 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 API e un deployment, che, convenientemente, sono già convalidati dall'hub API. La specifica fornisce le operazioni dell'API all'estensione, mentre il deployment fornisce l'endpoint server dell'API.

crea un'estensione di Vertex AI

Per creare un'estensione Vertex AI nell'hub API:

Console

Per creare un'estensione:

1. Nella console Google Cloud, vai alla pagina API nell'hub API Apigee.

   Vai all'hub API
2. Individua l'API in cui vuoi aggiungere un'estensione. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco delle API. Se necessario, utilizza la ricerca per individuare un'API.
3. Fai clic sull'API per visualizzare la relativa pagina dei dettagli.
4. Fai clic su Crea estensione Vertex.
5. Specifica i dettagli dell'estensione nel modulo Crea un'estensione Vertex:
   • Nome estensione: (obbligatorio) devi fornire il nome dell'estensione.
   • Descrizione: (obbligatorio) aggiungi una descrizione dell'estensione.
   • Versione: (obbligatorio) seleziona una versione dell'API.
   • File delle specifiche: (obbligatorio) se una specifica è collegata alla versione API, viene compilata automaticamente in questo campo. Consulta Gestire le specifiche API.
     L'estensione Vertex AI supporta solo file di specifiche OpenAPI in formato YAML. Il limite per la dimensione del file delle specifiche è 1 MB.
   • Deployment: (obbligatorio) se un deployment è collegato alla versione API, viene compilato automaticamente in questo campo. Consulta Gestire i deployment.
     Nota: poiché le estensioni Vertex supportano un solo endpoint server per specifica, non possiamo consentire deployment con più endpoint server. Se un deployment contiene più endpoint, scegliamo il primo.
     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, verrà visualizzata nella sezione Estensioni della pagina dei dettagli dell'API. Se hai aggiunto l'estensione a un'altra versione, devi visualizzare la pagina dei dettagli della versione per vedere l'estensione elencata.

Elenca le estensioni Vertex AI

Questa sezione spiega come elencare le estensioni Vertex.

Console

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

1. Nella console Google Cloud, vai alla pagina dell'hub API.

   Vai all'hub API
2. Fai clic su API.
3. Individua l'API che vuoi ispezionare. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco delle API. Se necessario, utilizza la ricerca per individuare 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, devi visualizzare la pagina dei dettagli della versione per vedere l'estensione elencata.

Ottieni 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 dell'hub API.

   Vai all'hub API
2. Fai clic su API.
3. Individua l'API che vuoi ispezionare. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco delle API. Se necessario, utilizza la ricerca per individuare 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, devi visualizzare la pagina dei dettagli della versione per vedere l'estensione elencata. Nella tabella Vertex extensions, fai clic su un'estensione per visualizzarne la pagina dei dettagli.

Elimina un'estensione di Vertex AI

Questa sezione spiega come eliminare un'estensione di Vertex.

Console

Per eliminare un'estensione:

1. Nella console Google Cloud, vai alla pagina dell'hub API.

   Vai all'hub API
2. Fai clic su API.
3. Individua l'API che include l'estensione da eliminare. Utilizza Filtra per specificare le parole chiave per filtrare l'elenco delle API. Se necessario, utilizza la ricerca per individuare un'API.
4. Seleziona un'API.
5. Individua l'estensione da eliminare. 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, devi visualizzare la pagina dei dettagli della versione per vedere l'estensione elencata.
6. Nel menu Azioni (sul lato destro della riga contenente l'estensione), fai clic su Elimina.