Gobernanza y confianza

Cómo se aplican el acceso, la autenticación y los valores predeterminados seguros cuando un agente de codificación actúa en tu organización de UiPath.

Cuando un agente de codificación crea y ejecuta el trabajo de UiPath, actúa a través de la CLI uip bajo tu identidad de inicio de sesión. Comprender ese límite es lo que hace que el flujo de trabajo sea seguro de adoptar en una empresa.

Importante:

En esta página se describe el modelo de confianza previsto. Confirma los detalles con las políticas de seguridad de tu organización y el comportamiento actual de la plataforma antes de confiar en ellos para tomar decisiones de cumplimiento.

Directrices recomendadas antes de empezar

Antes de permitir que un agente de codificación actúe en tu organización de UiPath, recomendamos las siguientes prácticas para apoyar el uso compatible y responsable.

• Autenticación. Se recomienda una cuenta dedicada y tokenizada con permisos mínimos, en lugar de una que herede tu acceso completo. Esto limita el impacto si el token se ve comprometido en algún momento y mantiene las acciones del agente auditables por separado de las tuyas en un entorno controlado y rastreable.
• Configuración. El modo de ejecución atendido mantiene a un humano al tanto y reduce el riesgo de acciones autónomas no intencionadas. La opción unattended requiere permisos elevados o sin restricciones y conlleva más riesgos, por lo que el modo atendido es el predeterminado más seguro.
• Barreras de seguridad. Las barreras de seguridad adecuadas en el agente de codificación de terceros, establecidas antes de que se le dé acceso al entorno de UiPath, ayudan a limitar lo que el agente puede hacer y reducir el riesgo de comportamiento inesperado o malicioso. Es mejor definir cuidadosamente el ámbito de los permisos del agente antes de la implementación.
• Datos personales. Cuando se procesan datos personales, dicho procesamiento debe permitirse según las políticas de tu organización y los requisitos de protección de datos aplicables antes de habilitar o expandir el acceso del agente.
• Supervisión humana. En cualquier paso en el que tus procesos internos requieran un punto de control o aprobación, la supervisión humana sigue siendo necesaria.

ADVERTENCIA:

Descargo de responsabilidad: un agente de codificación no valida el cumplimiento del código generado. Eres responsable de revisar todo el código generado antes de implementarlo en producción, de acuerdo con tus políticas internas.

El agente actúa como tú

La CLI se autentica como una identidad de UiPath específica en una organización y un tenant específicos. Todo lo que haga tu agente de codificación a través de la CLI está limitado por los permisos de esa identidad: no puede acceder a los recursos a los que no puede acceder la cuenta que ha iniciado sesión. Por lo tanto, el acceso al ámbito funciona de la misma manera que siempre lo ha hecho en UiPath: a través de roles, carpetas y asignación de tenants.

Autenticación e identidad

El inicio de sesión interactivo utiliza su navegador y el inicio de sesión normal de su organización, incluidas las políticas multifactor y de acceso condicional. Para contextos automatizados, la autenticación no interactiva utiliza credenciales que tú aprovisionas y controlas. El agente nunca necesita tu contraseña; funciona con la sesión que establece la CLI.

Secretos y credenciales

Las credenciales y los secretos pertenecen a tu almacén de secretos o a la gestión de secretos de tu sistema CI/CD, no a solicitudes, archivos de proyecto o control de origen. La misma disciplina que aplicas a cualquier automatización se aplica aquí.

Datos que recopilamos

Dos fuentes envían la telemetría de uso del producto a Azure Application Insights, propiedad de UiPath, alojado en la región de Europa Occidental: la uip telemetría de comandos de la CLI y las habilidades de UiPath que el agente de codificación invoca a través de la CLI. Ambos aterrizan en el mismo recurso gestionado por UiPath y están etiquetados para que se distingan. Los datos nos ayudan a comprender qué comandos y habilidades se utilizan y dónde fallan.

