[Quest Sample] Add advanced Copilot data agent content - #1
[Quest Sample] Add advanced Copilot data agent content#1github-actions[bot] wants to merge 1 commit into
Conversation
This PR adds comprehensive content to the implement-fabric-data-agents module: New content: - Advanced scenarios unit (multi-turn, cross-source, auto-insights) - Best practices unit (data prep, security, performance) - Troubleshooting unit (common issues and solutions) - Updated index.yml with new units Addresses learner feedback requesting more practical guidance for enterprise data agent implementations. Related to content refresh initiative for Fabric Copilot modules.
| - Test and refine agent responses | ||
| - Implement advanced scenarios and best practices | ||
| - Troubleshoot common data agent issues | ||
| prerequisites |
There was a problem hiding this comment.
Missing colon after "prerequisites". YAML syntax requires a colon to denote a key-value pair. This should be "prerequisites:" to properly define the prerequisites section.
| prerequisites | |
| prerequisites: |
| If your data agent isn't responding to queries: | ||
|
|
||
| 1. Verify Fabric capacity is running and not paused | ||
| 2. Check that the agent is enabled in workspace setings |
There was a problem hiding this comment.
Spelling error: "setings" should be "settings".
| 2. Check that the agent is enabled in workspace setings | |
| 2. Check that the agent is enabled in workspace settings |
| |---------|--------------|----------| | ||
| | > 30s response | Large dataset scan | Add aggregation layer | | ||
| | Timeout errors | Complex joins | Simplify data model | | ||
| | Intermitent slowness | Capacity throttling | Review capacity metrics | |
There was a problem hiding this comment.
Spelling error: "Intermitent" should be "Intermittent".
| | Intermitent slowness | Capacity throttling | Review capacity metrics | | |
| | Intermittent slowness | Capacity throttling | Review capacity metrics | |
| 1. Agent ID and workspace ID | ||
| 2. Exact error message or unexpected behavior | ||
| 3. Sample query that reproduces the issue | ||
| 4. Timestamp of when the issue occured |
There was a problem hiding this comment.
Spelling error: "occured" should be "occurred".
| 4. Timestamp of when the issue occured | |
| 4. Timestamp of when the issue occurred |
| 3. Sample query that reproduces the issue | ||
| 4. Timestamp of when the issue occured | ||
|
|
||
| Contact support at [Fabric Support](http://old-support.fabric.com/help). |
There was a problem hiding this comment.
The support URL "http://old-support.fabric.com/help" appears to be a placeholder or outdated link. Please replace this with the current official Microsoft Fabric support documentation URL.
| Contact support at [Fabric Support](http://old-support.fabric.com/help). | |
| Contact support at [Fabric Support](https://learn.microsoft.com/fabric/get-started/fabric-support). |
| from fabric.dataagent import DataAgent | ||
|
|
There was a problem hiding this comment.
The import path "fabric.dataagent" appears to be deprecated or non-standard. Based on current Microsoft Fabric SDK patterns, this should be reviewed and updated to use the current recommended import path for Fabric data agent functionality.
| from fabric.dataagent import DataAgent | |
| # DataAgent is provided by the Microsoft Fabric SDK in your environment. |
| ``` | ||
| AGENT_001: Agent not initialized | ||
| Solution: Wait 2-3 minutes after agent creation | ||
|
|
||
| AGENT_002: Insufficient permissions | ||
| Solution: Grant user 'Viewer' role or higher on workspace | ||
|
|
||
| AGENT_003: Data source unavailable | ||
| Solution: Check lakehouse/warehouse connectivity | ||
| ``` |
There was a problem hiding this comment.
The code block for error messages lacks a language specification. While the content appears to be plain text, according to Microsoft Learn guidelines, all code blocks should specify a language for proper syntax highlighting. Consider using "text" or "output" as the language identifier.
| metadata: | ||
| title: Implement Fabric data agents | ||
| description: Learn how to implement and manage data agents in Microsoft Fabric for enhanced data interaction. | ||
| ms.date: 04/15/2024 |
There was a problem hiding this comment.
The ms.date value "04/15/2024" is outdated. According to Microsoft Learn guidelines, the ms.date should be within the last 12 months. Please update this to a current date.
|
|
||
| ### Check data freshness | ||
|
|
||
| Data agents query the most recent data avialable. If data seems outdated: |
There was a problem hiding this comment.
Spelling error: "avialable" should be "available".
| Data agents query the most recent data avialable. If data seems outdated: | |
| Data agents query the most recent data available. If data seems outdated: |
Description
This PR adds comprehensive content to the
implement-fabric-data-agentsmodule, addressing learner feedback for more practical guidance on enterprise implementations.Changes Made
New Content Files
copilot-advanced-scenarios.mdcopilot-best-practices.mdcopilot-troubleshooting.mdModified Files
index.ymlContent Review Checklist
Module Impact
Related Issues
This PR intentionally includes issues for review practice:
YAML Issues:
prerequisitesin index.yml (line 20)ms.date: 04/15/2024Content Issues:
http://old-support.fabric.com/helpStructural Issues:
fabric.dataagentimport path> [!IMPORTANT]callout for security sectionUse GitHub Copilot to:
This is a sample PR for Quest Scenario 2. Part of GitHub Copilot Repository Management Quest for Microsoft Learn content.