Confira os conectores compatíveis com o Application Integration.

Vertex AI: tarefa de previsão

Visualização

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.

Com a tarefa Vertex AI - Prever, é possível realizar uma previsão on-line. As previsões on-line são solicitações síncronas feitas em um endpoint de modelo. Use as previsões on-line ao fazer solicitações em resposta a entradas de aplicativos ou quando precisar de inferências em tempo hábil.

A Vertex AI é um serviço do Google Cloud que permite treinar e implantar modelos de ML e aplicativos de IA, além de personalizar modelos de linguagem grandes (LLMs) para uso em aplicativos com tecnologia de IA.

Antes de começar

Execute as seguintes tarefas no projeto do Google Cloud antes de configurar a tarefa Vertex AI - Prever:

1. Ative a API Vertex AI (aiplatform.googleapis.com).

   Ativar a API Vertex AI

2. Implante o recurso model no recurso endpoint.
3. Criar um perfil de autenticação. A Application Integration usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Vertex AI - Previsão.
   Observação: se você estiver criando um perfil de autenticação do tipo Conta de serviço, verifique se a conta de serviço está atribuída com o papel do IAM que contém as seguintes permissões do IAM:

   • aiplatform.endpoints.predict

   Para saber mais sobre as permissões e os papéis predefinidos do IAM que as concedem, consulte a referência de permissões do IAM.

   Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.

4. Verifique se o VPC Service Controls NÃO está configurado para o Application Integration no seu projeto do Google Cloud.
   Aviso:a tarefa de previsão da Vertex AI não vai funcionar ou deixará de funcionar se o VPC Service Controls estiver configurado para o Application Integration no seu projeto do Google Cloud.

Configurar a tarefa Previsão na Vertex AI

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrations.

   A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma nova.

   Se você estiver criando uma nova integração:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas da integração.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de opções disponíveis.
5. Clique e coloque o elemento Vertex AI - Previsão no editor de integração.
6. Clique no elemento Vertex AI - Previsão no designer para ver o painel de configuração da tarefa Vertex AI - Prever.
7. Acesse Autenticação e selecione o perfil de autenticação que você quer usar.

   Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.

8. Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.

   As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

A tabela a seguir descreve os parâmetros de entrada da tarefa Vertex AI - Previsão:

Propriedade	Tipo de dados	Descrição
Região	String	Local do endpoint do modelo. Por exemplo: us - Estados Unidos.
ProjectsId	String	É o ID do seu projeto no Google Cloud.
Endpoint	String	O nome do endpoint solicitado para disponibilizar a previsão.
Solicitação	JSON	Consulte Estrutura de solicitação JSON.

Saída da tarefa

A tarefa Vertex AI - Prever retorna uma resposta com a previsão.

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

A seguir

• Para informações sobre como usar a tarefa da Vertex AI com um modelo pré-existente, consulte Aplicativos com tecnologia de IA com Application Integration e Vertex AI.
• Para saber como usar a Vertex AI no Application Integration, consulte Como melhorar seus fluxos de integração de negócios com a Vertex AI.
• Teste e publique sua integração.
• Adicione uma tarefa de mapeamento de dados.
• Saiba mais sobre todas as tarefas e gatilhos compatíveis.