knowledge_base.json

{
  "team_usernames": ["haakam21", "simplehacker1313", "mikesteroonie"],
  "skip_patterns": ["thanks", "thank you", "got it", "ok cool", "perfect", "awesome", "nice", "np", "no problem", "appreciate it", "ty", "thx", "lgtm", "sounds good", "will do"],
  "faqs": [
    {
      "id": "what_is_agentmail",
      "category": "Getting Started",
      "keywords": ["what", "agentmail", "overview", "about", "platform", "explain"],
      "question_patterns": ["what.*agentmail", "what.*is.*this", "tell.*about"],
      "answer": "AgentMail is an email API platform purpose-built for AI agents. It lets your agents send, receive, and manage emails programmatically via REST API, SDKs (Python & TypeScript), MCP, or WebSockets.\n\nKey features: inboxes, threads, messages, webhooks, custom domains, pods, labels, drafts, attachments, allowlists/blocklists.",
      "docs_link": "https://docs.agentmail.to/get-started/what-is-agentmail"
    },
    {
      "id": "quickstart",
      "category": "Getting Started",
      "keywords": ["start", "begin", "setup", "get started", "first", "how to", "quickstart"],
      "question_patterns": ["how.*start", "get.*started", "quick.*start", "where.*begin"],
      "answer": "1. Sign up at **console.agentmail.to**\n2. Create an API key\n3. Install SDK: `pip install agentmail` (Python) or `npm install agentmail` (TypeScript)\n4. Create your first inbox and send an email!",
      "docs_link": "https://docs.agentmail.to/get-started/quickstart"
    },
    {
      "id": "sdk_installation",
      "category": "SDK Setup",
      "keywords": ["install", "sdk", "pip", "npm", "package", "library", "python", "typescript", "node", "javascript"],
      "question_patterns": ["install.*sdk", "pip.*install", "npm.*install", "how.*install", "setup.*sdk"],
      "answer": "**Python:**\n```bash\npip install agentmail\n```\n\n**TypeScript/Node:**\n```bash\nnpm install agentmail\n```\n\nThen set `AGENTMAIL_API_KEY` in your `.env` file.",
      "docs_link": "https://docs.agentmail.to/get-started/quickstart"
    },
    {
      "id": "api_key_setup",
      "category": "Authentication",
      "keywords": ["api", "key", "token", "auth", "authentication", "create", "get", "where", "find"],
      "question_patterns": ["get.*api.*key", "create.*api.*key", "where.*api.*key", "api.*key.*setup", "find.*key"],
      "answer": "Go to **console.agentmail.to** → **API Keys** → **Create API Key**. Copy and store it securely — you won't see it again!\n\nSet it as `AGENTMAIL_API_KEY` in your `.env` file. Keys start with `am_`.",
      "docs_link": "https://docs.agentmail.to/get-started/quickstart"
    },
    {
      "id": "first_inbox",
      "category": "Getting Started",
      "keywords": ["first", "inbox", "create", "try", "test", "hello world"],
      "question_patterns": ["first.*inbox", "create.*first", "try.*out", "hello.*world"],
      "answer": "```python\nfrom agentmail import AgentMail\nclient = AgentMail()\ninbox = client.inboxes.create()\nprint(inbox.inbox_id)\n```\nThis creates a random `@agentmail.to` inbox. Free tier: up to 3 inboxes.",
      "docs_link": "https://docs.agentmail.to/first-inbox"
    },
    {
      "id": "inbox_create",
      "category": "Inboxes",
      "keywords": ["inbox", "create", "default", "domain", "username", "random", "display", "name"],
      "question_patterns": ["create.*inbox", "new.*inbox", "make.*inbox", "custom.*inbox"],
      "answer": "```python\ninbox = client.inboxes.create(\n    username=\"myagent\",      # Optional, random if omitted\n    domain=\"mydomain.com\",   # Optional, requires paid plan\n    display_name=\"My Agent\"  # Optional, shown as 'From' name\n)\n```\nFree tier: up to 3 inboxes on `@agentmail.to`.",
      "docs_link": "https://docs.agentmail.to/core-concepts/inboxes"
    },
    {
      "id": "inbox_delete",
      "category": "Inboxes",
      "keywords": ["delete", "remove", "inbox", "clean", "destroy"],
      "question_patterns": ["delete.*inbox", "remove.*inbox", "destroy.*inbox"],
      "answer": "Use `client.inboxes.delete(inbox_id)`. Deletion is async — the inbox and all its threads/messages are cleaned up in the background.",
      "docs_link": "https://docs.agentmail.to/core-concepts/inboxes"
    },
    {
      "id": "threads_vs_messages",
      "category": "Messages & Threads",
      "keywords": ["thread", "message", "difference", "which", "list", "overview", "conversation"],
      "question_patterns": ["thread.*vs.*message", "thread.*message.*differ", "list.*thread.*message", "should.*thread.*message"],
      "answer": "**Threads** group related emails into conversations. **Messages** are individual emails.\n\n- Use `list_threads` for inbox overview (shows conversations)\n- Use `list_messages` when you need individual emails (verification codes, invoices)\n- **Important:** `list_threads` doesn't return full message bodies — follow up with `get_message`",
      "docs_link": "https://docs.agentmail.to/core-concepts/threads"
    },
    {
      "id": "send_email",
      "category": "Sending Email",
      "keywords": ["send", "email", "message", "how", "to", "subject", "body", "text", "html"],
      "question_patterns": ["send.*email", "how.*send", "send.*message", "first.*email"],
      "answer": "```python\nclient.inboxes.messages.send(\n    inbox_id=\"your-inbox@agentmail.to\",\n    to=[\"recipient@example.com\"],  # Must be a list!\n    subject=\"Hello!\",\n    text=\"Plain text body\",\n    html=\"<b>HTML body</b>\"  # Always provide both\n)\n```",
      "docs_link": "https://docs.agentmail.to/guides/sending-receiving-email"
    },
    {
      "id": "reply_followup",
      "category": "Sending Email",
      "keywords": ["reply", "follow", "followup", "thread", "to", "recipient", "wrong", "myself"],
      "question_patterns": ["reply.*myself", "reply.*wrong", "follow.*up", "send.*same.*thread", "reply.*to"],
      "answer": "If `reply()` sends to yourself instead of the recipient, **override the `to` field explicitly**:\n```python\nclient.inboxes.messages.reply(\n    inbox_id=\"...\",\n    message_id=\"...\",\n    to=[\"recipient@email.com\"],  # Must be a list!\n    text=\"Your reply\"\n)\n```",
      "docs_link": "https://docs.agentmail.to/guides/sending-receiving-email"
    },
    {
      "id": "to_field_array",
      "category": "Common Mistakes",
      "keywords": ["to", "field", "array", "list", "string", "single", "recipient", "format"],
      "question_patterns": ["to.*array", "to.*list", "single.*recipient", "to.*format"],
      "answer": "The `to` field **must be a list** of strings, even for a single recipient:\n```python\n# Correct\nto=[\"user@example.com\"]\n\n# Wrong — will cause errors\nto=\"user@example.com\"\n```",
      "docs_link": "https://docs.agentmail.to/guides/sending-receiving-email"
    },
    {
      "id": "send_attachments",
      "category": "Attachments",
      "keywords": ["attachment", "send", "file", "attach", "pdf", "image", "upload", "base64"],
      "question_patterns": ["send.*attachment", "attach.*file", "how.*attach", "email.*file"],
      "answer": "Include attachments as base64 in the `attachments` array:\n```python\nimport base64\nwith open(\"doc.pdf\", \"rb\") as f:\n    content = base64.b64encode(f.read()).decode()\n\nclient.inboxes.messages.send(\n    inbox_id=\"...\",\n    to=[\"recipient@example.com\"],\n    subject=\"File attached\",\n    text=\"See attachment\",\n    attachments=[{\"content\": content, \"filename\": \"doc.pdf\", \"content_type\": \"application/pdf\"}]\n)\n```\nLimit: 30 MB for entire email including attachments.",
      "docs_link": "https://docs.agentmail.to/core-concepts/attachments"
    },
    {
      "id": "attachment_download",
      "category": "Attachments",
      "keywords": ["attachment", "download", "pdf", "file", "open", "get", "retrieve"],
      "question_patterns": ["attachment.*download", "can't.*download", "get.*attachment", "download.*file"],
      "answer": "Use the API to download attachments:\n```python\nfile_data = client.inboxes.messages.get_attachment(\n    inbox_id=\"...\",\n    message_id=\"...\",\n    attachment_id=\"...\"\n)\n```\nGet the `attachment_id` from the message response. The API returns a signed S3 URL (valid for 1 hour).",
      "docs_link": "https://docs.agentmail.to/core-concepts/attachments"
    },
    {
      "id": "domain_pending",
      "category": "Domain Setup",
      "keywords": ["domain", "pending", "verification", "verifying", "dns", "propagation", "stuck", "waiting"],
      "question_patterns": ["domain.*pending", "still.*pending", "domain.*stuck", "verify.*domain", "domain.*verifying"],
      "answer": "Domain verification typically takes 5–30 minutes for DNS changes to propagate. If it's been over an hour:\n1. Double-check all 5 DNS records (DKIM, 2 MX, SPF, DMARC)\n2. Make sure you copied values exactly\n3. Try clicking **Verify Domain** in the console\n4. Some registrars take up to 48 hours",
      "docs_link": "https://docs.agentmail.to/guides/domains/custom-domains"
    },
    {
      "id": "domain_dns_records",
      "category": "Domain Setup",
      "keywords": ["dns", "records", "mx", "txt", "cname", "spf", "dkim", "dmarc", "setup"],
      "question_patterns": ["dns.*record", "mx.*record", "what.*dns", "add.*dns", "spf.*dkim"],
      "answer": "After adding a domain, you need 5 DNS records:\n1. **DKIM** (TXT): `agentmail._domainkey` → public key\n2. **MX** (inbound): `@` → `inbound-smtp.us-east-1.amazonaws.com` priority 10\n3. **MX** (feedback): `mail` → `feedback-smtp.us-east-1.amazonses.com` priority 10\n4. **SPF** (TXT): `mail` → `v=spf1 include:amazonses.com -all`\n5. **DMARC** (TXT): `_dmarc` → `v=DMARC1; p=reject; rua=mailto:dmarc@agentmail.to`",
      "docs_link": "https://docs.agentmail.to/guides/domains/custom-domains"
    },
    {
      "id": "domain_registrar",
      "category": "Domain Setup",
      "keywords": ["domain", "registrar", "buy", "purchase", "where", "porkbun", "cloudflare", "namecheap"],
      "question_patterns": ["where.*buy.*domain", "domain.*registrar", "buy.*domain"],
      "answer": "AgentMail doesn't sell domains — buy from a registrar and connect them. Popular options:\n- **Porkbun** (popular in community)\n- **Cloudflare** (good DNS management)\n- **Namecheap**\n\nAfter purchase, add the DNS records from your AgentMail console.",
      "docs_link": "https://docs.agentmail.to/guides/domains/custom-domains"
    },
    {
      "id": "gmail_integration",
      "category": "Domain Setup",
      "keywords": ["gmail", "google", "workspace", "existing", "subdomain", "forward", "routing"],
      "question_patterns": ["gmail.*agentmail", "existing.*domain", "use.*with.*gmail", "google.*workspace"],
      "answer": "Two options to use AgentMail alongside Gmail:\n\n**Option 1: Subdomain (simpler)**\nCreate a subdomain like `mail.yourdomain.com` and point its MX records to AgentMail only.\n\n**Option 2: Google Workspace Routing**\nRequires paid Workspace. Configure email routing in Google Admin to forward specific addresses to AgentMail.",
      "docs_link": "https://docs.agentmail.to/guides/domains/custom-domains"
    },
    {
      "id": "api_404",
      "category": "API Errors",
      "keywords": ["404", "not found", "api", "error", "sending", "inbox", "message"],
      "question_patterns": ["404.*error", "not found", "api.*404", "can't send", "cannot send"],
      "answer": "404 errors usually mean:\n1. **Free tier**: Custom domains require a paid plan\n2. **Wrong inbox_id**: Make sure you're using the correct inbox ID from the console\n3. **Domain not verified**: Check that your domain shows 'Verified' status\n4. **Inbox deleted**: The inbox may have been deleted",
      "docs_link": "https://docs.agentmail.to/api-reference"
    },
    {
      "id": "api_403",
      "category": "API Errors",
      "keywords": ["403", "forbidden", "blocked", "access", "denied", "playground"],
      "question_patterns": ["403.*error", "forbidden", "access.*denied", "blocked"],
      "answer": "403 errors can mean:\n- **Playground key**: You may be using a Playground API key. Use keys from console.agentmail.to instead.\n- **Bounced address**: Sending to an address that previously bounced or filed a spam complaint.\n- **Domain not verified**: Custom domain not verified.\n- **Limit exceeded**: Inbox or domain limit reached on your plan.",
      "docs_link": "https://docs.agentmail.to/api-reference"
    },
    {
      "id": "free_tier_limits",
      "category": "Pricing & Plans",
      "keywords": ["free", "tier", "plan", "limit", "inboxes", "emails", "month", "access", "pricing"],
      "question_patterns": ["free tier", "free plan", "what.*included", "limit.*free", "pricing", "how much"],
      "answer": "The free tier includes:\n- 3 inboxes\n- 3,000 emails per month\n- No custom domains (agentmail.to subdomain only)\n\nUpgrade at **agentmail.to/pricing** for custom domains and higher limits.",
      "docs_link": "https://agentmail.to/pricing"
    },
    {
      "id": "upgrade_plan",
      "category": "Billing",
      "keywords": ["upgrade", "paid", "plan", "billing", "subscribe", "payment", "pricing", "tier"],
      "question_patterns": ["how.*upgrade", "upgrade.*plan", "can't.*add.*domain", "paid.*plan"],
      "answer": "To upgrade: go to **agentmail.to/pricing** → choose your plan → complete payment.\n\nIf you've paid but still can't access features, let the team know with your email address.",
      "docs_link": "https://agentmail.to/pricing"
    },
    {
      "id": "webhook_setup",
      "category": "Webhooks",
      "keywords": ["webhook", "setup", "configure", "create", "endpoint", "url", "events"],
      "question_patterns": ["webhook.*setup", "how.*webhook", "configure.*webhook", "create.*webhook"],
      "answer": "```python\nwebhook = client.webhooks.create(\n    url=\"https://your-server.com/webhook\",\n    event_types=[\"message.received\"],\n    client_id=\"my-webhook\"  # Idempotency key\n)\nprint(webhook.secret)  # Save this for verification!\n```\nFor local dev, use ngrok to expose your endpoint. **Store the secret immediately** — it's only shown once.",
      "docs_link": "https://docs.agentmail.to/webhooks/webhook-setup"
    },
    {
      "id": "webhook_events",
      "category": "Webhooks",
      "keywords": ["webhook", "event", "types", "received", "sent", "bounced", "delivered"],
      "question_patterns": ["webhook.*event", "event.*type", "what.*events", "which.*webhook"],
      "answer": "Available event types:\n- `message.received` — New email received\n- `message.sent` — Email sent (accepted by SES)\n- `message.delivered` — Email delivered to recipient\n- `message.bounced` — Email bounced\n- `message.complained` — Spam complaint\n- `message.rejected` — Email rejected\n- `domain.verified` — Domain verification complete",
      "docs_link": "https://docs.agentmail.to/webhooks/webhooks-events"
    },
    {
      "id": "webhook_loop_prevention",
      "category": "Webhooks",
      "keywords": ["webhook", "loop", "infinite", "self", "reply", "own", "message", "sent"],
      "question_patterns": ["infinite.*loop", "reply.*own", "webhook.*loop", "message.*sent.*event"],
      "answer": "**Critical**: Always filter out `message.sent` events to prevent infinite loops!\n```python\n@app.route('/webhook', methods=['POST'])\ndef webhook():\n    event = request.json\n    if event['type'] == 'message.sent':\n        return 'OK', 200  # Ignore sent events!\n    # Process message.received...\n```",
      "docs_link": "https://docs.agentmail.to/examples/auto-reply-agent"
    },
    {
      "id": "webhook_verification",
      "category": "Webhooks",
      "keywords": ["webhook", "verify", "signature", "svix", "secret", "signing"],
      "question_patterns": ["verify.*webhook", "webhook.*signature", "svix", "webhook.*secret"],
      "answer": "Webhooks are signed with Svix. Get your secret from the webhook detail or API:\n```python\nwebhook = client.webhooks.get(webhook_id=\"ep_xxx\")\nsecret = webhook.secret\n```\nUse the Svix library to verify: `pip install svix` / `npm install svix`.",
      "docs_link": "https://docs.agentmail.to/webhooks/webhook-verification"
    },
    {
      "id": "webhook_specific_inbox",
      "category": "Webhooks",
      "keywords": ["webhook", "specific", "inbox", "one", "single", "particular", "filter"],
      "question_patterns": ["webhook.*specific.*inbox", "webhook.*one.*inbox", "webhook.*single", "filter.*webhook"],
      "answer": "Yes! Filter webhooks to specific inboxes with `inbox_ids`:\n```python\nclient.webhooks.create(\n    url=\"https://...\",\n    event_types=[\"message.received\"],\n    inbox_ids=[\"myagent@agentmail.to\"]\n)\n```\nYou can also filter by `pod_ids`.",
      "docs_link": "https://docs.agentmail.to/webhooks/webhook-setup"
    },
    {
      "id": "websockets",
      "category": "WebSockets",
      "keywords": ["websocket", "real-time", "realtime", "stream", "live", "connection", "ws"],
      "question_patterns": ["websocket", "real.*time", "stream.*event", "live.*update"],
      "answer": "WebSockets provide real-time event streaming without polling:\n```typescript\nconst client = new AsyncAgentMail();\nconst socket = await client.websockets.connect();\nsocket.subscribe({ inbox_ids: [\"...\"] });\nsocket.on('message.received', (event) => { ... });\n```\nUse WebSockets when you need instant notification; use webhooks for reliable delivery.",
      "docs_link": "https://docs.agentmail.to/websockets"
    },
    {
      "id": "labels_state_tracking",
      "category": "Labels",
      "keywords": ["label", "labels", "tag", "categorize", "add", "remove", "update", "track", "state", "processed"],
      "question_patterns": ["add.*label", "label.*message", "categorize.*email", "tag.*message", "track.*state", "mark.*processed"],
      "answer": "Use labels to track email state:\n```python\nclient.inboxes.messages.update(\n    inbox_id=\"...\",\n    message_id=\"...\",\n    add_labels=[\"processed\", \"needs-review\"],\n    remove_labels=[\"unread\"]\n)\n```\nFilter by labels: `client.inboxes.threads.list(inbox_id, labels=\"unread\")`",
      "docs_link": "https://docs.agentmail.to/core-concepts/labels"
    },
    {
      "id": "pods",
      "category": "Pods",
      "keywords": ["pod", "pods", "workspace", "isolate", "environment", "multi-tenant", "separate"],
      "question_patterns": ["what.*pod", "pod.*for", "separate.*environment", "multi.*tenant"],
      "answer": "Pods are isolated workspaces within your organization. Use them for:\n- Separating dev/staging/production\n- Multi-tenant setups (one pod per customer)\n- Project isolation\n\n```python\npod = client.pods.create(name=\"Production\", client_id=\"prod-pod\")\ninbox = client.pods.inboxes.create(pod_id=pod.pod_id)\n```",
      "docs_link": "https://docs.agentmail.to/core-concepts/pods"
    },
    {
      "id": "drafts",
      "category": "Drafts",
      "keywords": ["draft", "drafts", "schedule", "later", "unsent", "review", "human"],
      "question_patterns": ["draft", "schedule.*email", "send.*later", "human.*loop", "review.*before"],
      "answer": "Drafts let you compose emails for review before sending:\n```python\ndraft = client.inboxes.drafts.create(\n    inbox_id=\"...\",\n    to=[\"recipient@example.com\"],\n    subject=\"Draft email\",\n    text=\"Review this before sending\"\n)\n# Later: send it\nclient.inboxes.drafts.send(inbox_id=\"...\", draft_id=draft.draft_id)\n```\nYou can also schedule with `send_at`.",
      "docs_link": "https://docs.agentmail.to/core-concepts/drafts"
    },
    {
      "id": "lists_allowblock",
      "category": "Lists",
      "keywords": ["allowlist", "blocklist", "whitelist", "blacklist", "block", "allow", "filter", "safety"],
      "question_patterns": ["allowlist", "blocklist", "whitelist", "blacklist", "block.*email", "allow.*email", "filter.*sender"],
      "answer": "Control who your agent can communicate with:\n```python\n# Allow receiving from a domain\nclient.lists.create(\"receive\", \"allow\", entry=\"trusted-corp.com\")\n\n# Block sending to competitors\nclient.lists.create(\"send\", \"block\", entry=\"competitor.com\", reason=\"competitor\")\n\n# List entries\nentries = client.lists.list(\"receive\", \"allow\")\n```\nFour types: receive-allow, receive-block, send-allow, send-block.",
      "docs_link": "https://docs.agentmail.to/core-concepts/lists"
    },
    {
      "id": "client_id_idempotency",
      "category": "API Usage",
      "keywords": ["client_id", "idempotent", "idempotency", "duplicate", "safe", "restart"],
      "question_patterns": ["client_id", "idempoten", "duplicate", "already.*exist", "safe.*restart"],
      "answer": "`client_id` makes create operations **idempotent** — running the same request twice returns the existing resource:\n```python\ninbox = client.inboxes.create(client_id=\"my-agent-inbox\")\n# Running again returns the same inbox, not a duplicate\n```\n**Note:** `client_id` is NOT for storing your user ID. Use it as a deduplication key.",
      "docs_link": "https://docs.agentmail.to/best-practices/idempotency"
    },
    {
      "id": "minimum_toolset",
      "category": "AI Agents",
      "keywords": ["minimum", "toolset", "tools", "agent", "required", "essential", "basic"],
      "question_patterns": ["minimum.*tool", "what.*tools.*need", "essential.*api", "basic.*agent"],
      "answer": "Minimum toolset for an AI agent:\n1. `list_threads` — Inbox overview (doesn't include full bodies)\n2. `get_message` — Get full message content\n3. `reply_to_message` — Reply using last message ID\n4. `send_message` — Start new conversations\n\nOptional: `create_inbox`, `list_messages`, `update_message` (for labels).",
      "docs_link": "https://docs.agentmail.to/using-agents"
    },
    {
      "id": "mcp_setup",
      "category": "MCP",
      "keywords": ["mcp", "model context protocol", "claude desktop", "cursor", "windsurf"],
      "question_patterns": ["mcp.*setup", "mcp.*install", "claude.*desktop", "cursor.*agentmail"],
      "answer": "Install the AgentMail MCP server:\n```bash\nnpx @smithery/cli@latest mcp add agentmail\n```\nOr run directly: `npx -y agentmail-mcp`\n\nSet `AGENTMAIL_API_KEY` env var. Works with Claude Desktop, Cursor, Windsurf, and other MCP clients.",
      "docs_link": "https://docs.agentmail.to/integrations/mcp"
    },
    {
      "id": "imap_smtp",
      "category": "IMAP/SMTP",
      "keywords": ["imap", "smtp", "outlook", "thunderbird", "email client", "pop3"],
      "question_patterns": ["imap", "smtp", "outlook.*agentmail", "thunderbird", "email.*client"],
      "answer": "AgentMail supports IMAP and SMTP for traditional email client access. Connect Outlook, Thunderbird, Apple Mail, etc. using your inbox credentials. Enable SSL/TLS in your client settings.",
      "docs_link": "https://docs.agentmail.to/guides/imap-smtp"
    },
    {
      "id": "profile_picture",
      "category": "Email Settings",
      "keywords": ["profile", "picture", "image", "avatar", "logo", "photo", "icon"],
      "question_patterns": ["profile.*pic", "add.*image", "inbox.*picture", "email.*avatar"],
      "answer": "Profile pictures are set on the **receiving email client side**, not AgentMail. To show a profile pic in Gmail:\n1. Create a Google account using your AgentMail email\n2. Add a profile picture there\n3. Takes a few days to propagate",
      "docs_link": "https://docs.agentmail.to"
    },
    {
      "id": "deliverability",
      "category": "Best Practices",
      "keywords": ["deliverability", "spam", "warmup", "reputation", "bounce", "inbox placement"],
      "question_patterns": ["deliverability", "spam.*folder", "warm.*up", "email.*reputation", "not.*receiving"],
      "answer": "Email deliverability best practices:\n- Send 10–20 emails per inbox per day\n- Have 10–20 inboxes per domain\n- Use email warmup services (compatible with Instantly)\n- Always provide both `text` and `html` body\n- Have CTA to reply (builds reputation)\n- Minimize links, avoid spammy content\n- No open/click tracking (hurts deliverability)",
      "docs_link": "https://docs.agentmail.to/best-practices/email-deliverability"
    },
    {
      "id": "sandbox_testing",
      "category": "Testing",
      "keywords": ["sandbox", "test", "testing", "development", "dev", "staging", "dummy"],
      "question_patterns": ["sandbox", "test.*environment", "staging", "dev.*mode", "test.*email"],
      "answer": "No universal sandbox for email. Workarounds:\n- Create dummy inboxes on `@agentmail.to` and send test emails between them\n- Use pods to separate dev/prod environments\n- Request a separate API key for development\n\nDedicated test environment (no real email sending) is in development.",
      "docs_link": "https://docs.agentmail.to"
    },
    {
      "id": "contexts_feature",
      "category": "Contexts",
      "keywords": ["context", "contexts", "memory", "store", "data", "arbitrary"],
      "question_patterns": ["context.*for", "what.*context", "store.*data", "memory.*layer"],
      "answer": "Contexts are a flexible way to store arbitrary data that agents can reference — like a crude memory layer. Currently in testing with select customers. Will be documented once stabilized.\n\nFuture: ability to search/query semantically related threads.",
      "docs_link": "https://docs.agentmail.to/core-concepts/contexts"
    },
    {
      "id": "attachment_size_limit",
      "category": "Attachments",
      "keywords": ["attachment", "size", "limit", "maximum", "large", "mb"],
      "question_patterns": ["attachment.*limit", "max.*size", "how.*big", "large.*attachment"],
      "answer": "The size limit is **30 MB** for the entire email (including all attachments). Emails larger than this may be blocked entirely.",
      "docs_link": "https://docs.agentmail.to/core-concepts/attachments"
    },
    {
      "id": "auto_reply_example",
      "category": "Examples",
      "keywords": ["auto", "reply", "automatic", "respond", "automation", "incoming", "receive", "example"],
      "question_patterns": ["auto.*reply", "automatic.*respond", "automat.*email", "incoming.*email", "example.*agent"],
      "answer": "Check out our auto-reply agent example! Key steps:\n1. Create inbox with `client_id` (idempotent)\n2. Create webhook for `message.received`\n3. On webhook event, parse sender and send reply\n4. **Always filter out `message.sent` events** to prevent loops",
      "docs_link": "https://docs.agentmail.to/examples/auto-reply-agent"
    },
    {
      "id": "webhook_308",
      "category": "Known Issues",
      "keywords": ["308", "redirect", "trailing", "slash", "webhook", "not working"],
      "question_patterns": ["308.*redirect", "trailing.*slash", "webhook.*not.*working", "webhook.*not.*receiving"],
      "answer": "If webhooks aren't being received and you see 308 status: **remove the trailing slash** from your webhook endpoint URL. For example, use `https://example.com/webhook` not `https://example.com/webhook/`.",
      "docs_link": "https://docs.agentmail.to/webhooks/webhook-setup"
    },
    {
      "id": "uppercase_emails",
      "category": "Known Issues",
      "keywords": ["uppercase", "capital", "case", "sensitive", "email", "not received"],
      "question_patterns": ["uppercase.*email", "capital.*letter", "case.*sensitive"],
      "answer": "If emails with uppercase addresses aren't being received: the system now automatically lowercases email addresses. Always use lowercase email addresses to be safe.",
      "docs_link": "https://docs.agentmail.to"
    }
  ]
}