La telemetría de habilidades está desactivada de forma predeterminada : consulta Activar o desactivar la telemetría a continuación.

Qué se recopila

• Uso de comandos y habilidades : para cada comando uip o llamada de herramienta basada en habilidades: el nombre del comando o herramienta, el subcomando uip derivado (sus primeros uno o dos verbos, nunca la línea de comandos completa), el nombre de la habilidad (solo habilidades de UiPath), cuánto tiempo se ejecutó y si tuvo éxito, se interrumpió o falló (con el mensaje de error para los comandos CLI).
• Tipo de archivo : la extensión de archivo involucrada en una llamada de herramienta (por ejemplo, .flow), nunca la ruta del archivo.
• Entorno : las versiones de CLI y habilidades, el entorno en la nube derivado de tu inicio de sesión (por ejemplo, alfa, preparación o producción) y qué agente de codificación de IA invocó CLI (por ejemplo, Claude Code, Cursor, Gemini CLI o Códice).
• Identidad : tu identidad de UiPath cloud iniciada: ID de usuario de cloud, ID de tenant e ID de organización. Esta telemetría no es anónima; lleva la misma identidad que el uip de la actividad de CLI.
• ID de correlación : identificadores de sesión y por llamada que vinculan los pasos de una sola ejecución.

Lo que nunca se recopila

Los siguientes nunca salen de tu máquina, aunque el agente y CLI los leen localmente para hacer su trabajo:

• Contenido del archivo, salida del comando (stdout y stderr) y transcripciones del agente.
• Líneas de comando completas: solo el verbo de subcomando derivado.
• Rutas de archivo y tu directorio de trabajo: solo la extensión del archivo.

Cada campo de telemetría se extrae de una parte específica y acotada de la carga útil, por lo que el contenido de forma libre (como la salida que contiene una ruta o un nombre de comando) no puede filtrarse en un campo. Para la telemetría de comandos propia de la CLI, los valores se redactan adicionalmente en el origen. Todo lo que se parezca a cualquiera de los siguientes se reemplaza por [REDACTED]:

• Token o clave
• Secreto o contraseña
• Credencial o certificado

Los identificadores y los correos electrónicos se codifican; Las URL se reducen a su host.

A dónde va

Azure Application Insights, propiedad de UiPath, en la región de Europa Occidental. La conexión es propiedad de la CLI; las habilidades nunca lo mantienen. Puedes enrutar la telemetría a una instancia diferente con la variable de entorno UIPATH_AI_CONNECTION_STRING , aunque esto no es necesario en el uso normal.

Retención

La retención se rige por la configuración del espacio de trabajo de Application Insights en lugar de por la CLI o las habilidades. Azure Application Insights tiene un valor predeterminado de 90 días, a menos que el espacio de trabajo esté configurado de otra manera. Tu equipo de plataforma puede confirmar el período de retención configurado antes de que confíes en él.

Activar o desactivar la telemetría

Una sola variable de entorno, UIPATH_TELEMETRY_DISABLED, controla ambas fuentes, pero sus valores predeterminados difieren:

• La telemetría de habilidades está desactivada de forma predeterminada. Solo se envía cuando estableces explícitamente UIPATH_TELEMETRY_DISABLED=0.
• La propia telemetría de comandos de la CLI se envía a menos que se desactive configurando UIPATH_TELEMETRY_DISABLED=1.
• Toda la telemetría se puede deshabilitar configurando UIPATH_TELEMETRY_DISABLED=1. Cuando está deshabilitado, no se envía nada y CLI mantiene solo el registro de depuración local.

Mantener el control

Los agentes de codificación proponen acciones y, en sus configuraciones estándar, muestran comandos de superficie para que los apruebe antes de ejecutarlos. Revisar lo que generó el agente, y lo que está a punto de ejecutar, antes de aprobar mantiene a un humano al tanto de cualquier cambio de estado en tu organización.

Para investigar incidencias cuando algo sale mal, consulta Resolución de problemas y preguntas frecuentes.