Skip to content

Rehaul escalations → alerts docs (TSP-1058)#522

Open
alexrelevanceai wants to merge 2 commits intomainfrom
feature/tsp-1058-frontend-pr-12707-document-new-agent-published-notification
Open

Rehaul escalations → alerts docs (TSP-1058)#522
alexrelevanceai wants to merge 2 commits intomainfrom
feature/tsp-1058-frontend-pr-12707-document-new-agent-published-notification

Conversation

@alexrelevanceai
Copy link
Member

Summary

  • Renames escalations.mdxalerts.mdx to match the product UI
  • Documents all three alert types: status change, tool error, and agent published (new from PR #12707)
  • Documents notification channels: Email, Slack, Microsoft Teams
  • Documents the Escalate to Manager tool section (lives on the Alerts page in the product)
  • Moves Tool Approvals and Failure Policy content to tools.mdx where it belongs in the product UI
  • Adds redirect from old /escalations URL → /alerts
  • Updates cross-references in build-overview.mdx, create-an-agent.mdx, and quick-start-guide.mdx

Context

The old "Escalations" page bundled three unrelated concepts (notifications, tool approvals, failure policy) under an outdated name. The product now calls this page "Alerts" and has a proper alert rule system. This rehaul aligns docs with the current product.

Related: relevance-api-node PR #12707

Test plan

  • Verify /build/agents/build-your-agent/alerts renders correctly
  • Verify redirect from /build/agents/build-your-agent/escalations → alerts page works
  • Verify navigation shows "Alerts" in the Build an Agent sidebar
  • Verify tools page shows new Tool Approvals and Failure Policy sections
  • Check all cross-reference links resolve

🤖 Generated with Claude Code

…tation

Renames escalations.mdx to alerts.mdx to match the product UI, documents
all three alert types (status change, tool error, agent published), notification
channels (email, Slack, Teams), and the escalate to manager tool. Moves tool
approvals and failure policy content to the tools page where it belongs in
the product. Adds redirect for old escalations URL.

Closes TSP-1058

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@mintlify
Copy link
Contributor

mintlify bot commented Mar 23, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
relevanceai 🟢 Ready View Preview Mar 23, 2026, 11:01 AM

@linear
Copy link

linear bot commented Mar 23, 2026

- Replace plain bullet lists with CardGroup components (alert types,
  channels, escalation use cases)
- Move status list into Accordion (flowing sentences, not bullets)
- Reorder to Overview → Features → Setup flow
- Remove banned word "seamlessly"
- Fix British spelling "Behaviour" → "Behavior"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant