Vertex AI

O conetor do Vertex AI permite-lhe realizar as operações suportadas no Vertex AI.

Antes de começar

Antes de usar o conetor do Vertex AI, conclua as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
    • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
    • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.

    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (API Connectors)

      Para saber como ativar serviços, consulte o artigo Ativar serviços.

    Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

  • Se estiver a usar a autenticação da conta de serviço em vez da autenticação OAuth 2.0, certifique-se de que são concedidas as autorizações adequadas à conta de serviço. Para mais informações, consulte o artigo Funções e autorizações do IAM.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + Criar novo para abrir a página Criar associação.
  3. Na secção Localização, escolha a localização para a ligação.
    1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

    2. Clicar em Seguinte.
  • Na secção Detalhes da ligação, defina os seguintes campos:
    1. Conetor: selecione Vertex AI na lista pendente de conetores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista pendente de versões disponíveis.
    3. No campo Nome da associação, introduza um nome para a instância da associação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
    4. Opcionalmente, introduza uma Descrição para a instância de associação.
    5. Opcionalmente, selecione Ativar registo na nuvem se quiser registar os detalhes de execução do conector.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    8. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par de chave-valor.
    9. Clicar em Seguinte.
    10. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
      1. Tipo de destino: selecione um Tipo de destino. No campo Endereço do anfitrião, especifique o URL do serviço que quer associar. Por exemplo, https://us-central1-aiplatform.googleapis.com/. Para mais informações sobre como configurar o destino, consulte o artigo Configure o destino.

        Para introduzir destinos adicionais, clique em +Adicionar destino.

      2. Clicar em Seguinte.
    11. Na secção Autenticação, introduza os detalhes de autenticação.
      1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

        Pode escolher qualquer um dos seguintes tipos de autenticação:

        • OAuth 2.0 – Código de autorização
        • Conta de serviço

        2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

      2. Clicar em Seguinte.
    12. Rever: reveja os detalhes da ligação e da autenticação.
    13. Clique em Criar.

    Configure a autenticação

    Introduza os detalhes com base na autenticação que quer usar.

    • OAuth 2.0 – Código de autorização
      • ID de cliente: o ID de cliente necessário para estabelecer ligação ao serviço Google de back-end.
      • Âmbitos: selecione os âmbitos OAuth 2.0 necessários no menu pendente. Para ver todos os âmbitos do OAuth 2.0 suportados para o seu serviço Google necessário, consulte a secção relevante na página Âmbitos do OAuth 2.0 para APIs Google.
      • Segredo do cliente: selecione o segredo do Secret Manager que contém a palavra-passe associada ao segredo do cliente.
      • Versão do Secret: selecione a versão do Secret.
    • Conta de serviço

      Selecione esta opção para fazer a autenticação através da conta de serviço que indicou nos passos anteriores ao configurar esta associação. Certifique-se de que indicou a conta de serviço que tem as funções e as autorizações do IAM relevantes necessárias para a autenticação.

      • Âmbitos: selecione os âmbitos OAuth 2.0 necessários no menu pendente. Para mais informações, consulte os Âmbitos de acesso.

    Ações

    Este conector fornece uma camada de abstração para os objetos do serviço de back-end associado. Só pode aceder aos objetos do back-end através desta abstração. A abstração é exposta para si como ações. Uma Action é uma função de primeira classe disponibilizada à integração através da interface do conector. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

    Use a ligação do Vertex AI numa integração

    Depois de criar a associação, esta fica disponível na integração de aplicações. Pode usar a ligação numa integração através da tarefa Conectores.

    Obtenha ajuda da comunidade do Google Cloud

    Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

    O que se segue?

    •