**Nota: Para hacer uso de los agentes es necesario actualmente usar OpenAI como motor de IA.
Athento permite crear agentes de IA para ejecutar acciones sobre los documentos. Esto nos permite automatizar una serie de acciones sobre los documentos sin que tengamos que hacerlo manualmente.
Creación del agente
Para crear un agente debemos dirigirnos a la administración avanzada, concretamente al apartado "Athenea > Agentes". Dentro de este pulsaremos para crear un nuevo agente.
Para crear este nuevo agente debemos rellenar varios campos:
- Equipos: Se debe seleccionar en que equipos estará disponible el uso de este agente.
- Nombre: Nombre característico del agente.
- Prompt del sistema: Instrucciones que queremos que el agente lleve a cabo. Las instrucciones deben seguir el orden del flujo que queremos que ejecute nuestro agente. Ejemplo:
En el documento viene un correo de un usuaro. Debes obtener ese correo para busca información de la empresa y rellena automáticamente los metadatos nombre_empresa, sector y país. Ahora debes analizar si es una consulta válida. Es válida si has podido rellenar los metadatos del paso anterior. Si la consulta es válida cambia el estado del ciclo de vida al estado “Gestionada”. Si la consulta no es válida cambia el estado del ciclo de vida al estado “No es consulta”. Si el estado se ha movido a “Gestionada” ATHENTO creará un documento relacionado de tipo “X”. Debes solicitar este documento relacionado. Tras tener el documento de tipo "X", debes asignar a ese documento la empresa obtenida al inicio.
- Herramientas: Herramientas que podrá usar el agente. Debemos indicar aquellas herramientas que queremos que el agente tenga disponible para su uso. Si en las instrucciones indicamos que realice una acción pero el agente no la tiene disponible, esa acción no será ejecutada. Herramientas disponibles:
- Actualizar documento: Permite actualiza un campo o el nombre del documento.
- Actualizar el estado del ciclo de vida del documento.
- Crear documento.
- Ejecutar un automatismo.
- Obtener los documentos relacionados: Permite a la IA preguntar por un documento relacionado si necesita información sobre alguno de ellos.
Lanzamiento del agente
Para lanzar el agente debemos activar el automatismo "op_run_agent" en el espacio. Este automatismo lo encontraremos en la biblioteca de automatismos del espacio.
En este automatismo debemos configurar el agente que creamos anteriormente.
Una vez configurado podemos lanzar el agente para un documento concreto haciendo uso del automatismo. Tras lanzar el automatismo nos saldrá un mensaje de que el agente ha sido iniciado. La ejecución del agente se realizará en segundo plano.
Visualización de la ejecución del agente
Podremos ver el estado de ejecución del agente y las acciones que va realizando desde la administración avanzada. Para ello debemos dirigirnos al apartado "Athenea > Ejecuciones de agentes". En el veremos el listado de ejecuciones que se han ido realizando a lo largo del tiempo.
Si accedemos a una ejecución concreta podremos ver la siguiente información sobre ella:
- Agente: Agente que realizó la ejecución.
- Documento: Documento sobre el cual se ha lanzado el agente.
- Estado: Estado de la ejecución del agente sobre el documento. Los estados disponibles son:
- Pendiente (Pending): Estado inicial. La ejecución todavía no se ha iniciado y está pendiente de iniciarse.
- Ejecutando (Running): La ejecución se está realizando.
- Éxito (Success): La ejecución se ha realizado con éxito.
- Error: Se ha producido un error durante la ejecución.
- Cancelado: Se ha cancelado la ejecución por algún motivo.
- Salida: Mensaje de salida final del agente tras haber realizado la ejecución completa.
- Error: Error producido durante la ejecución. Si el estado es "error" aparecerá un mensaje aquí con el error correspondiente.
- Momento de inicio de la ejecución.
- Momento de finalización de la ejecución.
- Acciones que ha realizado el agente. Para las acciones veremos varios atributos:
- Herramienta ejecutada.
- Datos de entrada que el agente ha usado para ejecutar la herramienta.
- Datos de salida de la ejecución de la herramienta.
- Éxito: Indica si ha funciona correctamente o no.
- Error: En el caso de que haya dado error aparecerá un mensaje con el motivo.
¡Con esto tendremos un agente en Athento automatizando todo tipo de ejecuciones sobre nuestros documentos¡