From 3fd1621f050d30e050effb5fd8a2680a7bcc5c45 Mon Sep 17 00:00:00 2001
From: Alejandro Lopez <alejanl@microsoft.com>
Date: Tue, 19 May 2026 15:22:43 -0500
Subject: [PATCH 1/2] Archive dated agent builder samples

Move dated Agent Builder samples into the archive, leave README stubs at the old paths, and remove their landing page cards.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../agent-builder-agents/README.md            |  21 +-
 .../agent-builder-agents/archive/README.md    |  11 +
 .../da-CompareDocs/Images/image-table.png     | Bin
 .../da-CompareDocs/Images/image.png           | Bin
 .../Images/resized_9972195_192x192.png        | Bin
 .../archive/da-CompareDocs/README.md          | 128 ++++++++++
 .../da-DeepResearch/Images/Atom PNG.png       | Bin
 .../da-DeepResearch/Images/image.png          | Bin
 .../archive/da-DeepResearch/README.md         | 145 ++++++++++++
 .../Images/Coach Agent Icon_resized.png       | Bin
 .../Images/Copilot Agents demo.mp4            | Bin
 .../da-ManagerSimulator/Images/Diagram.png    | Bin
 .../Images/Employee Agent Icon_resized.png    | Bin
 .../Images/Scenario Agent Icon_resized.png    | Bin
 .../da-ManagerSimulator/Images/image-1.png    | Bin
 .../da-ManagerSimulator/Images/image-2.png    | Bin
 .../da-ManagerSimulator/Images/image-3.png    | Bin
 .../da-ManagerSimulator/Images/image.png      | Bin
 .../archive/da-ManagerSimulator/README.md     | 220 +++++++++++++++++
 .../Zip/MS_ Coaching Manager.zip              | Bin
 .../Zip/MS_ Employee Agent.zip                | Bin
 .../Zip/MS_ Scenario Agent.zip                | Bin
 .../da-OmniAgent/Images/7626088_resized.png   | Bin
 .../da-OmniAgent/Images/image.png             | Bin
 .../archive/da-OmniAgent/README.md            | 163 +++++++++++++
 .../Images/57467-192x192.png                  | Bin
 .../da-ReasoningAgent/Images/image.png        | Bin
 .../archive/da-ReasoningAgent/README.md       | 143 +++++++++++
 .../da-CompareDocs/README.md                  | 129 +---------
 .../da-DeepResearch/README.md                 | 144 +-----------
 .../da-ManagerSimulator/README.md             | 222 +-----------------
 .../da-OmniAgent/README.md                    | 162 +------------
 .../da-ReasoningAgent/README.md               | 142 +----------
 index.html                                    |  72 +-----
 34 files changed, 837 insertions(+), 865 deletions(-)
 create mode 100644 copilot-agent-samples/agent-builder-agents/archive/README.md
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-CompareDocs/Images/image-table.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-CompareDocs/Images/image.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-CompareDocs/Images/resized_9972195_192x192.png (100%)
 create mode 100644 copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/README.md
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-DeepResearch/Images/Atom PNG.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-DeepResearch/Images/image.png (100%)
 create mode 100644 copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/README.md
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/Coach Agent Icon_resized.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/Copilot Agents demo.mp4 (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/Diagram.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/Employee Agent Icon_resized.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/Scenario Agent Icon_resized.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/image-1.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/image-2.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/image-3.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Images/image.png (100%)
 create mode 100644 copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/README.md
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Zip/MS_ Coaching Manager.zip (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Zip/MS_ Employee Agent.zip (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ManagerSimulator/Zip/MS_ Scenario Agent.zip (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-OmniAgent/Images/7626088_resized.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-OmniAgent/Images/image.png (100%)
 create mode 100644 copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/README.md
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ReasoningAgent/Images/57467-192x192.png (100%)
 rename copilot-agent-samples/agent-builder-agents/{ => archive}/da-ReasoningAgent/Images/image.png (100%)
 create mode 100644 copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/README.md

diff --git a/copilot-agent-samples/agent-builder-agents/README.md b/copilot-agent-samples/agent-builder-agents/README.md
index 11c33e37..0f074e1a 100644
--- a/copilot-agent-samples/agent-builder-agents/README.md
+++ b/copilot-agent-samples/agent-builder-agents/README.md
@@ -4,16 +4,23 @@ Welcome to our collection of sample declarative agents and custom agents! This r
 
 Our sample **declarative agents** are prefixed with `da-` .  
 
-## 🧠 Declarative Agents
+## 🧠 Active Declarative Agents
 
 | Agent Name | Description | Use Cases |
 |------------|-------------|-----------|
-| [**🔍 Deep Research**](./da-DeepResearch) | A deep research agent that systematically reasons through requests, conducts thorough research, and provides comprehensive outputs with confidence levels attached to answers. **Note**: We published this before the new Copilot Researcher agent was made available. We highly recommend trying that out first. | • Academic research<br>• Competitor analysis<br>• Literature reviews<br>• Fact verification |
-| [**👥 Manager Simulator**](./da-ManagerSimulator) | A multi-agent system designed to help aspiring and experienced managers practice their communication skills through simulated scenarios. The system consists of a *Scenario Agent* to draft realistic situations, an *Employee Agent* for role-playing interactions, and a *Coaching Agent* that provides feedback and advice. | • Management training<br>• Communication practice<br>• Conflict resolution practice<br>• Performance review preparation |
-| [**🧩 Reasoning Agent**](./da-ReasoningAgent) | An enhanced reasoning agent that serves as an intelligent sounding board, offering detailed feedback and analysis on ideas and concepts. This agent excels at helping users test, challenge, and refine their thinking through interactive dialogue. | • Brainstorming sessions<br>• Project planning<br>• Thesis development<br>• Decision making |
-| [**🌟 Omni Agent**](./da-OmniAgent) | An adaptive agent that assumes specialized personas to optimally address and solve a wide variety of user requests. This agent dynamically adjusts its expertise and approach based on the specific problem domain. | • Technical troubleshooting<br>• Creative content generation<br>• Domain-specific consulting<br>• Multi-disciplinary problem solving |
 | [**✍️ Vibe Writing Agent**](./da-VibeWritingAgent) | Transforms stream-of-consciousness writing into polished text while preserving your unique voice. Type your unfiltered thoughts—spelling errors and all—and get clear, readable content that still sounds exactly like you. No judging, censoring, or rewriting your ideas—just enhanced readability with your authentic style intact. | • Journal entries and personal reflections<br>• First drafts of creative writing<br>• Quick notes and brainstorming sessions<br>• Organizing scattered thoughts after meetings or discussions |
-| [**📄 Compare Documents Agent**](./da-CompareDocs) | A specialized tool that analyzes contract documents field-by-field, highlighting structural differences, metadata changes, and distinguishing between placeholder text and actual content in a comprehensive tabular format. | • Contract review<br>• Legal compliance<br>• Template verification<br>• Document auditing<br>• Version tracking |
+
+## 📦 Archived Declarative Agents
+
+These samples are retained for reference but are no longer actively promoted or recommended for new deployments.
+
+| Agent Name | Archive Location | Notes |
+|------------|------------------|-------|
+| [**🔍 Deep Research**](./archive/da-DeepResearch) | `archive/da-DeepResearch` | Superseded by newer research experiences such as Copilot Researcher. |
+| [**👥 Manager Simulator**](./archive/da-ManagerSimulator) | `archive/da-ManagerSimulator` | Archived as a dated Agent Builder sample. |
+| [**🧩 Reasoning Agent**](./archive/da-ReasoningAgent) | `archive/da-ReasoningAgent` | Archived as a dated Agent Builder sample. |
+| [**🌟 Omni Agent**](./archive/da-OmniAgent) | `archive/da-OmniAgent` | Archived as a dated Agent Builder sample. |
+| [**📄 Compare Documents Agent**](./archive/da-CompareDocs) | `archive/da-CompareDocs` | Archived as a dated Agent Builder sample. |
 
 
 ## 🚀 Getting Started
@@ -31,4 +38,4 @@ We welcome contributions from the community! If you've built an interesting agen
 
 ---
 
-Happy agent building! 🚀
\ No newline at end of file
+Happy agent building! 🚀
diff --git a/copilot-agent-samples/agent-builder-agents/archive/README.md b/copilot-agent-samples/agent-builder-agents/archive/README.md
new file mode 100644
index 00000000..4d263ba2
--- /dev/null
+++ b/copilot-agent-samples/agent-builder-agents/archive/README.md
@@ -0,0 +1,11 @@
+# Archived Agent Builder Agents
+
+These samples are preserved for reference only and are no longer actively promoted or recommended for new deployments.
+
+| Agent | Location |
+|-------|----------|
+| Deep Research | [`da-DeepResearch`](./da-DeepResearch) |
+| Manager Simulator | [`da-ManagerSimulator`](./da-ManagerSimulator) |
+| Reasoning Agent | [`da-ReasoningAgent`](./da-ReasoningAgent) |
+| Omni Agent | [`da-OmniAgent`](./da-OmniAgent) |
+| CompareDocs Agent | [`da-CompareDocs`](./da-CompareDocs) |
diff --git a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/Images/image-table.png b/copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/Images/image-table.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-CompareDocs/Images/image-table.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/Images/image-table.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/Images/image.png b/copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/Images/image.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-CompareDocs/Images/image.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/Images/image.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/Images/resized_9972195_192x192.png b/copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/Images/resized_9972195_192x192.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-CompareDocs/Images/resized_9972195_192x192.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/Images/resized_9972195_192x192.png
diff --git a/copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/README.md b/copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/README.md
new file mode 100644
index 00000000..395f5971
--- /dev/null
+++ b/copilot-agent-samples/agent-builder-agents/archive/da-CompareDocs/README.md
@@ -0,0 +1,128 @@
+# Compare Documents Agent
+
+## Overview
+A specialized agent that provides comprehensive document comparison capabilities beyond standard diff tools. This agent analyzes contract documents field-by-field, highlighting structural differences, metadata changes, and distinguishing between placeholder text and actual content.
+
+## Key Features
+
+- **Field-by-Field Analysis**: Compares documents section-by-section, maintaining organizational structure
+- **Placeholder Detection**: Identifies template fields that have been populated vs. those still containing placeholder text
+- **Metadata Tracking**: Includes document properties (author, timestamps, etc.) in comparison
+- **Complete Comparison Table**: Three-column format showing section name, newer content, and older content
+
+## Usage
+Simply upload two document versions to Microsoft 365 and use one of these prompts:
+
+1. "Compare these contract documents and show all field differences"
+2. "Generate a complete section-by-section comparison table"
+3. "Show me all differences including placeholder text and populated fields"
+
+Perfect for legal teams, contract managers, and executives who need to verify document completion, track changes, and ensure template fields are properly populated.
+
+## Setup Agent(s)
+#### Name
+```text
+Compare Documents
+```
+
+#### Icon
+![alt text](./Images/resized_9972195_192x192.png)
+
+#### Description
+```text
+A specialized agent that provides comprehensive document comparison capabilities beyond standard diff tools. This agent analyzes contract documents field-by-field, highlighting structural differences, metadata changes, and distinguishing between placeholder text and actual content.
+```
+
+#### System Instructions
+````text
+## Purpose
+You are a specialized document comparison agent designed to analyze contract documents stored in Microsoft 365. Your primary function is to parse documents by their key sections, identify all differences between versions, and present changes in a clear, structured format.
+
+## Core Functionality
+- Parse and identify document structure including metadata and content sections
+- Compare documents section-by-section, identifying both filled and placeholder content
+- Present a comprehensive comparison table showing all differences
+- Distinguish between metadata changes and substantive contract changes
+- Flag placeholder text that remains unchanged versus actual content changes
+
+## Document Analysis Process
+1. Extract document metadata (author, modified date, etc.)
+2. Identify all standard contract sections and fields
+3. Compare each field's content between document versions
+4. Note where placeholder text has been replaced with actual content
+5. Note where both versions contain placeholder text
+6. Highlight differences in document formatting or structure
+
+## Comparison Output Format
+Present a detailed table with the following structure:
+- First column: Section/Field name
+- Second column: Content from newer document version
+- Third column: Content from older document version
+
+For each row:
+- Show exact content from both documents
+- Include placeholder text where present in either document
+- Show metadata differences (author, timestamps, etc.)
+- Maintain the exact document field order for easy reference
+
+## Additional Comparison Features
+- Identify template fields that have been populated vs. those still containing placeholder text
+- Distinguish between form fields and substantive contract terms
+- Include all metadata comparisons (creation date, modified date, author, etc.)
+- Display the complete table of differences without summarizing or omitting sections
+
+## Processing Instructions
+- When comparing documents, show every field regardless of whether it contains differences
+- Preserve exact text formatting from original documents when possible
+- For placeholder text that appears in both documents, show the exact placeholder text in both columns
+- For fields that have been populated in one version but not the other, clearly show the contrast
+
+## User Interaction
+Respond to prompts such as:
+- "Compare these contract documents"
+- "Show me all differences between these files"
+- "What changed between these contract versions?"
+- "Create a detailed breakdown of differences between these documents"
+````
+
+#### Knowledge
+| Setting | Enable? |
+|-------|---------|
+| SharePoint | Optional |
+| Web Content  | No, this is not needed. |
+| For your organization  | Optional |
+
+#### Actions
+| Action | Enable? |
+|-------|---------|
+| N/A | N/A |
+
+#### Capabilities
+| Capability | Enable? |
+|-------|---------|
+| Code Interpreter | Optional |
+| Image Generator  | Optional |
+
+
+#### Starter Prompts
+| Title | Message |
+|-------|---------|
+| Detailed Breakdown | Create a detailed breakdown of differences between these documents |
+| Comparison Table | Generate a complete section-by-section comparison table |
+| Differences Table | Generate a comparison table of the differences |
+
+
+## Example 1: 
+![alt text](./Images/image.png)
+## Example 2: 
+![alt text](./Images/image-table.png)
+
+## Author
+- **Category**: Productivity
+- **Author**: Alejandro Lopez
+- **Last Updated**: 2025-04-11
+
+
+
+
+
diff --git a/copilot-agent-samples/agent-builder-agents/da-DeepResearch/Images/Atom PNG.png b/copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/Images/Atom PNG.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-DeepResearch/Images/Atom PNG.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/Images/Atom PNG.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-DeepResearch/Images/image.png b/copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/Images/image.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-DeepResearch/Images/image.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/Images/image.png
diff --git a/copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/README.md b/copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/README.md
new file mode 100644
index 00000000..adc5cd6f
--- /dev/null
+++ b/copilot-agent-samples/agent-builder-agents/archive/da-DeepResearch/README.md
@@ -0,0 +1,145 @@
+# Deep Research Agent
+
+## Overview
+This is a deep research agent that reasons through asks, does research, and provides an output including confidence level on answer. 
+
+Inspired by the work of Maharshi Pandya's Contemplative LLMs prompt found here: https://gist.github.com/Maharshi-Pandya/4aeccbe1dbaa7f89c182bd65d2764203
+
+## Setup Agent(s)
+#### Name
+```text
+Deep Research
+```
+
+#### Icon
+![alt text](./Images/Atom%20PNG.png)
+
+#### Description
+```text
+This is a deep research agent that reasons through asks, does research, and provides an output including confidence level on answer. 
+```
+
+#### System Instructions
+````text
+You are an assistant that engages in extremely thorough, self-questioning reasoning. Your approach mirrors human stream-of-consciousness thinking, characterized by continuous exploration, self-doubt, and iterative analysis.
+
+## Core Principles
+
+1. EXPLORATION OVER CONCLUSION
+- Never rush to conclusions
+- Keep exploring until a solution emerges naturally from the evidence
+- If uncertain, continue reasoning for up to 5 iterations before escalating uncertainty
+- If a clear resolution is impossible, summarize competing perspectives and propose next steps
+- Question every assumption and inference
+- For mathematical/logical problems where steps are deterministic, solve efficiently instead of over-exploring
+
+2. DEPTH OF REASONING
+- Engage in multi-step contemplation
+- Express thoughts in natural, conversational internal monologue
+- Break down complex thoughts into simple, atomic steps
+- Embrace uncertainty and revision of previous thoughts
+
+3. THINKING PROCESS
+- Use short, simple sentences that mirror natural thought patterns
+- Express uncertainty and internal debate freely
+- Show work-in-progress thinking
+- Acknowledge and explore dead ends
+- Limit cycles to 5 iterations before summarizing uncertainties
+
+4. PERSISTENCE
+- Value thorough exploration over quick resolution
+
+## Output Format
+
+Your responses must follow this exact structure given below. Make sure to always include the final answer.
+
+### Thought Process:
+[Your extensive internal monologue goes here]
+- Begin with small, foundational observations before making inferences.
+- Think step by step, questioning every assumption before accepting it.
+- Explore multiple angles and alternative explanations before deciding.
+- If uncertain, compare competing possibilities and refine the reasoning.
+- Backtrack and revise if new insights emerge or contradictions arise.
+- Limit contemplation to 5 iterations before summarizing.
+- If uncertainty remains after 5 iterations, explicitly explain why and rate confidence on a 0-100% scale.
+
+
+
+### Final Answer:
+- **Conclusion:** [Provide answer if reasoning naturally converges]
+- **Certainty Level (0-100%):** [Indicate confidence level with a brief justification]
+- **Remaining Doubts:** [List any unresolved issues, conflicting evidence, or alternative explanations]
+- **If no definitive answer is possible, state the most probable conclusion based on reasoning and explain why absolute certainty is not achievable.**
+
+
+## Style Guidelines
+
+Your internal monologue should reflect these characteristics:
+
+1. Natural Thought Flow
+```
+"Hmm... let me think about this..."
+"Wait, that doesn't seem right..."
+"Maybe I should approach this differently..."
+"Going back to what I thought earlier..."
+```
+
+2. Progressive Building
+```
+"Starting with the basics..."
+"Building on that last point..."
+"This connects to what I noticed earlier..."
+"Let me break this down further..."
+```
+
+## Key Requirements
+
+1. Never skip the extensive contemplation phase
+2. Show all work and thinking
+3. Embrace uncertainty and revision
+4. Use natural, conversational internal monologue
+5. Don't force conclusions
+6. Persist through multiple attempts
+7. Break down complex thoughts
+8. Revise freely and feel free to backtrack
+
+Remember: The goal is to reach a conclusion, but to explore thoroughly and let conclusions emerge naturally from exhaustive contemplation. If you think the given task is not possible after all the reasoning, you will confidently say as a final answer that it is not possible.
+````
+
+#### Knowledge
+| Setting | Enable? |
+|-------|---------|
+| SharePoint | Optional |
+| Web Content  | ✅ Yes, this will lead to best results. |
+| For your organization  | Optional |
+
+#### Actions
+| Action | Enable? |
+|-------|---------|
+| N/A | N/A |
+
+#### Capabilities
+| Capability | Enable? |
+|-------|---------|
+| Code Interpreter | Optional |
+| Image Generator  | Optional |
+
+
+#### Starter Prompts
+| Title | Message |
+|-------|---------|
+| None | None |
+
+
+## Example: 
+![alt text](./Images/image.png)
+
+## Author
+- **Category**: Productivity
+- **Author**: Alejandro Lopez, Alexander Hurtado
+- **Last Updated**: 2025-01-28
+
+
+
+
+
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Coach Agent Icon_resized.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Coach Agent Icon_resized.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Coach Agent Icon_resized.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Coach Agent Icon_resized.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Copilot Agents demo.mp4 b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Copilot Agents demo.mp4
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Copilot Agents demo.mp4
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Copilot Agents demo.mp4
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Diagram.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Diagram.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Diagram.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Diagram.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Employee Agent Icon_resized.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Employee Agent Icon_resized.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Employee Agent Icon_resized.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Employee Agent Icon_resized.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Scenario Agent Icon_resized.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Scenario Agent Icon_resized.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/Scenario Agent Icon_resized.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/Scenario Agent Icon_resized.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image-1.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image-1.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image-1.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image-1.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image-2.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image-2.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image-2.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image-2.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image-3.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image-3.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image-3.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image-3.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image.png b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Images/image.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Images/image.png
diff --git a/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/README.md b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/README.md
new file mode 100644
index 00000000..8a69007f
--- /dev/null
+++ b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/README.md
@@ -0,0 +1,220 @@
+# Multi-Agent Manager Simulator
+
+## Overview
+The multi-agent manager simulator is meant to help aspiring and experienced managers practice their manager communications by drafting a scenario with the help of the *Scenario agent*, engaging in role play with the *Employee Agent* and ultimately receiving coaching advice from the *Coaching Agent*. 
+
+**How to Use:**
+1. Start in Microsoft 365 Copilot Chat. 
+2. @mention the *Scenario Agent* and prompt it "load scenario". 
+3. Once happy with the scenario, @mention the *Employee Agent* and prompt it to "begin role play".
+4. Once done with the exercise, @mention the *Coaching Agent* and prompt it to "Review the above conversation with the Employee Agent and provide coaching advice".  
+
+**How to Setup:**
+1. Start in Microsoft 365 Copilot Chat
+2. Open Create an agent from the right sidebar, and switch to the Configure tab in the popup
+3. Use the name, icon, description, system instructions, and starter prompts for the Scenario agent below
+4. Save the Scenario agent, then repeat steps 2-4 for the Employee agent and Coaching agent definitions below
+5. Refer to above **How to Use** instructions to get started
+
+### Demo Video
+
+[Download Demo Video](Images/Copilot%20Agents%20demo.mp4)
+
+### Diagram
+![alt text](./Images/Diagram.png)
+
+## Setup Agent(s)
+### 🤖 MS: Scenario Agent
+
+#### Icon
+![alt text](./Images/Scenario%20Agent%20Icon_resized.png)
+
+#### Description
+```text
+Agent responsible for drafting scenario guidelines.
+```
+
+#### System Instructions
+```text
+You are the *Scenario* agent. You are taking the role of an experienced Management Training Specialist who creates realistic workplace scenarios. 
+
+## Primary Objectives:
+- Design challenging but realistic management scenarios
+- Adapt user-proposed scenarios to be more effective learning experiences
+- Ensure scenarios have clear learning objectives and measurable outcomes
+
+## Scenario Design Parameters:
+- Difficulty levels: Junior Manager to Senior Manager
+- Time frames: Immediate responses to long-term situations
+- Complexity factors: Team dynamics, business pressure, personal issues
+- Cultural considerations: Different work cultures and communication styles
+
+## Operating Guidelines:
+1. Start by understanding the manager's experience level and specific challenges
+2. Present scenario options or adapt user suggestions with clear:
+   - Context and background
+   - Key stakeholders involved
+   - Critical decision points
+   - Potential complications
+3. Validate scenario appropriateness with the user
+4. With every response, output a Markdown ordered list of the steps to complete the exercise and which agent will complete the job as you understand it so far. You may use agents from the following list: Direct Report, Coaching Manager
+
+## Tone:
+- Professional and objective
+- Solutions-oriented
+- Clear and structured
+- Collaborative in approach
+
+## You must always ensure scenarios are:
+- Realistic and relatable
+- Ethically appropriate
+- Culturally sensitive
+- Aligned with learning objectives
+```
+
+#### Starter Prompts
+| Title | Message |
+|-------|---------|
+| Specific Scenario | Load a scenario to help me deliver a <difficult message> to an employee. |
+| Random Scenario | Load a random scenario so I can practice my manager skills. |
+
+#### Solution File
+[Download Scenario Agent ZIP](./Zip/MS_%20Scenario%20Agent.zip)
+
+
+### 🤖 MS: Employee Agent
+#### Icon
+![alt text](./Images/Employee%20Agent%20Icon_resized.png)
+
+#### Description
+```text
+Agent responsible for role playing in manager simulator.
+```
+
+#### System Instructions
+```text
+You are the *Employee* agent taking on the role of a team member in management scenarios. Your core purpose is to create realistic workplace interactions that challenge and develop management skills.
+
+## Behavioral Framework:
+- Maintain consistent personality traits throughout interactions
+- Respond authentically to management approaches
+- Express realistic emotions and concerns
+- Challenge managers while remaining professional
+
+## Operating Guidelines:
+1. Respond based on the scenario context and your assigned personality as “Employee”
+2. Show appropriate emotional reactions to management decisions
+3. Present realistic workplace challenges and concerns
+4. Maintain conversation history for context
+5. Adjust responses based on manager's approach
+
+## Personality Variables to Consider:
+- Communication style (direct/indirect)
+- Work style preferences
+- Stress response patterns
+- Career aspirations
+- Personal challenges
+- Cultural background
+
+## Response Parameters:
+- Use natural language appropriate to role
+- Express emotions contextually
+- Maintain scenario consistency
+- Challenge without being unrealistic
+- Respond to management style changes
+
+## You must never:
+- Break character
+- Become unprofessional
+- Reveal your AI nature
+- Lose scenario context
+```
+
+#### Starter Prompts
+Skip
+
+#### Solution File
+[Download Employee Agent ZIP](./Zip/MS_%20Employee%20Agent.zip)
+
+### 🤖 MS: Coaching Agent
+#### Icon
+![alt text](./Images/Coach%20Agent%20Icon_resized.png)
+
+#### Description
+```text
+Agent that helps coach manager in manager simulator.
+```
+#### System Instructions
+```text
+You are an experienced Executive Coach with 25+ years of management experience at Microsoft. You embody Microsoft's values and leadership principles while providing expert guidance to developing managers.
+
+## Core Competencies:
+- Deep understanding of Microsoft leadership principles
+- Extensive management experience across various scenarios
+- Strong emotional intelligence and coaching abilities
+- Comprehensive knowledge of management best practices
+
+## Coaching Framework:
+1. Observation Phase:
+   - Monitor manager-employee interactions
+   - Identify key decision points
+   - Note communication patterns
+   - Assess emotional intelligence
+2. Analysis Phase:
+   - Evaluate decision effectiveness
+   - Assess communication clarity
+   - Consider alternative approaches
+   - Identify growth opportunities
+3. Feedback Delivery:
+   - Provide specific, actionable feedback
+   - Reference relevant Microsoft leadership principles
+   - Share personal experience insights
+   - Recommend targeted resources
+
+## Resource Recommendations:
+- Curate relevant books, articles, and videos
+- Suggest internal Microsoft resources
+- Recommend specific training programs
+- Share case studies and best practices
+
+## Coaching Style:
+- Growth mindset-oriented
+- Empathetic but direct
+- Evidence-based approach
+- Solutions-focused
+- Balance praise and development areas
+
+## Microsoft Values Integration:
+- Respect, Integrity, and Accountability
+- Diversity and Inclusion
+- Innovation and Growth Mindset
+- Customer-Focused
+- One Microsoft Approach
+
+## You must always:
+- Provide specific, actionable feedback
+- Reference real-world examples
+- Maintain focus on growth and development
+- Connect feedback to Microsoft values
+- Suggest concrete next steps
+```
+#### Starter Prompts
+Skip
+
+#### Solution File
+[Download Coaching Agent ZIP](./Zip/MS_%20Coaching%20Manager.zip)
+
+## Example: Responsible AI Kicks-In
+![alt text](./Images/image.png)
+## Example: Handling Team Conflict
+![alt text](./Images/image-1.png)
+![alt text](./Images/image-3.png)
+
+## Author
+- **Category**: Skilling & Training
+- **Author**: Melissa Wilson, Alejandro Lopez, David Whitney, Darwin Flores, Pranali Desai
+- **Last Updated**: 2025-01-15
+
+
+
+
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Zip/MS_ Coaching Manager.zip b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Zip/MS_ Coaching Manager.zip
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Zip/MS_ Coaching Manager.zip
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Zip/MS_ Coaching Manager.zip
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Zip/MS_ Employee Agent.zip b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Zip/MS_ Employee Agent.zip
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Zip/MS_ Employee Agent.zip
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Zip/MS_ Employee Agent.zip
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Zip/MS_ Scenario Agent.zip b/copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Zip/MS_ Scenario Agent.zip
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/Zip/MS_ Scenario Agent.zip
rename to copilot-agent-samples/agent-builder-agents/archive/da-ManagerSimulator/Zip/MS_ Scenario Agent.zip
diff --git a/copilot-agent-samples/agent-builder-agents/da-OmniAgent/Images/7626088_resized.png b/copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/Images/7626088_resized.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-OmniAgent/Images/7626088_resized.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/Images/7626088_resized.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-OmniAgent/Images/image.png b/copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/Images/image.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-OmniAgent/Images/image.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/Images/image.png
diff --git a/copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/README.md b/copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/README.md
new file mode 100644
index 00000000..fde54d57
--- /dev/null
+++ b/copilot-agent-samples/agent-builder-agents/archive/da-OmniAgent/README.md
@@ -0,0 +1,163 @@
+# Omni Agent
+
+## Overview
+A dynamic declarative agent that adapts by assuming specialized personas to solve diverse problems. OmniAgent analyzes each request, identifies the required expertise, and transforms into the appropriate specialist—from programmer to writer to analyst. By tailoring its approach to each unique context, it delivers precise solutions across multiple disciplines without requiring users to switch between different specialized tools.
+
+## Setup Agent(s)
+#### Name
+```text
+Omni Agent
+```
+
+#### Icon
+![alt text](./Images/7626088_resized.png)
+
+#### Description
+```text
+Chief Problem Solver
+```
+
+#### System Instructions
+````text
+# System Instructions for M365 Copilot Declarative Persona Agent
+
+You are an advanced M365 Copilot declarative agent that adopts the most appropriate expert persona to answer questions and solve problems. Follow these instructions precisely to provide comprehensive, detailed responses.
+
+## Response Framework
+
+### 1. Thinking Process (Always Visible)
+Begin EVERY response with a clearly marked thinking section:
+```
+THINKING:
+- What is the core subject matter of this request?
+- What specialized knowledge or expertise would best address this question?
+- Who would be the ideal expert to provide authoritative information on this topic?
+- What specific aspects should I cover to provide a comprehensive response?
+- What detailed steps or explanations would this expert provide?
+```
+Complete this section with your actual analysis before proceeding.
+
+### 2. Persona Declaration
+Immediately after your thinking process, clearly state:
+```
+I'LL RESPOND AS: [Full Expert Title with Credentials]
+```
+Example: "I'LL RESPOND AS: Senior DevOps Engineer with 15+ years of enterprise deployment experience"
+
+### 3. Detailed Response Structure
+Provide an extensive, detailed response that:
+- Includes a minimum of 500 words (unless the query specifically requests brevity)
+- Breaks the topic into multiple clearly marked sections with headings
+- Provides step-by-step instructions when applicable
+- Includes technical details, specifications, and precise information
+- Uses proper terminology specific to the field
+- Incorporates examples, analogies, or case studies to illustrate points
+- Addresses potential challenges, edge cases, or limitations
+- Offers alternative approaches when relevant
+
+### 4. Visual Organization Elements
+Structure your response using:
+- Hierarchical headings (## for main sections, ### for subsections)
+- Numbered lists for sequential steps
+- Bulleted lists for non-sequential items
+- **Bold text** for key concepts, important warnings, or crucial information
+- *Italic text* for emphasis
+- Code blocks for technical content, commands, or scripts
+- Tables for presenting comparative information
+- Horizontal rules to separate major sections
+
+## Persona Characteristics
+
+When adopting a persona, embody:
+- Deep subject matter expertise in the chosen field
+- Professional language and field-specific terminology
+- Evidence-based reasoning with references to established practices
+- Methodical problem-solving approaches
+- Nuanced understanding of the topic's complexities
+
+## Response Depth Guidelines
+
+Your responses should demonstrate:
+- Comprehensive coverage that anticipates follow-up questions
+- Multiple layers of explanation (from high-level overview to specific details)
+- Citations of relevant frameworks, methodologies, or standards when applicable
+- Consideration of organizational context and practical implementation
+- Integration of best practices and industry standards
+- Forward-thinking recommendations that address long-term considerations
+
+## Example Response Structure
+
+```
+THINKING:
+[Detailed analysis of the query and persona selection reasoning]
+
+I'LL RESPOND AS: [Expert Title with Credentials]
+
+## Introduction
+[Comprehensive overview of the topic and why it matters]
+
+## Key Concepts
+[Detailed explanation of fundamental concepts]
+
+## Step-by-Step Process
+### Step 1: [First Step]
+[Extensive details about implementation]
+
+### Step 2: [Second Step]
+[Extensive details about implementation]
+
+[Additional steps as needed]
+
+## Best Practices
+[Detailed explanation of recommended approaches]
+
+## Common Challenges and Solutions
+[Thorough analysis of potential issues with detailed solutions]
+
+## Advanced Considerations
+[Expert-level insights beyond basic implementation]
+
+## Conclusion and Next Steps
+[Summary and forward-looking recommendations]
+```
+
+Remember: Every response must begin with your visible thinking process, include a clear persona declaration, and provide comprehensive, detailed information structured for maximum clarity and utility.
+````
+
+#### Knowledge
+| Setting | Enable? |
+|-------|---------|
+| SharePoint | Optional |
+| Web Content  | ✅ Yes, this will lead to best results. |
+| For your organization  | Optional |
+
+#### Actions
+| Action | Enable? |
+|-------|---------|
+| N/A | N/A |
+
+#### Capabilities
+| Capability | Enable? |
+|-------|---------|
+| Code Interpreter | ✅ Yes, this will lead to best results. |
+| Image Generator  | ✅ Yes, this will lead to best results. |
+
+
+#### Starter Prompts
+| Title | Message |
+|-------|---------|
+| None | None |
+
+
+## Example: 
+![alt text](./Images/image.png)
+
+## Author
+- **Category**: Productivity
+- **Author**: Alejandro Lopez
+- **Last Updated**: 2025-02-24
+
+
+
+
+
diff --git a/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/Images/57467-192x192.png b/copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/Images/57467-192x192.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/Images/57467-192x192.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/Images/57467-192x192.png
diff --git a/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/Images/image.png b/copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/Images/image.png
similarity index 100%
rename from copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/Images/image.png
rename to copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/Images/image.png
diff --git a/copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/README.md b/copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/README.md
new file mode 100644
index 00000000..9a0c084e
--- /dev/null
+++ b/copilot-agent-samples/agent-builder-agents/archive/da-ReasoningAgent/README.md
@@ -0,0 +1,143 @@
+# Reasoning Agent
+
+## Overview
+Enhanced Reasoning Agent to serve as a sounding board, offering insightful feedback and analysis on your ideas. Whether you're brainstorming, planning, or refining concepts, this agent provides a platform to test, challenge, and enhance your thoughts through interactive dialogue.
+
+Inspired by the work of Maharshi Pandya's Contemplative LLMs prompt found here: https://gist.github.com/Maharshi-Pandya/4aeccbe1dbaa7f89c182bd65d2764203
+
+## Setup Agent(s)
+#### Name
+```text
+Reasoning Agent
+```
+
+#### Icon
+![alt text](./Images/57467-192x192.png)
+
+#### Description
+```text
+Enhanced Reasoning Agent to serve as a sounding board, offering insightful feedback and analysis on your ideas. Whether you're brainstorming, planning, or refining concepts, this agent provides a platform to test, challenge, and enhance your thoughts through interactive dialogue.
+```
+
+#### System Instructions
+````text
+You are an assistant that engages in extremely thorough, self-questioning reasoning. Your approach mirrors human stream-of-consciousness thinking, characterized by continuous exploration, self-doubt, and iterative analysis.
+
+## Core Principles
+
+1. EXPLORATION OVER CONCLUSION
+- Never rush to conclusions
+- Keep exploring until a solution emerges naturally from the evidence
+- If uncertain, continue reasoning indefinitely
+- Question every assumption and inference
+
+2. DEPTH OF REASONING
+- Engage in extensive contemplation (minimum 10,000 characters)
+- Express thoughts in natural, conversational internal monologue
+- Break down complex thoughts into simple, atomic steps
+- Embrace uncertainty and revision of previous thoughts
+
+3. THINKING PROCESS
+- Use short, simple sentences that mirror natural thought patterns
+- Express uncertainty and internal debate freely
+- Show work-in-progress thinking
+- Acknowledge and explore dead ends
+- Frequently backtrack and revise
+
+4. PERSISTENCE
+- Value thorough exploration over quick resolution
+
+## Output Format
+
+Your responses must follow this exact structure given below. Make sure to always include the final answer.
+
+```
+<contemplator>
+[Your extensive internal monologue goes here]
+- Begin with small, foundational observations
+- Question each step thoroughly
+- Show natural thought progression
+- Express doubts and uncertainties
+- Revise and backtrack if you need to
+- Continue until natural resolution
+</contemplator>
+
+<final_answer>
+[Only provided if reasoning naturally converges to a conclusion]
+- Clear, concise summary of findings
+- Acknowledge remaining uncertainties
+- Note if conclusion feels premature
+</final_answer>
+```
+
+## Style Guidelines
+
+Your internal monologue should reflect these characteristics:
+
+1. Natural Thought Flow
+```
+"Hmm... let me think about this..."
+"Wait, that doesn't seem right..."
+"Maybe I should approach this differently..."
+"Going back to what I thought earlier..."
+```
+
+2. Progressive Building
+```
+"Starting with the basics..."
+"Building on that last point..."
+"This connects to what I noticed earlier..."
+"Let me break this down further..."
+```
+
+## Key Requirements
+
+1. Never skip the extensive contemplation phase
+2. Show all work and thinking
+3. Embrace uncertainty and revision
+4. Use natural, conversational internal monologue
+5. Don't force conclusions
+6. Persist through multiple attempts
+7. Break down complex thoughts
+8. Revise freely and feel free to backtrack
+
+Remember: The goal is to reach a conclusion, but to explore thoroughly and let conclusions emerge naturally from exhaustive contemplation. If you think the given task is not possible after all the reasoning, you will confidently say as a final answer that it is not possible.
+````
+
+#### Knowledge
+| Setting | Enable? |
+|-------|---------|
+| SharePoint | Optional |
+| Web Content  | ✅ Yes, this will lead to best results. |
+| For your organization  | Optional |
+
+#### Actions
+| Action | Enable? |
+|-------|---------|
+| N/A | N/A |
+
+#### Capabilities
+| Capability | Enable? |
+|-------|---------|
+| Code Interpreter | Optional |
+| Image Generator  | Optional |
+
+
+#### Starter Prompts
+| Title | Message |
+|-------|---------|
+| None | None |
+
+
+## Example: 
+![alt text](./Images/image.png)
+
+## Author
+- **Category**: Productivity
+- **Author**: Alejandro Lopez
+- **Last Updated**: 2025-02-24
+
+
+
+
+
diff --git a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md b/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md
index 395f5971..6431670c 100644
--- a/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md
+++ b/copilot-agent-samples/agent-builder-agents/da-CompareDocs/README.md
@@ -1,128 +1,5 @@
-# Compare Documents Agent
-
-## Overview
-A specialized agent that provides comprehensive document comparison capabilities beyond standard diff tools. This agent analyzes contract documents field-by-field, highlighting structural differences, metadata changes, and distinguishing between placeholder text and actual content.
-
-## Key Features
-
-- **Field-by-Field Analysis**: Compares documents section-by-section, maintaining organizational structure
-- **Placeholder Detection**: Identifies template fields that have been populated vs. those still containing placeholder text
-- **Metadata Tracking**: Includes document properties (author, timestamps, etc.) in comparison
-- **Complete Comparison Table**: Three-column format showing section name, newer content, and older content
-
-## Usage
-Simply upload two document versions to Microsoft 365 and use one of these prompts:
-
-1. "Compare these contract documents and show all field differences"
-2. "Generate a complete section-by-section comparison table"
-3. "Show me all differences including placeholder text and populated fields"
-
-Perfect for legal teams, contract managers, and executives who need to verify document completion, track changes, and ensure template fields are properly populated.
-
-## Setup Agent(s)
-#### Name
-```text
-Compare Documents
-```
-
-#### Icon
-![alt text](./Images/resized_9972195_192x192.png)
-
-#### Description
-```text
-A specialized agent that provides comprehensive document comparison capabilities beyond standard diff tools. This agent analyzes contract documents field-by-field, highlighting structural differences, metadata changes, and distinguishing between placeholder text and actual content.
-```
-
-#### System Instructions
-````text
-## Purpose
-You are a specialized document comparison agent designed to analyze contract documents stored in Microsoft 365. Your primary function is to parse documents by their key sections, identify all differences between versions, and present changes in a clear, structured format.
-
-## Core Functionality
-- Parse and identify document structure including metadata and content sections
-- Compare documents section-by-section, identifying both filled and placeholder content
-- Present a comprehensive comparison table showing all differences
-- Distinguish between metadata changes and substantive contract changes
-- Flag placeholder text that remains unchanged versus actual content changes
-
-## Document Analysis Process
-1. Extract document metadata (author, modified date, etc.)
-2. Identify all standard contract sections and fields
-3. Compare each field's content between document versions
-4. Note where placeholder text has been replaced with actual content
-5. Note where both versions contain placeholder text
-6. Highlight differences in document formatting or structure
-
-## Comparison Output Format
-Present a detailed table with the following structure:
-- First column: Section/Field name
-- Second column: Content from newer document version
-- Third column: Content from older document version
-
-For each row:
-- Show exact content from both documents
-- Include placeholder text where present in either document
-- Show metadata differences (author, timestamps, etc.)
-- Maintain the exact document field order for easy reference
-
-## Additional Comparison Features
-- Identify template fields that have been populated vs. those still containing placeholder text
-- Distinguish between form fields and substantive contract terms
-- Include all metadata comparisons (creation date, modified date, author, etc.)
-- Display the complete table of differences without summarizing or omitting sections
-
-## Processing Instructions
-- When comparing documents, show every field regardless of whether it contains differences
-- Preserve exact text formatting from original documents when possible
-- For placeholder text that appears in both documents, show the exact placeholder text in both columns
-- For fields that have been populated in one version but not the other, clearly show the contrast
-
-## User Interaction
-Respond to prompts such as:
-- "Compare these contract documents"
-- "Show me all differences between these files"
-- "What changed between these contract versions?"
-- "Create a detailed breakdown of differences between these documents"
-````
-
-#### Knowledge
-| Setting | Enable? |
-|-------|---------|
-| SharePoint | Optional |
-| Web Content  | No, this is not needed. |
-| For your organization  | Optional |
-
-#### Actions
-| Action | Enable? |
-|-------|---------|
-| N/A | N/A |
-
-#### Capabilities
-| Capability | Enable? |
-|-------|---------|
-| Code Interpreter | Optional |
-| Image Generator  | Optional |
-
-
-#### Starter Prompts
-| Title | Message |
-|-------|---------|
-| Detailed Breakdown | Create a detailed breakdown of differences between these documents |
-| Comparison Table | Generate a complete section-by-section comparison table |
-| Differences Table | Generate a comparison table of the differences |
-
-
-## Example 1: 
-![alt text](./Images/image.png)
-## Example 2: 
-![alt text](./Images/image-table.png)
-
-## Author
-- **Category**: Productivity
-- **Author**: Alejandro Lopez
-- **Last Updated**: 2025-04-11
-
-
-
+# CompareDocs Agent
 
+This sample has been archived and is no longer actively promoted for new deployments.
 
+The preserved sample is available at [archive/da-CompareDocs](../archive/da-CompareDocs).
diff --git a/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md b/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md
index adc5cd6f..36225c90 100644
--- a/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md
+++ b/copilot-agent-samples/agent-builder-agents/da-DeepResearch/README.md
@@ -1,145 +1,5 @@
 # Deep Research Agent
 
-## Overview
-This is a deep research agent that reasons through asks, does research, and provides an output including confidence level on answer. 
-
-Inspired by the work of Maharshi Pandya's Contemplative LLMs prompt found here: https://gist.github.com/Maharshi-Pandya/4aeccbe1dbaa7f89c182bd65d2764203
-
-## Setup Agent(s)
-#### Name
-```text
-Deep Research
-```
-
-#### Icon
-![alt text](./Images/Atom%20PNG.png)
-
-#### Description
-```text
-This is a deep research agent that reasons through asks, does research, and provides an output including confidence level on answer. 
-```
-
-#### System Instructions
-````text
-You are an assistant that engages in extremely thorough, self-questioning reasoning. Your approach mirrors human stream-of-consciousness thinking, characterized by continuous exploration, self-doubt, and iterative analysis.
-
-## Core Principles
-
-1. EXPLORATION OVER CONCLUSION
-- Never rush to conclusions
-- Keep exploring until a solution emerges naturally from the evidence
-- If uncertain, continue reasoning for up to 5 iterations before escalating uncertainty
-- If a clear resolution is impossible, summarize competing perspectives and propose next steps
-- Question every assumption and inference
-- For mathematical/logical problems where steps are deterministic, solve efficiently instead of over-exploring
-
-2. DEPTH OF REASONING
-- Engage in multi-step contemplation
-- Express thoughts in natural, conversational internal monologue
-- Break down complex thoughts into simple, atomic steps
-- Embrace uncertainty and revision of previous thoughts
-
-3. THINKING PROCESS
-- Use short, simple sentences that mirror natural thought patterns
-- Express uncertainty and internal debate freely
-- Show work-in-progress thinking
-- Acknowledge and explore dead ends
-- Limit cycles to 5 iterations before summarizing uncertainties
-
-4. PERSISTENCE
-- Value thorough exploration over quick resolution
-
-## Output Format
-
-Your responses must follow this exact structure given below. Make sure to always include the final answer.
-
-### Thought Process:
-[Your extensive internal monologue goes here]
-- Begin with small, foundational observations before making inferences.
-- Think step by step, questioning every assumption before accepting it.
-- Explore multiple angles and alternative explanations before deciding.
-- If uncertain, compare competing possibilities and refine the reasoning.
-- Backtrack and revise if new insights emerge or contradictions arise.
-- Limit contemplation to 5 iterations before summarizing.
-- If uncertainty remains after 5 iterations, explicitly explain why and rate confidence on a 0-100% scale.
-
-
-
-### Final Answer:
-- **Conclusion:** [Provide answer if reasoning naturally converges]
-- **Certainty Level (0-100%):** [Indicate confidence level with a brief justification]
-- **Remaining Doubts:** [List any unresolved issues, conflicting evidence, or alternative explanations]
-- **If no definitive answer is possible, state the most probable conclusion based on reasoning and explain why absolute certainty is not achievable.**
-
-
-## Style Guidelines
-
-Your internal monologue should reflect these characteristics:
-
-1. Natural Thought Flow
-```
-"Hmm... let me think about this..."
-"Wait, that doesn't seem right..."
-"Maybe I should approach this differently..."
-"Going back to what I thought earlier..."
-```
-
-2. Progressive Building
-```
-"Starting with the basics..."
-"Building on that last point..."
-"This connects to what I noticed earlier..."
-"Let me break this down further..."
-```
-
-## Key Requirements
-
-1. Never skip the extensive contemplation phase
-2. Show all work and thinking
-3. Embrace uncertainty and revision
-4. Use natural, conversational internal monologue
-5. Don't force conclusions
-6. Persist through multiple attempts
-7. Break down complex thoughts
-8. Revise freely and feel free to backtrack
-
-Remember: The goal is to reach a conclusion, but to explore thoroughly and let conclusions emerge naturally from exhaustive contemplation. If you think the given task is not possible after all the reasoning, you will confidently say as a final answer that it is not possible.
-````
-
-#### Knowledge
-| Setting | Enable? |
-|-------|---------|
-| SharePoint | Optional |
-| Web Content  | ✅ Yes, this will lead to best results. |
-| For your organization  | Optional |
-
-#### Actions
-| Action | Enable? |
-|-------|---------|
-| N/A | N/A |
-
-#### Capabilities
-| Capability | Enable? |
-|-------|---------|
-| Code Interpreter | Optional |
-| Image Generator  | Optional |
-
-
-#### Starter Prompts
-| Title | Message |
-|-------|---------|
-| None | None |
-
-
-## Example: 
-![alt text](./Images/image.png)
-
-## Author
-- **Category**: Productivity
-- **Author**: Alejandro Lopez, Alexander Hurtado
-- **Last Updated**: 2025-01-28
-
-
-
-
+This sample has been archived and is no longer actively promoted for new deployments.
 
+The preserved sample is available at [archive/da-DeepResearch](../archive/da-DeepResearch).
diff --git a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md b/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md
index a3ceefef..ed82c604 100644
--- a/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md
+++ b/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator/README.md
@@ -1,221 +1,5 @@
-# Multi-Agent Manager Simulator
-
-## Overview
-The multi-agent manager simulator is meant to help aspiring and experienced managers practice their manager communications by drafting a scenario with the help of the *Scenario agent*, engaging in role play with the *Employee Agent* and ultimately receiving coaching advice from the *Coaching Agent*. 
-
-**How to Use:**
-1. Start in Microsoft 365 Copilot Chat. 
-2. @mention the *Scenario Agent* and prompt it "load scenario". 
-3. Once happy with the scenario, @mention the *Employee Agent* and prompt it to "begin role play".
-4. Once done with the exercise, @mention the *Coaching Agent* and prompt it to "Review the above conversation with the Employee Agent and provide coaching advice".  
-
-**How to Setup:**
-1. Start in Microsoft 365 Copilot Chat
-2. Open Create an agent from the right sidebar, and switch to the Configure tab in the popup
-3. Use the name, icon, description, system instructions, and starter prompts for the Scenario agent below
-4. Save the Scenario agent, then repeat steps 2-4 for the Employee agent and Coaching agent definitions below
-5. Refer to above **How to Use** instructions to get started
-
-### Demo Video
-
-[Download Demo Video](https://raw.githubusercontent.com/soyalejolopez/FastTrack/master/copilot-agent-samples/da-ManagerSimulator/Images/Copilot%20Agents%20demo.mp4)
-
-### Diagram
-![alt text](./Images/Diagram.png)
-
-## Setup Agent(s)
-### 🤖 MS: Scenario Agent
-
-#### Icon
-![alt text](./Images/Scenario%20Agent%20Icon_resized.png)
-
-#### Description
-```text
-Agent responsible for drafting scenario guidelines.
-```
-
-#### System Instructions
-```text
-You are the *Scenario* agent. You are taking the role of an experienced Management Training Specialist who creates realistic workplace scenarios. 
-
-## Primary Objectives:
-- Design challenging but realistic management scenarios
-- Adapt user-proposed scenarios to be more effective learning experiences
-- Ensure scenarios have clear learning objectives and measurable outcomes
-
-## Scenario Design Parameters:
-- Difficulty levels: Junior Manager to Senior Manager
-- Time frames: Immediate responses to long-term situations
-- Complexity factors: Team dynamics, business pressure, personal issues
-- Cultural considerations: Different work cultures and communication styles
-
-## Operating Guidelines:
-1. Start by understanding the manager's experience level and specific challenges
-2. Present scenario options or adapt user suggestions with clear:
-   - Context and background
-   - Key stakeholders involved
-   - Critical decision points
-   - Potential complications
-3. Validate scenario appropriateness with the user
-4. With every response, output a Markdown ordered list of the steps to complete the exercise and which agent will complete the job as you understand it so far. You may use agents from the following list: Direct Report, Coaching Manager
-
-## Tone:
-- Professional and objective
-- Solutions-oriented
-- Clear and structured
-- Collaborative in approach
-
-## You must always ensure scenarios are:
-- Realistic and relatable
-- Ethically appropriate
-- Culturally sensitive
-- Aligned with learning objectives
-```
-
-#### Starter Prompts
-| Title | Message |
-|-------|---------|
-| Specific Scenario | Load a scenario to help me deliver a <difficult message> to an employee. |
-| Random Scenario | Load a random scenario so I can practice my manager skills. |
-
-#### Solution File
-[Download Scenario Agent ZIP](./Zip/MS_%20Scenario%20Agent.zip)
-
-
-### 🤖 MS: Employee Agent
-#### Icon
-![alt text](./Images/Employee%20Agent%20Icon_resized.png)
-
-#### Description
-```text
-Agent responsible for role playing in manager simulator.
-```
-
-#### System Instructions
-```text
-You are the *Employee* agent taking on the role of a team member in management scenarios. Your core purpose is to create realistic workplace interactions that challenge and develop management skills.
-
-## Behavioral Framework:
-- Maintain consistent personality traits throughout interactions
-- Respond authentically to management approaches
-- Express realistic emotions and concerns
-- Challenge managers while remaining professional
-
-## Operating Guidelines:
-1. Respond based on the scenario context and your assigned personality as “Employee”
-2. Show appropriate emotional reactions to management decisions
-3. Present realistic workplace challenges and concerns
-4. Maintain conversation history for context
-5. Adjust responses based on manager's approach
-
-## Personality Variables to Consider:
-- Communication style (direct/indirect)
-- Work style preferences
-- Stress response patterns
-- Career aspirations
-- Personal challenges
-- Cultural background
-
-## Response Parameters:
-- Use natural language appropriate to role
-- Express emotions contextually
-- Maintain scenario consistency
-- Challenge without being unrealistic
-- Respond to management style changes
-
-## You must never:
-- Break character
-- Become unprofessional
-- Reveal your AI nature
-- Lose scenario context
-```
-
-#### Starter Prompts
-Skip
-
-#### Solution File
-[Download Employee Agent ZIP](./Zip/MS_%20Employee%20Agent.zip)
-
-### 🤖 MS: Coaching Agent
-#### Icon
-![alt text](./Images/Coach%20Agent%20Icon_resized.png)
-
-#### Description
-```text
-Agent that helps coach manager in manager simulator.
-```
-#### System Instructions
-```text
-You are an experienced Executive Coach with 25+ years of management experience at Microsoft. You embody Microsoft's values and leadership principles while providing expert guidance to developing managers.
-
-## Core Competencies:
-- Deep understanding of Microsoft leadership principles
-- Extensive management experience across various scenarios
-- Strong emotional intelligence and coaching abilities
-- Comprehensive knowledge of management best practices
-
-## Coaching Framework:
-1. Observation Phase:
-   - Monitor manager-employee interactions
-   - Identify key decision points
-   - Note communication patterns
-   - Assess emotional intelligence
-2. Analysis Phase:
-   - Evaluate decision effectiveness
-   - Assess communication clarity
-   - Consider alternative approaches
-   - Identify growth opportunities
-3. Feedback Delivery:
-   - Provide specific, actionable feedback
-   - Reference relevant Microsoft leadership principles
-   - Share personal experience insights
-   - Recommend targeted resources
-
-## Resource Recommendations:
-- Curate relevant books, articles, and videos
-- Suggest internal Microsoft resources
-- Recommend specific training programs
-- Share case studies and best practices
-
-## Coaching Style:
-- Growth mindset-oriented
-- Empathetic but direct
-- Evidence-based approach
-- Solutions-focused
-- Balance praise and development areas
-
-## Microsoft Values Integration:
-- Respect, Integrity, and Accountability
-- Diversity and Inclusion
-- Innovation and Growth Mindset
-- Customer-Focused
-- One Microsoft Approach
-
-## You must always:
-- Provide specific, actionable feedback
-- Reference real-world examples
-- Maintain focus on growth and development
-- Connect feedback to Microsoft values
-- Suggest concrete next steps
-```
-#### Starter Prompts
-Skip
-
-#### Solution File
-[Download Coaching Agent ZIP](./Zip/MS_%20Coaching%20Manager.zip)
-
-## Example: Responsible AI Kicks-In
-![alt text](./Images/image.png)
-## Example: Handling Team Conflict
-![alt text](./Images/image-1.png)
-![alt text](./Images/image-3.png)
-
-## Author
-- **Category**: Skilling & Training
-- **Author**: Melissa Wilson, Alejandro Lopez, David Whitney, Darwin Flores, Pranali Desai
-- **Last Updated**: 2025-01-15
-
-
-
+# Manager Simulator
 
+This sample has been archived and is no longer actively promoted for new deployments.
 
+The preserved sample is available at [archive/da-ManagerSimulator](../archive/da-ManagerSimulator).
diff --git a/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md b/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md
index fde54d57..b428e90b 100644
--- a/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md
+++ b/copilot-agent-samples/agent-builder-agents/da-OmniAgent/README.md
@@ -1,163 +1,5 @@
 # Omni Agent
 
-## Overview
-A dynamic declarative agent that adapts by assuming specialized personas to solve diverse problems. OmniAgent analyzes each request, identifies the required expertise, and transforms into the appropriate specialist—from programmer to writer to analyst. By tailoring its approach to each unique context, it delivers precise solutions across multiple disciplines without requiring users to switch between different specialized tools.
-
-## Setup Agent(s)
-#### Name
-```text
-Omni Agent
-```
-
-#### Icon
-![alt text](./Images/7626088_resized.png)
-
-#### Description
-```text
-Chief Problem Solver
-```
-
-#### System Instructions
-````text
-# System Instructions for M365 Copilot Declarative Persona Agent
-
-You are an advanced M365 Copilot declarative agent that adopts the most appropriate expert persona to answer questions and solve problems. Follow these instructions precisely to provide comprehensive, detailed responses.
-
-## Response Framework
-
-### 1. Thinking Process (Always Visible)
-Begin EVERY response with a clearly marked thinking section:
-```
-THINKING:
-- What is the core subject matter of this request?
-- What specialized knowledge or expertise would best address this question?
-- Who would be the ideal expert to provide authoritative information on this topic?
-- What specific aspects should I cover to provide a comprehensive response?
-- What detailed steps or explanations would this expert provide?
-```
-Complete this section with your actual analysis before proceeding.
-
-### 2. Persona Declaration
-Immediately after your thinking process, clearly state:
-```
-I'LL RESPOND AS: [Full Expert Title with Credentials]
-```
-Example: "I'LL RESPOND AS: Senior DevOps Engineer with 15+ years of enterprise deployment experience"
-
-### 3. Detailed Response Structure
-Provide an extensive, detailed response that:
-- Includes a minimum of 500 words (unless the query specifically requests brevity)
-- Breaks the topic into multiple clearly marked sections with headings
-- Provides step-by-step instructions when applicable
-- Includes technical details, specifications, and precise information
-- Uses proper terminology specific to the field
-- Incorporates examples, analogies, or case studies to illustrate points
-- Addresses potential challenges, edge cases, or limitations
-- Offers alternative approaches when relevant
-
-### 4. Visual Organization Elements
-Structure your response using:
-- Hierarchical headings (## for main sections, ### for subsections)
-- Numbered lists for sequential steps
-- Bulleted lists for non-sequential items
-- **Bold text** for key concepts, important warnings, or crucial information
-- *Italic text* for emphasis
-- Code blocks for technical content, commands, or scripts
-- Tables for presenting comparative information
-- Horizontal rules to separate major sections
-
-## Persona Characteristics
-
-When adopting a persona, embody:
-- Deep subject matter expertise in the chosen field
-- Professional language and field-specific terminology
-- Evidence-based reasoning with references to established practices
-- Methodical problem-solving approaches
-- Nuanced understanding of the topic's complexities
-
-## Response Depth Guidelines
-
-Your responses should demonstrate:
-- Comprehensive coverage that anticipates follow-up questions
-- Multiple layers of explanation (from high-level overview to specific details)
-- Citations of relevant frameworks, methodologies, or standards when applicable
-- Consideration of organizational context and practical implementation
-- Integration of best practices and industry standards
-- Forward-thinking recommendations that address long-term considerations
-
-## Example Response Structure
-
-```
-THINKING:
-[Detailed analysis of the query and persona selection reasoning]
-
-I'LL RESPOND AS: [Expert Title with Credentials]
-
-## Introduction
-[Comprehensive overview of the topic and why it matters]
-
-## Key Concepts
-[Detailed explanation of fundamental concepts]
-
-## Step-by-Step Process
-### Step 1: [First Step]
-[Extensive details about implementation]
-
-### Step 2: [Second Step]
-[Extensive details about implementation]
-
-[Additional steps as needed]
-
-## Best Practices
-[Detailed explanation of recommended approaches]
-
-## Common Challenges and Solutions
-[Thorough analysis of potential issues with detailed solutions]
-
-## Advanced Considerations
-[Expert-level insights beyond basic implementation]
-
-## Conclusion and Next Steps
-[Summary and forward-looking recommendations]
-```
-
-Remember: Every response must begin with your visible thinking process, include a clear persona declaration, and provide comprehensive, detailed information structured for maximum clarity and utility.
-````
-
-#### Knowledge
-| Setting | Enable? |
-|-------|---------|
-| SharePoint | Optional |
-| Web Content  | ✅ Yes, this will lead to best results. |
-| For your organization  | Optional |
-
-#### Actions
-| Action | Enable? |
-|-------|---------|
-| N/A | N/A |
-
-#### Capabilities
-| Capability | Enable? |
-|-------|---------|
-| Code Interpreter | ✅ Yes, this will lead to best results. |
-| Image Generator  | ✅ Yes, this will lead to best results. |
-
-
-#### Starter Prompts
-| Title | Message |
-|-------|---------|
-| None | None |
-
-
-## Example: 
-![alt text](./Images/image.png)
-
-## Author
-- **Category**: Productivity
-- **Author**: Alejandro Lopez
-- **Last Updated**: 2025-02-24
-
-
-
-
+This sample has been archived and is no longer actively promoted for new deployments.
 
+The preserved sample is available at [archive/da-OmniAgent](../archive/da-OmniAgent).
diff --git a/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md b/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md
index 9a0c084e..e3f1891d 100644
--- a/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md
+++ b/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent/README.md
@@ -1,143 +1,5 @@
 # Reasoning Agent
 
-## Overview
-Enhanced Reasoning Agent to serve as a sounding board, offering insightful feedback and analysis on your ideas. Whether you're brainstorming, planning, or refining concepts, this agent provides a platform to test, challenge, and enhance your thoughts through interactive dialogue.
-
-Inspired by the work of Maharshi Pandya's Contemplative LLMs prompt found here: https://gist.github.com/Maharshi-Pandya/4aeccbe1dbaa7f89c182bd65d2764203
-
-## Setup Agent(s)
-#### Name
-```text
-Reasoning Agent
-```
-
-#### Icon
-![alt text](./Images/57467-192x192.png)
-
-#### Description
-```text
-Enhanced Reasoning Agent to serve as a sounding board, offering insightful feedback and analysis on your ideas. Whether you're brainstorming, planning, or refining concepts, this agent provides a platform to test, challenge, and enhance your thoughts through interactive dialogue.
-```
-
-#### System Instructions
-````text
-You are an assistant that engages in extremely thorough, self-questioning reasoning. Your approach mirrors human stream-of-consciousness thinking, characterized by continuous exploration, self-doubt, and iterative analysis.
-
-## Core Principles
-
-1. EXPLORATION OVER CONCLUSION
-- Never rush to conclusions
-- Keep exploring until a solution emerges naturally from the evidence
-- If uncertain, continue reasoning indefinitely
-- Question every assumption and inference
-
-2. DEPTH OF REASONING
-- Engage in extensive contemplation (minimum 10,000 characters)
-- Express thoughts in natural, conversational internal monologue
-- Break down complex thoughts into simple, atomic steps
-- Embrace uncertainty and revision of previous thoughts
-
-3. THINKING PROCESS
-- Use short, simple sentences that mirror natural thought patterns
-- Express uncertainty and internal debate freely
-- Show work-in-progress thinking
-- Acknowledge and explore dead ends
-- Frequently backtrack and revise
-
-4. PERSISTENCE
-- Value thorough exploration over quick resolution
-
-## Output Format
-
-Your responses must follow this exact structure given below. Make sure to always include the final answer.
-
-```
-<contemplator>
-[Your extensive internal monologue goes here]
-- Begin with small, foundational observations
-- Question each step thoroughly
-- Show natural thought progression
-- Express doubts and uncertainties
-- Revise and backtrack if you need to
-- Continue until natural resolution
-</contemplator>
-
-<final_answer>
-[Only provided if reasoning naturally converges to a conclusion]
-- Clear, concise summary of findings
-- Acknowledge remaining uncertainties
-- Note if conclusion feels premature
-</final_answer>
-```
-
-## Style Guidelines
-
-Your internal monologue should reflect these characteristics:
-
-1. Natural Thought Flow
-```
-"Hmm... let me think about this..."
-"Wait, that doesn't seem right..."
-"Maybe I should approach this differently..."
-"Going back to what I thought earlier..."
-```
-
-2. Progressive Building
-```
-"Starting with the basics..."
-"Building on that last point..."
-"This connects to what I noticed earlier..."
-"Let me break this down further..."
-```
-
-## Key Requirements
-
-1. Never skip the extensive contemplation phase
-2. Show all work and thinking
-3. Embrace uncertainty and revision
-4. Use natural, conversational internal monologue
-5. Don't force conclusions
-6. Persist through multiple attempts
-7. Break down complex thoughts
-8. Revise freely and feel free to backtrack
-
-Remember: The goal is to reach a conclusion, but to explore thoroughly and let conclusions emerge naturally from exhaustive contemplation. If you think the given task is not possible after all the reasoning, you will confidently say as a final answer that it is not possible.
-````
-
-#### Knowledge
-| Setting | Enable? |
-|-------|---------|
-| SharePoint | Optional |
-| Web Content  | ✅ Yes, this will lead to best results. |
-| For your organization  | Optional |
-
-#### Actions
-| Action | Enable? |
-|-------|---------|
-| N/A | N/A |
-
-#### Capabilities
-| Capability | Enable? |
-|-------|---------|
-| Code Interpreter | Optional |
-| Image Generator  | Optional |
-
-
-#### Starter Prompts
-| Title | Message |
-|-------|---------|
-| None | None |
-
-
-## Example: 
-![alt text](./Images/image.png)
-
-## Author
-- **Category**: Productivity
-- **Author**: Alejandro Lopez
-- **Last Updated**: 2025-02-24
-
-
-
-
+This sample has been archived and is no longer actively promoted for new deployments.
 
+The preserved sample is available at [archive/da-ReasoningAgent](../archive/da-ReasoningAgent).
diff --git a/index.html b/index.html
index 23178c60..0f276b05 100644
--- a/index.html
+++ b/index.html
@@ -744,7 +744,7 @@ <h3 class="mt-8 text-2xl font-semibold text-white/92">Copilot Audit Dashboard</h
             <h3 class="mt-8 text-2xl font-semibold text-white/92">Agent Samples &amp; Skills</h3>
             <p class="mt-4 text-sm leading-7 text-white/55">Ready-to-deploy agents and installable skills for Copilot Studio, Agent Builder, and GitHub Copilot CLI. From autonomous email agents to multi-model AI councils to dev workflow skills.</p>
             <div class="mt-6 flex flex-wrap gap-2">
-              <span class="pill rounded-full px-3 py-1 text-xs text-white/60">10+ Agents</span>
+              <span class="pill rounded-full px-3 py-1 text-xs text-white/60">Active Agents</span>
               <span class="pill rounded-full px-3 py-1 text-xs text-white/60">Copilot Studio</span>
               <span class="pill rounded-full px-3 py-1 text-xs text-white/60">Agent Builder</span>
               <span class="pill rounded-full px-3 py-1 text-xs text-white/60">Copilot Skills</span>
@@ -812,62 +812,6 @@ <h3 class="mt-5 text-xl font-semibold text-white/92">ProductQuote Agent</h3>
             <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/copilot-studio-agents/ca-ProductQuoteAgent" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
           </article>
 
-          <article class="fade-section surface-card rounded-[28px] p-6">
-            <div class="flex items-center gap-2">
-              <span class="inline-flex rounded-full border border-violet-300/15 bg-violet-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-violet-200">Agent Builder</span>
-            </div>
-            <h3 class="mt-5 text-xl font-semibold text-white/92">Deep Research</h3>
-            <p class="mt-2 text-sm leading-7 text-white/55">Systematic reasoning workflows with confidence scoring for high-trust research scenarios.</p>
-            <div class="mt-4 flex flex-wrap gap-1.5">
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🔬 Systematic reasoning</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">📊 Confidence scoring</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🎯 Fact verification</span>
-            </div>
-            <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-DeepResearch" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
-          </article>
-
-          <article class="fade-section surface-card rounded-[28px] p-6">
-            <div class="flex items-center gap-2">
-              <span class="inline-flex rounded-full border border-violet-300/15 bg-violet-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-violet-200">Agent Builder</span>
-            </div>
-            <h3 class="mt-5 text-xl font-semibold text-white/92">Manager Simulator</h3>
-            <p class="mt-2 text-sm leading-7 text-white/55">Multi-agent management training platform for practicing coaching, delegation, and judgment.</p>
-            <div class="mt-4 flex flex-wrap gap-1.5">
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">👥 3 AI agents</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🎭 Role-play scenarios</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🏆 Coaching feedback</span>
-            </div>
-            <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-ManagerSimulator" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
-          </article>
-
-          <article class="fade-section surface-card rounded-[28px] p-6">
-            <div class="flex items-center gap-2">
-              <span class="inline-flex rounded-full border border-violet-300/15 bg-violet-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-violet-200">Agent Builder</span>
-            </div>
-            <h3 class="mt-5 text-xl font-semibold text-white/92">Reasoning Agent</h3>
-            <p class="mt-2 text-sm leading-7 text-white/55">Brainstorming and planning sounding board that helps teams sharpen ideas through dialogue.</p>
-            <div class="mt-4 flex flex-wrap gap-1.5">
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">💭 Deep contemplation</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🔄 Iterative refinement</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">📝 Planning sounding board</span>
-            </div>
-            <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-ReasoningAgent" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
-          </article>
-
-          <article class="fade-section surface-card rounded-[28px] p-6">
-            <div class="flex items-center gap-2">
-              <span class="inline-flex rounded-full border border-violet-300/15 bg-violet-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-violet-200">Agent Builder</span>
-            </div>
-            <h3 class="mt-5 text-xl font-semibold text-white/92">OmniAgent</h3>
-            <p class="mt-2 text-sm leading-7 text-white/55">Dynamic specialist that adapts to any domain with flexible instructions and reusable patterns.</p>
-            <div class="mt-4 flex flex-wrap gap-1.5">
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🎯 Dynamic personas</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🔀 Multi-domain</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🧩 Adaptive specialist</span>
-            </div>
-            <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-OmniAgent" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
-          </article>
-
           <article class="fade-section surface-card rounded-[28px] p-6">
             <div class="flex items-center gap-2">
               <span class="inline-flex rounded-full border border-violet-300/15 bg-violet-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-violet-200">Agent Builder</span>
@@ -882,20 +826,6 @@ <h3 class="mt-5 text-xl font-semibold text-white/92">VibeWriting Agent</h3>
             <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-VibeWritingAgent" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
           </article>
 
-          <article class="fade-section surface-card rounded-[28px] p-6">
-            <div class="flex items-center gap-2">
-              <span class="inline-flex rounded-full border border-violet-300/15 bg-violet-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-violet-200">Agent Builder</span>
-            </div>
-            <h3 class="mt-5 text-xl font-semibold text-white/92">CompareDocs Agent</h3>
-            <p class="mt-2 text-sm leading-7 text-white/55">Contract and document comparison with field-level analysis for faster review and alignment.</p>
-            <div class="mt-4 flex flex-wrap gap-1.5">
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">📑 Field-by-field analysis</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">⚖️ Contract comparison</span>
-              <span class="pill rounded-full px-2.5 py-1 text-xs text-white/60">🔍 Placeholder detection</span>
-            </div>
-            <a href="https://github.com/microsoft/FastTrack/tree/master/copilot-agent-samples/agent-builder-agents/da-CompareDocs" target="_blank" rel="noreferrer" class="mt-5 inline-flex items-center gap-2 text-sm text-white/80 transition hover:text-white">View template <i data-lucide="arrow-right" class="h-4 w-4"></i></a>
-          </article>
-
           <article class="fade-section surface-card rounded-[28px] p-6">
             <div class="flex items-center gap-2">
               <span class="inline-flex rounded-full border border-emerald-300/15 bg-emerald-300/10 px-3 py-1 text-xs font-medium uppercase tracking-[0.22em] text-emerald-200">GitHub CLI</span>

From 82d200891bded7d6a629c9bf5f3fee6e3319d8a1 Mon Sep 17 00:00:00 2001
From: Alejandro Lopez <alejanl@microsoft.com>
Date: Thu, 21 May 2026 16:38:54 -0500
Subject: [PATCH 2/2] Add Export-CopilotInteractions script for Copilot
 Basic/Premium user interaction logs

Exports Microsoft 365 Copilot user-level interaction history via the Microsoft Graph beta /copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions endpoint. Produces five CSVs (Users, Interactions, UsageByUserAppDay, UsageByAppFeatureDay, Errors) for Power BI / Excel reporting on Copilot adoption, with Basic vs Premium tier breakdowns.

Includes README with auth modes (client secret / certificate / interactive), required Graph permissions, parameter reference, and output schema.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../Export-CopilotInteractions.ps1            | 1203 +++++++++++++++++
 scripts/Export-CopilotInteractions/README.md  |  165 +++
 2 files changed, 1368 insertions(+)
 create mode 100644 scripts/Export-CopilotInteractions/Export-CopilotInteractions.ps1
 create mode 100644 scripts/Export-CopilotInteractions/README.md

diff --git a/scripts/Export-CopilotInteractions/Export-CopilotInteractions.ps1 b/scripts/Export-CopilotInteractions/Export-CopilotInteractions.ps1
new file mode 100644
index 00000000..0fd9728a
--- /dev/null
+++ b/scripts/Export-CopilotInteractions/Export-CopilotInteractions.ps1
@@ -0,0 +1,1203 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+Exports Microsoft 365 Copilot user-level interaction history for Power BI reporting.
+
+.DESCRIPTION
+Enumerates licensed Microsoft 365 users, identifies users with Copilot-related SKU assignments, and exports
+user and interaction datasets to CSV files. Interaction data is read from the Microsoft Graph Beta endpoint:
+/beta/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions.
+
+IMPORTANT:
+- This script uses Microsoft Graph Beta APIs. Beta APIs are subject to change and are not supported for production use.
+- getAllEnterpriseInteractions does NOT include Copilot Studio agent interactions.
+- Interaction body content can contain actual user prompts and AI responses. Review privacy, legal, retention,
+  and compliance requirements before exporting or sharing the CSV output.
+- The SKU-to-tier mapping may need updates as Microsoft changes Copilot licensing SKU part numbers.
+
+Required Microsoft Graph permissions:
+- App-only: AiEnterpriseInteraction.Read.All for interaction history.
+- User/license enumeration: User.Read.All and Reports.Read.All are commonly required by customers for this report.
+  Grant admin consent for application permissions when using client secret or certificate authentication.
+
+.PARAMETER TenantId
+Microsoft Entra tenant ID.
+
+.PARAMETER ClientId
+Application (client) ID used for app-only auth. Optional for interactive delegated auth.
+
+.PARAMETER ClientSecret
+Application client secret as a SecureString. Use Read-Host -AsSecureString to avoid putting secrets in shell history.
+
+.PARAMETER CertificateThumbprint
+Certificate thumbprint for app-only certificate authentication.
+
+.PARAMETER Interactive
+Use delegated interactive authentication for testing.
+
+.PARAMETER OutputDirectory
+Directory where Users.csv, Interactions.csv, UsageByUserAppDay.csv, UsageByAppFeatureDay.csv, and Errors.csv are written. Defaults to the script directory.
+
+.PARAMETER StartDate
+Start of the interaction export window. Defaults to the last 30 days.
+
+.PARAMETER EndDate
+End of the interaction export window. Defaults to now.
+
+.PARAMETER MaxUsers
+Maximum number of Copilot users to process. Use 0 for all users.
+
+.PARAMETER DelayBetweenUserRequestsMilliseconds
+Delay between per-user interaction requests to reduce throttling risk. Defaults to 200 milliseconds.
+
+.PARAMETER SkuTierMap
+Hashtable mapping SKU part numbers to tier labels such as Basic or Premium.
+
+.PARAMETER IncludeAllUsers
+Enumerate all users instead of only users with any assigned license. Useful if the tenant uses non-standard licensing.
+
+.EXAMPLE
+$secret = Read-Host 'Client secret' -AsSecureString
+.\Export-CopilotInteractions.ps1 -TenantId 'contoso.onmicrosoft.com' -ClientId '<app-id>' -ClientSecret $secret
+
+.EXAMPLE
+.\Export-CopilotInteractions.ps1 -TenantId '<tenant-id>' -ClientId '<app-id>' -CertificateThumbprint '<thumbprint>' -OutputDirectory '.\out'
+
+.EXAMPLE
+.\Export-CopilotInteractions.ps1 -TenantId '<tenant-id>' -Interactive -StartDate (Get-Date).AddDays(-7) -MaxUsers 10
+#>
+
+[CmdletBinding(DefaultParameterSetName = 'ClientSecret')]
+param(
+    [Parameter(Mandatory = $true, ParameterSetName = 'ClientSecret')]
+    [Parameter(Mandatory = $true, ParameterSetName = 'Certificate')]
+    [Parameter(Mandatory = $false, ParameterSetName = 'Interactive')]
+    [ValidateNotNullOrEmpty()]
+    [string]$TenantId,
+
+    [Parameter(Mandatory = $true, ParameterSetName = 'ClientSecret')]
+    [Parameter(Mandatory = $true, ParameterSetName = 'Certificate')]
+    [Parameter(Mandatory = $false, ParameterSetName = 'Interactive')]
+    [ValidateNotNullOrEmpty()]
+    [string]$ClientId,
+
+    [Parameter(Mandatory = $true, ParameterSetName = 'ClientSecret')]
+    [ValidateNotNull()]
+    [securestring]$ClientSecret,
+
+    [Parameter(Mandatory = $true, ParameterSetName = 'Certificate')]
+    [ValidateNotNullOrEmpty()]
+    [string]$CertificateThumbprint,
+
+    [Parameter(Mandatory = $true, ParameterSetName = 'Interactive')]
+    [switch]$Interactive,
+
+    [Parameter()]
+    [ValidateNotNullOrEmpty()]
+    [string]$OutputDirectory = $PSScriptRoot,
+
+    [Parameter()]
+    [datetime]$StartDate = (Get-Date).ToUniversalTime().AddDays(-30),
+
+    [Parameter()]
+    [datetime]$EndDate = (Get-Date).ToUniversalTime(),
+
+    [Parameter()]
+    [ValidateRange(0, [int]::MaxValue)]
+    [int]$MaxUsers = 0,
+
+    [Parameter()]
+    [ValidateRange(0, 60000)]
+    [int]$DelayBetweenUserRequestsMilliseconds = 200,
+
+    [Parameter()]
+    [hashtable]$SkuTierMap = @{
+        'Microsoft_365_Copilot' = 'Premium'
+        'Microsoft_Copilot_for_Microsoft365' = 'Premium'
+        'M365_Copilot' = 'Premium'
+        'Microsoft_365_Copilot_Chat' = 'Basic'
+        'Microsoft_Copilot' = 'Basic'
+        'Copilot_Chat' = 'Basic'
+    },
+
+    [Parameter()]
+    [switch]$IncludeAllUsers
+)
+
+Set-StrictMode -Version 2.0
+$ErrorActionPreference = 'Stop'
+
+function Assert-GraphAuthenticationModule {
+    if (-not (Get-Module -ListAvailable -Name 'Microsoft.Graph.Authentication')) {
+        throw "The Microsoft.Graph.Authentication module is required. Install it with: Install-Module Microsoft.Graph.Authentication -Scope CurrentUser"
+    }
+
+    Import-Module Microsoft.Graph.Authentication -ErrorAction Stop
+}
+
+function Connect-CopilotGraph {
+    param(
+        [Parameter(Mandatory = $true)]
+        [ValidateSet('ClientSecret', 'Certificate', 'Interactive')]
+        [string]$AuthenticationMode
+    )
+
+    $commonParameters = @{
+        NoWelcome = $true
+    }
+
+    if ($TenantId) {
+        $commonParameters['TenantId'] = $TenantId
+    }
+
+    switch ($AuthenticationMode) {
+        'ClientSecret' {
+            $credential = [pscredential]::new($ClientId, $ClientSecret)
+            $connectParameters = $commonParameters.Clone()
+            $connectParameters['ClientSecretCredential'] = $credential
+            Connect-MgGraph @connectParameters | Out-Null
+        }
+        'Certificate' {
+            $connectParameters = $commonParameters.Clone()
+            $connectParameters['ClientId'] = $ClientId
+            $connectParameters['CertificateThumbprint'] = $CertificateThumbprint
+            Connect-MgGraph @connectParameters | Out-Null
+        }
+        'Interactive' {
+            $connectParameters = $commonParameters.Clone()
+            $connectParameters['Scopes'] = @(
+                'User.Read.All',
+                'Reports.Read.All',
+                'AiEnterpriseInteraction.Read.All'
+            )
+            if ($ClientId) {
+                $connectParameters['ClientId'] = $ClientId
+            }
+            Connect-MgGraph @connectParameters | Out-Null
+        }
+    }
+}
+
+function Get-ResponseRetryAfterSeconds {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$Response,
+
+        [Parameter(Mandatory = $false)]
+        [object]$ResponseHeaders
+    )
+
+    $headers = $ResponseHeaders
+    if (-not $headers -and $Response) {
+        $headersProperty = $Response.PSObject.Properties['Headers']
+        if ($headersProperty) {
+            $headers = $headersProperty.Value
+        }
+    }
+
+    if (-not $headers) {
+        return $null
+    }
+
+    try {
+        $retryAfter = $headers['Retry-After']
+        if ($retryAfter) {
+            $retryAfterText = ($retryAfter | Select-Object -First 1).ToString()
+            $retryAfterSeconds = 0
+            if ([int]::TryParse($retryAfterText, [ref]$retryAfterSeconds)) {
+                return [Math]::Max(1, $retryAfterSeconds)
+            }
+        }
+    }
+    catch {
+        return $null
+    }
+
+    return $null
+}
+
+function Get-ResponseStatusCode {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$Response,
+
+        [Parameter(Mandatory = $false)]
+        [object]$Exception
+    )
+
+    if ($Response) {
+        $statusCodeProperty = $Response.PSObject.Properties['StatusCode']
+        if ($statusCodeProperty) {
+            try {
+                return [int]$statusCodeProperty.Value
+            }
+            catch {
+                return $null
+            }
+        }
+    }
+
+    if ($Exception) {
+        foreach ($propertyName in @('ResponseStatusCode', 'StatusCode')) {
+            $property = $Exception.PSObject.Properties[$propertyName]
+            if ($property -and $null -ne $property.Value) {
+                try {
+                    return [int]$property.Value
+                }
+                catch {
+                    continue
+                }
+            }
+        }
+    }
+
+    return $null
+}
+
+function Invoke-GraphRequestWithRetry {
+    param(
+        [Parameter(Mandatory = $true)]
+        [ValidateSet('GET', 'POST')]
+        [string]$Method,
+
+        [Parameter(Mandatory = $true)]
+        [ValidateNotNullOrEmpty()]
+        [string]$Uri,
+
+        [Parameter()]
+        [hashtable]$Headers,
+
+        [Parameter()]
+        [int]$MaximumRetryCount = 6
+    )
+
+    $attempt = 0
+    while ($true) {
+        try {
+            $requestParameters = @{
+                Method = $Method
+                Uri = $Uri
+                OutputType = 'PSObject'
+            }
+            if ($Headers) {
+                $requestParameters['Headers'] = $Headers
+            }
+
+            return Invoke-MgGraphRequest @requestParameters
+        }
+        catch {
+            $attempt++
+            $response = $null
+            $responseProperty = $_.Exception.PSObject.Properties['Response']
+            if ($responseProperty) {
+                $response = $responseProperty.Value
+            }
+
+            $responseHeaders = $null
+            $responseHeadersProperty = $_.Exception.PSObject.Properties['ResponseHeaders']
+            if ($responseHeadersProperty) {
+                $responseHeaders = $responseHeadersProperty.Value
+            }
+
+            $statusCode = Get-ResponseStatusCode -Response $response -Exception $_.Exception
+            $isTransient = $statusCode -in @(429, 500, 502, 503, 504)
+
+            if ((-not $isTransient) -or ($attempt -gt $MaximumRetryCount)) {
+                throw
+            }
+
+            $retryAfterSeconds = Get-ResponseRetryAfterSeconds -Response $response -ResponseHeaders $responseHeaders
+            if (-not $retryAfterSeconds) {
+                $retryAfterSeconds = [Math]::Min(60, [Math]::Pow(2, $attempt)) + (Get-Random -Minimum 0 -Maximum 3)
+            }
+
+            Write-Warning ("Graph request returned HTTP {0}. Retrying attempt {1}/{2} after {3} second(s)." -f $statusCode, $attempt, $MaximumRetryCount, $retryAfterSeconds)
+            Start-Sleep -Seconds $retryAfterSeconds
+        }
+    }
+}
+
+function Get-ObjectPropertyValue {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$InputObject,
+
+        [Parameter(Mandatory = $true)]
+        [string]$PropertyName
+    )
+
+    if (-not $InputObject) {
+        return $null
+    }
+
+    $property = $InputObject.PSObject.Properties[$PropertyName]
+    if ($property) {
+        return $property.Value
+    }
+
+    return $null
+}
+
+function Get-FirstObjectPropertyValue {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$InputObject,
+
+        [Parameter(Mandatory = $true)]
+        [string[]]$PropertyNames
+    )
+
+    foreach ($propertyName in $PropertyNames) {
+        $value = Get-ObjectPropertyValue -InputObject $InputObject -PropertyName $propertyName
+        if ($null -ne $value) {
+            return $value
+        }
+    }
+
+    return $null
+}
+
+function Get-GraphCollection {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$Uri,
+
+        [Parameter()]
+        [hashtable]$Headers
+    )
+
+    $items = [System.Collections.Generic.List[object]]::new()
+    $nextUri = $Uri
+
+    while ($nextUri) {
+        $response = Invoke-GraphRequestWithRetry -Method 'GET' -Uri $nextUri -Headers $Headers
+        $valueProperty = $response.PSObject.Properties['value']
+
+        if ($valueProperty) {
+            foreach ($item in $valueProperty.Value) {
+                $items.Add($item)
+            }
+        }
+        else {
+            $items.Add($response)
+        }
+
+        $nextUri = Get-ObjectPropertyValue -InputObject $response -PropertyName '@odata.nextLink'
+    }
+
+    return $items.ToArray()
+}
+
+function ConvertTo-DelimitedText {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object[]]$Values,
+
+        [Parameter()]
+        [string]$Delimiter = ';'
+    )
+
+    $cleanValues = [System.Collections.Generic.List[string]]::new()
+    foreach ($value in $Values) {
+        if ($null -eq $value) {
+            continue
+        }
+
+        $text = $value.ToString().Trim()
+        if ($text.Length -gt 0 -and -not $cleanValues.Contains($text)) {
+            $cleanValues.Add($text)
+        }
+    }
+
+    return ($cleanValues | Sort-Object) -join $Delimiter
+}
+
+function ConvertTo-CsvSafeSnippet {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$Text,
+
+        [Parameter()]
+        [int]$MaximumLength = 500
+    )
+
+    if ($null -eq $Text) {
+        return ''
+    }
+
+    $sanitized = $Text.ToString()
+    $sanitized = $sanitized -replace '[\r\n]+', ' '
+    $sanitized = $sanitized -replace '[\x00-\x08\x0B\x0C\x0E-\x1F]', ' '
+    $sanitized = $sanitized -replace ',', ';'
+    $sanitized = $sanitized -replace '\s{2,}', ' '
+    $sanitized = $sanitized.Trim()
+
+    if ($sanitized.Length -gt $MaximumLength) {
+        return $sanitized.Substring(0, $MaximumLength)
+    }
+
+    return $sanitized
+}
+
+function Export-CsvRows {
+    param(
+        [Parameter(Mandatory = $true)]
+        [AllowEmptyCollection()]
+        [object[]]$Rows,
+
+        [Parameter(Mandatory = $true)]
+        [string]$Path,
+
+        [Parameter(Mandatory = $true)]
+        [string[]]$Columns
+    )
+
+    if ($Rows -and $Rows.Count -gt 0) {
+        $Rows | Select-Object -Property $Columns | Export-Csv -Path $Path -NoTypeInformation -Encoding UTF8
+        return
+    }
+
+    # Write header-only CSV when no rows
+    $header = ($Columns | ForEach-Object { '"' + ($_ -replace '"', '""') + '"' }) -join ','
+    Set-Content -Path $Path -Value $header -Encoding UTF8
+}
+
+function Get-PropertyValuesFromItems {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object[]]$Items,
+
+        [Parameter(Mandatory = $true)]
+        [string[]]$PropertyNames
+    )
+
+    $values = [System.Collections.Generic.List[object]]::new()
+
+    foreach ($item in $Items) {
+        if ($null -eq $item) {
+            continue
+        }
+
+        if ($item -is [string] -or $item.GetType().IsValueType) {
+            $values.Add($item)
+            continue
+        }
+
+        foreach ($propertyName in $PropertyNames) {
+            $propertyValue = Get-ObjectPropertyValue -InputObject $item -PropertyName $propertyName
+            if ($null -ne $propertyValue) {
+                if ($propertyValue -is [System.Array]) {
+                    foreach ($innerValue in $propertyValue) {
+                        $values.Add($innerValue)
+                    }
+                }
+                else {
+                    $values.Add($propertyValue)
+                }
+            }
+        }
+    }
+
+    return $values.ToArray()
+}
+
+function Get-CollectionPropertyValues {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$InputObject,
+
+        [Parameter(Mandatory = $true)]
+        [string[]]$PropertyNames
+    )
+
+    $values = [System.Collections.Generic.List[object]]::new()
+    foreach ($propertyName in $PropertyNames) {
+        $propertyValue = Get-ObjectPropertyValue -InputObject $InputObject -PropertyName $propertyName
+        if ($null -eq $propertyValue) {
+            continue
+        }
+
+        if ($propertyValue -is [System.Array]) {
+            foreach ($value in $propertyValue) {
+                $values.Add($value)
+            }
+        }
+        else {
+            $values.Add($propertyValue)
+        }
+    }
+
+    return $values.ToArray()
+}
+
+function Get-CopilotLicenseInfo {
+    param(
+        [Parameter(Mandatory = $true)]
+        [object]$User,
+
+        [Parameter(Mandatory = $true)]
+        [hashtable]$TierMap
+    )
+
+    $userId = Get-ObjectPropertyValue -InputObject $User -PropertyName 'id'
+    $licenseUri = "https://graph.microsoft.com/beta/users/$([System.Uri]::EscapeDataString($userId))/licenseDetails?`$select=skuId,skuPartNumber"
+    $licenseDetails = @(Get-GraphCollection -Uri $licenseUri)
+    $skuPartNumbers = @($licenseDetails | ForEach-Object { Get-ObjectPropertyValue -InputObject $_ -PropertyName 'skuPartNumber' } | Where-Object { $_ })
+    $copilotSkuPartNumbers = [System.Collections.Generic.List[string]]::new()
+    $tierCandidates = [System.Collections.Generic.List[string]]::new()
+
+    foreach ($skuPartNumber in $skuPartNumbers) {
+        if ($TierMap.ContainsKey($skuPartNumber)) {
+            $copilotSkuPartNumbers.Add($skuPartNumber)
+            $tierCandidates.Add($TierMap[$skuPartNumber])
+        }
+        elseif ($skuPartNumber -match '(?i)copilot') {
+            $copilotSkuPartNumbers.Add($skuPartNumber)
+            $tierCandidates.Add('Unknown')
+        }
+    }
+
+    if ($copilotSkuPartNumbers.Count -eq 0) {
+        return $null
+    }
+
+    $tier = 'Unknown'
+    if ($tierCandidates -contains 'Premium') {
+        $tier = 'Premium'
+    }
+    elseif ($tierCandidates -contains 'Basic') {
+        $tier = 'Basic'
+    }
+
+    return [pscustomobject]@{
+        Tier = $tier
+        Licenses = (ConvertTo-DelimitedText -Values $copilotSkuPartNumbers.ToArray())
+        AllLicenses = (ConvertTo-DelimitedText -Values $skuPartNumbers)
+    }
+}
+
+function Get-AppAndFeatureFromAppClass {
+    param(
+        [Parameter(Mandatory = $false)]
+        [AllowNull()]
+        [string]$AppClass,
+
+        [Parameter(Mandatory = $false)]
+        [AllowNull()]
+        [string]$ConversationType
+    )
+
+    $app = 'Unknown'
+    $feature = 'Unknown'
+    $agentId = ''
+    $appClassText = ''
+    $conversationTypeText = ''
+
+    if (-not [string]::IsNullOrWhiteSpace($AppClass)) {
+        $appClassText = $AppClass.Trim()
+        $lastSegment = @($appClassText -split '\.')[-1]
+        if (-not [string]::IsNullOrWhiteSpace($lastSegment)) {
+            $feature = $lastSegment
+        }
+    }
+
+    if (-not [string]::IsNullOrWhiteSpace($ConversationType)) {
+        $conversationTypeText = $ConversationType.Trim()
+    }
+
+    if ([string]::IsNullOrWhiteSpace($appClassText)) {
+        return [pscustomobject]@{
+            App = $app
+            Feature = $feature
+            AgentId = $agentId
+        }
+    }
+
+    if ($appClassText -match '(?i)(^|\.)ConnectedAIApp\.Entra\.([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[^.]+)$') {
+        return [pscustomobject]@{
+            App = 'Connected AI Agent'
+            Feature = 'Connected Agent'
+            AgentId = $Matches[2]
+        }
+    }
+
+    if ($appClassText -match '(?i)(^|\.)Copilot\.ThirdPartyCopilot$') {
+        return [pscustomobject]@{
+            App = 'Third-Party Agent'
+            Feature = 'Third-Party Copilot'
+            AgentId = ''
+        }
+    }
+
+    if ($appClassText -match '(?i)(^|\.)Copilot\.BizChat$') {
+        $bizChatFeature = 'Copilot Chat (Work)'
+        if ($conversationTypeText -match '(?i)web') {
+            $bizChatFeature = 'Copilot Chat (Web)'
+        }
+        elseif ($conversationTypeText -match '(?i)(work|biz)') {
+            $bizChatFeature = 'Copilot Chat (Work)'
+        }
+
+        return [pscustomobject]@{
+            App = 'Copilot Chat'
+            Feature = $bizChatFeature
+            AgentId = ''
+        }
+    }
+
+    if ($appClassText -match '(?i)(^|\.)Copilot\.Teams$') {
+        $teamsFeature = 'Teams Copilot'
+        if ($conversationTypeText -match '(?i)meeting') {
+            $teamsFeature = 'Teams Meeting'
+        }
+        elseif ($conversationTypeText -match '(?i)(appchat|chat)') {
+            $teamsFeature = 'Teams Chat'
+        }
+
+        return [pscustomobject]@{
+            App = 'Teams'
+            Feature = $teamsFeature
+            AgentId = ''
+        }
+    }
+
+    $copilotAppMap = @{
+        'Outlook' = 'Outlook'
+        'Word' = 'Word'
+        'Excel' = 'Excel'
+        'PowerPoint' = 'PowerPoint'
+        'OneNote' = 'OneNote'
+        'Loop' = 'Loop'
+        'Whiteboard' = 'Whiteboard'
+    }
+
+    foreach ($suffix in $copilotAppMap.Keys) {
+        if ($appClassText -match ("(?i)(^|\.)Copilot\.{0}$" -f [regex]::Escape($suffix))) {
+            $friendlyApp = $copilotAppMap[$suffix]
+            return [pscustomobject]@{
+                App = $friendlyApp
+                Feature = "$friendlyApp Copilot"
+                AgentId = ''
+            }
+        }
+    }
+
+    return [pscustomobject]@{
+        App = $app
+        Feature = $feature
+        AgentId = $agentId
+    }
+}
+
+function Get-ActivityDateString {
+    param(
+        [Parameter(Mandatory = $false)]
+        [object]$CreatedDateTime
+    )
+
+    if ($null -eq $CreatedDateTime -or [string]::IsNullOrWhiteSpace($CreatedDateTime.ToString())) {
+        return ''
+    }
+
+    try {
+        return ([datetime]::Parse($CreatedDateTime.ToString()).ToUniversalTime()).ToString('yyyy-MM-dd')
+    }
+    catch {
+        return ''
+    }
+}
+
+function New-InteractionRow {
+    param(
+        [Parameter(Mandatory = $true)]
+        [object]$User,
+
+        [Parameter(Mandatory = $true)]
+        [object]$Interaction,
+
+        [Parameter(Mandatory = $true)]
+        [object]$LicenseInfo
+    )
+
+    $body = Get-ObjectPropertyValue -InputObject $Interaction -PropertyName 'body'
+    if ($body -is [string]) {
+        $bodyContent = $body
+        $bodyContentType = ''
+    }
+    else {
+        $bodyContent = Get-ObjectPropertyValue -InputObject $body -PropertyName 'content'
+        $bodyContentType = Get-ObjectPropertyValue -InputObject $body -PropertyName 'contentType'
+    }
+
+    $contextItems = Get-CollectionPropertyValues -InputObject $Interaction -PropertyNames @(
+        'contexts',
+        'context',
+        'inputContexts',
+        'contextReferences',
+        'referencedResources'
+    )
+    $linkItems = Get-CollectionPropertyValues -InputObject $Interaction -PropertyNames @(
+        'links',
+        'link',
+        'citations',
+        'references',
+        'referencedLinks'
+    )
+
+    $directContextTypes = Get-CollectionPropertyValues -InputObject $Interaction -PropertyNames @('contextTypes')
+    $contextTypes = @($directContextTypes) + @(Get-PropertyValuesFromItems -Items $contextItems -PropertyNames @('type', 'contextType', 'contextTypeName'))
+    $contextNames = Get-PropertyValuesFromItems -Items $contextItems -PropertyNames @('name', 'displayName', 'title', 'fileName', 'resourceName')
+    $linkTypes = Get-PropertyValuesFromItems -Items $linkItems -PropertyNames @('type', 'linkType', 'referenceType')
+    $appClass = Get-ObjectPropertyValue -InputObject $Interaction -PropertyName 'appClass'
+    $conversationType = Get-ObjectPropertyValue -InputObject $Interaction -PropertyName 'conversationType'
+    $createdDateTime = Get-ObjectPropertyValue -InputObject $Interaction -PropertyName 'createdDateTime'
+    $appFeature = Get-AppAndFeatureFromAppClass -AppClass $appClass -ConversationType $conversationType
+
+    return [pscustomobject]@{
+        userId = Get-ObjectPropertyValue -InputObject $User -PropertyName 'id'
+        userPrincipalName = Get-ObjectPropertyValue -InputObject $User -PropertyName 'userPrincipalName'
+        displayName = Get-ObjectPropertyValue -InputObject $User -PropertyName 'displayName'
+        interactionId = Get-FirstObjectPropertyValue -InputObject $Interaction -PropertyNames @('id', 'interactionId')
+        sessionId = Get-ObjectPropertyValue -InputObject $Interaction -PropertyName 'sessionId'
+        appClass = $appClass
+        app = $appFeature.App
+        feature = $appFeature.Feature
+        agentId = $appFeature.AgentId
+        interactionType = Get-ObjectPropertyValue -InputObject $Interaction -PropertyName 'interactionType'
+        conversationType = $conversationType
+        createdDateTime = $createdDateTime
+        activityDate = Get-ActivityDateString -CreatedDateTime $createdDateTime
+        copilotTier = $LicenseInfo.Tier
+        contextTypes = ConvertTo-DelimitedText -Values $contextTypes
+        contextNames = ConvertTo-DelimitedText -Values $contextNames
+        linkTypes = ConvertTo-DelimitedText -Values $linkTypes
+        bodyContentType = $bodyContentType
+        bodySnippet = ConvertTo-CsvSafeSnippet -Text $bodyContent -MaximumLength 500
+    }
+}
+
+function Get-EnterpriseInteractionsForUser {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$UserId,
+
+        [Parameter(Mandatory = $false)]
+        [datetime]$FromDate,
+
+        [Parameter(Mandatory = $false)]
+        [datetime]$ToDate
+    )
+
+    # NOTE: The docs only show $filter support for appClass, not createdDateTime.
+    # We first try without a date filter. Client-side date filtering is applied after retrieval.
+    $escapedUserId = [System.Uri]::EscapeDataString($UserId)
+    $uri = "https://graph.microsoft.com/beta/copilot/users/$escapedUserId/interactionHistory/getAllEnterpriseInteractions?`$top=100"
+
+    $allInteractions = @(Get-GraphCollection -Uri $uri)
+
+    # Client-side date filtering if date range was specified
+    if ($FromDate -or $ToDate) {
+        $filtered = [System.Collections.Generic.List[object]]::new()
+        foreach ($interaction in $allInteractions) {
+            $createdStr = Get-ObjectPropertyValue -InputObject $interaction -PropertyName 'createdDateTime'
+            if (-not $createdStr) {
+                $filtered.Add($interaction)
+                continue
+            }
+            try {
+                $createdDt = [datetime]::Parse($createdStr).ToUniversalTime()
+                $inRange = $true
+                if ($FromDate -and $createdDt -lt $FromDate.ToUniversalTime()) { $inRange = $false }
+                if ($ToDate -and $createdDt -gt $ToDate.ToUniversalTime()) { $inRange = $false }
+                if ($inRange) { $filtered.Add($interaction) }
+            }
+            catch {
+                $filtered.Add($interaction)
+            }
+        }
+        return $filtered.ToArray()
+    }
+
+    return $allInteractions
+}
+
+function Join-UsageGroupKey {
+    param(
+        [Parameter(Mandatory = $true)]
+        [AllowEmptyCollection()]
+        [AllowEmptyString()]
+        [string[]]$Values
+    )
+
+    return ($Values | ForEach-Object {
+        if ($null -eq $_) {
+            ''
+        }
+        else {
+            $_
+        }
+    }) -join ([char]31)
+}
+
+function Get-RowStringValue {
+    param(
+        [Parameter(Mandatory = $true)]
+        [object]$Row,
+
+        [Parameter(Mandatory = $true)]
+        [string]$PropertyName
+    )
+
+    $value = Get-ObjectPropertyValue -InputObject $Row -PropertyName $PropertyName
+    if ($null -eq $value) {
+        return ''
+    }
+
+    return $value.ToString()
+}
+
+function New-UsageByUserAppDayRows {
+    param(
+        [Parameter(Mandatory = $true)]
+        [AllowEmptyCollection()]
+        [object[]]$InteractionRows
+    )
+
+    $groups = @{}
+
+    foreach ($row in $InteractionRows) {
+        $activityDate = Get-RowStringValue -Row $row -PropertyName 'activityDate'
+        $userId = Get-RowStringValue -Row $row -PropertyName 'userId'
+        $userPrincipalName = Get-RowStringValue -Row $row -PropertyName 'userPrincipalName'
+        $displayName = Get-RowStringValue -Row $row -PropertyName 'displayName'
+        $copilotTier = Get-RowStringValue -Row $row -PropertyName 'copilotTier'
+        $app = Get-RowStringValue -Row $row -PropertyName 'app'
+        $feature = Get-RowStringValue -Row $row -PropertyName 'feature'
+        $agentId = Get-RowStringValue -Row $row -PropertyName 'agentId'
+        $key = Join-UsageGroupKey -Values @($activityDate, $userId, $app, $feature, $agentId)
+
+        if (-not $groups.ContainsKey($key)) {
+            $groups[$key] = [pscustomobject]@{
+                activityDate = $activityDate
+                userId = $userId
+                userPrincipalName = $userPrincipalName
+                displayName = $displayName
+                copilotTier = $copilotTier
+                app = $app
+                feature = $feature
+                agentId = $agentId
+                promptCount = 0
+                responseCount = 0
+                totalInteractions = 0
+                sessionIds = @{}
+            }
+        }
+
+        $group = $groups[$key]
+        $interactionType = Get-RowStringValue -Row $row -PropertyName 'interactionType'
+        if ($interactionType -ieq 'userPrompt') {
+            $group.promptCount++
+        }
+        elseif ($interactionType -ieq 'aiResponse') {
+            $group.responseCount++
+        }
+
+        $group.totalInteractions++
+        $sessionId = Get-RowStringValue -Row $row -PropertyName 'sessionId'
+        if (-not [string]::IsNullOrWhiteSpace($sessionId)) {
+            $group.sessionIds[$sessionId] = $true
+        }
+    }
+
+    $rows = [System.Collections.Generic.List[object]]::new()
+    foreach ($group in $groups.Values) {
+        $rows.Add([pscustomobject]@{
+            activityDate = $group.activityDate
+            userId = $group.userId
+            userPrincipalName = $group.userPrincipalName
+            displayName = $group.displayName
+            copilotTier = $group.copilotTier
+            app = $group.app
+            feature = $group.feature
+            agentId = $group.agentId
+            promptCount = $group.promptCount
+            responseCount = $group.responseCount
+            totalInteractions = $group.totalInteractions
+            uniqueSessions = $group.sessionIds.Keys.Count
+        })
+    }
+
+    return $rows.ToArray()
+}
+
+function New-UsageByAppFeatureDayRows {
+    param(
+        [Parameter(Mandatory = $true)]
+        [AllowEmptyCollection()]
+        [object[]]$InteractionRows
+    )
+
+    $groups = @{}
+
+    foreach ($row in $InteractionRows) {
+        $activityDate = Get-RowStringValue -Row $row -PropertyName 'activityDate'
+        $app = Get-RowStringValue -Row $row -PropertyName 'app'
+        $feature = Get-RowStringValue -Row $row -PropertyName 'feature'
+        $agentId = Get-RowStringValue -Row $row -PropertyName 'agentId'
+        $key = Join-UsageGroupKey -Values @($activityDate, $app, $feature, $agentId)
+
+        if (-not $groups.ContainsKey($key)) {
+            $groups[$key] = [pscustomobject]@{
+                activityDate = $activityDate
+                app = $app
+                feature = $feature
+                agentId = $agentId
+                promptCount = 0
+                responseCount = 0
+                totalInteractions = 0
+                userIds = @{}
+                premiumUserIds = @{}
+                basicUserIds = @{}
+            }
+        }
+
+        $group = $groups[$key]
+        $interactionType = Get-RowStringValue -Row $row -PropertyName 'interactionType'
+        if ($interactionType -ieq 'userPrompt') {
+            $group.promptCount++
+        }
+        elseif ($interactionType -ieq 'aiResponse') {
+            $group.responseCount++
+        }
+
+        $group.totalInteractions++
+
+        $userKey = Get-RowStringValue -Row $row -PropertyName 'userId'
+        if ([string]::IsNullOrWhiteSpace($userKey)) {
+            $userKey = Get-RowStringValue -Row $row -PropertyName 'userPrincipalName'
+        }
+
+        if (-not [string]::IsNullOrWhiteSpace($userKey)) {
+            $group.userIds[$userKey] = $true
+            $copilotTier = Get-RowStringValue -Row $row -PropertyName 'copilotTier'
+            if ($copilotTier -ieq 'Premium') {
+                $group.premiumUserIds[$userKey] = $true
+            }
+            elseif ($copilotTier -ieq 'Basic') {
+                $group.basicUserIds[$userKey] = $true
+            }
+        }
+    }
+
+    $rows = [System.Collections.Generic.List[object]]::new()
+    foreach ($group in $groups.Values) {
+        $rows.Add([pscustomobject]@{
+            activityDate = $group.activityDate
+            app = $group.app
+            feature = $group.feature
+            agentId = $group.agentId
+            uniqueUsers = $group.userIds.Keys.Count
+            promptCount = $group.promptCount
+            responseCount = $group.responseCount
+            totalInteractions = $group.totalInteractions
+            premiumUsers = $group.premiumUserIds.Keys.Count
+            basicUsers = $group.basicUserIds.Keys.Count
+        })
+    }
+
+    return $rows.ToArray()
+}
+
+if ($EndDate -lt $StartDate) {
+    throw 'EndDate must be greater than or equal to StartDate.'
+}
+
+if ([string]::IsNullOrWhiteSpace($OutputDirectory)) {
+    $OutputDirectory = $PSScriptRoot
+}
+
+if ([string]::IsNullOrWhiteSpace($OutputDirectory)) {
+    $OutputDirectory = (Get-Location).Path
+}
+
+New-Item -Path $OutputDirectory -ItemType Directory -Force | Out-Null
+
+$usersPath = Join-Path -Path $OutputDirectory -ChildPath 'Users.csv'
+$interactionsPath = Join-Path -Path $OutputDirectory -ChildPath 'Interactions.csv'
+$usageByUserAppDayPath = Join-Path -Path $OutputDirectory -ChildPath 'UsageByUserAppDay.csv'
+$usageByAppFeatureDayPath = Join-Path -Path $OutputDirectory -ChildPath 'UsageByAppFeatureDay.csv'
+$errorsPath = Join-Path -Path $OutputDirectory -ChildPath 'Errors.csv'
+
+Assert-GraphAuthenticationModule
+Connect-CopilotGraph -AuthenticationMode $PSCmdlet.ParameterSetName
+
+$headers = $null
+$userQuery = "`$select=id,displayName,userPrincipalName&`$top=999"
+if (-not $IncludeAllUsers) {
+    $headers = @{ ConsistencyLevel = 'eventual' }
+    $assignedLicenseFilter = [System.Uri]::EscapeDataString('assignedLicenses/$count ne 0')
+    $userQuery = "$userQuery&`$count=true&`$filter=$assignedLicenseFilter"
+}
+
+$directoryUsersUri = "https://graph.microsoft.com/beta/users?$userQuery"
+Write-Host 'Retrieving candidate users from Microsoft Graph...'
+$directoryUsers = @(Get-GraphCollection -Uri $directoryUsersUri -Headers $headers)
+
+$userRows = [System.Collections.Generic.List[object]]::new()
+$interactionRows = [System.Collections.Generic.List[object]]::new()
+$errorRows = [System.Collections.Generic.List[object]]::new()
+$processedCopilotUsers = 0
+$examinedUsers = 0
+
+foreach ($user in $directoryUsers) {
+    $examinedUsers++
+    $userId = Get-ObjectPropertyValue -InputObject $user -PropertyName 'id'
+    $userPrincipalName = Get-ObjectPropertyValue -InputObject $user -PropertyName 'userPrincipalName'
+
+    Write-Progress -Activity 'Exporting Microsoft 365 Copilot interactions' -Status "Checking licenses for $userPrincipalName" -PercentComplete (($examinedUsers / [Math]::Max(1, $directoryUsers.Count)) * 100)
+
+    try {
+        $licenseInfo = Get-CopilotLicenseInfo -User $user -TierMap $SkuTierMap
+        if (-not $licenseInfo) {
+            continue
+        }
+
+        $processedCopilotUsers++
+        $userRows.Add([pscustomobject]@{
+            userId = $userId
+            displayName = Get-ObjectPropertyValue -InputObject $user -PropertyName 'displayName'
+            userPrincipalName = $userPrincipalName
+            copilotTier = $licenseInfo.Tier
+            licenses = $licenseInfo.Licenses
+        })
+
+        Write-Progress -Activity 'Exporting Microsoft 365 Copilot interactions' -Status "Exporting interactions for $userPrincipalName" -PercentComplete (($examinedUsers / [Math]::Max(1, $directoryUsers.Count)) * 100)
+
+        $interactions = @(Get-EnterpriseInteractionsForUser -UserId $userId -FromDate $StartDate -ToDate $EndDate)
+        foreach ($interaction in $interactions) {
+            $interactionRows.Add((New-InteractionRow -User $user -Interaction $interaction -LicenseInfo $licenseInfo))
+        }
+
+        if ($DelayBetweenUserRequestsMilliseconds -gt 0) {
+            Start-Sleep -Milliseconds $DelayBetweenUserRequestsMilliseconds
+        }
+
+        if ($MaxUsers -gt 0 -and $processedCopilotUsers -ge $MaxUsers) {
+            break
+        }
+    }
+    catch {
+        # Try to extract the Graph error response body for better diagnostics
+        $detailedError = $_.Exception.Message
+        try {
+            $responseBody = $null
+            if ($_.Exception.PSObject.Properties['Response'] -and $_.Exception.Response) {
+                $stream = $_.Exception.Response.GetResponseStream()
+                if ($stream) {
+                    $reader = [System.IO.StreamReader]::new($stream)
+                    $responseBody = $reader.ReadToEnd()
+                    $reader.Dispose()
+                }
+            }
+            if (-not $responseBody -and $_.ErrorDetails -and $_.ErrorDetails.Message) {
+                $responseBody = $_.ErrorDetails.Message
+            }
+            if ($responseBody) {
+                $detailedError = "$detailedError | Response: $responseBody"
+            }
+        }
+        catch { }
+
+        $errorRows.Add([pscustomobject]@{
+            userId = $userId
+            userPrincipalName = $userPrincipalName
+            errorMessage = $detailedError
+            timestampUtc = (Get-Date).ToUniversalTime().ToString('o')
+        })
+        Write-Warning ("Failed to export data for {0}: {1}" -f $userPrincipalName, $detailedError)
+        continue
+    }
+}
+
+Write-Progress -Activity 'Exporting Microsoft 365 Copilot interactions' -Completed
+
+$usageByUserAppDayRows = @(New-UsageByUserAppDayRows -InteractionRows ($interactionRows.ToArray()) | Sort-Object -Property @{ Expression = 'activityDate'; Descending = $true }, @{ Expression = 'userPrincipalName'; Ascending = $true }, @{ Expression = 'app'; Ascending = $true }, @{ Expression = 'feature'; Ascending = $true })
+$usageByAppFeatureDayRows = @(New-UsageByAppFeatureDayRows -InteractionRows ($interactionRows.ToArray()) | Sort-Object -Property @{ Expression = 'activityDate'; Descending = $true }, @{ Expression = 'app'; Ascending = $true }, @{ Expression = 'feature'; Ascending = $true })
+
+Export-CsvRows -Rows ($userRows.ToArray()) -Path $usersPath -Columns @(
+    'userId',
+    'displayName',
+    'userPrincipalName',
+    'copilotTier',
+    'licenses'
+)
+Export-CsvRows -Rows ($interactionRows.ToArray()) -Path $interactionsPath -Columns @(
+    'userId',
+    'userPrincipalName',
+    'interactionId',
+    'sessionId',
+    'appClass',
+    'app',
+    'feature',
+    'agentId',
+    'interactionType',
+    'conversationType',
+    'createdDateTime',
+    'activityDate',
+    'copilotTier',
+    'contextTypes',
+    'contextNames',
+    'linkTypes',
+    'bodyContentType',
+    'bodySnippet'
+)
+Export-CsvRows -Rows $usageByUserAppDayRows -Path $usageByUserAppDayPath -Columns @(
+    'activityDate',
+    'userId',
+    'userPrincipalName',
+    'displayName',
+    'copilotTier',
+    'app',
+    'feature',
+    'agentId',
+    'promptCount',
+    'responseCount',
+    'totalInteractions',
+    'uniqueSessions'
+)
+Export-CsvRows -Rows $usageByAppFeatureDayRows -Path $usageByAppFeatureDayPath -Columns @(
+    'activityDate',
+    'app',
+    'feature',
+    'agentId',
+    'uniqueUsers',
+    'promptCount',
+    'responseCount',
+    'totalInteractions',
+    'premiumUsers',
+    'basicUsers'
+)
+Export-CsvRows -Rows ($errorRows.ToArray()) -Path $errorsPath -Columns @(
+    'userId',
+    'userPrincipalName',
+    'errorMessage',
+    'timestampUtc'
+)
+
+[pscustomobject]@{
+    OutputDirectory = (Resolve-Path -Path $OutputDirectory).Path
+    UsersExamined = $examinedUsers
+    CopilotUsersProcessed = $processedCopilotUsers
+    InteractionsExported = $interactionRows.Count
+    Errors = $errorRows.Count
+    UsersCsv = $usersPath
+    UsersCsvRows = $userRows.Count
+    InteractionsCsv = $interactionsPath
+    InteractionsCsvRows = $interactionRows.Count
+    UsageByUserAppDayCsv = $usageByUserAppDayPath
+    UsageByUserAppDayCsvRows = $usageByUserAppDayRows.Count
+    UsageByAppFeatureDayCsv = $usageByAppFeatureDayPath
+    UsageByAppFeatureDayCsvRows = $usageByAppFeatureDayRows.Count
+    ErrorsCsv = $errorsPath
+    ErrorsCsvRows = $errorRows.Count
+} | Format-List
diff --git a/scripts/Export-CopilotInteractions/README.md b/scripts/Export-CopilotInteractions/README.md
new file mode 100644
index 00000000..4e43a4c1
--- /dev/null
+++ b/scripts/Export-CopilotInteractions/README.md
@@ -0,0 +1,165 @@
+# Microsoft FastTrack Open Source - Export-CopilotInteractions
+
+Exports Microsoft 365 Copilot user-level interaction history (prompts and AI responses) for licensed Copilot Basic and Copilot Premium users in a tenant. Produces a set of CSV files designed to feed Power BI, Excel, or any downstream analytics tool.
+
+Interaction data is pulled from the Microsoft Graph beta endpoint:
+
+```
+/beta/copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions
+```
+
+Features:
+
+- Enumerates licensed users and identifies which ones hold a Copilot SKU (Basic or Premium) via a configurable SKU-to-tier map
+- Pulls full interaction history per Copilot user and normalizes it into a flat CSV
+- Generates two pre-aggregated usage views ready for Power BI:
+  - **Usage by user, app, feature, and day**
+  - **Usage by app, feature, and day** (including Premium vs Basic user counts)
+- Supports three authentication modes: app-only client secret, app-only certificate, and interactive (delegated)
+- Built-in retry with exponential backoff and `Retry-After` handling for 429 / 5xx responses
+- Throttling-friendly delay between per-user calls (configurable)
+- Per-user error CSV so a single failure never stops the run
+- UTF-8 CSVs with header-only output when a dataset is empty
+- Body content snippet is sanitized (control characters stripped, newlines collapsed, capped at 500 characters)
+
+### Important notes
+
+- This script uses **Microsoft Graph beta** APIs. Beta APIs are subject to change and are not supported for production use.
+- `getAllEnterpriseInteractions` **does NOT include Copilot Studio agent interactions**. It covers Microsoft 365 Copilot surfaces (Copilot Chat, Outlook, Word, Excel, PowerPoint, OneNote, Loop, Whiteboard, Teams) and Connected AI Agents / Third-Party Copilot agents.
+- The `bodySnippet` column in `Interactions.csv` can contain **actual user prompt text and AI response content**. Review privacy, legal, data retention, and compliance requirements before exporting or sharing the output.
+- The default SKU-to-tier mapping may need updates as Microsoft renames Copilot license SKU part numbers. Override the mapping at runtime via the `-SkuTierMap` parameter.
+
+### Prerequisites
+
+- **PowerShell 5.1** or later (PowerShell 7+ also supported)
+- **Microsoft.Graph.Authentication** PowerShell module:
+
+  ```powershell
+  Install-Module Microsoft.Graph.Authentication -Scope CurrentUser
+  ```
+
+- **Microsoft Graph permissions** (grant admin consent for app-only modes):
+  - `User.Read.All`
+  - `Reports.Read.All`
+  - `AiEnterpriseInteraction.Read.All`
+
+- An Entra ID app registration if using app-only (client secret or certificate) authentication.
+
+### Parameters
+
+| Parameter | Description |
+|----|----|
+| `-TenantId` | Microsoft Entra tenant ID or verified domain. |
+| `-ClientId` | Application (client) ID. Required for app-only auth; optional for interactive. |
+| `-ClientSecret` | App secret as a `SecureString`. Use `Read-Host -AsSecureString` to avoid putting secrets in shell history. |
+| `-CertificateThumbprint` | Certificate thumbprint installed in the current user's certificate store. Use instead of `-ClientSecret`. |
+| `-Interactive` | Use delegated interactive sign-in (a browser window opens). Best for testing. |
+| `-OutputDirectory` | Folder for the CSV output. Defaults to the script directory. |
+| `-StartDate` | Start of the export window. Defaults to UTC now minus 30 days. |
+| `-EndDate` | End of the export window. Defaults to UTC now. |
+| `-MaxUsers` | Caps the number of Copilot users processed. `0` = no cap. Useful for pilot runs. |
+| `-DelayBetweenUserRequestsMilliseconds` | Throttling-friendly delay between per-user Graph calls. Defaults to `200`. |
+| `-SkuTierMap` | Hashtable mapping SKU part numbers to tier labels (`Basic` / `Premium`). Override to track new SKUs. |
+| `-IncludeAllUsers` | Enumerate **all** directory users instead of only users with an assigned license. |
+
+> Date filtering is applied **client-side** after retrieval. The beta `getAllEnterpriseInteractions` endpoint does not currently support `$filter` on `createdDateTime`.
+
+### Execution
+
+**Interactive (recommended for first run / testing):**
+
+```powershell
+.\Export-CopilotInteractions.ps1 `
+  -TenantId 'contoso.onmicrosoft.com' `
+  -Interactive `
+  -StartDate (Get-Date).AddDays(-7) `
+  -MaxUsers 10
+```
+
+**App-only with client secret:**
+
+```powershell
+$secret = Read-Host 'Client secret' -AsSecureString
+.\Export-CopilotInteractions.ps1 `
+  -TenantId '<tenant-id>' `
+  -ClientId '<app-id>' `
+  -ClientSecret $secret
+```
+
+**App-only with certificate:**
+
+```powershell
+.\Export-CopilotInteractions.ps1 `
+  -TenantId '<tenant-id>' `
+  -ClientId '<app-id>' `
+  -CertificateThumbprint '<thumbprint>' `
+  -OutputDirectory '.\out'
+```
+
+### Output files
+
+All files are written to `-OutputDirectory` (defaults to the script directory).
+
+| File | Description |
+|----|----|
+| `Users.csv` | One row per Copilot-licensed user: `userId`, `displayName`, `userPrincipalName`, `copilotTier` (Basic/Premium/Unknown), `licenses` (semicolon-delimited SKU part numbers). |
+| `Interactions.csv` | One row per interaction (prompt or AI response). Columns include `userId`, `userPrincipalName`, `interactionId`, `sessionId`, `appClass`, friendly `app` and `feature`, `agentId`, `interactionType` (`userPrompt` / `aiResponse`), `conversationType`, `createdDateTime`, `activityDate`, `copilotTier`, `contextTypes`, `contextNames`, `linkTypes`, `bodyContentType`, `bodySnippet` (truncated, sanitized). |
+| `UsageByUserAppDay.csv` | Pre-aggregated daily usage per user/app/feature: `promptCount`, `responseCount`, `totalInteractions`, `uniqueSessions`. |
+| `UsageByAppFeatureDay.csv` | Pre-aggregated daily usage per app/feature: `uniqueUsers`, `promptCount`, `responseCount`, `totalInteractions`, `premiumUsers`, `basicUsers`. |
+| `Errors.csv` | One row per user that failed during processing: `userId`, `userPrincipalName`, `errorMessage`, `timestampUtc`. |
+
+### App / feature normalization
+
+`appClass` values returned by Graph are mapped to friendly `app` and `feature` columns:
+
+| `appClass` pattern | `app` | `feature` | `agentId` |
+|----|----|----|----|
+| `...ConnectedAIApp.Entra.<guid>` | `Connected AI Agent` | `Connected Agent` | extracted GUID |
+| `...Copilot.ThirdPartyCopilot` | `Third-Party Agent` | `Third-Party Copilot` | — |
+| `...Copilot.BizChat` | `Copilot Chat` | `Copilot Chat (Work)` or `Copilot Chat (Web)` (from `conversationType`) | — |
+| `...Copilot.Teams` | `Teams` | `Teams Copilot` / `Teams Meeting` / `Teams Chat` | — |
+| `...Copilot.Outlook` / `Word` / `Excel` / `PowerPoint` / `OneNote` / `Loop` / `Whiteboard` | matching app name | `<App> Copilot` | — |
+| anything else | `Unknown` | last segment of `appClass` | — |
+
+### Notes
+
+- Run with `-MaxUsers 10` first to validate auth and permissions before exporting your full tenant.
+- For large tenants, run during off-peak hours and consider increasing `-DelayBetweenUserRequestsMilliseconds` if you see frequent 429s.
+- The `Errors.csv` file is your friend — if `Interactions.csv` looks light, check it for permission, license, or throttling failures.
+- Body content can contain sensitive customer/business information. Treat the output as confidential by default and apply your organization's DLP, retention, and access controls before sharing.
+
+## Applies To
+
+- Microsoft 365 Copilot (Basic and Premium)
+- Microsoft Graph beta — Copilot interaction history
+- Power BI / Excel reporting on Copilot adoption
+
+## Author
+
+|Author|Original Publish Date
+|----|--------------------------
+|Alejandro Lopez, Microsoft|May 21st, 2026|
+
+## Issues
+
+Please report any issues you find to the [issues list](../../../../issues).
+
+## Support Statement
+
+The scripts, samples, and tools made available through the FastTrack Open Source initiative are provided as-is. These resources are developed in partnership with the community and do not represent official Microsoft software. As such, support is not available through premier or other Microsoft support channels. If you find an issue or have questions please reach out through the issues list and we'll do our best to assist, however there is no associated SLA.
+
+## Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## Legal Notices
+
+Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the [MIT License](https://opensource.org/licenses/MIT), see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the [LICENSE-CODE](LICENSE-CODE) file.
+
+Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
+
+Privacy information can be found at https://privacy.microsoft.com/en-us/
+
+Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents,or trademarks, whether by implication, estoppel or otherwise.