Uso del asistente¶

Chat interactivo¶

Los usuarios de backend con el grupo AI: User pueden abrir el asistente desde la burbuja de la bandeja del sistema (interfaz de chat persistente) o desde AI ‣ Conversaciones.

Flujo típico de un turno:

Usted envía un mensaje (opcionalmente con archivos adjuntos).
El orquestador compone los prompts de sistema por capas (seguridad básica, comportamiento global, prompt del agente, habilidades, datos del entorno, instantánea opcional del registro, historial).
El modelo puede llamar a herramientas (buscar, leer, habilidades, memoria, …).
Cada llamada a una herramienta se autoriza mediante el control de acceso (bloqueo → capacidad → política de IA → ACL de Odoo → depuración → auditoría).
El asistente responde en el idioma de la conversación siempre que sea posible.

Al chatear desde un formulario de negocio se puede adjuntar una instantánea del registro (L4) para que el modelo vea el contexto actual del registro. Las instantáneas están acotadas como datos; trátelas como sensibles si el formulario es sensible.

Conversaciones¶

AI ‣ Conversaciones muestra los hilos de chat del usuario actual (los administradores pueden ver más según las reglas de registro).

Use las conversaciones para:

continuar un trabajo de varios turnos con el historial completo;
revisar lo que se preguntó y se respondió;
relacionar propuestas de escritura y registros con un hilo.

Nota

Los canales del agente (Discuss, chatter, asignación) también usan registros con estilo de conversación, de modo que cada canal tiene un historial de comunicación auditable.

Archivos adjuntos¶

Los usuarios pueden adjuntar imágenes y documentos a un turno de chat (según los tipos MIME configurados y el tamaño máximo definidos en Ajustes de IA → Acceso web / límites de archivos).

Las imágenes pueden volver a codificarse antes de llegar al modelo.
El HTML/SVG y otro contenido activo representable se rechaza en las herramientas de descarga de documentos.
Para obtener un archivo desde una URL y guardarlo en un campo binario se requieren ambas capacidades, Web y Escritura (fetch_file_to_field).

Propuestas de escritura¶

Cuando una herramienta quiere crear, actualizar, eliminar, adjuntar un archivo o ejecutar ciertas acciones y se requiere confirmación, el control de acceso crea un registro ai.pending.write en lugar de aplicarlo de inmediato.

Abra AI ‣ Propuestas de escritura para:

leer el Resumen legible para humanos;
inspeccionar el modelo, la operación, el id de destino y los valores;
Aplicar o Cancelar mientras la propuesta siga en estado Pendiente;
usar Abrir registro para ir al documento de destino existente (escritura, eliminación o acción sobre un id activo; no disponible para creaciones puras).

En el caso de las propuestas de agente, el supervisor también recibe una tarea pendiente en el registro de negocio de destino cuando es posible (por ejemplo, la factura de proveedor), junto con una nota en el chatter y, para las creaciones que aún no tienen id, una actividad de respaldo en la tarea del agente. Esa actividad es un puntero al flujo de la propuesta; al aplicar o cancelar la propuesta, se cierra. Consulte Modo de escritura de la tarea (solo ejecuciones de agente).

Una propuesta de agente puede rechazarse en el momento de aplicarla, incluso si todavía figura como Pendiente. Si la ejecución que la propuso se detuvo a petición, o si el recolector de ejecuciones bloqueadas la cerró porque su proceso murió, Aplicar responde La ejecución del agente que propuso esta escritura se detuvo antes de terminar, por lo que esta propuesta ya no se puede aprobar. Una ejecución que otra persona declaró terminada ya no puede autorizar un cambio, por lo que el trabajo debe volver a solicitarse en lugar de aprobarse — consulte Detener una ejecución. Por lo general, una propuesta así ya se habrá cancelado o expirado junto con su ejecución; si el registro sobrevive, esto es lo que encontrará. Las propuestas de una ejecución que terminó por sí misma siguen siendo aprobables hasta que expiran, y Cancelar nunca se rechaza por este motivo.

Nota

Incluso con la Escritura habilitada, el control de acceso rechaza los campos que también escriben en otro modelo, como el correo electrónico de una iniciativa o un producto en una línea de factura. El rechazo indica el modelo y el campo que no se escribiría; para una línea dentro de Líneas de factura indica ese campo superior en lugar del propio de la línea. No explica el motivo, así que pida a un administrador que revise Protección de escritura entre modelos. Un rechazo de este tipo es un límite de configuración: no registra ninguna infracción ni le cuesta ninguna falta.

