Ferramentas

O conector tem 149 ferramentas: 73 de leitura e 76 de escrita, das quais 19 são destrutivas (apagam, param ou encerram algo). O assistente escolhe as ferramentas sozinho a partir do seu pedido: você não precisa saber os nomes. Esta lista serve para saber o que dá para pedir e qual permissão do perfil cada coisa exige.

• Leitura funciona com a conexão de leitura. Escrita exige a conexão de leitura e escrita e a escrita liberada na organização. Ver Permissões e segurança.
• Destrutiva: apaga, para ou encerra algo; o assistente confirma com você antes de chamar.
• Permissão do perfil: a permissão que o seu perfil precisa ter na organização, como na tela Perfis. Além dela, vale a regra de equipe da automação.

Automações e componentes

Automações, pastas, tags, sistemas, componentes e parâmetros: o que a tela de Automações e de Configuração faz.

Ferramenta	O que faz
list_automations	Lista as automações que você vê, com filtros por nome, pasta, tag, componente e mobile Leitura · permissão automation.automation.read
get_automation	Detalhe de uma automação e os datasets dela, com a última execução Leitura · permissão automation.automation.read
create_automation	Cria uma automação Escrita · permissão automation.automation.create
update_automation	Altera nome, identificador, descrição, pasta, tags, processo de negócio e as equipes de uma automação privada Escrita · permissão automation.automation.update
delete_automation	Apaga a automação com todos os datasets e o histórico de execuções Escrita, destrutiva · permissão automation.automation.delete
list_automation_folders	Lista as pastas de automação Leitura · permissão automation.automation.read
create_automation_folder	Cria uma pasta, dentro de outra se quiser Escrita · permissão automation.automation.update
list_tags	Lista as tags, com quantas automações e datasets usam cada uma Leitura · permissão automation.tag.read
create_tag	Cria uma tag Escrita · permissão automation.tag.create
list_systems	Lista os sistemas e o repositório git ligado a cada um Leitura · permissão config.system.read
create_system	Cria um sistema, ligado ou não a um repositório Escrita · permissão config.system.create
create_git_repository	Cadastra o repositório git com o código de um sistema Escrita · permissão config.gitRepository.create
list_components	Lista os componentes com a documentação e o sistema; com undocumented, só os sem documentação Leitura · permissão automation.component.read
get_component	Detalhe de um componente, com os parâmetros de entrada e de saída Leitura · permissão automation.component.read
create_component	Cria um componente num sistema, com os parâmetros Escrita · permissão automation.component.create
update_component	Altera nome, sistema, documentação e parâmetros de um componente Escrita · permissão automation.component.update
list_parameters	Lista os parâmetros da organização Leitura · permissão automation.parameter.read
create_parameters	Cria parâmetros (in_ ou out_); o que já existe com o mesmo nome é reaproveitado Escrita · permissão automation.parameter.create
get_parameter_usage	Onde um parâmetro é usado: componentes, datasets, automações e última execução Leitura · permissão automation.parameter.read
update_parameter	Renomeia um parâmetro ou muda a descrição, e lembra de trocar o nome no código Escrita · permissão automation.parameter.update
add_components_to_dataset	Inclui componentes como passos de um dataset, na ordem dada Escrita · permissão automation.datasetComponent.create
remove_component_from_dataset	Tira um passo de um dataset Escrita, destrutiva · permissão automation.datasetComponent.delete

Datasets

Datasets (as versões de uma automação), valores dos parâmetros, variáveis do dataset e parâmetros gerais.

