Agentes de IA

Un agente de IA es un asistente inteligente en Odoo que puede entender el lenguaje natural, realizar tareas y ayudar a los usuarios interactuando con las herramientas de Odoo. Los agentes son un componente central de la estructura de IA en Odoo. Cada agente tiene un propósito definido, un prompt y un conjunto de temas y herramientas que guían su comportamiento.

Los agentes están formados por dos componentes principales: Temas y Fuentes.

  • Los Temas son las instrucciones y roles que informan al agente sobre qué tareas debe completar. Las Herramientas se asignan a los temas 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 IA, es importante entender algunos conceptos básicos sobre los prompts de IA.

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, cada agente de IA tiene asignado un Prompt del 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.

Cada Tema también incluye su propio componente similar a un prompt, llamado Instrucciones. Las instrucciones son directrices específicas del tema que refinan cómo se comporta el agente dentro de un contexto o flujo de trabajo determinado, y cómo interactúa dentro del marco de Odoo.

Las instrucciones a menudo incluyen:

  • Un propósito, o qué cubre el tema

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

  • 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

Temas

Los Temas son una colección de instrucciones y herramientas que definen cómo se comporta un agente dentro de un contexto específico. Esencialmente, los temas definen lo que un agente puede hacer dentro de la base de datos. Los temas guían las conversaciones, indicando al agente qué puede hacer, cómo puede hacerlo y cuándo debería hacerlo.

Importante

Si no se asigna ningún tema a un agente, solo puede proporcionar información, no completar tareas ni realizar cambios en la base de datos.

Dentro de cada tema se incluye un prompt detallado, que proporciona al agente instrucciones más profundas sobre cómo realizar las tareas asociadas con ese tema, define los límites de su comportamiento y determina cómo debería interpretar la intención del usuario. Estos prompts aseguran que el agente siga un patrón de razonamiento consistente y use las herramientas apropiadas para generar respuestas precisas y conscientes del contexto.

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

  • Búsqueda en lenguaje natural: admite la interpretación de una consulta del usuario para abrir la vista de Odoo apropiada con un conjunto de herramientas necesarias para realizar la búsqueda.

  • Recuperación de información: una colección de herramientas para recuperar información sobre los modelos.

  • Crear iniciativas: una colección de herramientas para admitir la creación automatizada de iniciativas. Este tema está disponible solo si la aplicación CRM está instalada.

Dentro de cada tema hay un conjunto de Instrucciones, que actúan como una indicación y proporcionan orientación para 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. Estas incluyen acciones como crear una iniciativa o abrir una vista. Las herramientas amplían el propósito del agente más allá de las conversaciones, permiten 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 un solo tema.

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:

  • PDF

  • 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.

Crear un nuevo agente

Para crear un nuevo agente de IA, navega a Aplicación IA ‣ Nuevo. Introduce un Nombre del agente y luego añade una breve descripción, si lo deseas.

Truco

Antes de crear un nuevo agente, se recomienda tener en mente un caso de uso claro. Esto ayuda al redactar el Prompt del Sistema y asignar los Temas y las Herramientas de IA.

Selecciona un Modelo LLM del menú desplegable.

Importante

Odoo admite múltiples versiones tanto de ChatGPT como de Gemini.

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:

  • Analítico: más matemático, esta opción tiene más probabilidades de dar la misma respuesta a la misma pregunta. Se recomienda esta opción para situaciones donde la precisión es más importante que la diplomacia.

  • Equilibrado: una combinación de Analítico y Creativo. Es una excelente opción para situaciones con clientes externos que se beneficiarían de tanto precisión como diplomacia.

  • Creativo: aborda las preguntas de una manera más humana, cambia las respuestas cada vez para reaccionar a la conversación. Esta opción funciona mejor para momentos en que las soluciones a menudo varían según la situación.

Marca la casilla Restringir a Fuentes para limitar al agente a responder solo en base a los recursos proporcionados.

A continuación, selecciona uno o más Temas para el agente. Como se explicó anteriormente, los Temas 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.

Un nuevo formulario de agente con la información requerida.

Si se necesitan Fuentes para el agente, desplázate a la pestaña Fuentes, luego haz clic en Agregar una fuente.

Selecciona un formato:

  • PDFs: Selecciona el archivo apropiado de la ventana del explorador y haz clic en Abrir

  • Enlaces web: pega la URL. Se pueden agregar múltiples enlaces a la vez, pega un enlace por línea. Haz clic en Guardar.

  • Documentos (cargados en la aplicación Documentos): Marca la casilla junto a uno o más documentos, luego haz clic en Seleccionar.

  • Artículos de la aplicación Información: Marca la casilla junto a uno o más artículos, luego 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.

Una lista de fuentes para un agente, cada una indicada con su formato.

Importante

Si una fuente no se puede cargar, podría ser el resultado de un conflicto con el modelo LLM seleccionado.

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