Herramientas

El conector tiene 149 herramientas: 73 de lectura y 76 de escritura, de las cuales 19 son destructivas (borran, detienen o finalizan algo). El asistente elige las herramientas por su cuenta a partir de tu pedido: no necesitas saber los nombres. Esta lista sirve para saber qué puedes pedir y qué permiso del perfil exige cada cosa.

• Lectura funciona con la conexión de lectura. Escritura exige la conexión de lectura y escritura y la escritura habilitada en la organización. Ver Permisos y seguridad.
• Destructiva: borra, detiene o finaliza algo; el asistente lo confirma contigo antes de llamarla.
• Permiso del perfil: el permiso que tu perfil necesita tener en la organización, como en la pantalla Perfiles. Además de él, se aplica la regla de equipo de la automatización.

Automatizaciones y componentes

Automatizaciones, carpetas, tags, sistemas, componentes y parámetros: lo que hacen las pantallas de Automatizaciones y de Configuración.

Herramienta	Qué hace
list_automations	Lista las automatizaciones que ves, con filtros por nombre, carpeta, tag, componente y mobile Lectura · permiso automation.automation.read
get_automation	Detalle de una automatización y sus datasets, con la última ejecución Lectura · permiso automation.automation.read
create_automation	Crea una automatización Escritura · permiso automation.automation.create
update_automation	Modifica el nombre, el identificador, la descripción, la carpeta, los tags, el proceso de negocio y los equipos de una automatización privada Escritura · permiso automation.automation.update
delete_automation	Borra la automatización con todos sus datasets y el historial de ejecuciones Escritura, destructiva · permiso automation.automation.delete
list_automation_folders	Lista las carpetas de automatización Lectura · permiso automation.automation.read
create_automation_folder	Crea una carpeta, dentro de otra si quieres Escritura · permiso automation.automation.update
list_tags	Lista los tags, con cuántas automatizaciones y datasets usan cada uno Lectura · permiso automation.tag.read
create_tag	Crea un tag Escritura · permiso automation.tag.create
list_systems	Lista los sistemas y el repositorio git vinculado a cada uno Lectura · permiso config.system.read
create_system	Crea un sistema, vinculado o no a un repositorio Escritura · permiso config.system.create
create_git_repository	Registra el repositorio git con el código de un sistema Escritura · permiso config.gitRepository.create
list_components	Lista los componentes con la documentación y el sistema; con undocumented, solo los que no tienen documentación Lectura · permiso automation.component.read
get_component	Detalle de un componente, con los parámetros de entrada y de salida Lectura · permiso automation.component.read
create_component	Crea un componente en un sistema, con los parámetros Escritura · permiso automation.component.create
update_component	Modifica el nombre, el sistema, la documentación y los parámetros de un componente Escritura · permiso automation.component.update
list_parameters	Lista los parámetros de la organización Lectura · permiso automation.parameter.read
create_parameters	Crea parámetros (in_ o out_); lo que ya existe con el mismo nombre se reutiliza Escritura · permiso automation.parameter.create
get_parameter_usage	Dónde se usa un parámetro: componentes, datasets, automatizaciones y última ejecución Lectura · permiso automation.parameter.read
update_parameter	Renombra un parámetro o cambia la descripción, y recuerda cambiar el nombre en el código Escritura · permiso automation.parameter.update
add_components_to_dataset	Incluye componentes como pasos de un dataset, en el orden indicado Escritura · permiso automation.datasetComponent.create
remove_component_from_dataset	Quita un paso de un dataset Escritura, destructiva · permiso automation.datasetComponent.delete

Datasets

Datasets (las versiones de una automatización), valores de los parámetros, variables del dataset y parámetros generales.

