Skip to main content
Connect your Amazon Bedrock agent to Doconda so it can convert, create and edit Word, PowerPoint, Excel and PDF files, with any model enabled in your Bedrock account. The SDK tools plug into the Converse API (boto3 or @aws-sdk/client-bedrock-runtime) or into the AI SDK.

Capabilities

  • Create a Word, PowerPoint, Excel or PDF file, or an artifact, from a request or from Markdown the agent wrote.
  • Edit a file: only what is asked changes, and get_report lists every change.
  • Convert a file to another format with no AI, for example any file to Markdown so the agent can read it.
  • Read what people saved in an artifact, such as poll votes.

Setup

This integration uses a Doconda API key in DOCONDA_API_KEY (from API keys). AWS credentials come from your environment (AWS_REGION, AWS_ACCESS_KEY_ID…), like the rest of your code. BEDROCK_MODEL_ID is any model enabled in your Bedrock account.

With Python

The loop ends when stopReason is no longer tool_use; the last message includes the spreadsheet’s download links.

With the AI SDK

Tools

The agent gets the eight Doconda tools; see the tools for what each one does. doconda.tools() returns them with name, description, a JSON Schema (inputSchema in TypeScript, input_schema in Python) and run; the schema goes in the Converse toolSpec as inputSchema.json. A failed call returns { "error": "<code>", "message": "…" } instead of raising, so the model can correct itself.

Troubleshooting

  • Doconda: pass api_key or set DOCONDA_API_KEY. — The SDK found no key (in TypeScript: Doconda: pass { apiKey } or set DOCONDA_API_KEY.). Set DOCONDA_API_KEY, or pass the key to Doconda.
  • Bedrock rejects the model ID — The model must be enabled in your account and region, and support tool use in the Converse API.
  • A tool result has "error": "insufficient_balance" — The project’s balance can’t cover the document: top up in the dashboard, or ask for quality: "fast".
  • The download link stopped working — File links expire after 5 minutes; the agent calls get_document for fresh ones.