context aware chat widget

Author: Matanga1-2

docs/ai-interfaces/ai-agents/interact-with-ai-agents.md

@@ -53,6 +53,8 @@ The widget provides a chat interface where you can ask questions and receive res
 
 The widget will inherit all the agent's configuration including the prompts, conversation starters, tool access, etc.
 
+**Context Awareness**: The widget automatically understands the context of the page and entity where it's located. For example, when placed on a team entity page, you can ask questions like "What is this team's lead time for change?" or "How many open bugs does the team have?" without needing to specify the team name.
+
 Conversation starters appear in the initial state, helping users understand what they can ask the agent. Users can either click a starter to begin a new chat or type their own question.
 <img src='/img/ai-agents/AIAgentsWidgetConversationStarters.png' width='80%' border='1px' />
 

docs/ai-interfaces/ai-chat-widget.md

@@ -24,6 +24,7 @@ The AI Chat Widget is a dashboard component that:
 - **Uses configured tools**: Operates with the specific [Port AI tools](/ai-interfaces/port-ai/overview#port-ai-tools) you select.
 - **Customizable placement**: Can be embedded in any dashboard layout.
 - **Respects permissions**: Only accesses data based on user permissions.
+- **Context-aware**: Automatically understands the page and entity context where it's located, allowing you to ask questions about the specific entity or page without explicitly mentioning it.
 
 ## Widget Configuration
 
@@ -82,6 +83,17 @@ Users can type their own questions and requests directly into the chat interface
 - Show visual indicators when tools are being used.
 - Provide links to relevant Port pages and actions.
 
+### Context Awareness
+
+The AI Chat Widget automatically understands the context of the page and entity where it's located. This means you can ask questions about the specific entity or page without needing to explicitly mention it.
+
+**Examples:**
+- On a **team entity page**: "What is this team's lead time for change?" or "How many open bugs does the team have?"
+- On a **service entity page**: "What's the deployment status?" or "Show me recent incidents"
+- On a **dashboard**: Questions will be answered in the context of the dashboard's scope
+
+The widget uses this context to provide more relevant and accurate responses, making it easier to get information about the specific entity or page you're viewing.
+
 ### Tool Transparency
 The widget interface provides enhanced capabilities and visual indicators showing which tools are being used:
 
@@ -314,4 +326,17 @@ For comprehensive information, see [Security Considerations](#security-considera
 - [Data Privacy & Retention](/ai-interfaces/port-ai/security-and-data-controls#data-privacy--retention) - How your data is handled and stored.
 </details>
 
+<details>
+<summary><b>Does the widget understand the context of the page it's on? (Click to expand)</b></summary>
+
+Yes! The AI Chat Widget automatically understands the context of the page and entity where it's located. This means you can ask questions about the specific entity or page without needing to explicitly mention it.
+
+**Examples:**
+- On a **team entity page**: "What is this team's lead time for change?" or "How many open bugs does the team have?"
+- On a **service entity page**: "What's the deployment status?" or "Show me recent incidents"
+- On a **dashboard**: Questions will be answered in the context of the dashboard's scope
+
+The widget uses this context to provide more relevant and accurate responses. Learn more in [Context Awareness](#context-awareness).
+</details>
+
 The AI Chat Widget provides a powerful way to bring [Port AI](/ai-interfaces/port-ai/overview) capabilities directly into your team's daily workflows through customized dashboard experiences.