Herramienta	Qué hace
list_datasets	Lista los datasets de una automatización Lectura · permiso automation.dataset.read
get_dataset	Detalle de un dataset: los pasos en orden, cada valor y las variables Lectura · permiso automation.dataset.read
get_dataset_grid	Todos los datasets de una automatización uno al lado del otro, como la lista de la pantalla Lectura · permiso automation.dataset.read
create_dataset	Crea un dataset como copia de otro (con pasos, valores y variables) o en blanco Escritura · permiso automation.dataset.create
update_dataset	Modifica la descripción, los tags y el ambiente predeterminado de un dataset Escritura · permiso automation.dataset.update
delete_datasets	Borra datasets, con los pasos, los valores y el historial de ejecuciones Escritura, destructiva · permiso automation.dataset.delete
add_dataset_parameters	Incluye parámetros en un paso de un dataset Escritura · permiso automation.datasetParameter.create
set_dataset_parameter_value	Guarda el valor de un parámetro del dataset Escritura · permiso automation.datasetParameter.update
list_parameter_value_options	Lo que el valor puede referenciar: salida de un paso anterior, variable, parámetro general o salida de otro dataset Lectura · permiso automation.datasetParameter.read
set_step_expected_result	Guarda el resultado esperado de un paso en este dataset Escritura · permiso automation.datasetComponent.update
remove_dataset_parameter	Quita un parámetro (y su valor) de un paso Escritura, destructiva · permiso automation.datasetParameter.delete
preview_dataset_changes	Muestra lo que cambiaría una modificación en lote de los valores, sin guardar nada Lectura · permiso automation.dataset.update
apply_dataset_changes	Guarda la modificación en lote en una sola transacción: ante cualquier error, no se guarda nada Escritura · permiso automation.dataset.update
list_dataset_variables	Lista las variables de un dataset Lectura · permiso automation.datasetVariable.read
create_dataset_variable	Crea una variable en el dataset Escritura · permiso automation.datasetVariable.create
update_dataset_variable	Modifica el nombre o el valor de una variable del dataset Escritura · permiso automation.datasetVariable.update
list_general_parameters	Lista los parámetros generales, compartidos por todas las automatizaciones Lectura · permiso automation.generalParameter.read
create_general_parameter	Crea un parámetro general Escritura · permiso automation.generalParameter.create
update_general_parameter	Modifica un parámetro general Escritura · permiso automation.generalParameter.update

Ambientes

Los ambientes de la ejecución (Homologación, Producción) y sus variables. Una variable secreta entra por el conector, pero el valor nunca vuelve.

Herramienta	Qué hace
list_environments	Lista los ambientes con las variables y cuántos datasets usan cada uno; los secretos vuelven como *** Lectura · permiso automation.environment.read
create_environment	Crea un ambiente, también como copia de otro Escritura · permiso automation.environment.create
update_environment	Renombra el ambiente, cambia la descripción o lo marca como de producción Escritura · permiso automation.environment.update
delete_environment	Borra el ambiente y sus variables Escritura, destructiva · permiso automation.environment.delete
set_environment_variable	Crea o modifica una variable por el nombre, incluso secreta Escritura · permiso automation.environment.update
delete_environment_variable	Borra una variable del ambiente Escritura, destructiva · permiso automation.environment.update
set_datasets_environment	Define el ambiente predeterminado de varios datasets a la vez Escritura · permiso automation.dataset.update

Runners, grupos y ejecuciones

Runners, grupos de automatización, ciclos, disparo, recurrencias y seguimiento de las ejecuciones, como en el Centro de Automatización.

Runners y clusters

Herramienta	Qué hace
list_runners	Lista los runners que puedes usar, con estado, CPU y memoria; con onlyAvailable, solo los activos y que no están Offline Lectura · permiso infrastructure.runner.read
list_clusters	Lista los clusters y los runners de cada uno Lectura · permiso infrastructure.cluster.read
list_cloud_runners	Lista los cloud runners encendidos y las máquinas disponibles, con el precio por hora Lectura · permiso infrastructure.cloudRunner.read
start_cloud_runner	Enciende un cloud runner: una máquina en la nube, paga por hora hasta que se apague Escritura · permiso infrastructure.cloudRunner.create
stop_cloud_runner	Apaga un cloud runner y finaliza el cobro Escritura, destructiva · permiso infrastructure.cloudRunner.delete

Grupos y ciclos

Herramienta	Qué hace
list_automation_groups	Lista los grupos de automatización, con la finalidad (prueba u operación) Lectura · permiso automation.automationGroup.read
get_automation_group	Un grupo con sus ciclos y los datasets de un ciclo, con el estado de cada uno Lectura · permiso automation.automationGroup.read
create_automation_group	Crea un grupo con el primer ciclo y, si quieres, los datasets o las automatizaciones Escritura · permiso automation.automationGroup.create
add_datasets_to_group	Incluye datasets (o el dataset más reciente de automatizaciones) en un grupo Escritura · permiso automation.automationGroup.create
remove_dataset_from_group	Quita un dataset del grupo; las ejecuciones pasadas se mantienen Escritura, destructiva · permiso automation.automationGroup.delete
list_cycles	Lista los ciclos de un grupo Lectura · permiso automation.cycle.read
create_cycle	Crea un ciclo vacío o con los datasets de otro ciclo Escritura · permiso automation.cycle.create
set_cycle_open	Cierra o reabre un ciclo Escritura · permiso automation.cycle.update