Ferramenta	O que faz
list_datasets	Lista os datasets de uma automação Leitura · permissão automation.dataset.read
get_dataset	Detalhe de um dataset: os passos em ordem, cada valor e as variáveis Leitura · permissão automation.dataset.read
get_dataset_grid	Todos os datasets de uma automação lado a lado, como a lista da tela Leitura · permissão automation.dataset.read
create_dataset	Cria um dataset como cópia de outro (com passos, valores e variáveis) ou em branco Escrita · permissão automation.dataset.create
update_dataset	Altera descrição, tags e ambiente padrão de um dataset Escrita · permissão automation.dataset.update
delete_datasets	Apaga datasets, com os passos, os valores e o histórico de execuções Escrita, destrutiva · permissão automation.dataset.delete
add_dataset_parameters	Inclui parâmetros num passo de um dataset Escrita · permissão automation.datasetParameter.create
set_dataset_parameter_value	Grava o valor de um parâmetro do dataset Escrita · permissão automation.datasetParameter.update
list_parameter_value_options	O que o valor pode referenciar: saída de passo anterior, variável, parâmetro geral ou saída de outro dataset Leitura · permissão automation.datasetParameter.read
set_step_expected_result	Grava o resultado esperado de um passo neste dataset Escrita · permissão automation.datasetComponent.update
remove_dataset_parameter	Tira um parâmetro (e o valor) de um passo Escrita, destrutiva · permissão automation.datasetParameter.delete
preview_dataset_changes	Mostra o que uma alteração em lote dos valores mudaria, sem gravar nada Leitura · permissão automation.dataset.update
apply_dataset_changes	Grava a alteração em lote numa transação só: com qualquer erro, nada é gravado Escrita · permissão automation.dataset.update
list_dataset_variables	Lista as variáveis de um dataset Leitura · permissão automation.datasetVariable.read
create_dataset_variable	Cria uma variável no dataset Escrita · permissão automation.datasetVariable.create
update_dataset_variable	Altera nome ou valor de uma variável do dataset Escrita · permissão automation.datasetVariable.update
list_general_parameters	Lista os parâmetros gerais, compartilhados por todas as automações Leitura · permissão automation.generalParameter.read
create_general_parameter	Cria um parâmetro geral Escrita · permissão automation.generalParameter.create
update_general_parameter	Altera um parâmetro geral Escrita · permissão automation.generalParameter.update

Ambientes

Os ambientes da execução (Homologação, Produção) e as variáveis deles. Variável segredo entra pelo conector, mas o valor nunca volta.

Ferramenta	O que faz
list_environments	Lista os ambientes com as variáveis e quantos datasets usam cada um; segredo volta como *** Leitura · permissão automation.environment.read
create_environment	Cria um ambiente, também como cópia de outro Escrita · permissão automation.environment.create
update_environment	Renomeia, muda a descrição ou marca o ambiente como de produção Escrita · permissão automation.environment.update
delete_environment	Apaga o ambiente e as variáveis dele Escrita, destrutiva · permissão automation.environment.delete
set_environment_variable	Cria ou altera uma variável pelo nome, inclusive segredo Escrita · permissão automation.environment.update
delete_environment_variable	Apaga uma variável do ambiente Escrita, destrutiva · permissão automation.environment.update
set_datasets_environment	Define o ambiente padrão de vários datasets de uma vez Escrita · permissão automation.dataset.update

Runners, grupos e execuções

Runners, grupos de automação, ciclos, disparo, recorrências e acompanhamento das execuções, como no Centro de Automação.

Runners e clusters

Ferramenta	O que faz
list_runners	Lista os runners que você pode usar, com status, CPU e memória; com onlyAvailable, só os ativos e fora de Offline Leitura · permissão infrastructure.runner.read
list_clusters	Lista os clusters e os runners de cada um Leitura · permissão infrastructure.cluster.read
list_cloud_runners	Lista os cloud runners ligados e as máquinas disponíveis, com o preço por hora Leitura · permissão infrastructure.cloudRunner.read
start_cloud_runner	Liga um cloud runner: uma máquina na nuvem, paga por hora até ser desligada Escrita · permissão infrastructure.cloudRunner.create
stop_cloud_runner	Desliga um cloud runner e encerra a cobrança Escrita, destrutiva · permissão infrastructure.cloudRunner.delete

Grupos e ciclos

Ferramenta	O que faz
list_automation_groups	Lista os grupos de automação, com a finalidade (teste ou operação) Leitura · permissão automation.automationGroup.read
get_automation_group	Um grupo com os ciclos e os datasets de um ciclo, com o status de cada um Leitura · permissão automation.automationGroup.read
create_automation_group	Cria um grupo com o primeiro ciclo e, se quiser, os datasets ou as automações Escrita · permissão automation.automationGroup.create
add_datasets_to_group	Inclui datasets (ou o dataset mais recente de automações) num grupo Escrita · permissão automation.automationGroup.create
remove_dataset_from_group	Tira um dataset do grupo; as execuções passadas ficam Escrita, destrutiva · permissão automation.automationGroup.delete
list_cycles	Lista os ciclos de um grupo Leitura · permissão automation.cycle.read
create_cycle	Cria um ciclo vazio ou com os datasets de outro ciclo Escrita · permissão automation.cycle.create
set_cycle_open	Fecha ou reabre um ciclo Escrita · permissão automation.cycle.update

