AI Tool - Read

Para prohibir un campo, marque AI Read Forbidden en él. Como administrador, puede:

• Ir a Settings > Technical > Database Structure > Fields, buscar el campo y marcar la casilla (el filtro AI Read Forbidden y la columna de la lista le ayudan a revisar lo que ya está marcado), o
• Abrir el modelo en Settings > Technical > Database Structure > Models y marcar la casilla en la línea del campo, en la pestaña Fields.

La marca se aplica tanto a los campos base como a los personalizados, y surte efecto de inmediato. Una marca establecida en el campo de un mixin, como email_normalized en mail.thread.blacklist, se aplica a todos los modelos que heredan de él.

Un campo prohibido arrastra consigo los campos que exponen su valor a través de su definición, en cualquier modelo: campos relacionados, los campos que un modelo delega mediante _inherits y los campos calculados que dependen de él. La lista hidden devuelta por la herramienta get_fields muestra el resultado en un modelo. Un valor copiado a otro registro cuando se escribe ese registro no se sigue (véase Known issues): marque también esos campos.

Esto peca de prudente: un campo calculado se oculta en cuanto depende de un campo prohibido, incluso cuando su valor no lo contiene. Prohibir res.partner.email también oculta is_blacklisted, un sí/no calculado a partir de la dirección, y hr.employee.mobile_phone, calculado por el mismo método que el correo electrónico del trabajo. Por la misma razón, marque los campos que contienen los valores sensibles en sí (correo electrónico, teléfono, dirección), no los campos a partir de los cuales se calculan muchos otros, como parent_id o company_id: esos ocultarían mucho más de lo previsto.

Los campos restringidos a un grupo de usuarios (groups= en su definición) ya quedan fuera de los resultados para un usuario ajeno a ese grupo, sin necesidad de ninguna marca, y tampoco se notifican en la lista hidden. AI Read Forbidden solo es necesario para los campos que el usuario tiene permiso de leer en caso contrario.

Las herramientas se registran como registros ai.tool y se pueden invocar a través de cualquier integración ai_tool: ai_oca_mcp, por ejemplo, las expone a clientes MCP como Claude Desktop. Este módulo proporciona las herramientas en sí; cómo se accede a ellas depende del módulo de transporte instalado.

Un flujo de trabajo típico de un agente:

• Llama a list_models para descubrir los modelos que el usuario vinculado puede leer. Cada entrada proporciona el nombre técnico model (p. ej. res.partner) que se pasa a las demás herramientas.
• Llama a get_fields con model para conocer qué significa cada campo legible (etiqueta, tipo, ayuda, opciones de selección, destino de la relación) y qué campos se listan en hidden.
• Llama a search_read para obtener registros:
• model (obligatorio): el nombre técnico del modelo.
• domain (opcional): un dominio de Odoo como lista, p. ej. [["is_company", "=", true]].
• fields (opcional): una lista explícita de campos; en caso contrario se devuelven los campos legibles almacenados. Una lista vacía devuelve solo los ids.
• limit (opcional): tamaño de página, 200 por defecto y como máximo; un valor de 0 o inferior, o que supere el límite, se trata como el máximo.
• offset (opcional): omite esa cantidad de registros coincidentes.
• order (opcional): p. ej. "name asc". Los campos relacionales se devuelven como ids de registro, las fechas y fechas y horas como cadenas ISO-8601 en UTC. has_more indica si existe otra página con el mismo dominio y orden; los campos que la llamada no pudo leer se listan en inaccessible_fields, mientras que los campos prohibidos o restringidos simplemente están ausentes de los registros.

Ejemplo de argumentos de search_read:

{
  "model": "res.partner",
  "domain": [["is_company", "=", true]],
  "fields": ["name", "email", "country_id"],
  "limit": 20,
  "order": "name asc"
}

Cada llamada se ejecuta con los derechos de acceso del usuario que llama —el propietario de la clave de API cuando se accede a través de ai_oca_mcp—, por lo que las ACL de Odoo, las reglas de registro y los groups de campo se aplican como de costumbre. Conecta el agente como un usuario dedicado que solo tenga los derechos que necesita.