Solo pasarela de API de DataPower

Gemini invocar

Utilice la política de invocación ' Gemini ' para invocar operaciones ' Gemini.

Soporte de pasarela

Tabla 1. Tabla que muestra qué pasarelas soportan esta política y la versión de política correspondiente
Pasarela Versión de política
DataPower® API Gateway 2.0.0

Este tema describe cómo configurar la política en la interfaz de usuario del ensamblador; para más detalles sobre cómo configurar la política en su fuente OpenAPI, consulte gemini-invoke.

Acerca de

La política de invocación " Gemini " da acceso a seis operaciones " Gemini ":
  • POST models/[model]:generateContent
  • POST models/[model]:countTokens
  • POST models/[model]:embedContent
  • POST models/[model]:batchEmbedContents
  • GET models/[model]
  • GET models

La política de invocación " Gemini " admite las propiedades que se muestran en la Tabla 2.

Propiedades

En la tabla siguiente se listan las propiedades de política, se indica si se requiere una propiedad, y se especifica los valores válidos y predeterminados para la entrada, así como el tipo de datos de los valores.

Tabla 2. Gemini Propiedades de política invoke
Etiqueta de propiedad Obligatorio Descripción Tipo de datos
Título Nee Gemini invocar finalizaciones de chat serie
Descripción Nee Una descripción de la política. serie
Operación Gemini La operación ' Gemini ' a invocar; debe ser una de las siguientes operaciones:
  • POST models/[model]:generateContent

    Una operación HTTP POST para generateContent. Consulte Generación de contenidos en la documentación de la API ' Gemini ' para ver ejemplos de solicitud y respuesta.

  • POST models/[model]:countTokens

    Una operación HTTP POST para /countTokens. Consulte Contar tokens en la documentación de la API ' Gemini ' para ver ejemplos de solicitud y respuesta.

  • POST models/[model]:embedContent

    Una operación HTTP POST para embedContent. Consulte Incrustar contenido en la documentación de la API ' Gemini ' para ver ejemplos de solicitud y respuesta.

  • POST models/[model]:batchEmbedContents

    Una operación HTTP POST para batchEmbedContents. Consulte Contenido incrustado por lotes en la documentación de la API ' Gemini ' para ver ejemplos de solicitud y respuesta.

  • GET models

    Una operación HTTP GET para /models. Consulte Modelos de listas en la documentación de la API ' Gemini ' para ver ejemplos de respuestas.

  • GET models/[model]

    Una operación HTTP GET para /models/[model]. Consulte Recuperar modelo en la documentación de la API ' Gemini ' para ver ejemplos de respuestas.

serie
Clave API Gemini La clave API, o una referencia a la variable que contiene una clave API. La clave API se utiliza para autenticar las solicitudes de ' Gemini '. serie
Activar la caché de respuesta Nee La caché de respuesta está activada por defecto para optimizar el rendimiento de la API; sin embargo, puede desactivarla si es necesario para su API.

Cuando la caché de respuesta está activada, cuando se envía una solicitud al servicio " Gemini ", se inspecciona la caché de respuesta para determinar si la carga útil de la solicitud tiene una respuesta en caché asociada. Si es así, esa respuesta almacenada en caché y sus cabeceras de respuesta HTTP asociadas se colocan en el mensaje de contexto de API Gateway DataPower especificado por la propiedad Output Message.

Si no hay respuesta en caché, la petición se pasa al servicio " Gemini ", y la respuesta se almacena en caché para operaciones posteriores utilizando el tiempo de vida especificado en la propiedad Expiración de caché de respuesta.

booleano
Caducidad de la caché de respuesta Nee La duración de la caché (el tiempo de vida). La duración mínima es de 60 segundos y la duración máxima es de 86400 segundos (1 día) -- cualquier valor fuera de ese rango fallará la validación cuando se publique la API, incluso si el valor es aceptado en este campo. entero
Alcance de la caché Nee Cadena que añade unicidad a la clave utilizada para almacenar una respuesta en caché. La adición de un ámbito de caché permite guardar la misma solicitud en varias entradas de caché. serie
Parámetros de la ruta de funcionamiento de Gemini Nee Para las operaciones que tienen un parámetro de ruta designado con un nombre de parámetro de ruta entre corchetes en la operación, especifique el nombre del parámetro y el valor separados por dos puntos. Si la operación tiene más de un parámetro de ruta, cada designación de parámetro de ruta debe separarse con una coma. Por ejemplo, para la operación " GET models/[model], la propiedad del parámetro de ruta se especificaría como " model:somename.
Nota: Si se requiere un parámetro de ruta para la operación seleccionada pero no se ha proporcionado, la operación de invocación fallará. Sin embargo, para las operaciones que no requieren un parámetro de ruta, se ignorará cualquier parámetro de ruta proporcionado.
serie
Parámetros de consulta de la operación Gemini Nee Para las operaciones que admiten parámetros de consulta, especifique una cadena de parámetros de consulta que especifique el nombre del parámetro y el valor separados por un carácter de signo igual. Si se admite más de un parámetro de consulta, cada parámetro de consulta se separaría con un carácter ampersand. Las operaciones admitidas en este momento no admiten parámetros de consulta, aunque las operaciones que podrían admitirse en el futuro sí admitirían parámetros de consulta. serie
mensaje de salida Nee El nombre del mensaje de contexto de DataPower API Gateway que recibe la respuesta ' Gemini '. By default, this property uses message as the value, which enables the response to be accessible by subsequent API policies in message.body and message.headers. serie