> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toolkit de Automation Anywhere

> Despliega y gestiona bots de Automation Anywhere desde dentro de un flujo de trabajo.

El **Toolkit de Automation Anywhere** permite que sus flujos de trabajo interactúen con la APA Control Room de Automation Anywhere — desplegando bots, monitoreando su estado, recuperando su salida, listando bots disponibles y cancelando ejecuciones activas.

## Autenticación

Todas las herramientas de Automation Anywhere requieren una conexión a Control Room. Cada herramienta incluye un selector de **Conexión**. Si no hay una conexión configurada, haga clic en **Agregar conexión** para crear una.

Al crear una conexión, proporcione lo siguiente:

| Campo                        | Obligatorio | Descripción                                                                                                      |
| ---------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
| **Nombre de la conexión**    | Sí          | Una etiqueta para identificar esta conexión (por ejemplo, `conexion-control-room`).                              |
| **URL de Control Room**      | Sí          | La URL de su Control Room de Automation Anywhere (por ejemplo, `https://su-empresa.automationanywhere.digital`). |
| **Nombre de usuario**        | Sí          | Su nombre de usuario de Automation Anywhere.                                                                     |
| **Versión de autenticación** | Sí          | Seleccione `Autenticación V2` para usar una clave API, o `Autenticación V1` para usar una contraseña.            |
| **Credencial**               | Sí          | Su clave API (para V2) o contraseña (para V1). Escriba `@` para hacer referencia a un secreto de vault.          |

## Herramientas

### Desplegar bot

Despliega un bot de Automation Anywhere desde la Control Room conectada.

| Campo                                | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conexión**                         | Sí          | Seleccione una conexión de Control Room configurada.                                                                                                                                                                                                                                                                                                                                                                             |
| **ID del bot**                       | Sí          | El ID del bot a desplegar. Escriba `@` para seleccionar una variable.                                                                                                                                                                                                                                                                                                                                                            |
| **Nombre de la automatización**      | No          | Nombre de la automatización. El valor predeterminado es `null`.                                                                                                                                                                                                                                                                                                                                                                  |
| **Descripción de la automatización** | No          | Descripción de la automatización que se despliega. El valor predeterminado es `null`.                                                                                                                                                                                                                                                                                                                                            |
| **Entrada del bot**                  | No          | Array de entradas para el bot. Haga clic en **Agregar elemento** para añadir entradas, o habilite **Modo JSON** para pegar datos o usar variables `@`. El valor predeterminado es `null`.                                                                                                                                                                                                                                        |
| **Tipo de despliegue**               | No          | Tipo de solicitud de despliegue. Opciones: `Solicitud atendida`, `Solicitud no atendida`, `Solicitud sin cabeza`. El valor predeterminado es `Solicitud no atendida`.                                                                                                                                                                                                                                                            |
| **IDs de usuario Run As**            | No          | Array de IDs de usuario para ejecutar el bot. El bot se desplegará en uno de los dispositivos de la lista proporcionada. Escriba `@` en cualquier elemento para hacer referencia a una variable. El valor predeterminado es `null`.                                                                                                                                                                                              |
| **IDs de pool**                      | No          | Array de IDs de pool que especifican el número de usuarios run-as a usar. Escriba `@` en cualquier elemento para hacer referencia a una variable. El valor predeterminado es `null`.                                                                                                                                                                                                                                             |
| **Número de usuarios Run As**        | No          | Cuántos usuarios run-as se deben usar de la lista `IDs de usuario Run As`. Si no se especifica, el despliegue se realizará en todos los dispositivos disponibles en la lista. El valor predeterminado es `0`.                                                                                                                                                                                                                    |
| **Iniciar en ventana secundaria**    | No          | Especifica cómo se seleccionan los dispositivos de despliegue. Opciones: `RUN_ONLY_ON_DEFAULT_DEVICE` — solo se usa el dispositivo predeterminado; `PREFER_DEFAULT_DEVICE` — prefiere el dispositivo predeterminado y, si no está disponible, usa otro dispositivo del pool; `RUN_ON_POOL_DEVICES` — el bot se desplegará en cualquier dispositivo disponible del pool. El valor predeterminado es `RUN_ONLY_ON_DEFAULT_DEVICE`. |
| **Continuar en caso de fallo**       | No          | Si es `true`, omite este paso y continúa el flujo de trabajo normalmente si falla. El valor predeterminado es `false`.                                                                                                                                                                                                                                                                                                           |
| **Reintentar en caso de fallo**      | No          | Si es `true`, reintenta automáticamente hasta cuatro intentos cuando el paso falla. El valor predeterminado es `false`.                                                                                                                                                                                                                                                                                                          |

### Obtener estado del bot

Recupera el estado de ejecución actual de un bot desplegado.

| Campo                       | Obligatorio | Descripción                                                                                                                     |
| --------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Conexión**                | Sí          | Seleccione una conexión de Control Room configurada.                                                                            |
| **ID de despliegue**        | Sí          | El ID de despliegue para verificar el estado. Escriba `@` para seleccionar una variable.                                        |
| **Sondear hasta completar** | No          | Cuando está habilitado, sigue verificando el estado del bot hasta que se complete o falle, en lugar de devolver inmediatamente. |

### Obtener salida del bot

Recupera la salida devuelta por un despliegue de bot completado.

| Campo                | Obligatorio | Descripción                                                                               |
| -------------------- | ----------- | ----------------------------------------------------------------------------------------- |
| **Conexión**         | Sí          | Seleccione una conexión de Control Room configurada.                                      |
| **ID de despliegue** | Sí          | El ID de despliegue del que obtener la salida. Escriba `@` para seleccionar una variable. |

### Listar bots

Recupera una lista de bots disponibles en la Control Room conectada.

| Campo              | Obligatorio | Descripción                                                        |
| ------------------ | ----------- | ------------------------------------------------------------------ |
| **Conexión**       | Sí          | Seleccione una conexión de Control Room configurada.               |
| **Filtrar nombre** | No          | Filtra bots por nombre. El valor predeterminado es `null`.         |
| **Límite**         | No          | Número máximo de bots a devolver. El valor predeterminado es `50`. |

### Cancelar ejecución de bot

Cancela un despliegue de bot activo en la Control Room conectada.

| Campo                | Obligatorio | Descripción                                                                                        |
| -------------------- | ----------- | -------------------------------------------------------------------------------------------------- |
| **Conexión**         | Sí          | Seleccione una conexión de Control Room configurada.                                               |
| **ID de despliegue** | Sí          | El ID de despliegue de la ejecución del bot a cancelar. Escriba `@` para seleccionar una variable. |
