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
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.