Propuestas de chat frente a las de agente¶

	Chat interactivo	Ejecución de agente autónomo
Controlado por	El Modo de escritura de IA global en Ajustes	El Modo de escritura de la tarea (predeterminado confirmar; consulte Modo de escritura de la tarea (solo ejecuciones de agente))
Aprobador	Normalmente el usuario que chatea	El supervisor del agente (cuando el modo de la tarea sigue proponiendo)
TTL predeterminado	60 minutos (configurable)	1440 minutos (configurable), solo mientras su ejecución esté abierta
Identidad que actúa al aplicar	El usuario del chat	El usuario del agente (de la ejecución), no el supervisor
Aviso en la bandeja del sistema	Tarjeta de chat / lista de propuestas propias	Tarea pendiente en el registro de negocio cuando es posible, o en la tarea en caso contrario

Nota

El tiempo de vida del agente solo se aplica mientras la ejecución que propuso sigue abierta. Una vez que esa ejecución termina — Hecho, Fallido o Tiempo agotado — la acción programada AI: Expire pending writes hace expirar las propuestas restantes en su siguiente pasada, como máximo 15 minutos después, sea cual sea el tiempo de vida configurado. El caso que sorprende a los supervisores es una ejecución que superó su propio límite de tiempo: se cierra como Tiempo agotado mientras aún mantiene propuestas abiertas. Revise sin demora las propuestas de ejecuciones fallidas o con tiempo agotado. Si abre una Tarea pendiente para una propuesta que ya no existe, marque la actividad como hecha: la propuesta expiró junto con su ejecución.

Importante

Aprobar una propuesta de agente significa: «Autorizo a este agente a realizar este cambio con sus propios permisos». El supervisor no necesita (y no debería usar) más permisos de los necesarios para revisar el resumen: los permisos de ejecución provienen del usuario del agente y de la política en el momento de aplicar.

Modos de escritura¶

Chat interactivo — en AI ‣ Configuración ‣ Ajustes:

Aplicar automáticamente — toda herramienta de creación, escritura, eliminación o archivo se ejecuta de inmediato. Riesgo más alto.
Requerir siempre confirmación — todo se convierte en una propuesta.
Crear automáticamente, confirmar actualizaciones (híbrido, predeterminado) — solo los registros nuevos se aplican automáticamente; las actualizaciones, eliminaciones y archivos adjuntos esperan confirmación.

Ejecuciones de agente — los mismos tres valores, pero en el formulario de la tarea (Modo de escritura), con Requerir siempre confirmación como valor predeterminado. El valor de Ajustes no se aplica a las ejecuciones de agente. Use auto o híbrido solo cuando la instrucción permanente y las habilidades mantengan el riesgo acotado (solo rellenar borradores, sin validar, sin pagos). Más detalles: Modo de escritura de la tarea (solo ejecuciones de agente).

Un TTL de 0 desactiva la expiración por antigüedad para esa clase de propuestas. No desactiva el barrido descrito antes: una propuesta cuya ejecución de agente ya haya terminado expira sin importar cuánto tiempo esté dispuesto a esperar una aprobación.

Navegar por la interfaz¶

Con la capacidad Navegar, el asistente puede ayudar a abrir menús o acciones a los que el usuario tiene acceso. No omite las ACL de los menús.

Presentar opciones¶

El asistente puede usar una herramienta estructurada de presentar opciones para que la interfaz muestre opciones seleccionables en lugar de solo texto libre (cuando el frontend del chat lo permite).

Lo que el asistente no debe hacer¶

Afirmar que existe un modelo, campo, etapa o módulo sin evidencia de una herramienta o del entorno en esta base de datos.
Escribir state directamente para saltarse los botones de negocio.
Prometer que se envió un correo a un cliente a menos que una herramienta o acción de correo real lo haya hecho conforme a la política (los prompts de soporte incluidos prohíben afirmar envíos falsos).
Tratar el texto de un ticket como una elevación de privilegios.

Para el trabajo impulsado por agentes (asignación, mención con @), consulte Agentes.