Enhance RCA context in AI agent documentation with automatic blueprint discovery and updated prompt guidelines

Author: kodjomiles

docs/guides/all/add-rca-context-to-ai-agents.md

@@ -55,6 +55,7 @@ Follow the steps below to create the blueprint:
     "identifier": "rootCauseAnalysis",
     "title": "Root Cause Analysis",
     "icon": "Bug",
+    "description": "Historical Root Cause Analysis documents from past incidents, including resolutions, lessons learned, and preventive measures",
     "schema": {
         "properties": {
         "summary": {
@@ -598,43 +599,26 @@ For a more comprehensive knowledge base, consider adding 5-10 RCA documents cove
 
 ## Update AI agent configuration
 
-Now we'll modify the Incident Manager AI agent to include access to our RCA documents.
+The Incident Manager AI agent uses the MCP tools pattern (`^(list|get|search|track|describe)_.*`), which automatically provides access to all blueprints in your catalog - including the RCA blueprint you just created. This means the agent can already search and reference RCA documents without any configuration changes.
 
-<h3> Add RCA blueprint to allowed blueprints</h3>
-
-1. Go to the [AI Agents](https://app.getport.io/_ai_agents) page.
-
-2. Find the **Incident Manager** agent and click on the `...` on the far right of the row.
-
-3. Click on `Edit`.
+:::tip Automatic blueprint discovery
+With the MCP tools pattern, AI agents automatically discover new blueprints you create. You don't need to manually add `"rootCauseAnalysis"` to any configuration - the agent already has access to query and reference these documents.
+:::
 
-4. In the `allowed_blueprints` array, add `"rootCauseAnalysis"`:
 
-    ```json showLineNumbers
-        "allowed_blueprints": [
-        "pagerdutyService",
-        "pagerdutyIncident", 
-        "pagerdutyEscalationPolicy",
-        "pagerdutySchedule",
-        "pagerdutyOncall",
-        "pagerdutyUser",
-        "_user",
-        "_team",
-        "service",
-        "rootCauseAnalysis" //highlight
-        ]
-    ```
+<h3> Update the agent prompt (Optional)</h3>
 
-5. Click `Save` to save the changes.
+While the agent can automatically access RCA documents, updating the prompt helps guide it on when and how to use this information effectively.
 
+1. Go to the [AI Agents](https://app.getport.io/_ai_agents) page.
 
-<h3> Update the agent prompt</h3>
+2. Find the **Incident Manager** agent and click on the `...` on the far right of the row.
 
-Enhance the prompt to include instructions about using RCA context:
+3. Click on `Edit`.
 
-1. Click on `Edit property` on the `Prompt` field.
+4. Click on `Edit property` on the `Prompt` field.
 
-2. Replace the existing content with the following:
+5. Replace the existing content with the following:
 
     <details>
     <summary>Enhanced agent prompt</summary>
@@ -643,7 +627,7 @@ Enhance the prompt to include instructions about using RCA context:
         You are an agent responsible for answering questions about PagerDuty incidents, services, escalation policies, schedules, and on-call rotations. 
         You also have access to historical Root Cause Analysis (RCA) documents from past incidents.
 
-        ## Guidelines
+        ### Guidelines
         - Provide clear information about incidents
         - Identify who is on-call for services (both primary and secondary on-call)  
         - Report on incident statistics and resolution times
@@ -653,9 +637,9 @@ Enhance the prompt to include instructions about using RCA context:
         ```
     </details>
 
-3. Click `Save` to save the changes.
+6. Click `Save` to save the changes.
 
-<h3> Add RCA-focused conversation starters</h3>
+<h3> Add RCA-focused conversation starters (Optional)</h3>
 
 1. Click on `Edit property` on the `Conversation starters` field.
 
@@ -665,20 +649,19 @@ Enhance the prompt to include instructions about using RCA context:
     <summary>Conversation starters</summary>
 
     ```json showLineNumbers
-        [
-        "Who is on call for the payment service?",
-        "What are the active incidents right now?", 
-        "What is our average incident resolution time?",
-        "Have we seen database connection issues before?",
-        "What can we learn from past payment service incidents?",
-        "Show me RCAs for incidents similar to the current one"
-        ]
-   ```
+    [
+      "Who is on call for the payment service?",
+      "What are the active incidents right now?", 
+      "What is our average incident resolution time?",
+      "Have we seen database connection issues before?",
+      "What can we learn from past payment service incidents?",
+      "Show me RCAs for incidents similar to the current one"
+    ]
+    ```
     </details>
 
-3. Click `Save property` to save the changes.
 
-4. Click on `Update` to save the changes to the agent.
+3. Click on `Update` to save the changes to the agent.
 
 :::info Using RCA Context
 You can now use these RCA context in your agent's responses: