Ferramentas

O servidor MCP da Glass Data oferece ao agente as ferramentas listadas nesta página, e o agente escolhe a ferramenta conforme a pergunta. Cada ferramenta exige um nível de acesso da conexão na conta e um perfil de acesso mínimo do usuário.

Toda ferramenta, exceto list_accounts, recebe a conta pelo slug no argumento account. O agente recebe a lista completa de ferramentas qualquer que seja o acesso, e uma chamada sem o acesso ou o perfil exigido é recusada com o que liberaria a ferramenta. A ferramenta describe_account informa as ferramentas retidas na conta.

O comportamento comum às ferramentas, como a comparação de versões e a simulação, está em Operações.

Contas

Ferramenta O que faz Acesso Perfil
list_accounts lista as contas do usuário, com o slug, o ambiente (produção ou teste), se a conexão está habilitada em cada conta e o que o agente pode fazer nela não exige não exige
describe_account descreve uma conta: nome, ambiente, situação, fuso horário, acesso da conexão, perfil do usuário e ferramentas retidas, com o que liberaria cada uma Ler Somente leitura

Tipos de evento e campos

Ferramenta O que faz Acesso Perfil
list_event_types lista os tipos de evento, com a situação, a quantidade de campos, métricas e monitoramentos e o horário do último evento aceito, inclusive o tipo _failure Ler Somente leitura
describe_event_type descreve os campos de um tipo de evento: identificador, nome, tipo de dado, configurações, valores aceitos e utilizações Ler Somente leitura
list_field_values lista os valores aceitos por um campo e os valores recebidos desde uma data, com o nome que cada valor representa Ler Somente leitura
list_field_elements lista os itens de um campo de lista ou booleano, com o rótulo, a cor e o ícone de cada item Ler Somente leitura
create_event_field cria um campo em um tipo de evento, com identificador, tipo de dado e tipo de propriedade que não podem ser alterados depois Ler e alterar Editor
update_event_field altera o nome, a descrição, a obrigatoriedade, a herança e o tamanho máximo de um campo Ler e alterar Editor
add_field_elements inclui itens em um campo de lista, em lote Ler e alterar Editor
update_field_elements altera o valor, o rótulo, a cor ou o ícone de itens de um campo de lista ou booleano, em lote, exceto os valores de um campo booleano Ler e alterar Editor
remove_field_elements remove itens de um campo de lista, em lote, sem alterar o valor dos eventos já gravados Ler e alterar Editor
deactivate_event_field desativa um campo e mantém os valores gravados, que voltam se o campo for reativado no painel Ler e alterar Editor
remove_event_field remove um campo, e os valores gravados deixam de ser consultados Ler e alterar Editor

Eventos e exportação

Ferramenta O que faz Acesso Perfil
count_events conta os eventos de um período em blocos de tempo, com filtros e divisão opcional por um campo Ler Somente leitura
find_events lista os eventos que atendem aos filtros, do mais recente ao mais antigo, com os campos escolhidos Ler Somente leitura
create_export inicia uma exportação dos eventos que atendem aos filtros, com todos os campos ativos do tipo de evento Ler Analista
describe_export informa a situação de uma exportação e devolve o link de download, que exige o perfil Analista Ler Somente leitura
list_exports lista as exportações recentes da conta, inclusive as iniciadas no painel, e o consumo do limite diário Ler Somente leitura

Métricas e monitoramentos

Ferramenta O que faz Acesso Perfil
list_metrics lista as métricas, com o tipo de evento, o agrupamento, a quantidade de filtros e as agregações de cada métrica Ler Somente leitura
describe_metric descreve uma métrica: filtros, agregações e granularidades, com o período que cada granularidade alcança Ler Somente leitura
query_metric lê os valores de uma métrica em um período recente ou em uma janela passada, com a faixa esperada e os alertas Ler Somente leitura
list_monitors lista os monitoramentos, com a métrica, o intervalo, a detecção, a situação e a quantidade de segmentos analisados nos últimos 30 dias Ler Somente leitura
describe_monitor descreve um monitoramento: filtros, critérios, ajustes da detecção de anomalias, última execução e destino dos alertas Ler Somente leitura

