Agentes de IA¶
Un agente de AI es un asistente virtual inteligente en Odoo que puede comprender el lenguaje natural, realizar tareas y ayudar a los usuarios interactuando con las herramientas de Odoo. Los agentes son un componente fundamental de la estructura de AI en Odoo. Cada agente tiene un propósito definido, un prompt y un conjunto de habilidades y herramientas que guían su comportamiento.
Al interactuar con un agente de AI, la interfaz de conversación puede mostrar mensajes de estado intermedios mientras se procesa una solicitud.
Estos mensajes reflejan el paso actual de la interacción, como analizar la solicitud, consultar fuentes o preparar una acción, antes de que se genere la respuesta final.
Los agentes están formados por dos componentes principales: habilidades y fuentes.
Las habilidades son las instrucciones y roles que indican al agente qué tareas debe completar. Las herramientas se asignan a las habilidades y son las funciones reales que el agente puede utilizar para realizar tareas.
Las Fuentes proporcionan al agente la información que necesita para completar sus tareas.
Importante
Aunque muchas funciones de IA se pueden usar en Odoo sin la aplicación IA, crear y personalizar agentes requiere que la aplicación IA esté instalada.
Prompts de IA en Odoo¶
Antes de trabajar con agentes de AI, es importante comprender algunos conceptos básicos sobre los prompts de AI.
Un prompt de IA es un conjunto de instrucciones escritas o contexto dado a un modelo de IA que le indica cómo responder a una solicitud o qué rol asumir. Los prompts pueden definir:
el tono, estilo y personalidad del modelo de IA
el alcance de lo que el modelo puede hacer
el tipo de resultado esperado de la solicitud
En Odoo, a cada agente de AI se le asigna un prompt de sistema, que define el rol general, el propósito y el comportamiento del agente. Actúa como la declaración de misión principal del agente e impulsa todas las interacciones. Durante una conversación, los prompts de sistema y las instrucciones de las habilidades se aplican de forma continua. Influyen en cómo interpreta el agente los mensajes, selecciona las herramientas, utiliza las fuentes y determina si se requieren acciones adicionales antes de responder.
Cada habilidad también incluye su propio componente tipo prompt, denominado Instrucciones. Las instrucciones son directrices específicas de la habilidad que definen con mayor detalle cómo se comporta el agente dentro de un determinado contexto o flujo de trabajo, y cómo interactúa dentro del marco de Odoo.
Las instrucciones a menudo incluyen:
Un propósito, o lo que cubre la habilidad.
Reglas o restricciones que debe seguir el agente cuando se le asigna esta habilidad.
Flujos de trabajo paso a paso sobre cómo completar una acción específica
Detalles técnicos necesarios para completar cualquier acción
Estructura del agente¶
Habilidades¶
Las habilidades son una colección de instrucciones y herramientas que definen cómo se comporta un agente dentro de un contexto específico. En esencia, las habilidades definen lo que un agente puede hacer dentro de la base de datos. Guían las conversaciones indicándole al agente qué puede hacer, cómo puede hacerlo y cuándo debe hacerlo.
Importante
Si a un agente no se le asigna ninguna habilidad, solo podrá facilitar información. No puede completar tareas ni realizar cambios en la base de datos.
Dentro de cada habilidad hay un prompt detallado que proporciona al agente instrucciones más precisas sobre cómo realizar las tareas asociadas a dicha habilidad, definir los límites de su comportamiento y determinar cómo debe interpretar la intención del usuario. Estos prompts garantizan que el agente siga un patrón de razonamiento coherente y utilice las herramientas adecuadas para generar respuestas precisas y adaptadas al contexto.
Las siguientes habilidades están preconfiguradas en la aplicación IA:
Creador de vistas: permite interpretar una consulta del usuario para abrir la vista adecuada de Odoo con el conjunto de herramientas necesarias para realizar la búsqueda. Las consultas en lenguaje natural también pueden incluir instrucciones de agrupación temporal. Esto permite a los agentes agrupar los resultados por intervalos de tiempo, como día, mes o año, al consultar registros.
Recuperación de información: una colección de herramientas para recuperar información sobre los modelos.
Actualizar registros: herramientas para actualizar registros.
Crear registros: herramientas para crear registros.
Generar imágenes: colección de herramientas para facilitar la generación de imágenes. Carga esta habilidad cuando el usuario pida generar o mejorar una imagen.
Búsqueda web: permite al agente explorar Internet en tiempo real.
Creador de sitios web: herramientas para editar páginas del sitio web de Odoo.
Crear leads: colección de herramientas para facilitar la creación automatizada de leads. Esta habilidad solo está disponible si la aplicación CRM está instalada.
Dentro de cada habilidad hay un conjunto de Instrucciones, que actúan como prompt y orientan sobre la estructura de la interacción, y una o más Herramientas de IA, que indican las funciones que puede realizar el agente.
Herramientas¶
Las herramientas son las funciones que el agente puede realizar en Odoo. Entre ellas se incluyen acciones como crear un lead o abrir una vista. Las herramientas amplían la utilidad del agente más allá de las conversaciones y le permiten ejecutar acciones reales. Las herramientas disponibles en una base de datos varían según las aplicaciones instaladas. Se pueden asignar varias Herramientas de IA a una sola habilidad.
Fuentes¶
Las fuentes son los datos a los que el agente puede referirse al generar respuestas o completar tareas. Las fuentes están indexadas para que el agente pueda recuperar información relevante cuando un usuario hace una pregunta.
Example
Un agente diseñado para responder preguntas de soporte al cliente tiene artículos de Información incluidos como fuentes, que incluyen preguntas frecuentes.
Las fuentes pueden estar en los siguientes formatos:
Enlaces web
Documentos (cargados en la aplicación Documentos)
Artículos de la aplicación Información
Importante
Si la opción Restringir a fuentes está habilitada en un agente, el agente solo puede utilizar información de las fuentes cargadas y activas.
Archivos subidos¶
Durante una conversación con un agente de AI, puedes aportar contexto adicional subiendo archivos. Los archivos se tratan temporalmente como fuentes para la conversación en curso. El agente puede utilizar su contenido para responder preguntas, resumir información o extraer detalles relevantes.
Los archivos proporcionados solo influyen en la conversación actual, a menos que se añadan explícitamente como fuentes en el agente.
Para adjuntar un archivo en una conversación, haz clic en el icono (círculo con signo más) de la ventana de mensajes y, a continuación, haz clic en Adjuntar archivos. En la ventana del explorador de archivos, selecciona uno o más archivos para adjuntar y haz clic en Abrir.
Example
Un responsable encuentra un recibo de suministros y no está seguro de si ya se ha enviado a la aplicación Gastos para su reembolso. Abre una conversación con el agente Preguntar a la IA e introduce el siguiente prompt:
¿Puedes abrir el gasto que coincide con este recibo?
Adjunta el recibo al mensaje. Tras analizar el archivo adjunto, el agente abre la vista del gasto correcto.
Obtén información a partir de los archivos previsualizados¶
Cuando un documento está abierto en el modo de vista previa, los agentes de AI pueden utilizar el contenido del archivo previsualizado como contexto para la conversación.
En primer lugar, ve a la aplicación y haz clic en un documento para previsualizarlo. Haz clic en el icono AI situado en la parte superior de la página para abrir la ventana de chat de Preguntar a la IA. Desde aquí, haz clic en una de las instrucciones predeterminadas para usarla o introduce una personalizada en la ventana de mensaje.
En este caso, las respuestas del agente se fundamentan en el archivo que se está previsualizando, junto con cualquier otra fuente asignada al agente.
Crear un nuevo agente¶
Para crear un nuevo agente de AI, ve a la aplicación y haz clic en Nuevo. Introduce un Nombre del agente y añade una breve descripción si lo deseas.
Truco
Antes de crear un nuevo agente, se recomienda tener claro un caso de uso. Esto ayuda al redactar el Prompt del sistema y al asignar las Habilidades y las Herramientas de IA.
A continuación, selecciona un Estilo de Respuesta. Esto gestiona el tono general que usa el agente al responder a una consulta. Elige una de las siguientes opciones:
Estándar: mantiene un tono equilibrado y profesional. Proporciona respuestas claras y directas con un nivel moderado de detalle.
Matizado: ofrece respuestas sofisticadas y profundamente contextualizadas. Explora múltiples perspectivas, reconoce matices y utiliza un lenguaje académico y preciso cuando corresponde.
Ágil y creativo: directo, dinámico y muy atractivo. Da prioridad a la brevedad y al ingenio. Utiliza un lenguaje expresivo, metáforas y una estructura dinámica para mantener el interés del usuario.
Lento y riguroso: da prioridad absoluta a la precisión y a la solidez lógica por encima de todo. Desglosa pasos complejos, cita razonamientos con claridad y verifica cada afirmación. Adopta un tono meticuloso y formal.
Marca la casilla Restringir a las fuentes para limitar al agente a responder solo a partir de los recursos proporcionados.
A continuación, selecciona una o varias Habilidades para el agente. Como se ha explicado anteriormente, las Habilidades incluyen tanto instrucciones como herramientas que guían al agente para ayudar a los usuarios a completar una tarea.
Introduce un Prompt del Sistema con instrucciones detalladas para el agente sobre su rol y responsabilidades.
Truco
La especificidad y longitud del Prompt del Sistema puede variar, dependiendo del caso de uso para el agente. Usa los agentes preconfigurados como ejemplo de la posible información.
Si se necesitan Fuentes para el agente, desplázate a la pestaña Fuentes, luego haz clic en Agregar una fuente.
Selecciona un formato:
Subir un archivo: selecciona el archivo correspondiente en la ventana del explorador y haz clic en Abrir.
Añadir un enlace: pega la URL. Puedes añadir varios enlaces a la vez pegando un enlace por línea. Haz clic en Guardar.
Añadir desde Documentos (subidos a la aplicación Documentos): marca la casilla situada junto a uno o varios documentos y haz clic en Seleccionar.
Añadir desde Conocimiento: marca la casilla situada junto a uno o varios artículos y haz clic en Seleccionar.
Una vez que se agrega una fuente, el campo Estado se actualiza para reflejar su estado actual. La fuente está lista cuando el estado cambia de Procesando a Indexado. Desliza el interruptor Activo para activar la fuente.
Importante
Si una fuente no se sube, puede deberse a un conflicto con el proveedor seleccionado.
Haz clic en el botón Probar para abrir una ventana de conversación y probar el nuevo agente.
Reprocesar fuentes manualmente¶
Si el contenido de una fuente cambia después de indexarse, puede que sea necesario reprocesarla para que los agentes utilicen la información más reciente. El reprocesamiento se puede iniciar manualmente y garantiza que los documentos, enlaces o artículos de Conocimiento actualizados se reflejen en las respuestas futuras del agente.
Para reprocesar una fuente, ve a la aplicación . Selecciona un agente de AI y, en la tarjeta kanban, haz clic en el icono (puntos suspensivos verticales) y luego en Configuración.
En la pestaña Fuentes, haz clic en Reprocesar junto a cualquier fuente que deba actualizarse.
