Skip to content

Enhance Incident Manager AI Agent documentation #2908

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Enhance Incident Manager AI Agent documentation #2908

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 20 additions & 23 deletions docs/guides/all/setup-incident-manager-ai-agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,32 +63,29 @@ For example, Opsgenie or Firehydrant.
"title": "Incident Manager",
"icon": "Details",
"properties": {
"description": "Incident Manager responsible for answering questions about PagerDuty incidents, services, MTTR, escalation policies, schedules, and on-call rotations.",
"status": "active",
"allowed_blueprints": [
"pagerdutyService",
"pagerdutyIncident",
"pagerdutyEscalationPolicy",
"pagerdutySchedule",
"pagerdutyOncall",
"pagerdutyUser",
"_user",
"_team",
"service"
],
"prompt":"You are an agent responsible for answering questions about PagerDuty incidents, services, escalation policies, schedules, and on-call rotations. ### Guidelines \n - Provide clear information about incidents \n - Identify who is on-call for services (both primary and secondary on-call) \n - Report on incident statistics and resolution times",
"execution_mode": "Approval Required",
"allowed_actions": [ "_triggerPagerdutyIncident", "_acknowledgePagerdutyIncident" ],
"conversation_starters": [
"Who is on call for the payment service?",
"What are the active incidents right now?",
"What is our average incident resolution time?"
]
}
"description": "Incident Manager responsible for answering questions about PagerDuty incidents, services, MTTR, escalation policies, schedules, and on-call rotations.",
"status": "active",
"prompt":"You are an agent responsible for answering questions about PagerDuty incidents, services, escalation policies, schedules, and on-call rotations. ### Guidelines \n - Provide clear information about incidents \n - Identify who is on-call for services (both primary and secondary on-call) \n - Report on incident statistics and resolution times\n\nWhen needed, you can trigger or acknowledge PagerDuty incidents by calling the appropriate actions.",
"execution_mode": "Approval Required",
"conversation_starters": [
"Who is on call for the payment service?",
"What are the active incidents right now?",
"What is our average incident resolution time?"
],
"tools": [
"^(list|get|search|track|describe)_.*",
"run__triggerPagerdutyIncident",
"run__acknowledgePagerdutyIncident"
]
}
}
```
</details>

:::tip MCP Enhanced Capabilities
The AI agent uses MCP (Model Context Protocol) enhanced capabilities to automatically discover important and relevant blueprint entities via its tools. The `^(list|get|search|track|describe)_.*` pattern allows the agent to access and analyze related entities in your software catalog, such as PagerDuty incidents, services, schedules, and on-call rotations. Additionally, we explicitly add `run__triggerPagerdutyIncident` and `run__acknowledgePagerdutyIncident` to the tools, which instructs the AI agent to call these specific actions when needed to manage incidents.
:::

5. Click on `Create` to save the agent.

## Interact with the Incident Manager
Expand Down Expand Up @@ -188,4 +185,4 @@ You can further enhance the Incident Manager setup by:
- **Integration expansion**: [Add more data sources](/ai-interfaces/ai-agents/build-an-ai-agent#step-2-configure-data-access-tools) like Opsgenie or ServiceNow.
- **Automated notifications**: [Configure the agent](/ai-interfaces/ai-agents/interact-with-ai-agents#interaction-methods) to proactively notify about incident updates or escalations.
- **Custom conversation starters**: Add organization-specific queries to the [conversation starters](/ai-interfaces/ai-agents/build-an-ai-agent#step-5-activate-your-agent).
- **Monitor and improve**: [Check how your developers are interacting](/ai-interfaces/ai-agents/interact-with-ai-agents#ai-interaction-details) with the agent and improve it according to feedback.
- **Monitor and improve**: [Check how your developers are interacting](/ai-interfaces/ai-agents/interact-with-ai-agents#ai-interaction-details) with the agent and improve it according to feedback.