Criar extensões da Vertex AI

Esta página se aplica à Apigee e à Apigee híbrida.

Visualização — Apigee API hub

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Este tópico explica como criar extensões Vertex AI no hub de API.

O que é uma extensão da Vertex AI?

As extensões da Vertex AI permitem que os LLMs se conectem a dados e ações do mundo real por meio de APIs. As extensões processam consultas de usuários e se comunicam com grandes modelos de linguagem (LLMs) para executar operações em nome de um aplicativo, como um aplicativo de bate-papo.

Por exemplo, suponha que você crie uma extensão Vertex AI para uma API de aluguel de automóveis e essa extensão esteja vinculada a um aplicativo de bate-papo. Quando um usuário pergunta ao aplicativo sobre aluguel de carro, a IA generativa entende o contexto da pergunta e chama a API de extensão para alugar um carro.

Para mais informações sobre extensões da Vertex AI, consulte a Visão geral da IA generativa na Vertex AI.

O hub de API simplifica a criação de extensões da Vertex AI

O hub de API simplifica o processo de criação de uma extensão da Vertex AI usando metadados do hub de API. Os principais dados usados pela API Hub para criar uma extensão são uma especificação de API e uma implantação, que, convenientemente, já são validadas pela API Hub. A especificação fornece as operações da API para a extensão e a implantação fornece o endpoint do servidor da API.

Criar uma extensão da Vertex AI

Para criar uma extensão da Vertex AI no hub de API:

Console

Para criar uma extensão:

1. No console do Google Cloud, acesse a página APIs no hub de APIs da Apigee.

   Acesse o hub de API
2. Localize a API em que você quer adicionar uma extensão. Use Filtro para especificar palavras-chave e filtrar a lista de APIs. Se necessário, use a Pesquisa para localizar uma API.
3. Clique na API para abrir a página de detalhes dela.
4. Clique em Criar extensão Vertex.
5. Especifique os detalhes da extensão no formulário Criar uma extensão Vertex:
   • Nome da extensão: (obrigatório) você precisa fornecer um nome de extensão.
   • Descrição: (obrigatório) adicione uma descrição da extensão.
   • Versão: (obrigatório) selecione uma versão da API.
   • Arquivo de especificação: (obrigatório) se uma especificação estiver vinculada à versão da API, ela será preenchida automaticamente neste campo. Consulte Gerenciar especificações da API.
     A extensão Vertex AI é compatível apenas com arquivos de especificação OpenAPI no formato YAML. O limite de tamanho do arquivo especificado é de 1 MB.
   • Implantação: (obrigatório) se uma implantação estiver vinculada à versão da API, ela será preenchida automaticamente neste campo. Consulte Gerenciar implantações.
     Observação: como as extensões Vertex oferecem suporte apenas a um endpoint de servidor por especificação, não podemos permitir implantações com vários endpoints de servidor. Se uma implantação contiver vários endpoints, escolheremos o primeiro.
     Observação: a única configuração de autenticação compatível com uma extensão Vertex é Sem autenticação.
6. Clique em Criar extensão. Se você adicionar a extensão à versão padrão, ela aparecerá na seção Extensões da página de detalhes da API. Se você adicionou a extensão a outra versão, terá que visualizar a página de detalhes da versão para ver a extensão listada lá.

Listar extensões da Vertex AI

Esta seção explica como listar extensões da Vertex.

Console

Para visualizar todas as extensões associadas a uma API registrada no console:

1. No console do Google Cloud, acesse a página Hub de APIs.

   Acesse o hub de API
2. Clique em APIs.
3. Localize a API que você quer inspecionar. Use Filtro para especificar palavras-chave e filtrar a lista de APIs. Se necessário, use a Pesquisa para localizar uma API.
4. Selecionar uma API.
5. Todas as extensões adicionadas à versão padrão estão listadas na seção Extensões da página de detalhes da API. Se uma extensão foi adicionada a outra versão, você terá que visualizar a página de detalhes da versão para ver a extensão listada lá.

Receber detalhes da extensão Vertex AI

Esta seção explica como obter detalhes sobre uma extensão da Vertex AI.

Console

Para visualizar detalhes da extensão Vertex AI no console:

1. No console do Google Cloud, acesse a página Hub de APIs.

   Acesse o hub de API
2. Clique em APIs.
3. Localize a API que você quer inspecionar. Use Filtro para especificar palavras-chave e filtrar a lista de APIs. Se necessário, use a Pesquisa para localizar uma API.
4. Selecionar uma API.
5. Todas as extensões adicionadas à versão padrão estão listadas na seção Extensões da página de detalhes da API. Se uma extensão foi adicionada a outra versão, você terá que visualizar a página de detalhes da versão para ver a extensão listada lá. Na tabela Extensões Vertex, clique em uma extensão para ver a página de detalhes dela.

Excluir uma extensão da Vertex AI

Esta seção explica como excluir uma extensão Vertex.

Console

Para excluir uma extensão:

1. No console do Google Cloud, acesse a página Hub de APIs.

   Acesse o hub de API
2. Clique em APIs.
3. Localize a API que inclui a extensão que você quer excluir. Use Filtro para especificar palavras-chave e filtrar a lista de APIs. Se necessário, use a Pesquisa para localizar uma API.
4. Selecionar uma API.
5. Localize a extensão a ser excluída. Todas as extensões adicionadas à versão padrão estão listadas na seção Extensões da página de detalhes da API. Se uma extensão foi adicionada a outra versão, você terá que visualizar a página de detalhes da versão para ver a extensão listada lá.
6. No menu Ações (à direita da linha que contém a extensão), clique em Excluir.