Acciones de servidor de IA¶
Las acciones IA de servidor extienden el marco de trabajo de automatización de Odoo ya que permiten que la inteligencia artificial tome decisiones durante el proceso de trabajo.
Están diseñadas para casos en los que la lógica no se puede expresar a través de condiciones fijas, pero todavía requiere una ejecución controlada a través de acciones de servidor estándar.
Cómo funcionan las acciones IA de servidor¶
Los flujos de trabajo impulsados por la IA en Odoo se construyeron alrededor de una separación clara de responsabilidades entre la acción IA del servidor, o el gerente, y la herramienta, o el trabajador.
Acción IA de servidor: el gerente¶
Una acción IA de servidor actúa como un tomador de decisiones, o un gerente. La acción lee el registro y el contexto, interpreta la instrucción de la IA y decide a qué herramienta llamar y qué argumentos usar.
La acción de servidor no aplica reglas empresariales, modifica registros de forma directa ni garantiza que una operación sea correcta. Esta función está limitada a la toma de decisiones.
Herramienta de IA: el trabajador¶
Una herramienta es una acción de servidor estándar con la opción Usar en IA activa en la pestaña Uso. Las herramientas contienen toda la lógica de ejecución y realizan actualizaciones, movimientos o escriben registros. Las herramientas deben implementar las reglas empresariales de forma explícita en código Python.
Si la acción IA de servidor llama a una herramienta, esta se ejecutará de forma incondicional, a no ser que el código en sí lo evite.
Flujo de trabajo de la acción IA de servidor¶
El flujo de trabajo de IA sigue la secuencia a continuación:
El registro activa una acción IA de servidor.
La instrucción de IA se evalúa usando el registro como contexto.
La IA selecciona una de las herramientas disponibles.
La IA brinda los argumentos que la herramienta espera.
La herramienta seleccionada ejecuta su código Python.
Importante
Las acciones IA de servidor funcionan sin lógica personalizada solo cuando ya existe un comportamiento en Odoo, como mover un documento a una carpeta. En estos casos, la IA selecciona los parámetros y Odoo ejecuta la acción.
Caso de uso paso a paso¶
El ejemplo ordenar los documentos en la bandeja de entrada de forma automática demuestra el patrón completo de la acción IA de servidor. Ve al menú de Acciones del servidor en .
Nota
La acción del servidor se diseña para revisar el contenido de los documentos y agregar etiquetas. La acción por sí misma no mueve documentos o agrega tareas, solo decide qué herramienta se debe usar según el contenido de los documentos.
El modelo para la acción se muestra como Documento y el Tipo es IA.
La instrucción para esta acción da contexto sobre el documento, así como el fin de la acción.
El campo Herramienta incluye varias acciones de servidor que se deben realizar según esta instrucción, incluyendo mover un documento, agregar etiquetas o crear facturas de clientes o de proveedores.
Nota
Las acciones del servidor IA: Agregar etiquetas, IA: Mover a la carpeta e IA: Cambiar el nombre del documento son de Ejecutar código, es decir, activan código Python.
Por ejemplo, si, de acuerdo con el contenido del documento, la acción determina que la herramienta más apropiada es IA: Mover a la carpeta, el código Python realiza la operación a continuación:
ai['result'] = record._ai_action_move_in_folder(folder_id)
Este código se ejecuta de forma incondicional cuando se llama y realiza el movimiento usando un método existente.
Nota
La IA no infiere argumentos del código Python o del método de firma. En su lugar, los argumentos que pasan a una herramienta se determinan completamente por la configuración de la herramienta.
Para la herramienta IA: Mover a la carpeta, el código Python espera una variable llamada folder_id- La IA sabe que debe proporcionar el folder_id ya que se declara como un argumento de forma explícita en la configuración. Esto se puede encontrar en la pestaña Uso de la acción del servidor, en el campo Esquema de IA. La columna Nombre en Esquema de IA debe coincidir de forma exacta con el nombre de la variable que se usa en el código Python.
La IA usa la descripción del argumento para entender qué representan los parámetros, qué tipo de valor se espera y cuál es el mejor momento para darlo.
Si no se define un argumento en la pestaña Uso, la IA no puede proporcionarlo, incluso si el código Python hace referencia a él.
Crear herramientas IA personalizadas¶
El mismo patrón en el ejemplo Ordenar los documentos en la bandeja de entrada de forma automática de arriba se puede implementar usando la lógica estándar de Odoo. Por ejemplo, para crear una acción que pueda actualizar la descripción de una tarea, se puede crear una acción Ejecutar código con el código a continuación:
record.write({'description': content})
Para funcionar de forma correcta, se debe definir contenido como un argumento en la pestaña Uso de la herramienta.
Consulta
Problemas frecuentes¶
¿Por qué el campo Herramientas está vacío?¶
Confirma que al menos una acción de servidor tenga la opción Usar en IA activada.
Confirma que al menos una herramienta tenga asignado el mismo modelo en Modelo que la acción de servidor.
¿Por qué se ejecutó la acción sin que nada pasara?¶
El código Python salió sin cambios.
Los argumentos requeridos faltaban o estaban vacíos.
Las condiciones empresariales no se implementaron en la lógica de la herramienta.
¿Por qué la IA seleccionó una herramienta inesperada?¶
La instrucción no tenía el contexto suficiente.
Varias herramientas coincidieron con el mismo fin.
No se aplicaron restricciones a nivel de las herramientas.