Disparo e recorrência

Ferramenta	O que faz
run_datasets	Executa datasets de um ciclo num runner ou cluster, agora ou agendado, com o ambiente e a branch de trabalho Escrita · permissão automation.automationCenter.run
list_scheduled_runs	Lista os lotes agendados de um ciclo e, por 7 dias, os que não rodaram, com o motivo Leitura · permissão automation.automationCenter.read
list_recurring_runs	Lista as recorrências, com a frequência, o runner, a próxima execução e o motivo da pausa Leitura · permissão automation.automationCenter.read
create_recurring_run	Cria uma recorrência: a cada N minutos ou horas, diária, semanal ou mensal Escrita · permissão automation.automationCenter.run
update_recurring_run	Pausa, retoma, renomeia ou muda a frequência, o runner, o ambiente e as branches de uma recorrência Escrita · permissão automation.automationCenter.run
delete_recurring_run	Apaga uma recorrência e cancela os lotes dela que ainda não saíram Escrita, destrutiva · permissão automation.automationCenter.run
stop_run	Para uma execução enviada, aguardando ou rodando Escrita, destrutiva · permissão automation.automationCenter.run
stop_cycle_runs	Para as execuções em andamento de um ciclo Escrita, destrutiva · permissão automation.automationCenter.run

Acompanhamento

Ferramenta	O que faz
get_run_status	Status das execuções de um lote ou de execuções escolhidas Leitura · permissão automation.datasetRun.read
list_dataset_runs	Histórico de execuções de um dataset Leitura · permissão automation.datasetRun.read
get_run	Detalhe de uma execução: status, motivo do fim, início, fim, duração, quem parou, Correlation ID e commit de cada repositório; acha também pelo Correlation ID Leitura · permissão automation.datasetRun.read
get_run_log	Log, mensagem de erro e diagnóstico da falha pela IA; filtra por nível e por texto Leitura · permissão automation.datasetRun.read
search_run_logs	Busca no log de várias execuções por texto e nível, num período de até 31 dias Leitura · permissão automation.datasetRun.read
get_run_evidence	Evidências de uma execução: prints de cada passo, vídeos e anexos Leitura · permissão automation.datasetRun.read

Agenda

Tudo o que está programado para rodar na organização, com as horas no seu fuso.

Ferramenta	O que faz
get_agenda	O que roda num período (lotes agendados e recorrências) e o que já rodou, com o resultado; até 62 dias Leitura · permissão automation.automationCenter.read
cancel_scheduled_run	Cancela um lote agendado que ainda não rodou; ele fica na agenda como cancelado Escrita, destrutiva · permissão automation.automationCenter.run
delete_scheduled_run	Exclui um lote agendado que ainda não rodou; ele sai da agenda Escrita, destrutiva · permissão automation.automationCenter.run
reschedule_run	Muda a hora de um lote agendado, ou o executa agora Escrita · permissão automation.automationCenter.run
run_recurring_now	Executa uma recorrência agora, uma vez, sem mudar a regra Escrita · permissão automation.automationCenter.run
skip_recurring_occurrence	Pula uma ocorrência futura de uma recorrência, ou desfaz o pulo Escrita · permissão automation.automationCenter.run

Relatórios e análises

Os números das execuções e do acervo, como o Dashboard e a página Análises da IA mostram.

Ferramenta	O que faz
get_execution_overview	Visão geral de um período: total, passou, falhou, taxa de sucesso, tendência diária e o que roda agora Leitura · permissão automation.datasetRun.read
get_top_failures	Datasets que mais falharam num período Leitura · permissão automation.datasetRun.read
get_most_executed	Datasets que mais rodaram num período Leitura · permissão automation.datasetRun.read
get_recent_runs	Execuções mais recentes Leitura · permissão automation.datasetRun.read
get_period_numbers	Os números de um período contra outro: taxa de sucesso, execuções válidas, falhas e duração média Leitura · permissão automation.datasetRun.read
get_cycle_summary	Quantos datasets de um ciclo estão em cada status Leitura · permissão automation.datasetRun.read
get_execution_insights	Relatórios de execução, com recorte por processo, área responsável e dono Leitura · permissão automation.datasetRun.read
get_asset_insights	Saúde do acervo de automações, datasets e componentes, inclusive os sem documentação Leitura · permissão automation.automation.read

