Merge pull request #953 from giles17/fix/critical-provider-docs

Fix provider documentation issues

Author: giles17

agent-framework/agents/providers/copilot-studio.md

@@ -41,7 +41,54 @@ Console.WriteLine(await agent.RunAsync("What are our company policies on remote
 :::zone pivot="programming-language-python"
 
 > [!NOTE]
-> Python support for Copilot Studio agents is coming soon.
+> Python support for Copilot Studio agents is available through the `agent-framework-copilotstudio` package.
+
+## Installation
+
+```bash
+pip install agent-framework-copilotstudio --pre
+```
+
+## Configuration
+
+Set the following environment variables for automatic configuration:
+
+```bash
+COPILOTSTUDIOAGENT__ENVIRONMENTID="<your-environment-id>"
+COPILOTSTUDIOAGENT__SCHEMANAME="<your-agent-schema-name>"
+COPILOTSTUDIOAGENT__AGENTAPPID="<your-client-id>"
+COPILOTSTUDIOAGENT__TENANTID="<your-tenant-id>"
+```
+
+## Create a Copilot Studio Agent
+
+`CopilotStudioAgent` reads connection settings from environment variables automatically:
+
+```python
+import asyncio
+from agent_framework.microsoft import CopilotStudioAgent
+
+async def main():
+    agent = CopilotStudioAgent()
+
+    result = await agent.run("What are our company policies on remote work?")
+    print(result)
+
+asyncio.run(main())
+```
+
+## Streaming
+
+```python
+async def streaming_example():
+    agent = CopilotStudioAgent()
+
+    print("Agent: ", end="", flush=True)
+    async for chunk in agent.run("What is the largest city in France?", stream=True):
+        if chunk.text:
+            print(chunk.text, end="", flush=True)
+    print()
+```
 
 :::zone-end
 

agent-framework/agents/providers/foundry-local.md

@@ -76,4 +76,4 @@ For additional runtime controls, `FoundryLocalClient` also supports options such
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Microsoft Foundry Provider](./microsoft-foundry.md)
+> [Anthropic](./anthropic.md)

agent-framework/agents/providers/github-copilot.md

@@ -306,14 +306,14 @@ async def thread_example():
     )
 
     async with agent:
-        thread = agent.create_session()
+        session = agent.create_session()
 
         # First interaction
-        result1 = await agent.run("My name is Alice.", session=thread)
+        result1 = await agent.run("My name is Alice.", session=session)
         print(f"Agent: {result1}")
 
         # Second interaction - agent remembers the context
-        result2 = await agent.run("What's my name?", session=thread)
+        result2 = await agent.run("What's my name?", session=session)
         print(f"Agent: {result2}")  # Should remember "Alice"
 ```
 
@@ -322,7 +322,7 @@ async def thread_example():
 By default, the agent cannot execute shell commands, read/write files, or fetch URLs. To enable these capabilities, provide a permission handler:
 
 ```python
-from copilot.types import PermissionRequest, PermissionRequestResult
+from copilot.generated.session_events import PermissionRequest
 
 def prompt_permission(
     request: PermissionRequest, context: dict[str, str]

agent-framework/agents/providers/index.md

@@ -11,18 +11,19 @@ ms.service: agent-framework
 
 # Providers Overview
 
-Microsoft Agent Framework supports several types of agents to accommodate different use cases and requirements. All agents are derived from a common base class, `AIAgent`, which provides a consistent interface for all agent types.
+Microsoft Agent Framework supports several types of agents to accommodate different use cases and requirements. All agents are derived from a common base class (`AIAgent` in .NET, `BaseAgent` in Python), which provides a consistent interface for all agent types.
 
 ## Provider Comparison
 
 | Provider | Function Tools | Structured Output | Code Interpreter | File Search | MCP Tools | Background Responses |
 |----------|:---:|:---:|:---:|:---:|:---:|:---:|
 | [Azure OpenAI](./azure-openai.md) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [OpenAI](./openai.md) | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ |
+| [OpenAI](./openai.md) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | [Microsoft Foundry](./microsoft-foundry.md) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [Anthropic](./anthropic.md) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
+| [Anthropic](./anthropic.md) | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ |
 | [Ollama](./ollama.md) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
-| [GitHub Copilot](./github-copilot.md) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| [Foundry Local](./foundry-local.md) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| [GitHub Copilot](./github-copilot.md) | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ |
 | [Copilot Studio](./copilot-studio.md) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
 | [Custom](./custom.md) | Varies | Varies | Varies | Varies | Varies | Varies |
 
@@ -61,6 +62,7 @@ Agent Framework supports many different inference services through chat clients.
 - **[Anthropic](./anthropic.md)** — Claude models with extended thinking and hosted tools support.
 - **[Ollama](./ollama.md)** — Run open-source models locally.
 - **[GitHub Copilot](./github-copilot.md)** — GitHub Copilot SDK integration.
+- **[Copilot Studio](./copilot-studio.md)** — Integration with Microsoft Copilot Studio agents.
 - **[Custom](./custom.md)** — Build your own provider by implementing the `BaseAgent` class.
 
 :::zone-end

agent-framework/agents/providers/microsoft-foundry.md

@@ -200,4 +200,4 @@ Both `FoundryChatClient` and `FoundryAgent` integrate with the standard Python `
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Anthropic](./anthropic.md)
+> [Foundry Local](./foundry-local.md)