Acciones del servidor de IA¶
Las acciones de servidor de AI extienden el marco de automatización de Odoo al permitir que la inteligencia artificial tome decisiones durante un flujo de trabajo.
Están diseñadas para casos en los que la lógica no puede expresarse completamente mediante condiciones fijas, pero aún requiere una ejecución controlada a través de acciones de servidor estándar.
Cómo funcionan las acciones de servidor de IA¶
Los flujos de trabajo impulsados por IA en Odoo se basan en una separación clara de responsabilidades entre la acción de servidor de AI, o el Gestor, y la herramienta, o el Trabajador.
Acción de servidor de IA: el gestor¶
Una acción de servidor de AI actúa como tomador de decisiones, o gestor. Lee el registro y su contexto. Interpreta el prompt de AI. Y decide qué herramienta llamar y qué argumentos usar.
La acción de servidor no aplica reglas de negocio, no modifica registros directamente ni garantiza la corrección de la operación. Su rol se limita 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 habilitada en su pestaña Uso. Las herramientas contienen toda la lógica de ejecución y realizan actualizaciones, movimientos o escrituras de registros. Las herramientas deben aplicar las reglas de negocio explícitamente en código Python.
Si una herramienta es llamada por la acción de servidor de AI, se ejecutará incondicionalmente, a menos que el código mismo lo impida.
Flujo de trabajo de acción de servidor de IA¶
El flujo de trabajo de la acción de servidor de AI sigue esta secuencia:
Un registro activa una acción de servidor de AI.
El prompt de AI se evalúa usando el registro como contexto.
La AI selecciona una de las herramientas disponibles.
La AI proporciona los argumentos esperados por la herramienta.
La herramienta seleccionada ejecuta su código Python.
Importante
Las acciones de servidor de AI funcionan sin lógica personalizada solo cuando el comportamiento subyacente ya existe en Odoo, como mover un documento a una carpeta. En estos casos, la AI selecciona los parámetros y Odoo ejecuta la acción.
Ejemplo de caso de uso¶
El ejemplo Auto-ordenar documentos en Bandeja de entrada demuestra el patrón completo de Acción de Servidor de AI. Navega al menú Acciones de servidor yendo a .
Nota
Esta acción de servidor está diseñada para revisar documentos por su contenido y agregar etiquetas. La acción en sí no mueve documentos ni agrega etiquetas, solo decide qué herramienta debe usarse, según el contenido de los documentos.
El modelo de la acción se indica como Documento y el tipo es IA.
El prompt de esta acción proporciona contexto sobre el documento, así como la intención de la acción.
El campo herramienta incluye varias acciones que pueden tomarse según este prompt, incluyendo mover un documento, agregar etiquetas o crear facturas.
Nota
IA: Agregar etiquetas, IA: Mover a carpeta e IA: Renombrar documento son acciones de servidor de Ejecutar código, lo que significa que activan código python.
Por ejemplo, si la acción determina, según el contenido del documento, que la herramienta más apropiada es IA: Mover a carpeta, el código Python realiza la siguiente operación:
ai['result'] = record._ai_action_move_in_folder(folder_id)
Este código se ejecuta incondicionalmente cuando se llama y realiza el movimiento usando un método existente.
Nota
La AI no infiere argumentos del código Python ni de la firma del método. En cambio, los argumentos pasados a una herramienta se determinan completamente por la configuración de la herramienta.
Para la herramienta IA: Mover a carpeta, el código Python espera una variable llamada folder_id. La AI sabe proporcionar folder_id porque está explícitamente declarado como argumento en la configuración. Esto se encuentra en la pestaña Uso de la acción de servidor, en el campo esquema de IA. La columna nombre bajo Esquema de IA debe coincidir exactamente con el nombre de variable usado en el código Python.
La AI usa la descripción del argumento para comprender qué representa el parámetro, qué tipo de valor se espera y cuándo es apropiado proporcionarlo.
Si un argumento no está definido en la pestaña Uso, la IA no puede proporcionarlo, incluso si el código Python hace referencia a él.
Crear herramientas de IA personalizadas¶
El mismo patrón del ejemplo Ordenar automáticamente documentos en la bandeja de entrada anterior puede implementarse usando lógica estándar de Odoo. Por ejemplo, para crear una acción que pueda actualizar la descripción de una tarea, podría crearse una acción Ejecutar código con el siguiente código:
record.write({'description': content})
Para funcionar correctamente, content debe estar definido como argumento en la pestaña Uso de la herramienta.
Ver también
Problemas comunes¶
¿Por qué está vacío el campo Herramientas?¶
Confirma que al menos una acción de servidor tenga habilitado usar en IA.
Confirma que al menos una herramienta esté asignada al mismo modelo Modelo que la acción del servidor.
¿Por qué se ejecutó la herramienta pero no pasó nada?¶
El código Python finalizó sin cambios.
Faltaban argumentos obligatorios o estaban vacíos.
Las condiciones de negocio no se implementaron en la lógica de la herramienta.
¿Por qué la IA eligió una herramienta inesperada?¶
El prompt carecía de contexto suficiente.
Varias herramientas coincidían con la misma intención.
No se aplicaron restricciones a nivel de herramienta.