AI AGENTS

Resolved Incident to Public Troubleshooting Doc

For customer-facing errors resolved in Sentry, the agent drafts a sanitized troubleshooting entry and opens a PR to your ReadMe documentation.

CategoryAI Agents
Enginepaperclip
Difficultyadvanced
Triggerevent
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerSentry issue resolvedSentrySentry
  • LogicContinue only if issue is customer-facing
  • ActionRead resolution; redact internal detailsSentrySentry
  • ActionAgent drafts public troubleshooting entry
  • ActionOpen PR to ReadMe docsReadMeReadMe
  • OutputNotify support channel in SlackSlack

What it does

Some resolved incidents map to errors your customers actually see. This agent detects when a resolved Sentry issue is tagged customer-facing, then drafts a public-safe troubleshooting article — symptom, cause in plain language, and the workaround or fix — and opens a PR to your ReadMe docs. It deliberately omits stack traces, internal hostnames, and engineer names.

When to use it

Use it when support tickets repeat known errors that you've already fixed internally but never documented for users. Turns each resolution into self-serve deflection content.

How it works

  1. 1Sentry triggers on a resolved issue.
  2. 2The agent checks tags and the issue's user-impact data; it stops unless the issue is customer-facing.
  3. 3It reads the resolution to understand symptom and fix, then rewrites it as a user-facing troubleshooting entry with all internal detail redacted.
  4. 4It opens a PR against the ReadMe documentation project.
  5. 5It notifies the support channel in Slack so the team can link the new article in open tickets.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect SentryErrors, performance, releases.
  2. 2
    Connect ReadMeAPI docs, changelog, auth.
  3. 3
    Connect SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.