# Ferramentas O servidor MCP da Glass Data oferece ao [agente](/pt/admin/agent/) as ferramentas listadas nesta página, e o agente escolhe a ferramenta conforme a pergunta. Cada ferramenta exige um [nível de acesso](/pt/admin/agent/#contas-e-níveis-de-acesso) da conexão na conta e um [perfil de acesso](/pt/admin/users/#perfis-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](/pt/admin/agent/#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`](/pt/events/event_types/#tipo-de-evento-de-falhas) | **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](/pt/events/event_fields/#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](/pt/admin/export/) 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](/pt/rules/conditions/#ações-avulsas) 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](/pt/rules/conditions/#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](/pt/rules/simulation/) 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](/pt/rules/lists/), 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](/pt/rules/analyses/), 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](/pt/rules/versioning/#comparação-e-publicação).