Skip to main content
Instala 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

  1. Guarda tu key de OpenAI en OPENAI_API_KEY y la de Doconda (panel → API keys) en DOCONDA_API_KEY.
  2. Instala las dependencias: pip install openai-agents doconda.
  3. 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 a create_document devuelve al agente un resumen corto:
  • format: docx, pdf, pptx, xlsx o artifact. Word, PowerPoint y Excel llegan siempre con su PDF.
  • status: ready, ready_with_warnings, needs_review o failed (no se cobra).
  • Los enlaces caducan a los 5 minutos; el agente pide otros con get_document.

Preguntas frecuentes

Sí. Tiene upload_file, review_document (arregla problemas sin tocar el contenido) y edit_document (cambia solo lo que se pide).
create_document espera a que el documento esté listo. Un documento sencillo tarda segundos; uno en calidad standard, unos minutos. Ver niveles de calidad.
Lo que hace el agente cuenta como si lo hicieras tú con la API: mismo proyecto, mismo precio. Ver precios.

Sigue leyendo