diff --git a/dotnet/agent-framework/sample-agent/README.md b/dotnet/agent-framework/sample-agent/README.md index 1842231c..3f98be53 100644 --- a/dotnet/agent-framework/sample-agent/README.md +++ b/dotnet/agent-framework/sample-agent/README.md @@ -21,7 +21,14 @@ It covers: - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for .NET](https://github.com/microsoft/Agent365-dotnet). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [NuGet Gallery | Microsoft.Agents.A365.Notifications](https://www.nuget.org/packages/Microsoft.Agents.A365.Notifications) +- [NuGet Gallery | Microsoft.Agents.A365.Tooling.Extensions.AgentFramework](https://www.nuget.org/packages/Microsoft.Agents.A365.Tooling.Extensions.AgentFramework) +- [NuGet Gallery | Microsoft.Agents.AI](https://www.nuget.org/packages/Microsoft.Agents.AI) +- [NuGet Gallery | Microsoft.Agents.Authentication.Msal](https://www.nuget.org/packages/Microsoft.Agents.Authentication.Msal) +- [NuGet Gallery | Microsoft.Agents.Hosting.AspNetCore](https://www.nuget.org/packages/Microsoft.Agents.Hosting.AspNetCore) +- [NuGet Gallery | Microsoft.OpenTelemetry](https://www.nuget.org/packages/Microsoft.OpenTelemetry) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/dotnet/autonomous/github-trending/sample-agent/README.md b/dotnet/autonomous/github-trending/sample-agent/README.md index e673ff19..3488bba8 100644 --- a/dotnet/autonomous/github-trending/sample-agent/README.md +++ b/dotnet/autonomous/github-trending/sample-agent/README.md @@ -176,8 +176,9 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) -- [Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability) +- [Microsoft Agent 365 SDK - .NET repository](https://github.com/microsoft/Agent365-dotnet) +- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- [Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability) ## Trademarks diff --git a/dotnet/semantic-kernel/sample-agent/README.md b/dotnet/semantic-kernel/sample-agent/README.md index fbc4a575..5a25c144 100644 --- a/dotnet/semantic-kernel/sample-agent/README.md +++ b/dotnet/semantic-kernel/sample-agent/README.md @@ -19,7 +19,13 @@ This sample demonstrates how to build an agent using Semantic Kernel in C#/.NET - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for .NET](https://github.com/microsoft/Agent365-dotnet). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [NuGet Gallery | Microsoft.Agents.A365.Notifications](https://www.nuget.org/packages/Microsoft.Agents.A365.Notifications) +- [NuGet Gallery | Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel](https://www.nuget.org/packages/Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel) +- [NuGet Gallery | Microsoft.Agents.Authentication.Msal](https://www.nuget.org/packages/Microsoft.Agents.Authentication.Msal) +- [NuGet Gallery | Microsoft.Agents.Hosting.AspNetCore](https://www.nuget.org/packages/Microsoft.Agents.Hosting.AspNetCore) +- [NuGet Gallery | Microsoft.OpenTelemetry](https://www.nuget.org/packages/Microsoft.OpenTelemetry) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/nodejs/claude/sample-agent/README.md b/nodejs/claude/sample-agent/README.md index 0395d6aa..715ca539 100644 --- a/nodejs/claude/sample-agent/README.md +++ b/nodejs/claude/sample-agent/README.md @@ -20,7 +20,14 @@ This sample demonstrates how to build an agent using Claude in Node.js with the - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-notifications - npm](https://www.npmjs.com/package/@microsoft/agents-a365-notifications) +- [@microsoft/agents-a365-tooling - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling) +- [@microsoft/agents-a365-tooling-extensions-claude - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-claude) +- [@microsoft/agents-activity - npm](https://www.npmjs.com/package/@microsoft/agents-activity) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) +- [@microsoft/opentelemetry - npm](https://www.npmjs.com/package/@microsoft/opentelemetry) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/nodejs/copilot-studio/sample-agent/README.md b/nodejs/copilot-studio/sample-agent/README.md index e0e68f21..baaea1cf 100644 --- a/nodejs/copilot-studio/sample-agent/README.md +++ b/nodejs/copilot-studio/sample-agent/README.md @@ -33,7 +33,14 @@ This sample demonstrates: - **Observability**: End-to-end tracing with OpenTelemetry spans for Copilot Studio calls - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [@microsoft/agents-copilotstudio-client](https://github.com/microsoft/Agents-for-js/tree/main/packages/agents-copilotstudio-client) package and the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-notifications - npm](https://www.npmjs.com/package/@microsoft/agents-a365-notifications) +- [@microsoft/agents-a365-observability - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability) +- [@microsoft/agents-a365-runtime - npm](https://www.npmjs.com/package/@microsoft/agents-a365-runtime) +- [@microsoft/agents-activity - npm](https://www.npmjs.com/package/@microsoft/agents-activity) +- [@microsoft/agents-copilotstudio-client - npm](https://www.npmjs.com/package/@microsoft/agents-copilotstudio-client) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) ## Prerequisites diff --git a/nodejs/devin/sample-agent/README.md b/nodejs/devin/sample-agent/README.md index 463a2b84..7b36b82e 100644 --- a/nodejs/devin/sample-agent/README.md +++ b/nodejs/devin/sample-agent/README.md @@ -19,7 +19,13 @@ This sample demonstrates how to build an agent using Devin in Node.js with the M - **Notifications**: Services and models for managing user notifications - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-notifications - npm](https://www.npmjs.com/package/@microsoft/agents-a365-notifications) +- [@microsoft/agents-a365-observability - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability) +- [@microsoft/agents-a365-runtime - npm](https://www.npmjs.com/package/@microsoft/agents-a365-runtime) +- [@microsoft/agents-a365-tooling - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/nodejs/langchain/sample-agent/README.md b/nodejs/langchain/sample-agent/README.md index 9e47bdf6..6204d702 100644 --- a/nodejs/langchain/sample-agent/README.md +++ b/nodejs/langchain/sample-agent/README.md @@ -20,7 +20,15 @@ This sample demonstrates how to build an agent using LangChain in Node.js with t - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-notifications - npm](https://www.npmjs.com/package/@microsoft/agents-a365-notifications) +- [@microsoft/agents-a365-runtime - npm](https://www.npmjs.com/package/@microsoft/agents-a365-runtime) +- [@microsoft/agents-a365-tooling - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling) +- [@microsoft/agents-a365-tooling-extensions-langchain - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-langchain) +- [@microsoft/agents-activity - npm](https://www.npmjs.com/package/@microsoft/agents-activity) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) +- [@microsoft/opentelemetry - npm](https://www.npmjs.com/package/@microsoft/opentelemetry) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/nodejs/openai/sample-agent/README.md b/nodejs/openai/sample-agent/README.md index 004abe1c..7c5b2e1e 100644 --- a/nodejs/openai/sample-agent/README.md +++ b/nodejs/openai/sample-agent/README.md @@ -20,7 +20,17 @@ This sample demonstrates how to build an agent using OpenAI in Node.js with the - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-notifications - npm](https://www.npmjs.com/package/@microsoft/agents-a365-notifications) +- [@microsoft/agents-a365-observability - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability) +- [@microsoft/agents-a365-observability-extensions-openai - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability-extensions-openai) +- [@microsoft/agents-a365-observability-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability-hosting) +- [@microsoft/agents-a365-runtime - npm](https://www.npmjs.com/package/@microsoft/agents-a365-runtime) +- [@microsoft/agents-a365-tooling - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling) +- [@microsoft/agents-a365-tooling-extensions-openai - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling-extensions-openai) +- [@microsoft/agents-activity - npm](https://www.npmjs.com/package/@microsoft/agents-activity) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/nodejs/perplexity/sample-agent/README.md b/nodejs/perplexity/sample-agent/README.md index 699c66e7..5309430f 100644 --- a/nodejs/perplexity/sample-agent/README.md +++ b/nodejs/perplexity/sample-agent/README.md @@ -20,7 +20,12 @@ This sample demonstrates how to build an agent using Perplexity in Node.js with - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-observability - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability) +- [@microsoft/agents-a365-runtime - npm](https://www.npmjs.com/package/@microsoft/agents-a365-runtime) +- [@microsoft/agents-activity - npm](https://www.npmjs.com/package/@microsoft/agents-activity) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/nodejs/vercel-sdk/sample-agent/README.md b/nodejs/vercel-sdk/sample-agent/README.md index ad74e7ae..6a976c20 100644 --- a/nodejs/vercel-sdk/sample-agent/README.md +++ b/nodejs/vercel-sdk/sample-agent/README.md @@ -20,7 +20,14 @@ This sample demonstrates how to build an agent using Vercel AI SDK in Node.js wi - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [@microsoft/agents-a365-notifications - npm](https://www.npmjs.com/package/@microsoft/agents-a365-notifications) +- [@microsoft/agents-a365-observability - npm](https://www.npmjs.com/package/@microsoft/agents-a365-observability) +- [@microsoft/agents-a365-runtime - npm](https://www.npmjs.com/package/@microsoft/agents-a365-runtime) +- [@microsoft/agents-a365-tooling - npm](https://www.npmjs.com/package/@microsoft/agents-a365-tooling) +- [@microsoft/agents-activity - npm](https://www.npmjs.com/package/@microsoft/agents-activity) +- [@microsoft/agents-hosting - npm](https://www.npmjs.com/package/@microsoft/agents-hosting) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/python/agent-framework/sample-agent/README.md b/python/agent-framework/sample-agent/README.md index 9d67a72f..35f23be1 100644 --- a/python/agent-framework/sample-agent/README.md +++ b/python/agent-framework/sample-agent/README.md @@ -19,7 +19,18 @@ This sample demonstrates how to build an agent using Agent Framework in Python w - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [microsoft-agents-activity · PyPI](https://pypi.org/project/microsoft-agents-activity/) +- [microsoft-agents-authentication-msal · PyPI](https://pypi.org/project/microsoft-agents-authentication-msal/) +- [microsoft-agents-hosting-aiohttp · PyPI](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) +- [microsoft-agents-hosting-core · PyPI](https://pypi.org/project/microsoft-agents-hosting-core/) +- [microsoft-agents-a365-notifications · PyPI](https://pypi.org/project/microsoft-agents-a365-notifications/) +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-runtime · PyPI](https://pypi.org/project/microsoft-agents-a365-runtime/) +- [microsoft-agents-a365-tooling · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling/) +- [microsoft-agents-a365-tooling-extensions-agentframework · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-agentframework/) +- [microsoft-opentelemetry · PyPI](https://pypi.org/project/microsoft-opentelemetry/) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/python/claude/sample-agent/README.md b/python/claude/sample-agent/README.md index f37c692e..df40dc02 100644 --- a/python/claude/sample-agent/README.md +++ b/python/claude/sample-agent/README.md @@ -19,7 +19,17 @@ This directory contains a sample agent implementation using Python and Anthropic - **Tools**: Built-in Claude tools (Read, Write, WebSearch, Bash, Grep) for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [microsoft-agents-activity · PyPI](https://pypi.org/project/microsoft-agents-activity/) +- [microsoft-agents-authentication-msal · PyPI](https://pypi.org/project/microsoft-agents-authentication-msal/) +- [microsoft-agents-hosting-aiohttp · PyPI](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) +- [microsoft-agents-hosting-core · PyPI](https://pypi.org/project/microsoft-agents-hosting-core/) +- [microsoft-agents-a365-notifications · PyPI](https://pypi.org/project/microsoft-agents-a365-notifications/) +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-observability-hosting · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-hosting/) +- [microsoft-agents-a365-runtime · PyPI](https://pypi.org/project/microsoft-agents-a365-runtime/) +- [microsoft-agents-a365-tooling · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling/) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/python/crewai/sample_agent/README.md b/python/crewai/sample_agent/README.md index e5cc94d5..b6323f25 100644 --- a/python/crewai/sample_agent/README.md +++ b/python/crewai/sample_agent/README.md @@ -23,7 +23,17 @@ This sample demonstrates how to build a multi-agent system using CrewAI while in - **Azure OpenAI Integration**: Native support for Azure OpenAI deployments via CrewAI's `azure-ai-inference` extra and LiteLLM routing - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [microsoft-agents-activity · PyPI](https://pypi.org/project/microsoft-agents-activity/) +- [microsoft-agents-authentication-msal · PyPI](https://pypi.org/project/microsoft-agents-authentication-msal/) +- [microsoft-agents-hosting-aiohttp · PyPI](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) +- [microsoft-agents-hosting-core · PyPI](https://pypi.org/project/microsoft-agents-hosting-core/) +- [microsoft-agents-a365-notifications · PyPI](https://pypi.org/project/microsoft-agents-a365-notifications/) +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-observability-hosting · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-hosting/) +- [microsoft-agents-a365-runtime · PyPI](https://pypi.org/project/microsoft-agents-a365-runtime/) +- [microsoft-agents-a365-tooling · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling/) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/python/google-adk/sample-agent/README.md b/python/google-adk/sample-agent/README.md index 395782d2..0afc44d8 100644 --- a/python/google-adk/sample-agent/README.md +++ b/python/google-adk/sample-agent/README.md @@ -19,7 +19,15 @@ This sample demonstrates how to build an agent using Google ADK in Python with t - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [microsoft-agents-activity · PyPI](https://pypi.org/project/microsoft-agents-activity/) +- [microsoft-agents-authentication-msal · PyPI](https://pypi.org/project/microsoft-agents-authentication-msal/) +- [microsoft-agents-hosting-aiohttp · PyPI](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) +- [microsoft-agents-hosting-core · PyPI](https://pypi.org/project/microsoft-agents-hosting-core/) +- [microsoft-agents-a365-notifications · PyPI](https://pypi.org/project/microsoft-agents-a365-notifications/) +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-tooling · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling/) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). diff --git a/python/observability-with-azure-monitor/README.md b/python/observability-with-azure-monitor/README.md index 6cecc7a7..926c6625 100644 --- a/python/observability-with-azure-monitor/README.md +++ b/python/observability-with-azure-monitor/README.md @@ -12,7 +12,12 @@ description: "Add Agent 365 observability to a Python app that already exports O # Observability — Agent 365 SDK alongside Azure Monitor -This sample shows how to add the [Microsoft Agent 365 Python SDK](https://github.com/microsoft/Agent365-python) to an app that **already** uses [Azure Monitor / Application Insights OpenTelemetry](https://learn.microsoft.com/azure/azure-monitor/app/opentelemetry-overview). After running this, both Azure Monitor and the Agent 365 backend receive your agent's spans. +This sample shows how to add the Microsoft Agent 365 Python SDK to an app that **already** uses [Azure Monitor / Application Insights OpenTelemetry](https://learn.microsoft.com/azure/azure-monitor/app/opentelemetry-overview). After running this, both Azure Monitor and the Agent 365 backend receive your agent's spans. + +This sample uses the following Agent 365 packages: + +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-observability-extensions-openai · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-extensions-openai/) > This is **not** a from-scratch tracing setup. For a full agent host with Microsoft 365 Agents SDK, see the [`python/openai/sample-agent`](../openai/sample-agent) sample. diff --git a/python/observability-with-langgraph/README.md b/python/observability-with-langgraph/README.md index f2a88292..60f606f4 100644 --- a/python/observability-with-langgraph/README.md +++ b/python/observability-with-langgraph/README.md @@ -12,7 +12,12 @@ description: "Add Agent 365 observability to a Python LangGraph agent while pres # Observability — Agent 365 SDK with LangGraph -This sample shows how to add the [Microsoft Agent 365 Python SDK](https://github.com/microsoft/Agent365-python) to a [LangGraph](https://langchain-ai.github.io/langgraph/) agent that **already** uses OpenTelemetry. After running this, both your existing exporter and the Agent 365 backend receive every span produced by the agent. +This sample shows how to add the Microsoft Agent 365 Python SDK to a [LangGraph](https://langchain-ai.github.io/langgraph/) agent that **already** uses OpenTelemetry. After running this, both your existing exporter and the Agent 365 backend receive every span produced by the agent. + +This sample uses the following Agent 365 packages: + +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-observability-extensions-langchain · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-extensions-langchain/) The structure mirrors Google Cloud's [LangGraph + OpenTelemetry reference sample](https://docs.cloud.google.com/stackdriver/docs/instrumentation/ai-agent-langgraph): an OTel TracerProvider is set up first, an auto-instrumentor handles the LLM and tool spans, and a manual top-level span wraps `agent.invoke(...)` so the trace tree has a clear "agent run" root. diff --git a/python/observability-with-otlp/README.md b/python/observability-with-otlp/README.md index 77ab19a3..28d6900f 100644 --- a/python/observability-with-otlp/README.md +++ b/python/observability-with-otlp/README.md @@ -54,9 +54,13 @@ blueprint assertion flow. This sample shows two patterns at once: -1. Adding the [Microsoft Agent 365 Python SDK](https://github.com/microsoft/Agent365-python) to an app with an **already-configured OpenTelemetry SDK** (vendor-neutral / OTLP). +1. Adding the Microsoft Agent 365 Python SDK to an app with an **already-configured OpenTelemetry SDK** (vendor-neutral / OTLP). 2. **Manual instrumentation** using `InvokeAgentScope`, `InferenceScope`, and `ExecuteToolScope` — useful when you don't use an agent framework, or when you want explicit control over which calls produce spans. +This sample uses the following Agent 365 package: + +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) + > This is **not** a from-scratch tracing setup. For a full agent host with Microsoft 365 Agents SDK, see the [`python/openai/sample-agent`](../openai/sample-agent) sample. ## Demonstrates diff --git a/python/openai/sample-agent/README.md b/python/openai/sample-agent/README.md index f1c72d3b..6b3613d0 100644 --- a/python/openai/sample-agent/README.md +++ b/python/openai/sample-agent/README.md @@ -19,7 +19,17 @@ This sample demonstrates how to build an agent using OpenAI in Python with the M - **Tools**: Model Context Protocol tools for building advanced agent solutions - **Hosting Patterns**: Hosting with Microsoft 365 Agents SDK -This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). +This sample uses the following Microsoft Agents and Agent 365 packages: + +- [microsoft-agents-activity · PyPI](https://pypi.org/project/microsoft-agents-activity/) +- [microsoft-agents-authentication-msal · PyPI](https://pypi.org/project/microsoft-agents-authentication-msal/) +- [microsoft-agents-hosting-aiohttp · PyPI](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) +- [microsoft-agents-hosting-core · PyPI](https://pypi.org/project/microsoft-agents-hosting-core/) +- [microsoft-agents-a365-notifications · PyPI](https://pypi.org/project/microsoft-agents-a365-notifications/) +- [microsoft-agents-a365-observability-core · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-core/) +- [microsoft-agents-a365-observability-extensions-openai · PyPI](https://pypi.org/project/microsoft-agents-a365-observability-extensions-openai/) +- [microsoft-agents-a365-tooling · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling/) +- [microsoft-agents-a365-tooling-extensions-openai · PyPI](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai/) For comprehensive documentation and guidance on building agents with the Microsoft Agent 365 SDK, including how to add tooling, observability, and notifications, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). @@ -41,12 +51,12 @@ For comprehensive documentation and guidance on building agents with the Microso Set up the Python virtual environment manually before running the agent or deploy steps: 1. Install `uv`: - - `pip install uv` + - `pip install uv` 2. Create a virtual environment: - - `uv venv` + - `uv venv` 3. Activate the virtual environment: - - Windows PowerShell: `.venv\Scripts\Activate.ps1` - - macOS/Linux: `source .venv/bin/activate` + - Windows PowerShell: `.venv\Scripts\Activate.ps1` + - macOS/Linux: `source .venv/bin/activate` ## Observability S2S export