Disparo y recurrencia

Herramienta	Qué hace
run_datasets	Ejecuta datasets de un ciclo en un runner o cluster, ahora o programado, con el ambiente y la rama de trabajo Escritura · permiso automation.automationCenter.run
list_scheduled_runs	Lista los lotes programados de un ciclo y, durante 7 días, los que no se ejecutaron, con el motivo Lectura · permiso automation.automationCenter.read
list_recurring_runs	Lista las recurrencias, con la frecuencia, el runner, la próxima ejecución y el motivo de la pausa Lectura · permiso automation.automationCenter.read
create_recurring_run	Crea una recurrencia: cada N minutos u horas, diaria, semanal o mensual Escritura · permiso automation.automationCenter.run
update_recurring_run	Pausa, reanuda, renombra o cambia la frecuencia, el runner, el ambiente y las ramas de una recurrencia Escritura · permiso automation.automationCenter.run
delete_recurring_run	Borra una recurrencia y cancela sus lotes que todavía no salieron Escritura, destructiva · permiso automation.automationCenter.run
stop_run	Detiene una ejecución enviada, en espera o en curso Escritura, destructiva · permiso automation.automationCenter.run
stop_cycle_runs	Detiene las ejecuciones en curso de un ciclo Escritura, destructiva · permiso automation.automationCenter.run

Seguimiento

Herramienta	Qué hace
get_run_status	Estado de las ejecuciones de un lote o de ejecuciones elegidas Lectura · permiso automation.datasetRun.read
list_dataset_runs	Historial de ejecuciones de un dataset Lectura · permiso automation.datasetRun.read
get_run	Detalle de una ejecución: estado, motivo del fin, inicio, fin, duración, quién la detuvo, Correlation ID y commit de cada repositorio; también la encuentra por el Correlation ID Lectura · permiso automation.datasetRun.read
get_run_log	Log, mensaje de error y diagnóstico del fallo por la IA; filtra por nivel y por texto Lectura · permiso automation.datasetRun.read
search_run_logs	Busca en el log de varias ejecuciones por texto y nivel, en un período de hasta 31 días Lectura · permiso automation.datasetRun.read
get_run_evidence	Evidencias de una ejecución: capturas de cada paso, videos y adjuntos Lectura · permiso automation.datasetRun.read

Agenda

Todo lo que está programado para ejecutarse en la organización, con los horarios en tu zona horaria.

Herramienta	Qué hace
get_agenda	Lo que se ejecuta en un período (lotes programados y recurrencias) y lo que ya se ejecutó, con el resultado; hasta 62 días Lectura · permiso automation.automationCenter.read
cancel_scheduled_run	Cancela un lote programado que todavía no se ejecutó; queda en la agenda como cancelado Escritura, destructiva · permiso automation.automationCenter.run
delete_scheduled_run	Elimina un lote programado que todavía no se ejecutó; sale de la agenda Escritura, destructiva · permiso automation.automationCenter.run
reschedule_run	Cambia la hora de un lote programado, o lo ejecuta ahora Escritura · permiso automation.automationCenter.run
run_recurring_now	Ejecuta una recurrencia ahora, una vez, sin cambiar la regla Escritura · permiso automation.automationCenter.run
skip_recurring_occurrence	Salta una ocurrencia futura de una recurrencia, o deshace el salto Escritura · permiso automation.automationCenter.run

Informes y análisis

Los números de las ejecuciones y del acervo, como los muestran el Dashboard y la página Análisis de IA.

Herramienta	Qué hace
get_execution_overview	Visión general de un período: total, aprobadas, fallidas, tasa de éxito, tendencia diaria y lo que se ejecuta ahora Lectura · permiso automation.datasetRun.read
get_top_failures	Datasets que más fallaron en un período Lectura · permiso automation.datasetRun.read
get_most_executed	Datasets que más se ejecutaron en un período Lectura · permiso automation.datasetRun.read
get_recent_runs	Ejecuciones más recientes Lectura · permiso automation.datasetRun.read
get_period_numbers	Los números de un período frente a otro: tasa de éxito, ejecuciones válidas, fallos y duración promedio Lectura · permiso automation.datasetRun.read
get_cycle_summary	Cuántos datasets de un ciclo están en cada estado Lectura · permiso automation.datasetRun.read
get_execution_insights	Informes de ejecución, con desglose por proceso, área responsable y responsable del proceso Lectura · permiso automation.datasetRun.read
get_asset_insights	Salud del acervo de automatizaciones, datasets y componentes, incluso los que no tienen documentación Lectura · permiso automation.automation.read

