Aidoo expone tu Odoo en forma de herramientas. El asistente elige una, Aidoo comprueba que tiene derecho a usarla y ejecuta la llamada sobre tu base.

Esta página es el inventario completo. Cada herramienta enlaza con la página que la detalla.

La matriz completa

Herramienta	Permiso	Por defecto
aidoo_query	`query`	Sí
aidoo_read	`read`	Sí
aidoo_schema	`schema`	Sí
aidoo_report	`report`	Sí
aidoo_print	`print`	Sí
aidoo_create	`create`	No
aidoo_write	`write`	No
aidoo_delete	`delete`	No
aidoo_execute	`execute`	No
aidoo_workflow	`execute`	No
aidoo_workflow_run	`workflow`	No
aidoo_feedback	`feedback`	No
aidoo_attach	`attach`	No
aidoo_document	`document`	No

Una clave API recién creada recibe los cinco permisos de lectura habituales: query, read, schema, report y print. La pantalla de consentimiento marca de antemano los mismos cuando conectas Claude o ChatGPT. Todo lo demás, incluido document, debe activarse explícitamente: en Claves API, o marcando la casilla correspondiente en la pantalla de consentimiento.

Las herramientas de lectura

No pueden modificar nada: el vínculo herramienta → método de Odoo está bloqueado en el servidor, y aidoo_query solo sabe llamar a search_read y search_count.

aidoo_queryPermiso query · activado por defecto

Busca y lee registros. Es la herramienta más usada, la que responde a «qué presupuestos…», «cuántos clientes…», «la lista de facturas…».

Parámetros: model, domain (el filtro de Odoo), fields, limit (80 por defecto), offset, order. Devuelve los registros, pero también total_count, has_more y next_offset, para que el asistente sepa que solo ve una página y dónde continuar.

aidoo_readPermiso read · activado por defecto

Lee registros cuyos identificadores ya se conocen. Más directo que aidoo_query cuando el asistente acaba de encontrar un id.

aidoo_schemaPermiso schema · activado por defecto

Descubre la estructura de tu base: la lista de modelos, o los campos de un modelo concreto con su tipo y sus relaciones. No lee ningún dato de negocio. El equivalente público sobre Odoo estándar: el explorador de modelos de Odoo, con los campos de cada modelo.

También es la herramienta que devuelve los hints: tus instrucciones de negocio asociadas a un modelo.

aidoo_reportPermiso report · activado por defecto

Agrega sin traerse los datos. Agrupa por uno o varios campos y calcula una medida: facturación por mes, pendiente por comercial, cantidades por categoría.

Conviene preferirla siempre a aidoo_query cuando se trata de totales: Odoo hace el cálculo y solo viajan los resultados.

aidoo_printPermiso print · activado por defecto

Genera un PDF mediante el motor de informes QWeb de Odoo y devuelve un enlace de descarga. Factura, presupuesto, albarán, orden de fabricación.

Se clasifica como solo lectura: produce un documento, no modifica ningún registro.

aidoo_documentPermiso document · hay que activarlo manualmente

Lee el contenido de un adjunto de Odoo: PDF, imagen (escaneos incluidos) o documento Word. Devuelve una transcripción y un análisis estructurado: firmado o no, fechas, importes, partes, casillas marcadas. Es la herramienta que responde a «¿está firmado este presupuesto?» sin que abras el archivo.

Destino: un adjunto concreto, un documento de Odoo Documents, o los adjuntos de un registro (el asistente te pregunta cuál si hay varios).
Acciones: extract lee el documento, ask hace una pregunta concreta sobre un documento ya leído, status sigue la lectura de un documento largo, procesada en segundo plano.
Límites: 30 páginas y 20 MB por documento. Un archivo Word se lee a partir de su texto: la detección de firmas no está disponible para él.
Coste: 1 crédito por cada tramo de 20 páginas, descontado una sola vez por documento. Volver a leer el mismo archivo en los 30 días siguientes, o hacerle una pregunta, no cuesta nada.

Se aplican dos cerrojos: el permiso document en la clave y el ajuste del espacio de lectura de documentos por IA, en Ajustes (activado por defecto, modificable por el propietario y los administradores). El archivo se lee con tu identidad de Odoo: la herramienta solo alcanza los adjuntos que tú ves. El contenido leído se transmite al asistente como un dato, nunca como una instrucción que seguir. El detalle está en Adjuntos y OCR.

Las herramientas de escritura

Ninguna se concede por defecto. Lo que las acota son los permisos de tu clave, no un paso de confirmación adicional, consulta Escribir en Odoo.

Lo que escriben puede deshacerse durante 7 días desde Aidoo: las creaciones siempre, las modificaciones y eliminaciones si el snapshot antes de escribir está activado. Las acciones de negocio de aidoo_workflow y aidoo_execute no se pueden deshacer.

