casos practicos
Herramientas personalizadas: cómo darle a un agente acceso seguro a Odoo
Un agente es tan útil como sus herramientas y tan seguro como sus permisos. Cómo diseñar herramientas para Odoo con @tool.
Focuz Academy · 6 de octubre de 2026 · 6 min
Con el decorador @tool del Claude Agent SDK conviertes una función async de Python en una herramienta que el agente puede llamar. El SDK la expone a través de un servidor MCP en proceso creado con create_sdk_mcp_server.
Principios de diseño para Odoo
- Una herramienta, una intención.
search_leadsyset_prioritymejor que una herramienta genérica "ejecuta cualquier método". - Lectura marcada como lectura.
ToolAnnotations(readOnlyHint=True)le indica al SDK que la herramienta no modifica nada. - Errores como datos. Devuelve
"is_error": Truecon el mensaje de Odoo: el agente puede corregir su siguiente llamada. - Usuario técnico con permisos mínimos. El API key que usa la herramienta define lo máximo que el agente podría hacer.
- Permisos explícitos. Lista solo las herramientas necesarias en
allowed_tools(formatomcp__<servidor>__<herramienta>).
Encuentra el ejemplo completo en la lección Tu primer agente en Python conectado a Odoo.
Guía gratuita: 5 agentes Python para Odoo
Casos de Junior a Senior, con código verificado contra Odoo 20.
Descargar →