Procesos, documentación y trazabilidad

Procesos de negocio, personas y áreas de la organización, el diagrama BPMN, el documento de la automatización, la matriz de trazabilidad, el análisis de impacto y el historial de cambios.

Herramienta	Qué hace
list_processes	Lista los procesos de negocio en árbol, con criticidad, responsable y área responsable Lectura · permiso organization.process.read
get_process	Detalle de un proceso, con subprocesos, personas, áreas y automatizaciones Lectura · permiso organization.process.read
create_process	Crea un proceso de negocio Escritura · permiso organization.process.create
update_process	Modifica un proceso de negocio Escritura · permiso organization.process.update
delete_process	Borra un proceso de negocio Escritura, destructiva · permiso organization.process.delete
list_people	Lista las personas de los procesos (responsables e involucrados, sin acceso a Proton) Lectura · permiso organization.person.read
create_person	Registra una persona de proceso Escritura · permiso organization.person.create
update_person	Modifica una persona de proceso Escritura · permiso organization.person.update
delete_person	Borra una persona de proceso Escritura, destructiva · permiso organization.person.delete
list_business_areas	Lista las áreas de negocio, con cuántas personas y procesos tiene cada una Lectura · permiso organization.businessArea.read
create_business_area	Crea un área de negocio Escritura · permiso organization.businessArea.create
update_business_area	Renombra un área o cambia la descripción Escritura · permiso organization.businessArea.update
delete_business_area	Borra un área de negocio Escritura, destructiva · permiso organization.businessArea.delete
get_traceability_matrix	Matriz de trazabilidad: proceso, automatización, dataset y última ejecución, con cobertura y documentación Lectura · permiso organization.process.read
get_component_impact	Lo que afecta un cambio en el componente: datasets, automatizaciones, procesos y grupos Lectura · permiso automation.component.read
get_system_impact	Lo que afecta un cambio en el sistema (pantalla nueva, versión, ambiente) Lectura · permiso config.system.read
get_audit_trail	Historial de cambios de proceso, persona, área, componente o automatización: quién, cuándo y de qué valor a cuál Lectura · permiso automation.automation.read
get_automation_document	El documento de la automatización, con el proceso, los pasos documentados, los datos usados y el resultado esperado Lectura · permiso automation.automation.read
get_process_diagram	El diagrama BPMN de un proceso, con las tareas y los componentes de cada una Lectura · permiso organization.process.read
import_process_diagram	Importa una versión nueva del diagrama BPMN (XML BPMN 2.0) Escritura · permiso organization.process.update
link_process_task	Vincula componentes a una tarea del diagrama Escritura · permiso organization.process.update
remove_process_diagram	Quita el diagrama BPMN de un proceso, con todas las versiones Escritura, destructiva · permiso organization.process.update

Jira: requisitos y bugs

Con la integración de Jira Cloud registrada en Proton.

Herramienta	Qué hace
list_jira_integrations	Lista las integraciones de Jira Cloud Lectura · permiso automation.requirement.read
search_jira_issues	Busca issues en Jira por la clave o por texto en el resumen Lectura · permiso automation.requirement.read
list_requirements	Requisitos (issues de Jira) cubiertos por una automatización o dataset Lectura · permiso automation.requirement.read
link_requirement	Vincula un issue de Jira como requisito de una automatización o de un dataset Escritura · permiso automation.requirement.update
unlink_requirement	Deshace el vínculo de un requisito Escritura, destructiva · permiso automation.requirement.update
list_defects	Bugs de Jira vinculados a una ejecución o a un dataset Lectura · permiso automation.defect.read
get_defect_draft	Lo que Proton sabe de una ejecución para abrir un bug: paso que falló, error, log y análisis de la IA Lectura · permiso automation.defect.create
create_defect	Abre un bug en Jira a partir de una ejecución, con el informe en PDF y el enlace de vuelta Escritura · permiso automation.defect.create
link_defect	Vincula un bug que ya existe a una ejecución Escritura · permiso automation.defect.create

Xray y Zephyr

Gestión de pruebas en Jira, con la integración de Xray Cloud o de Zephyr registrada en Proton.