Processos, documentação e rastreabilidade

Processos de negócio, pessoas e áreas da organização, o diagrama BPMN, o documento da automação, a matriz de rastreabilidade, a análise de impacto e o histórico de mudanças.

Ferramenta	O que faz
list_processes	Lista os processos de negócio em árvore, com criticidade, dono e área responsável Leitura · permissão organization.process.read
get_process	Detalhe de um processo, com subprocessos, pessoas, áreas e automações Leitura · permissão organization.process.read
create_process	Cria um processo de negócio Escrita · permissão organization.process.create
update_process	Altera um processo de negócio Escrita · permissão organization.process.update
delete_process	Apaga um processo de negócio Escrita, destrutiva · permissão organization.process.delete
list_people	Lista as pessoas dos processos (donos e envolvidos, sem login no Proton) Leitura · permissão organization.person.read
create_person	Cadastra uma pessoa de processo Escrita · permissão organization.person.create
update_person	Altera uma pessoa de processo Escrita · permissão organization.person.update
delete_person	Apaga uma pessoa de processo Escrita, destrutiva · permissão organization.person.delete
list_business_areas	Lista as áreas de negócio, com quantas pessoas e processos cada uma tem Leitura · permissão organization.businessArea.read
create_business_area	Cria uma área de negócio Escrita · permissão organization.businessArea.create
update_business_area	Renomeia uma área ou muda a descrição Escrita · permissão organization.businessArea.update
delete_business_area	Apaga uma área de negócio Escrita, destrutiva · permissão organization.businessArea.delete
get_traceability_matrix	Matriz de rastreabilidade: processo, automação, dataset e última execução, com cobertura e documentação Leitura · permissão organization.process.read
get_component_impact	O que uma mudança no componente afeta: datasets, automações, processos e grupos Leitura · permissão automation.component.read
get_system_impact	O que uma mudança no sistema afeta (tela nova, versão, ambiente) Leitura · permissão config.system.read
get_audit_trail	Histórico de mudanças de processo, pessoa, área, componente ou automação: quem, quando e de qual valor para qual Leitura · permissão automation.automation.read
get_automation_document	O documento da automação, com o processo, os passos documentados, os dados usados e o resultado esperado Leitura · permissão automation.automation.read
get_process_diagram	O diagrama BPMN de um processo, com as tarefas e os componentes de cada uma Leitura · permissão organization.process.read
import_process_diagram	Importa uma versão nova do diagrama BPMN (XML BPMN 2.0) Escrita · permissão organization.process.update
link_process_task	Liga componentes a uma tarefa do diagrama Escrita · permissão organization.process.update
remove_process_diagram	Remove o diagrama BPMN de um processo, com todas as versões Escrita, destrutiva · permissão organization.process.update

Jira: requisitos e bugs

Com a integração do Jira Cloud cadastrada no Proton.

Ferramenta	O que faz
list_jira_integrations	Lista as integrações do Jira Cloud Leitura · permissão automation.requirement.read
search_jira_issues	Busca issues no Jira pela chave ou por texto no resumo Leitura · permissão automation.requirement.read
list_requirements	Requisitos (issues do Jira) cobertos por uma automação ou dataset Leitura · permissão automation.requirement.read
link_requirement	Liga uma issue do Jira como requisito de uma automação ou de um dataset Escrita · permissão automation.requirement.update
unlink_requirement	Desfaz a ligação de um requisito Escrita, destrutiva · permissão automation.requirement.update
list_defects	Bugs do Jira ligados a uma execução ou a um dataset Leitura · permissão automation.defect.read
get_defect_draft	O que o Proton sabe de uma execução para abrir um bug: passo que falhou, erro, log e análise da IA Leitura · permissão automation.defect.create
create_defect	Abre um bug no Jira a partir de uma execução, com o relatório em PDF e o link de volta Escrita · permissão automation.defect.create
link_defect	Liga um bug que já existe a uma execução Escrita · permissão automation.defect.create

Xray e Zephyr

Gestão de testes no Jira, com a integração do Xray Cloud ou do Zephyr cadastrada no Proton.

