Visualização — Conector do BigQuery

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço 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.

Conector MCP

O conector do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) permite criar e configurar uma conexão MCP nos Integration Connectors. Você pode usar essa conexão nos aplicativos de negócios para trocar dados com segurança e realizar operações com o MCP.

Para conferir a lista de entidades e operações compatíveis, consulte Exemplos de operações de entidade. Para informações sobre as ações específicas do conector com suporte, consulte Ações.

Todas as conexões nos Integration Connectors oferecem uma camada de abstração para os objetos de serviço subjacentes. Esses objetos são expostos como entidades gerenciáveis, permitindo que você realize operações padrão ou use ações específicas do conector.

Versões do conector MCP

O conector MCP oferece suporte a duas versões:

• MCP v1: use essa versão do conector para acessar a API MCP v1.
• MCP v2: use essa versão do conector para acessar a API MCP v2.

Para informações sobre como criar uma conexão MCP, consulte Criar e configurar um conector MCP.

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

Observação:você pode ver as entidades, as operações e as ações de um conector na tarefa de conectores.

• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a Entities lista estará vazia.

• Operação: Uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações não serão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Observação: Todas as entidades e ações terão um esquema associado a elas. Por exemplo, um esquema de ação terá os detalhes do parâmetro, como: os nomes do parâmetro e tipos de dados correspondentes. O esquema (metadados) de entidades e ações é buscado pela conexão no ambiente de execução do back-end. Se houver atualizações no esquema, elas não serão refletidas automaticamente nas suas conexões, faça isso manualmente. Para atualizar o esquema de uma conexão, abra a página Detalhes da conexão e clique em Atualizar esquema de conexão.

Entidades e operações com suporte

O conector MCP oferece suporte a entidades e operações, com as específicas disponíveis dependendo da ferramenta conectada pelo MCP.

Exemplos de operações de entidade

Esta seção fornece exemplos de operações de entidade para diferentes ferramentas.

Listar entidade de problemas do Jira

Este exemplo lista todos os problemas na entidade Problemas usando uma conexão MCP do Jira.

1. Na janela Configurar tarefa do conector, clique em Entidades.
2. Selecione Problemas na lista Entidade.
3. Selecione a operação Lista e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Conectores, clique connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

   {
         "operation": "LIST_ENTITIES",
         "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
         "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
         "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
         "entity": "Issues",
         "entity_id": "Issues",
         "page_token": ""
       }

Listar todas as solicitações

Este exemplo lista todas as solicitações na entidade Solicitações.

1. Na janela Configurar tarefa do conector, clique em Entidades.
2. Selecione Solicitações na lista Entidade.
3. Selecione a operação Lista e clique em Concluído.

Receber um usuário por ID

Este exemplo recebe o usuário com AccountId como `6035864ce2020c0070b5285b` da entidade Usuários. `AccountId` é a chave primária da entidade Usuários. Para receber uma entidade específica, use a operação Lista com uma filterClause na chave primária, já que a operação Receber não é compatível com essa entidade.

1. Na janela Configurar tarefa do conector, clique em Entidades.
2. Selecione Usuários na lista Entidade.
3. Selecione a operação Lista e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Conectores, clique em filterClause e insira `AccountId`=6035864ce2020c0070b5285b no campo Valor padrão.

Ações

O conector MCP oferece várias ações, com as específicas disponíveis dependendo da ferramenta conectada pelo MCP.

Exemplos de ações

Esta seção descreve como realizar algumas das ações disponíveis pelo conector MCP para diferentes ferramentas.

Ações do Jira: receber problemas

Este exemplo demonstra como listar problemas do Jira usando uma conexão MCP configurada para o Jira.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação get_issues e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
     }

Ações lineares: listar problemas

Este exemplo demonstra como listar problemas no Linear usando uma conexão MCP configurada para o Linear.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação list_issues e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "limit": 50
     }

Ações do Sentry: Whoami

Este exemplo demonstra como receber informações do usuário do Sentry usando uma conexão MCP configurada para o Sentry.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação whoami e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "name": "example-org"
     }

Encontrar organizações

Este exemplo demonstra como encontrar organizações no Sentry usando uma conexão MCP configurada para o Sentry.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação find_organizations e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {}

Ações do Intercom: pesquisar conversas

Este exemplo demonstra como pesquisar detalhes de conversas no Intercom usando uma conexão MCP configurada para o Intercom.

1. Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
2. Selecione a ação search e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Valor padrão:

     {
       "query": "object_type:conversations state:open created_at:gt:2024-01-01"
     }

Limitações do sistema

O conector MCP tem limitações de sistema que podem variar com base na ferramenta específica que está sendo conectada. Por padrão, os Integration Connectors alocam dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Observação: o número de nós dos Integration Connectors será escalonado automaticamente de forma dinâmica com base no seu uso. No entanto, se você quiser reservar capacidade para grandes volumes sem esperar pelo escalonamento automático, ajuste o valor mínimo do nó para uma conexão. Mais nós são necessários para processar mais transações para uma conexão. Por outro lado, menos nós são necessários se uma conexão processar menos transações. Para configurar os valores do nó, faça o seguinte:

• Se você for um cliente de pagamento por uso, configure o valor mínimo e máximo do nó na página de edição da conexão.
• Se você for um cliente baseado em assinatura, entre em contato com o suporte.

O número máximo de transações que um nó pode processar depende de vários fatores. Portanto, antes de ajustar os nós mínimos para melhorar a capacidade de processamento, é recomendável verificar se os sistemas de back-end estão configurados de maneira ideal para processar o tráfego necessário.