Agentes de IA

Un agente de IA es un asistente inteligente dentro de Odoo que puede entender el lenguaje natural e interactuar con las herramientas del sistema para realizar tareas y ayudar a los usuarios. Los agentes son un componente clave en la estructura de IA de Odoo. Cada agente tiene un propósito, instrucciones y conjunto de temas determinados que le indican cómo comportarse.

Los agentes están compuestos por dos componentes principales, Temas y Fuentes.

  • Los temas son instrucciones y roles que le informan al agente las tareas que necesita completar. Se asignan herramientas a los temas y son las funciones que el agente puede utilizar para realizar tareas.

  • Las fuentes le dan al agente la información que necesita para completar las tareas.

Importante

Aunque se pueden usar muchas funciones de IA en Odoo sin la aplicación IA, es necesario instalar la aplicación para poder crear y personalizar agentes.

Instrucciones de IA en Odoo

Antes de trabajar con agentes de IA, es importante entender algunos conceptos básicos sobre las instrucciones para IA.

Una instrucción para IA es un conjunto de indicaciones o contexto escritos que se le dan a un modelo de IA para decirle cómo responder a una solicitud o qué función realizar. Las instrucciones pueden definir:

  • El tono, estilo y personalidad del modelo de IA.

  • El enfoque de lo que el modelo puede hacer.

  • El tipo de respuesta que se espera para una solicitud.

En Odoo a cada agente se le asigna una instrucción del sistema que definirá la función, propósito y comportamiento general del agente. Esta instrucción es la declaración principal de objetivos del agente e impulsa todas sus interacciones.

Cada tema también incluye un componente propio llamado indicaciones. Las indicaciones son reglas específicas del tema que pulen el comportamiento del agente en un contexto o flujo de trabajo y la forma en la que interactúa dentro del marco de trabajo de Odoo.

Las indicaciones suelen incluir:

  • Un propósito o de qué trata el tema.

  • Reglas o limitaciones que el agente debe seguir cuando se le asigna este tema.

  • Los flujos de trabajo paso a paso para poder completar una acción específica.

  • Detalles técnicos necesarios para completar cualquier acción.

Estructura del agente

Temas

Los temas son una colección de indicaciones y herramientas que definen cómo se comporta un agente dentro de un contexto específico. Dicho de otra forma, los temas definen qué puede hacer un agente dentro de una base de datos.

Importante

Si no se le asigna un tema a un agente, el agente podrá dar información, pero no podrá realizar tareas o cambios en la base de datos.

Los temas guían las conversaciones pues le dicen al agente qué puede hacer, cómo lo puede hacer y cuándo lo debe hacer. Cada tema incluye una instrucción detallada que le da al agente información más precisa sobre cómo realizar una tarea.

Los temas a continuación están preconfigurados en la aplicación IA:

  • Natural Language Search (Buscar en lenguaje natural): Un conjunto de herramientas necesarias para realizar una búsqueda. Permite interpretar la consulta de un usuario y abrir la vista indicada de Odoo.

  • Information retrieval (Recuperar información): Un conjunto de herramientas para recuperar información sobre los modelos.

  • Create Leads (Crear leads): Un conjunto de herramientas para la creación automatizada de leads. Este tema solo está disponible si se instala la aplicación CRM.

Cada tema tiene un conjunto de indicaciones que funcionan como una instrucción y guían la estructura de la interacción; además, 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 dentro de Odoo y que incluyen acciones como crear un lead o abrir una vista. Las herramientas amplían el propósito del agente a más que solo conversaciones y permiten que realice acciones reales. Las herramientas disponibles en una base de datos dependen de las aplicaciones instaladas. Se pueden asignar varias herramientas de IA a un mismo tema.

Fuentes

Las fuentes son los datos que el agente puede usar como referencia al generar respuestas o completar tareas. Las fuentes están indexadas para que el agente pueda recuperar información relevante al responder la pregunta de un usuario.

Example

Un agente creado para responder preguntas de soporte al cliente tiene páginas de Artículos incluidas como fuentes. En estas páginas también se incluirán las preguntas más frecuentes.

Los formatos de las fuentes pueden ser:

  • PDF

  • Enlaces

  • Documentos (que se hayan subido a la aplicación Documentos)

  • Páginas de la aplicación Artículos

Importante

Si se habilita la opción Limitar a las fuentes en un agente, el agente solo puede utilizar la información de fuentes subidas o activas.

Crear un agente nuevo

Para crear un agente de IA nuevo, ve a la aplicación IA ‣ Nuevo. Ingresa el nombre del agente y agrega una descripción corta, si lo deseas.

Truco

Antes de crear un agente nuevo, recomendamos que tengas un caso de uso específico en mente. Esto te ayudará al momento de escribir la instrucción del sistema y a asignar temas y herramientas de IA.

Selecciona un modelo de lenguaje de gran tamaño (LLM) del menú desplegable.

Importante

Odoo es compatible con varias versiones de ChatGPT y Gemini.

Ahora selecciona un estilo de la respuesta. Esta opción indica el tono general que el agente usará cuando responda a una consulta; puedes seleccionar una de las siguientes opciones:

  • Analítico: Es un tono más matemático, con esta opción es más probable obtener la misma respuesta para la misma pregunta. Esta opción es ideal para situaciones donde la exactitud es más importante que el profesionalismo.

  • Equilibrado: Este tono es una mezcla entre el analítico y el creativo. Es una opción excelente para situaciones con clientes externos que necesitan exactitud y profesionalismo.

  • Creativo: Este tono responde a las preguntas con un tono más humano, no siempre responde lo mismo pues reacciona a la conversación. Esta opción es mejor para cuando las soluciones pueden cambiar según la situación.

Selecciona la opción Limitar a las fuentes para que el agente solo responda según las fuentes que hayas agregado.

Después, selecciona uno o más temas para el agente. Como se explicó antes, los temas incluyen indicaciones y herramientas que le indican al agente cómo ayudar a los usuarios a completar una tarea.

Ingresa una instrucción del sistema con indicaciones para el agente donde detalles su rol y sus responsabilidades.

Truco

La longitud y especificidad de la instrucción del sistema puede cambiar dependiendo de para qué se usará el agente. Consulta los agentes preconfigurados para ver ejemplos de instrucciones posibles.

Captura de pantalla del formulario de un agente nuevo con la información necesaria.

Si el agente necesita fuentes, baja a la pestaña Fuentes y haz clic en Agregar una fuente.

Selecciona un formato:

  • PDF: Selecciona el archivo deseado en la ventana del explorador y haz clic en Abrir.

  • Enlaces: Pega la URL, toma en cuenta que puedes agregar varias al mismo tiempo, una por línea. Haz clic en Guardar.

  • Documentos (que se hayan subido a la aplicación Documentos): Marca la casilla a un lado de uno o más documentos y después haz clic en Seleccionar.

  • Páginas de la aplicación Artículos: Marca la casilla a un lado de uno o más artículos, luego haz clic en Seleccionar.

Una vez agregada la fuente, el campo Estado se actualizará para reflejar el estado actual. La fuente estará lista cuando el estado cambie de Procesando a Indexada. Activa la fuente en la columna Activo.

Captura de pantalla de una lista de fuentes para un agente, cada una con su formato específico.

Importante

Si no se puede subir una fuente, es posible que exista un conflicto con el modelo LLM seleccionado.

Haz clic en el botón Probar para abrir una ventana de conversación y probar el agente nuevo.