aidoo_createPermiso create · hay que activarlo manualmente

Crea uno o varios registros. En modo por lotes, los registros salen en una sola llamada a Odoo, lo que preserva la coherencia.

aidoo_writePermiso write · hay que activarlo manualmente

Modifica registros existentes. En modo por lotes, cada grupo de identificadores recibe sus propios valores, y el resultado detalla el éxito o el fallo de cada grupo.

aidoo_deletePermiso delete · hay que activarlo manualmente

Elimina definitivamente: es el unlink de Odoo, sin papelera. Solo el ajuste «Snapshot antes de escribir» de Aidoo permite recrear los registros eliminados, con nuevos identificadores, consulta Deshacer.

Concédelo con pleno conocimiento

delete es el permiso que destruye información: sin snapshot no hay recurso posible, e incluso con él las líneas vinculadas y los adjuntos no vuelven. En la mayoría de los despliegues permanece desactivado: archivar un registro con aidoo_write cubre la misma necesidad y se puede deshacer.

aidoo_workflowPermiso execute · hay que activarlo manualmente

Dispara una acción de negocio de Odoo, los botones de tus pantallas: confirmar un presupuesto, validar una factura, recibir una transferencia. Solo se aceptan los métodos con prefijo action_ o button_.

aidoo_executePermiso execute · hay que activarlo manualmente

Llama a un método arbitrario de Odoo, para los casos que las demás herramientas no cubren. Los métodos que duplicarían una herramienta dedicada están bloqueados (create, write, unlink, read, search_read…), de modo que un permiso no pueda usarse para eludir otro.

Es la herramienta más potente del catálogo, y por tanto la que conviene conceder con mayor prudencia.

Las herramientas especializadas

Tres herramientas, una misma palabra

Tres herramientas llevan «workflow» en el nombre y hacen cosas totalmente distintas. Es la confusión más frecuente de todo el catálogo.

Herramienta	Qué ejecuta	Permiso
`aidoo_workflow`	Un botón de Odoo: confirmar un presupuesto, contabilizar una factura. Nada que ver con los flujos de Aidoo	`execute`
`aidoo_workflow_list`	Nada. Lista tus flujos de Aidoo guardados	`workflow`
`aidoo_workflow_run`	Un flujo de Aidoo: la secuencia de pasos que guardaste	`workflow`

La línea divisoria: aidoo_workflow actúa dentro de Odoo, las otras dos actúan sobre lo que guardaste en Aidoo.

aidoo_workflow_run

Ejecuta un flujo de trabajo de Aidoo: una secuencia de pasos guardada una vez y repetida con una frase, con variables.

Un flujo guardado puede realizar operaciones que las herramientas individuales rechazarían: fuiste tú quien lo validó al crearlo.

El asistente invoca aidoo_workflow_list al inicio de la conversación para saber qué existe, y luego aidoo_workflow_run para ejecutar el que corresponda.

aidoo_feedbackPermiso feedback · hay que activarlo manualmente

Actualiza el hint de un modelo cuando corriges al asistente. Es el mecanismo de aprendizaje de Aidoo, consulta Hints y aprendizaje.

Exige el permiso feedback y el derecho canUpdateHints en tu perfil de miembro.

aidoo_attachPermiso attach · hay que activarlo manualmente

Hace llegar un archivo a Odoo sin que pase por la IA: el asistente te da un enlace de envío de un solo uso, tú depositas el archivo y Odoo lo recibe. Sirve también para digitalizar facturas de proveedor.

Cómo elegir los permisos a conceder

Una progresión que funciona

Empieza en solo lectura durante una semana. Añade create cuando aparezca una necesidad concreta. Abre execute solo para un uso identificado, y mantén delete cerrado.

Uso	Permisos
Consulta, informes, análisis	Los cinco permisos de lectura, por defecto
Introducción asistida (contactos, notas, actividades)	+ `create`, `write`
Tratamiento de principio a fin (confirmar, validar)	+ `execute`
Lectura de PDF y escaneos (firmas, importes)	+ `document`
Saneamiento de datos, correcciones masivas	+ `delete`, de forma temporal

Cada permiso se configura por clave y por entorno: puedes permitir la escritura en tu base de pruebas y denegarla en producción.

Lo que el asistente sabe antes de intentarlo

Al arrancar, aidoo_context devuelve la lista de herramientas realmente disponibles. El asistente sabe de antemano lo que no puede hacer y te lo dice, en lugar de intentar la operación y fallar.

Si te deniegan una acción que creías permitida, comprueba en este orden: el permiso de la clave, luego los permisos de la cuenta de Odoo, y por último los modelos bloqueados en Seguridad y permisos. Para aidoo_document, comprueba también que el ajuste de lectura de documentos por IA está activado.