Empleados virtuales¶

Un empleado virtual es un asistente con una tarea permanente: una instrucción que realiza por su cuenta, según un horario o cuando alguien elige Ejecutar ahora, como una cuenta propia con los derechos que le des a esa cuenta, dentro de límites de acciones y de tiempo, y capaz de preguntar a una persona antes de actuar. Cada vez que empieza es un run, que las personas siguen en el Cockpit. Esta página es para administradores: quienes tienen el rol de administrador de la organización.

Un empleado virtual puede exactamente lo que puede su cuenta, y nada más. La cuenta es una cuenta de servicio de tu organización, una por asistente, que comparten varios empleados virtuales de ese asistente. Dale a la cuenta solo lo que necesita el trabajo.

Quién puede qué¶

Los administradores y los operadores tienen los cuatro, un auditor tiene Ver, y los miembros y los administradores de personas no tienen ninguno; da a otros un rol personalizado. Aun sin derecho, las personas que el empleado virtual nombra para un evento, y quien inició un run, ven ese run, leen su historial y responden a sus preguntas.

En la pantalla¶

Abre los ajustes del asistente y elige la pestaña Triggers. La pestaña Runs a su lado lista los runs de ese asistente.

1. Configurar la cuenta. En la sección Actúa como, elige Configurar la cuenta. Elige los roles, grupos y valores de atributo que recibe la cuenta, como para una cuenta de servicio; solo puedes dar lo que tienes tú mismo. La cuenta se une a los miembros como cuenta de servicio. Los roles, grupos y el estado se cambian después en su página de miembro, que abre Gestionar roles y grupos en su página de miembro. Dale un derecho sobre el asistente y sobre todo lo que usen sus instrucciones.
2. Fijar un límite mensual, si quieres. En Actúa como, rellena Límite mensual (€): lo que pueden costar los runs de la cuenta en un mes natural. Core los detiene en ese límite. La sección también muestra los turnos, el coste y los rechazos de este mes, si tu organización te deja ver los costes.
3. Añadir un empleado virtual. Elige Añadir empleado virtual. Rellena Nombre e Instrucción; escribe la instrucción como se la pedirías a un colega. En Criterios para un run correcto puedes enumerar comprobaciones, una por línea; el asistente informa de cada una al terminar, y un run que no las cumple falla.
4. Elegir cuándo se ejecuta. En Programación, elige Repetir (cada día, cada semana un día concreto o cada mes: un día del 1 al 28, el primer a cuarto o el último de un día de la semana, o el último día del mes; a una hora), Una vez (un momento, tras el cual se desactiva solo) o, al final, Avanzado (cron) con cinco campos. Las horas se leen en la zona horaria mostrada. Dos momentos distan al menos cinco minutos. La pantalla muestra mientras escribes los cinco próximos momentos, leídos en Core, así que lo que ves es lo que se disparará.
5. Elegir si pregunta. Activa Aprobación humana y di con tus palabras cuándo el asistente involucra a una persona: entonces pide aprobación antes de una acción, o lo que falta. Si se deja vacío, pregunta antes de cualquier acción que cambie algo fuera de la conversación. Core retiene entonces las llamadas a herramientas del asistente hasta que una persona decide: una llamada que el asistente marca como por aprobar espera, igual que una que no marca; una llamada rechazada nunca se ejecuta. Una llamada que marca como sin aprobación se ejecuta enseguida: solo tus palabras guían esa elección, así que di con claridad qué hay que preguntar. Sin aprobación humana, un run solo espera a una persona cuando su cuenta necesita iniciar sesión en una conexión: se avisa a las personas nombradas para «requiere atención» y a tus administradores, y solo quien puede cambiar el empleado virtual y tiene todo lo que tiene su cuenta puede iniciar sesión, con la cuenta reservada para él, no con la suya. Sin ello, el run se detiene a los 7 días. Para que una herramienta pida aprobación en cada llamada, piense lo que piense el asistente, usa Herramientas que siempre piden aprobación (Hacer aprobar herramientas).
6. Elegir a quién se avisa. Por evento (iniciado, completado, requiere atención, fallido), elige los miembros y grupos a notificar. Quien figura aquí también ve los runs de ese empleado virtual y puede responder a sus preguntas. Un empleado virtual nuevo te avisa cuando un run requiere atención o falla. Recordatorio fija tras cuántas horas (1, 4 o 24) las personas consultadas reciben un recordatorio de una pregunta en espera.
7. Fijar los límites. Número máximo de acciones por run (hasta 250) y Límite de tiempo por run (minutos) (hasta 120; la espera de una persona no cuenta), y Límite de coste por run (€) (hasta 25 €, 2 € salvo que lo cambies), que solo ve y cambia quien tu organización deja ver los costes. Un run que supera un límite se detiene como fallido.
8. Guardar, y pruébalo con Ejecutar ahora. Si el empleado virtual ya tiene un run abierto, OS lo dice y no inicia nada.
9. Desactivar, cambiar, eliminar. El interruptor de la lista activa o desactiva el horario. Eliminar quita el empleado virtual y su horario; un run en curso se cancela y los runs terminados permanecen hasta que los elimines.

Todavía no construido: los disparadores de webhook y de correo, las variables de la instrucción y los inicios de sesión propios de la cuenta.

Lo que cuesta un run¶

Un run se mide bajo su cuenta, así que cuenta para la asignación de tu organización y para la cantidad de uso razonable de nadie. El coste de un run figura en Detalles en su página, solo para quien tu organización deja ver los costes.

Mediante la API¶

• GET, POST, PATCH y DELETE /api/v1/organisations/{id}/assistants/{agent_id}/virtual-employee-account leen, configuran, limitan y eliminan la cuenta.
• GET y POST /api/v1/organisations/{id}/virtual-employees; GET, PATCH (con If-Match) y DELETE …/virtual-employees/{employee_id}; POST …/virtual-employees/{employee_id}/run es Ejecutar ahora; POST …/virtual-employees/schedule-preview lee los cinco próximos momentos.
• GET …/runs lista runs, GET …/runs/summary los cuenta para un periodo y GET …/runs/attention cuenta los que esperan al solicitante.