openai-agents y doconda, y envuelve cada herramienta de doconda.tools() en un FunctionTool (o conecta el
servidor MCP remoto con MCPServerStreamableHttp). El agente llama a create_document y su respuesta final trae los
enlaces al Word, PowerPoint, Excel o PDF que ha creado.
Pasos
- Guarda tu key de OpenAI en
OPENAI_API_KEYy la de Doconda (panel → API keys) enDOCONDA_API_KEY. - Instala las dependencias:
pip install openai-agents doconda. - Convierte las herramientas y lanza el agente:
strict_json_schema=False porque el modo estricto marca todos los campos como obligatorios, y en Doconda casi todos
son opcionales (prompt o markdown, style, name…).
Con MCP, en vez de FunctionTool, pasa el servidor remoto en mcp_servers y sube la espera por llamada con
client_session_timeout_seconds=300 (5 s por defecto): un documento tarda más en estar listo. El código está en la
guía del Agents SDK.
Qué devuelve
Cada llamada acreate_document devuelve al agente un resumen corto:
format:docx,pdf,pptx,xlsxoartifact. Word, PowerPoint y Excel llegan siempre con su PDF.status:ready,ready_with_warnings,needs_reviewofailed(no se cobra).- Los enlaces caducan a los 5 minutos; el agente pide otros con
get_document.
Preguntas frecuentes
¿Puede el agente revisar o editar un archivo del usuario?
¿Puede el agente revisar o editar un archivo del usuario?
Sí. Tiene
upload_file, review_document (arregla problemas sin tocar el contenido) y edit_document (cambia solo
lo que se pide).¿Por qué tarda la herramienta?
¿Por qué tarda la herramienta?
create_document espera a que el documento esté listo. Un documento sencillo tarda segundos; uno en calidad
standard, unos minutos. Ver niveles de calidad.¿Cuánto cuesta?
¿Cuánto cuesta?
Lo que hace el agente cuenta como si lo hicieras tú con la API: mismo proyecto, mismo precio. Ver
precios.
Sigue leyendo
- OpenAI Agents SDK: la guía completa, también con MCP en local.
- Quickstart.