Creare estensioni Vertex AI

Questa pagina si applica a Apigee e Apigee ibridi.

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

Che cos'è un'estensione 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 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.

le estensioni Vertex.
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 delle estensioni di Vertex AI

L'hub API semplifica il processo di creazione di un'estensione Vertex AI utilizzando l'hub API esistente metadati. 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, mentre che fornisce l'endpoint server dell'API.

Crea un'estensione 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 in API Hub.

    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 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 estensione: (obbligatorio) devi fornire il nome dell'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 API.
    • Deployment: (obbligatorio) se un deployment è collegato alla versione dell'API, viene automaticamente compilate in questo campo. Consulta: Gestire i deployment.
  6. Fai clic su Crea estensione. Se aggiungi l'estensione alla versione predefinita, verranno visualizzate nella sezione Estensioni della pagina dei dettagli dell'API. Se hai aggiunto il parametro un'estensione a un'altra versione, devi accedere alla pagina dei dettagli della versione per controllare estensione.

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.

Visualizza i dettagli dell'estensione Vertex AI

Questa sezione spiega come ottenere i dettagli di un'estensione di 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 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 di Vertex.

Console

Per eliminare un'estensione:

  1. Nella console Google Cloud, vai alla pagina 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, dovrai visualizzare la pagina dei dettagli della versione per visualizzarla.
  6. Nel menu Azioni (sul lato destro della riga contenente l'estensione), fai clic su Elimina.