Herramienta	Qué hace
list_xray_integrations	Lista las integraciones de Xray Cloud y de Zephyr Lectura · permiso automation.automationGroup.read
get_group_test_management	Dónde publica un grupo los resultados: proyecto, Test Plan y lo que crea Proton Lectura · permiso automation.automationGroup.read
set_group_test_management	Hace que el grupo publique cada lote en una Test Execution, vinculada al Test Plan Escritura · permiso automation.automationGroup.update
remove_group_test_management	El grupo deja de publicar los resultados Escritura, destructiva · permiso automation.automationGroup.update
publish_batch_to_xray	Publica un lote de nuevo ahora Escritura · permiso automation.automationGroup.update
link_dataset_to_xray_test	Apunta un dataset a un Test que ya existe Escritura · permiso automation.dataset.update
search_xray_test_plans	Busca Test Plans por la clave o por una palabra del resumen Lectura · permiso automation.automationGroup.create
preview_xray_plan_import	Muestra lo que haría la importación de un Test Plan, sin cambiar nada Lectura · permiso automation.automationGroup.create
import_xray_plan	Importa un Test Plan como grupo de automatización, o sincroniza el grupo que ya vino de él Escritura · permiso automation.automationGroup.create
get_automation_xray_tests	El Test de cada dataset de una automatización Lectura · permiso automation.dataset.read
get_run_xray_links	Dónde está una ejecución en Xray: Test Execution, Test y Test Plan, con los enlaces Lectura · permiso automation.datasetRun.read
create_xray_tests	Crea un Test manual, con los pasos, para cada dataset que todavía no lo tiene Escritura · permiso automation.dataset.update
list_xray_folders	Carpetas del repositorio de Tests de un proyecto de Jira Lectura · permiso automation.dataset.read
run_xray_issue	Ejecuta a partir de un issue de Xray (Test Plan o Test Execution), como la regla de Jira Automation Escritura · permiso automation.automationCenter.run

Operación de robots

La cola de ocurrencias de los grupos de Operación. Solo con el módulo de RPA activado en la organización.

Herramienta	Qué hace
list_run_exceptions	Lista la cola de ocurrencias: robots que fallaron, no se ejecutaron o se trabaron Lectura · permiso operation.exception.read
get_run_exception	Una ocurrencia con su línea de tiempo Lectura · permiso operation.exception.read
update_run_exception	Asigna una ocurrencia, cambia su estado con una nota o la comenta Escritura · permiso operation.exception.update
rerun_run_exception	Reejecuta ahora; si pasa, la ocurrencia se resuelve Escritura · permiso operation.exception.update

Repositorios git

La parte de git que antes solo hacía la pantalla. El conector solo lee tu git, por la integración registrada en Proton: ninguna herramienta escribe en el repositorio.

Herramienta	Qué hace
list_git_integrations	Lista las integraciones git (GitHub, GitLab, Bitbucket), sin la credencial Lectura · permiso config.integration.read
list_repository_branches	Lista las ramas de un repositorio, leídas en el proveedor Lectura · permiso config.system.read
update_git_repository	Cambia la rama predeterminada, la descripción o la integración de un repositorio registrado Escritura · permiso config.gitRepository.update
update_system	Renombra un sistema o lo vincula a otro repositorio registrado Escritura · permiso config.system.update

Proyecto desde cero y revisión

Iniciar un proyecto de automatización con la IA y revisar el código y el registro antes de ejecutar. Ver Proyecto desde cero.

Herramienta	Qué hace
get_project_template	El modelo público del lenguaje (Python o Java) para clonar, con las reglas del proyecto Lectura · sin permiso de perfil
generate_component_code	El archivo del componente en el formato del modelo, con cada parámetro leído por el nombre Lectura · permiso automation.component.read
check_project	Revisa el código del repositorio frente al contrato del proyecto y el registro de los componentes, solo leyendo Lectura · permiso config.gitRepository.read
check_automation	Revisa si los datasets están listos para ejecutarse: pasos, valores, referencias, secretos, ambiente, runner y ciclo Lectura · permiso automation.dataset.read

Personas

Herramienta	Qué hace
list_users	Usuarios de la organización, con perfil, licencia y equipos Lectura · permiso identity.user.read

Documentación de Proton

Herramienta	Qué hace
search_proton_documentation	Busca en esta documentación Lectura · sin permiso de perfil
get_documentation_recommendations	Artículos de esta documentación relacionados con un tema Lectura · sin permiso de perfil