Crea extensiones de Vertex AI

Esta página se aplica a Apigee y Apigee Hybrid.

En este tema, se explica cómo crear extensiones de Vertex AI en el concentrador de APIs.

¿Qué es una extensión de Vertex AI?

Las extensiones de Vertex AI permiten que los LLM se conecten a datos y acciones del mundo real a través de APIs. Las extensiones procesan consultas de los usuarios y se comunican con modelos de lenguaje grandes (LLM) para ejecutar operaciones en nombre de una aplicación, como una app de chat.

Por ejemplo, supongamos que creas una extensión de Vertex AI para una API de alquiler de automóviles y esta extensión está vinculada a una aplicación de chat. Cuando un usuario pregunta a la aplicación sobre el alquiler de un automóvil, la IA generativa comprende el contexto de la pregunta y llama a la API de la extensión para alquilar un automóvil.

Para obtener más información sobre las extensiones de Vertex AI, consulta la Descripción general de la IA generativa en Vertex AI.

El concentrador de APIs optimiza la creación de extensiones de Vertex AI

El concentrador de APIs optimiza el proceso de creación de una extensión de Vertex AI mediante los metadatos existentes del concentrador de APIs. Los datos clave que usa el concentrador de APIs para crear una extensión son una especificación de API y una implementación, que, de forma conveniente, ya están validadas por el concentrador de APIs. La especificación proporciona las operaciones de la API a la extensión y la implementación proporciona el extremo del servidor de la API.

Crea una extensión de Vertex AI

Para crear una extensión de Vertex AI en el concentrador de APIs, haz lo siguiente:

Console

Para crear una extensión, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página API en el Centro de APIs de Apigee.

    Ir al centro de APIs
  2. Ubica la API en la que quieres agregar una extensión. Usa el Filtro para especificar palabras clave a fin de filtrar la lista de APIs. Si es necesario, usa Buscar para ubicar una API.
  3. Haz clic en una API para ver su página de detalles.
  4. Haz clic en Crear una extensión de Vertex.
  5. Especifica los detalles de la extensión en el formulario Crear una extensión de Vertex:
    • Nombre de la extensión: (obligatorio) Debes proporcionar un nombre de extensión.
    • Descripción: Agrega una descripción de la extensión (obligatorio).
    • Versión: (obligatorio) Selecciona una versión de API.
    • Archivo de especificación: (obligatorio) Si una especificación está vinculada a la versión de la API, se propaga de forma automática en este campo. Consulta Administra especificaciones de API.
    • Implementación: (obligatorio) si una implementación está vinculada a la versión de la API, se propaga automáticamente en este campo. Consulta Administra implementaciones.
  6. Haz clic en Create Extension. Si agregas la extensión a la versión predeterminada, la extensión aparecerá en la sección Extensiones de la página de detalles de la API. Si agregaste la extensión a otra versión, tendrás que ver la página de detalles de la versión para ver la extensión que aparece allí.

Enumera extensiones de Vertex AI

En esta sección, se explica cómo enumerar las extensiones de vértices.

Console

Para ver todas las extensiones asociadas con una API registrada en la consola, sigue estos pasos:

  1. En la consola de Google Cloud, dirígete a la página del concentrador de APIs.

    Ir al centro de APIs
  2. Haz clic en APIs.
  3. Ubica la API que quieres inspeccionar. Usa el Filtro para especificar palabras clave a fin de filtrar la lista de APIs. Si es necesario, usa Buscar para ubicar una API.
  4. Selecciona una API
  5. Todas las extensiones que se agregaron a la versión predeterminada se enumeran en la sección Extensiones de la página de detalles de la API. Si se agregó una extensión a otra versión, tendrás que ver la página de detalles de la versión para ver la extensión que aparece allí.

Obtén detalles de la extensión de Vertex AI

En esta sección, se explica cómo obtener los detalles sobre una extensión de Vertex AI.

Console

Para ver los detalles de la extensión de Vertex AI en la consola, haz lo siguiente:

  1. En la consola de Google Cloud, dirígete a la página del concentrador de APIs.

    Ir al concentrador de APIs
  2. Haz clic en APIs.
  3. Ubica la API que quieres inspeccionar. Usa el Filtro para especificar palabras clave a fin de filtrar la lista de APIs. Si es necesario, usa Buscar para ubicar una API.
  4. Selecciona una API
  5. Todas las extensiones que se agregaron a la versión predeterminada se enumeran en la sección Extensiones de la página de detalles de la API. Si se agregó una extensión a otra versión, tendrás que ver la página de detalles de la versión para ver la extensión que aparece allí. En la tabla Extensiones de Vertex, haz clic en una extensión para ver su página de detalles.

Borra una extensión de Vertex AI

En esta sección, se explica cómo borrar una extensión de Vertex.

Console

Para borrar una extensión, sigue estos pasos:

  1. En la consola de Google Cloud, dirígete a la página del concentrador de APIs.

    Ir al concentrador de APIs
  2. Haz clic en APIs.
  3. Ubica la API que incluye la extensión que deseas borrar. Usa el Filtro para especificar palabras clave a fin de filtrar la lista de APIs. Si es necesario, usa Buscar para ubicar una API.
  4. Selecciona una API
  5. Ubica la extensión que quieras borrar. Todas las extensiones que se agregaron a la versión predeterminada se enumeran en la sección Extensiones de la página de detalles de la API. Si se agregó una extensión a otra versión, tendrás que ver la página de detalles de la versión para ver la extensión que aparece allí.
  6. En el menú Acciones (el lado derecho de la fila que contiene la extensión), haz clic en Borrar.