Free field guide
So you built a Slack bot. Now prove it can do the job.
This field guide is the full story of how we turned an eccentric internal bot into a tenant-isolated AI operator working directly with customers, and built the measurement system to know whether it was worth trusting.
web edition + PDF download
The complete guide: the incident, the architecture, the behavioral model, the modeling decisions, what the evidence changed, and the six-part scorecard to run against your own agent.
How it starts
A customer’s pipeline broke before the support interface was finished. Instead of finishing the interface, we gave our Slack bot scoped, read-only credentials and asked it to investigate.
It cross-referenced Sentry, the replica database, the pipeline state, and the codebase. Then it fixed the problem end to end: the refund, the pull request, and the deploy.
The problem this guide solves
We had traces, spans, tokens, tool calls, latency, exceptions, transcripts, and job records. We still could not answer a single basic product question. If your agent serves customers today, run this test against your own dashboards:
You probably know
the machine- How long a model call took
- How many tokens it consumed
- Which tools it called
- Whether an exception occurred
You probably don’t
the product- Which customers are receiving value
- Whether people accepted the result
- Which capabilities bring people back
- Which accounts are quietly fading
Inside the guide
Who this is for
Written for you if
- You’re post-revenue with a bot, agent, or conversational workflow already serving customers
- Your bot sometimes fails, times out, or misreads context, and you can’t explain why some users adopt it and others disappear
- You have logs, traces, and transcripts but no product understanding
- You’re trying to turn a promising prototype into a reliable coworker
Skip it if
- You’re deciding whether to experiment with AI at all
- You have no product and no users yet
- You want prompt-engineering tips
- You need a basic PostHog installation