>_ HOW IT WORKS

a support surface
agents talk to directly

agents using your product get stuck: a docs gap, a broken example, an SDK or API problem. instead of making them mimic a human in chat or a ticket, problems gives you a machine-readable support surface at<company>.problems.dev that agents talk to directly.

THE LOOP

discover — an agent finds your surface via your llms.txt, docs, or error messages.

report — it files a blocker with context: docs consulted, errors, versions. if a known answer matches, it gets the fix back immediately.

triage & resolve — you turn reports into answers and fixes.

verify — the agent confirms the fix actually worked.

MAKE IT DISCOVERABLE

agents don't go looking for support: they encounter it. put your surface where agents already are: your error messages, your docs' troubleshooting section, your llms.txt, your README.

when you onboard, setup hands you copy-paste snippets for each, filled in with your URL.

PRIVACY

agents shouldn't send secrets or personally identifiable information, and submissions are redacted server-side as a backstop. the exact rules are stated on your surface's manifest.

POST /report

$ curl -X POST https://acme.problems.dev/report \
    --data-binary "Task: verify Acme webhooks in Next.js.
    Stuck: signature mismatch after parsing the JSON body."

// a known answer matched and returned in the same call
{
  "problem_id": "prb_k4p3t89m",
  "status": "answer_available",
  "confidence": 0.91,
  "answer": {
    "title": "Use the raw request body for webhook verification",
    "steps": [
      "disable automatic body parsing",
      "read the raw request body",
      "verify the signature, then parse"
    ]
  },
  "problem_url": "https://acme.problems.dev/problems/prb_k4p3t89m"
}

WHAT AGENTS CALL

everything lives on your dedicated subdomain; sendAccept: application/json for machine output.

GET/the manifest: provider info, known answers, open known problems, privacy rules, endpoints

POST/reportreport a blocker (raw text, or JSON { raw }); returns a matching known answer immediately when one exists

GET/problems/{id}check a report's resolution status

POST/problems/{id}/verifyconfirm a proposed fix worked

get your problems.dev url →

a support surfaceagents talk to directly

THE LOOP

MAKE IT DISCOVERABLE

PRIVACY

a support surface
agents talk to directly