Regras

Ferramenta O que faz Acesso Perfil
list_rules lista as regras, com o tipo de evento, a versão ativa e a quantidade de condições de cada regra Ler Somente leitura
describe_rule descreve uma versão de regra, a ativa por padrão: condições em ordem de avaliação, subcondições, expressões, ações e o modo de cada nível Ler Somente leitura
create_rule cria uma regra em um tipo de evento, com um rascunho vazio Ler e alterar Editor
draft_rule cria um rascunho a partir de uma versão, a ativa por padrão Ler e alterar Editor
add_rule_condition inclui uma condição ou um Senão em um rascunho: no fim, antes ou depois de outra condição, ou como subcondição Ler e alterar Editor
add_rule_action inclui uma ação avulsa em um rascunho Ler e alterar Editor
update_rule_condition altera a expressão, o nome, as ações, o modo, a posição ou a condição superior de uma linha do rascunho Ler e alterar Editor
remove_rule_condition remove uma linha do rascunho, com as subcondições Ler e alterar Editor
update_rule altera o modo de avaliação do primeiro nível de um rascunho de regra de evento Ler e alterar Editor
validate_rule valida o rascunho inteiro e informa os avisos do editor Ler e alterar Editor
compare_rule_versions compara duas versões condição a condição, com a versão ativa como base por padrão Ler Somente leitura
simulate_rule simula uma versão com valores informados, inclusive um rascunho, e pode testar junto um rascunho de análise Ler Somente leitura

Listas

Ferramenta O que faz Acesso Perfil
list_lists lista as listas, com o tipo de valor, a quantidade de itens e as regras ativas que consultam cada lista Ler Somente leitura
describe_list descreve uma lista e, linha a linha e na sintaxe da regra, as regras que consultam a lista (in ou not in) ou incluem itens nela Ler Somente leitura
lookup_list_items verifica se até 100 valores estão na lista, com o autor, a data de inclusão, a validade e a descrição de cada item, sem consumir o limite de consultas Ler Somente leitura
list_list_items lista os itens de uma lista em páginas, com busca opcional por trecho do valor, e consome o limite de consultas Ler Somente leitura
add_list_items inclui até 1.000 valores em uma lista, com descrição e prazo de validade opcionais, e substitui um valor que já está na lista, informando o item substituído Ler e alterar Analista
remove_list_items remove até 1.000 valores de uma lista, informa os valores que não estavam na lista e avisa quando uma regra volta a incluir itens nela. A remoção de todos os itens é feita no painel Ler e alterar Analista

As inclusões e remoções valem a partir do evento seguinte, inclusive nas regras ativas.

Análises

Ferramenta O que faz Acesso Perfil
list_analyses lista as análises, com o tipo de evento, a versão ativa, a quantidade de células e as regras que executam e registram cada análise Ler Somente leitura
describe_analysis descreve uma versão de análise: as células em ordem e, nas versões ativas ou em observação (shadow), o efeito de cada célula nos últimos 30 dias Ler Somente leitura
create_analysis cria uma análise em um tipo de evento, com um nome que não pode ser alterado depois, e abre o primeiro rascunho Ler e alterar Editor
draft_analysis abre um rascunho a partir de uma versão, a ativa por padrão Ler e alterar Editor
add_analysis_cell inclui uma célula no rascunho, no fim, antes ou depois de outra célula Ler e alterar Editor
update_analysis_cell altera ou move uma célula do rascunho, e exige confirmação para uma alteração que reinicia a janela da célula Ler e alterar Editor
remove_analysis_cell remove uma célula do rascunho Ler e alterar Editor
compare_analysis_versions compara duas versões célula a célula, com as alterações que reiniciam a janela de uma célula Ler Somente leitura
simulate_analysis simula uma versão com valores informados e apresenta a medida de cada célula diante do gatilho Ler Somente leitura

O agente não publica regras nem análises: a publicação é feita no painel, pela comparação e publicação.