Agentes
Conecte um agente de IA (Claude Code, Claude Desktop, Cursor, VS Code ou Gemini CLI) à conta para consultar configurações e eventos na própria conversa. O agente acessa a conta pelo protocolo MCP (Model Context Protocol) e opera com as permissões do usuário que autorizou a conexão.
O recurso está em fase de testes. As funcionalidades e os limites de uso podem mudar sem aviso prévio.
A conexão destina-se ao uso interno, pelos colaboradores da conta. Não exponha a conexão a terceiros nem a incorpore a um produto oferecido aos clientes da conta. Para esse uso, fale com o suporte.
Conectar um agente
Em Agentes > Conectar agente:
- Selecione o agente pelo logotipo. A tela exibe as instruções específicas dele.
- No agente, informe a URL do servidor MCP e o client_id exibidos na tela. Se o agente pedir um segredo do cliente (
client secret), deixe em branco. - Quando o agente solicitar, autorize o acesso à conta pelo navegador.
Para agentes de linha de comando, a tela exibe um comando pronto para o terminal em lugar dos passos 1 e 2. A autorização pelo navegador é a mesma.
A tela lista os agentes cadastrados. Um agente fora da lista precisa ser habilitado pelo suporte antes de conectar.
O agente acessa uma conta por vez, indicada na tela de conexão. Para consultar outra conta, conecte o agente novamente a partir dela.
Agentes conectados
Agentes lista as conexões do usuário autenticado na conta, com o cliente, a data da autorização e a última atividade. A última atividade é atualizada a cada quinze minutos. A tela indica as conexões que nunca foram usadas.
Desconectar encerra o acesso do agente de imediato. As demais conexões, do mesmo usuário e dos outros, continuam ativas. O agente desconectado só volta a operar depois de uma nova autorização.
Permissões
O agente opera em nome do usuário que autorizou a conexão e herda o perfil de acesso desse usuário. Cada chamada passa por duas verificações, e as duas precisam ser aprovadas: a permissão do usuário e o consentimento concedido ao agente na conexão.
| Consentimento | O que autoriza |
|---|---|
| Leitura da configuração | consultar tipos de evento, campos, regras, análises, métricas, monitoramentos e listas |
| Leitura dos dados da conta | consultar os eventos recebidos, os valores medidos de uma métrica e os valores recebidos por um campo |
| Escrita da configuração | alterar o nome e a descrição de um campo |
Os eventos contêm dados pessoais, como emails, endereços IP, BINs de cartão e identificadores de dispositivo. Por isso a leitura dos dados da conta é um consentimento separado. Uma conexão pode ler a configuração da conta sem acessar nenhum evento.
Operações
O agente lista e detalha cada tipo de configuração, consulta eventos e métricas e edita campos:
| Operação | Conteúdo |
|---|---|
| Conta | dados gerais da conta conectada e os consentimentos concedidos à conexão |
| Tipos de evento | lista dos tipos e o detalhe de cada um, com os seus campos |
| Campos | valores já recebidos por um campo, inclusive por um campo de lista sem itens cadastrados |
| Eventos | contagem dos eventos de um período em blocos de tempo, com divisão opcional por um campo, e as linhas de evento |
| Regras | lista das regras e o detalhe de uma versão, com as suas condições e ações |
| Análises | lista das análises e o detalhe de uma, com o efeito de cada célula e as regras que a executam e a registram |
| Métricas | lista das métricas, o detalhe de uma (dimensões, agregações e filtros) e os valores por período, com a faixa esperada e os alertas |
| Monitoramentos | lista dos monitoramentos e o detalhe de um, com os seus critérios |
| Listas | lista das listas configuradas e o detalhe de uma |
| Edição de campo | alteração do nome e da descrição de um campo |
A consulta de eventos aceita os mesmos filtros de Explorar, inclusive a referência a uma lista e a comparação entre campos. A consulta cobre uma janela recente, não todo o histórico da conta.
Em clientes que exibem interfaces do MCP, os valores de uma métrica aparecem como gráfico na conversa.
Cada resposta inclui o endereço do artigo correspondente nesta documentação. O agente consulta a referência em vez de deduzir o comportamento da plataforma.
Perguntas típicas:
- qual regra decide determinado tipo de evento;
- quais métricas existem sobre um campo;
- o que uma versão de regra faz, antes de publicá-la;
- quantos eventos de um tipo chegaram por status no período.
Consentimentos
Uma operação sem consentimento não aparece para o agente. Para o agente, ela é igual a uma operação que não existe.
A operação Conta informa os consentimentos da conexão e as operações retidas, com o consentimento que falta em cada uma. Quando o agente responde que algo não é possível, peça a ele que consulte a conta. A resposta mostra se a operação existe e apenas não foi consentida.
Para liberar a operação, reconecte o agente concedendo o consentimento que falta, conforme Conectar um agente. Uma conexão existente não ganha acesso sem essa nova autorização.
As operações que o perfil de acesso do usuário não permite não aparecem como retidas. Nenhuma reautorização as liberaria, porque a barreira é a permissão do usuário, não a do agente.
Limites de uso
As chamadas têm limite por usuário e por conta em uma janela de tempo, com um valor próprio para cada operação. Ao ultrapassar o limite, o agente recebe uma recusa e volta a operar na janela seguinte.