Ferramenta	O que faz
list_xray_integrations	Lista as integrações do Xray Cloud e do Zephyr Leitura · permissão automation.automationGroup.read
get_group_test_management	Onde um grupo publica os resultados: projeto, Test Plan e o que o Proton cria Leitura · permissão automation.automationGroup.read
set_group_test_management	Faz o grupo publicar cada lote numa Test Execution, ligada ao Test Plan Escrita · permissão automation.automationGroup.update
remove_group_test_management	O grupo deixa de publicar os resultados Escrita, destrutiva · permissão automation.automationGroup.update
publish_batch_to_xray	Publica um lote de novo agora Escrita · permissão automation.automationGroup.update
link_dataset_to_xray_test	Aponta um dataset para um Test que já existe Escrita · permissão automation.dataset.update
search_xray_test_plans	Busca Test Plans pela chave ou por uma palavra do resumo Leitura · permissão automation.automationGroup.create
preview_xray_plan_import	Mostra o que a importação de um Test Plan faria, sem mudar nada Leitura · permissão automation.automationGroup.create
import_xray_plan	Importa um Test Plan como grupo de automação, ou sincroniza o grupo que já veio dele Escrita · permissão automation.automationGroup.create
get_automation_xray_tests	O Test de cada dataset de uma automação Leitura · permissão automation.dataset.read
get_run_xray_links	Onde uma execução está no Xray: Test Execution, Test e Test Plan, com os links Leitura · permissão automation.datasetRun.read
create_xray_tests	Cria um Test manual, com os passos, para cada dataset que ainda não tem Escrita · permissão automation.dataset.update
list_xray_folders	Pastas do repositório de Tests de um projeto do Jira Leitura · permissão automation.dataset.read
run_xray_issue	Executa a partir de uma issue do Xray (Test Plan ou Test Execution), como a regra do Jira Automation Escrita · permissão automation.automationCenter.run

Operação de robôs

A fila de ocorrências dos grupos de Operação. Só com o módulo de RPA ligado na organização.

Ferramenta	O que faz
list_run_exceptions	Lista a fila de ocorrências: robôs que falharam, não rodaram ou travaram Leitura · permissão operation.exception.read
get_run_exception	Uma ocorrência com a linha do tempo Leitura · permissão operation.exception.read
update_run_exception	Atribui, muda o status com uma nota ou comenta uma ocorrência Escrita · permissão operation.exception.update
rerun_run_exception	Reexecuta agora; se passar, a ocorrência se resolve Escrita · permissão operation.exception.update

Repositórios git

A parte git que antes só a tela fazia. O conector só lê o git do cliente, pela integração cadastrada no Proton: nenhuma ferramenta grava no repositório.

Ferramenta	O que faz
list_git_integrations	Lista as integrações git (GitHub, GitLab, Bitbucket), sem a credencial Leitura · permissão config.integration.read
list_repository_branches	Lista as branches de um repositório, lidas no provedor Leitura · permissão config.system.read
update_git_repository	Muda a branch padrão, a descrição ou a integração de um repositório cadastrado Escrita · permissão config.gitRepository.update
update_system	Renomeia um sistema ou o liga a outro repositório cadastrado Escrita · permissão config.system.update

Projeto do zero e conferência

Começar um projeto de automação com a IA e conferir código e cadastro antes de rodar. Ver Projeto do zero.

Ferramenta	O que faz
get_project_template	O modelo público da linguagem (Python ou Java) para clonar, com as regras do projeto Leitura · sem permissão de perfil
generate_component_code	O arquivo do componente no formato do modelo, com cada parâmetro lido pelo nome Leitura · permissão automation.component.read
check_project	Confere o código do repositório contra o contrato do projeto e o cadastro dos componentes, só lendo Leitura · permissão config.gitRepository.read
check_automation	Confere se os datasets estão prontos para rodar: passos, valores, referências, segredos, ambiente, runner e ciclo Leitura · permissão automation.dataset.read

Pessoas

Ferramenta	O que faz
list_users	Usuários da organização, com perfil, licença e equipes Leitura · permissão identity.user.read

Documentação do Proton

Ferramenta	O que faz
search_proton_documentation	Busca nesta documentação Leitura · sem permissão de perfil
get_documentation_recommendations	Artigos desta documentação ligados a um assunto Leitura · sem permissão de perfil