Somente DataPower API Gateway

Gemini invocar

Editar online

Draft comment: abeesh.thomas@ibm.com
done. Review pending. THIS IS THE UI VERSION.
Use a política de invocação " Gemini para invocar operações " Gemini.

Suporte de gateway

Tabela 1. Tabela que mostra quais gateways suportam esta política e a versão correspondente da política
Gateway Versão da política
DataPower® API Gateway 2.0.0

Este tópico descreve como configurar a política na interface de usuário do assembly; para obter detalhes sobre como configurar a política na sua fonte do OpenAPI, consulte gemini-invoke.

Sobre

A política de invocação " Gemini fornece acesso a seis operações " Gemini:
  • POST models/[model]:generateContent
  • POST models/[model]:countTokens
  • POST models/[model]:embedContent
  • POST models/[model]:batchEmbedContents
  • GET models/[model]
  • GET models

A política de invocação " Gemini suporta as propriedades mostradas na Tabela 2.

Propriedades

A tabela a seguir lista as propriedades de política, indica se uma propriedade é necessária, especifica os valores válidos e padrão para entrada e especifica o tipo de dados dos valores.

Tabela 2. Gemini chamar propriedades da política
Rótulo da propriedade Obrigatório Descrição Tipo de dados
Título Não Gemini invocar conclusões de bate-papo sequência
Descrição Não Uma descrição da política. sequência
Operação do Gemini True A operação ' Gemini a ser invocada; deve ser uma das seguintes operações:
  • POST models/[model]:generateContent

    Uma operação HTTP POST para generateContent. Consulte a seção “Geração de conteúdo” na documentação Gemini da API para ver exemplos de solicitações e respostas.

  • POST models/[model]:countTokens

    Uma operação HTTP POST para /countTokens. Consulte “Contagem de tokens” na documentação Gemini da API para ver exemplos de solicitações e respostas.

  • POST models/[model]:embedContent

    Uma operação HTTP POST para embedContent. Consulte a seção “Incorporar conteúdo” na documentação Gemini da API para ver exemplos de solicitações e respostas.

  • POST models/[model]:batchEmbedContents

    Uma operação HTTP POST para batchEmbedContents. Consulte “Incorporar conteúdo em lote” na documentação da Gemini API para ver exemplos de solicitações e respostas.

  • GET models

    Uma operação HTTP GET para /models. Consulte a seção “Modelos de lista” na documentação Gemini da API para ver exemplos de respostas.

  • GET models/[model]

    Uma operação HTTP GET para /models/[model]. Consulte “Recuperar modelo” na documentação Gemini da API para ver exemplos de respostas.

 sequência
Chave da API da Gemini True A chave de API ou uma referência de variável para a variável que contém uma chave de API. A chave da API é usada para autenticar solicitações " Gemini. sequência
Ativar o cache de resposta Não O cache de resposta é ativado por padrão para otimizar o desempenho da API; no entanto, você pode desativá-lo se necessário para a sua API.

Quando o cache de resposta está ativado, quando uma solicitação é enviada ao serviço " Gemini, o cache de resposta é inspecionado para determinar se a carga útil da solicitação tem uma resposta em cache associada. Em caso afirmativo, essa resposta em cache e seus cabeçalhos de resposta HTTP associados são colocados na mensagem de contexto do DataPower API Gateway especificada pela propriedade Output Message.

Se não houver resposta em cache, a solicitação será passada para o serviço ' Gemini e a resposta será armazenada em cache para operações subsequentes usando o tempo de vida especificado na propriedade Response Cache Expiration.

 booleano
Expiração do cache de respostas Não A duração do cache (o tempo de vida). A duração mínima é de 60 segundos e a duração máxima é de 86400 segundos (1 dia). Qualquer valor fora desse intervalo falhará na validação quando a API for publicada, mesmo que o valor seja aceito nesse campo. número inteiro
Escopo do cache Não Uma cadeia de caracteres que adiciona exclusividade à chave usada para armazenar uma resposta em cache. A adição de um escopo de cache permite que a mesma solicitação seja salva em várias entradas de cache. sequência
Parâmetros do caminho de operação do Gemini Não Para operações que têm um parâmetro de caminho designado com um nome de parâmetro de caminho entre colchetes na operação, especifique o nome do parâmetro e o valor separado por dois pontos. Se a operação tiver mais de um parâmetro de caminho, cada designação de parâmetro de caminho deverá ser separada por vírgula. Por exemplo, para a operação " GET models/[model], a propriedade do parâmetro de caminho seria especificada como " model:somename.
Observação: se um parâmetro de caminho for necessário para a operação selecionada, mas não tiver sido fornecido, a operação de invocação falhará. No entanto, para operações que não exigem um parâmetro de caminho, qualquer parâmetro de caminho fornecido será ignorado.
 sequência
Parâmetros de consulta da operação Gemini Não Para operações que suportam parâmetros de consulta, especifique uma string de parâmetro de consulta que especifique o nome do parâmetro e o valor separados por um caractere de sinal de igual. Se houver suporte para mais de um parâmetro de consulta, cada parâmetro de consulta deverá ser separado por um caractere e comercial. As operações suportadas no momento não suportam parâmetros de consulta, embora as operações que possam ser suportadas no futuro suportem parâmetros de consulta. sequência
Mensagem de saída Não O nome da mensagem de contexto DataPower API Gateway que recebe a resposta " Gemini. Por padrão, essa propriedade usa message como o valor, o que permite que a resposta seja acessível por políticas de API subsequentes em ' message.body e ' message.headers. sequência