From 1374fa829d6aa567b585735579931488ce4ba6a4 Mon Sep 17 00:00:00 2001 From: Jim Daly Date: Mon, 19 Oct 2026 15:30:41 -0700 Subject: [PATCH 1/4] Replace links to repos with links to packages --- dotnet/agent-framework/sample-agent/README.md | 10 +++++++-- dotnet/semantic-kernel/sample-agent/README.md | 9 ++++++-- nodejs/claude/sample-agent/README.md | 10 +++++++-- nodejs/copilot-studio/sample-agent/README.md | 10 +++++++-- nodejs/devin/sample-agent/README.md | 9 ++++++-- nodejs/langchain/sample-agent/README.md | 11 ++++++++-- nodejs/openai/sample-agent/README.md | 13 ++++++++++-- nodejs/perplexity/sample-agent/README.md | 8 +++++-- nodejs/vercel-sdk/sample-agent/README.md | 10 +++++++-- python/agent-framework/sample-agent/README.md | 14 +++++++++++-- python/claude/sample-agent/README.md | 13 ++++++++++-- python/crewai/sample_agent/README.md | 13 ++++++++++-- python/google-adk/sample-agent/README.md | 11 ++++++++-- .../README.md | 7 ++++++- python/observability-with-langgraph/README.md | 7 ++++++- python/observability-with-otlp/README.md | 6 +++++- python/openai/sample-agent/README.md | 21 +++++++++++++------ 17 files changed, 147 insertions(+), 35 deletions(-) diff --git a/dotnet/agent-framework/sample-agent/README.md b/dotnet/agent-framework/sample-agent/README.md index 7c519f8e..4dfc2596 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/en-us/microsoft-agent-365/developer/). @@ -256,7 +263,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - .NET repository](https://github.com/microsoft/Agent365-dotnet) - [Microsoft 365 Agents SDK - .NET repository](https://github.com/Microsoft/Agents-for-net) - [Semantic Kernel documentation](https://learn.microsoft.com/semantic-kernel/) - [.NET API documentation](https://learn.microsoft.com/dotnet/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/dotnet/semantic-kernel/sample-agent/README.md b/dotnet/semantic-kernel/sample-agent/README.md index bebeaac8..556a72cf 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/en-us/microsoft-agent-365/developer/). @@ -164,7 +170,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - .NET repository](https://github.com/microsoft/Agent365-dotnet) - [Microsoft 365 Agents SDK - .NET repository](https://github.com/Microsoft/Agents-for-net) - [Semantic Kernel documentation](https://learn.microsoft.com/semantic-kernel/) - [.NET API documentation](https://learn.microsoft.com/dotnet/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/claude/sample-agent/README.md b/nodejs/claude/sample-agent/README.md index 9a60b8ac..154ce75a 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/en-us/microsoft-agent-365/developer/). @@ -319,7 +326,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Claude API documentation](https://docs.anthropic.com/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/copilot-studio/sample-agent/README.md b/nodejs/copilot-studio/sample-agent/README.md index 39291ac9..96c40ec5 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 @@ -341,7 +348,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [@microsoft/agents-copilotstudio-client package](https://github.com/microsoft/Agents-for-js/tree/main/packages/agents-copilotstudio-client) - [Copilot Studio documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/) diff --git a/nodejs/devin/sample-agent/README.md b/nodejs/devin/sample-agent/README.md index f11d5782..2a9d5d58 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/en-us/microsoft-agent-365/developer/). @@ -147,7 +153,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Devin API documentation](https://docs.devin.ai/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/langchain/sample-agent/README.md b/nodejs/langchain/sample-agent/README.md index 85dc060b..3baf7fde 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/en-us/microsoft-agent-365/developer/). @@ -157,7 +165,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [LangChain documentation](https://js.langchain.com/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/openai/sample-agent/README.md b/nodejs/openai/sample-agent/README.md index 2bfdac37..001637de 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/en-us/microsoft-agent-365/developer/). @@ -162,7 +172,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [OpenAI API documentation](https://platform.openai.com/docs/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/perplexity/sample-agent/README.md b/nodejs/perplexity/sample-agent/README.md index fba44a4e..ed7b03e1 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/en-us/microsoft-agent-365/developer/). @@ -145,7 +150,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Perplexity API documentation](https://docs.perplexity.ai/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/vercel-sdk/sample-agent/README.md b/nodejs/vercel-sdk/sample-agent/README.md index d1e6bae7..ce3fe23c 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/en-us/microsoft-agent-365/developer/). @@ -162,7 +169,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Vercel AI SDK documentation](https://sdk.vercel.ai/docs) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/python/agent-framework/sample-agent/README.md b/python/agent-framework/sample-agent/README.md index 4b4b13cc..93036df4 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/en-us/microsoft-agent-365/developer/). @@ -178,7 +189,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [Agent Framework documentation](https://github.com/microsoft/Agent365-python/tree/main/packages/agent-framework) - [Python API documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/python/claude/sample-agent/README.md b/python/claude/sample-agent/README.md index c157e2a6..12c7f27d 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/en-us/microsoft-agent-365/developer/). @@ -241,7 +251,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Claude Agent SDK](https://anthropic.mintlify.app/en/api/agent-sdk/overview) - [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) -- [Microsoft Agents A365 Python](https://github.com/microsoft/Agent365-python) ## Trademarks diff --git a/python/crewai/sample_agent/README.md b/python/crewai/sample_agent/README.md index f3615ba4..0cf027c3 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/en-us/microsoft-agent-365/developer/). @@ -313,7 +323,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [CrewAI API documentation](https://docs.crewai.com) - [Python API documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/python/google-adk/sample-agent/README.md b/python/google-adk/sample-agent/README.md index 4f9581d3..f0d93dfa 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/en-us/microsoft-agent-365/developer/). @@ -616,7 +624,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [Google ADK API documentation](https://google.github.io/adk-docs/) - [Configure messaging endpoint](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-messaging-endpoint) diff --git a/python/observability-with-azure-monitor/README.md b/python/observability-with-azure-monitor/README.md index f88b5f38..650cb1f4 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 8b59f266..d41b9a5a 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 0843c810..be1bf8c2 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 2052a202..f2abcce6 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/en-us/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 @@ -184,7 +194,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [OpenAI API documentation](https://platform.openai.com/docs/) - [Python API documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true) From 8cc525536f22921c368db4523b5b00e3e9f11433 Mon Sep 17 00:00:00 2001 From: Jim Daly Date: Mon, 19 Oct 2026 15:33:07 -0700 Subject: [PATCH 2/4] Remove '/en-us' from links to learn.microsoft.com --- .claude/skills/generate-readme/SKILL.md | 14 ++++---- CLAUDE.md | 2 +- README.md | 4 +-- .../salesforce/apex-observability/README.md | 14 ++++---- .../apex-observability/docs/design.md | 2 +- dotnet/agent-framework/sample-agent/README.md | 8 ++--- .../github-trending/sample-agent/README.md | 12 +++---- dotnet/semantic-kernel/sample-agent/README.md | 6 ++-- .../w365-computer-use/sample-agent/README.md | 8 ++--- nodejs/autonomous/github-trending/README.md | 12 +++---- nodejs/claude/quickstart-before/README.md | 2 +- nodejs/claude/sample-agent/README.md | 6 ++-- nodejs/copilot-studio/sample-agent/README.md | 8 ++--- nodejs/devin/sample-agent/README.md | 8 ++--- nodejs/langchain/quickstart-before/README.md | 4 +-- nodejs/langchain/sample-agent/README.md | 6 ++-- nodejs/n8n/sample-agent/README.md | 16 +++++----- nodejs/openai/sample-agent/README.md | 6 ++-- nodejs/perplexity/sample-agent/README.md | 6 ++-- nodejs/vercel-sdk/sample-agent/README.md | 6 ++-- prompts/Cursor IDE Prompt.md | 20 ++++++------ python/agent-framework/sample-agent/README.md | 6 ++-- python/autonomous/github-trending/README.md | 12 +++---- python/claude/sample-agent/README.md | 8 ++--- python/crewai/sample_agent/README.md | 4 +-- python/google-adk/sample-agent/README.md | 32 +++++++++---------- .../README.md | 2 +- python/observability-with-langgraph/README.md | 2 +- python/observability-with-otlp/README.md | 2 +- python/openai/sample-agent/README.md | 6 ++-- 30 files changed, 122 insertions(+), 122 deletions(-) diff --git a/.claude/skills/generate-readme/SKILL.md b/.claude/skills/generate-readme/SKILL.md index 1566bb32..cbe406d8 100644 --- a/.claude/skills/generate-readme/SKILL.md +++ b/.claude/skills/generate-readme/SKILL.md @@ -34,7 +34,7 @@ The README MUST contain the following sections in this exact order. Do not add, <1–3 sentence description of what the sample demonstrates. State whether it is interactive or autonomous, what SDK/orchestrator it uses, and what makes it a useful reference.> -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ``` ### 2. What This Sample Demonstrates @@ -56,7 +56,7 @@ A table of patterns demonstrated and their file locations: - - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role - @@ -125,7 +125,7 @@ For Python and Node.js samples, include `ENABLE_A365_OBSERVABILITY_EXPORTER`, `E ``` -For interactive agents, reference the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing) guide and Microsoft 365 Agents Playground. +For interactive agents, reference the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing) guide and Microsoft 365 Agents Playground. ### 7. Deploying the Agent @@ -143,7 +143,7 @@ For interactive agents, reference the [Configure Agent Testing](https://learn.mi ``` -Keep this section concise — no ASCII art diagrams. Reference the [Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability) for details. +Keep this section concise — no ASCII art diagrams. Reference the [Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability) for details. ### 9. Support @@ -153,7 +153,7 @@ Keep this section concise — no ASCII art diagrams. Reference the [Agent observ For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ``` @@ -174,8 +174,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ```markdown ## Additional Resources -- [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) +- [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) - - ``` diff --git a/CLAUDE.md b/CLAUDE.md index 9675824d..5bd6050b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -270,5 +270,5 @@ For language-specific design patterns, see: ## Official Documentation -- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - [Microsoft 365 Agents SDK Documentation](https://learn.microsoft.com/microsoft-365/agents-sdk/) diff --git a/README.md b/README.md index 050b7c09..64c4d71b 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ compatible SDK releases. Legacy Node.js samples pin their tested SDK family to preserve compatible tracing APIs and S2S exporter options. > #### Note: -> Use the information in this README to contribute to this open-source project. To learn about using this SDK in your projects, refer to the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +> Use the information in this README to contribute to this open-source project. To learn about using this SDK in your projects, refer to the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ## Survey @@ -44,7 +44,7 @@ This samples repository is currently in active development and contains: ## Documentation -For comprehensive documentation and guides, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +For comprehensive documentation and guides, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ### Microsoft Agent 365 SDK diff --git a/agent-platforms/salesforce/apex-observability/README.md b/agent-platforms/salesforce/apex-observability/README.md index 039c7028..9d9db726 100644 --- a/agent-platforms/salesforce/apex-observability/README.md +++ b/agent-platforms/salesforce/apex-observability/README.md @@ -12,7 +12,7 @@ description: "Emit native Agent 365 telemetry from Salesforce Apex with correlat # Salesforce Apex — Native Agent 365 Observability -This sample shows how **Salesforce Apex** can participate in [Microsoft Agent 365](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +This sample shows how **Salesforce Apex** can participate in [Microsoft Agent 365](https://learn.microsoft.com/microsoft-agent-365/developer/) observability as a **first-class telemetry emitter**. When an Agent 365 agent calls into Salesforce (or an Agentforce agent runs a Salesforce action), the Apex code emits its **own** Agent 365 OTLP spans — correlated to the agent turn by a shared W3C trace id — so Salesforce proves it ran from @@ -31,7 +31,7 @@ identity, audience, registration and service policy instead of switching to OBO or automatically adding OBS permissions. Apex runtime tests require an authorized Salesforce test org; an offline source audit is not live authorization validation. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -107,7 +107,7 @@ for the exact per-hop requests and Named Credentials. via a Dev Hub, or a Developer Edition org) - An Entra tenant onboarded to Agent 365, with at minimum the **Agent ID Developer** role - An Agent 365 **agent** and its **blueprint** app registration (the blueprint sponsors the FMI chain). - See the [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) + See the [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (`a365 setup all`) for provisioning the blueprint + agent identity. ## Project Layout @@ -264,12 +264,12 @@ trace. `A365ObsSpan` emits the Agent 365 exporter wire shape exactly — see [OTLP wire shape](docs/design.md#otlp-wire-shape) for the field-level contract. For details on the observability SDK and instrumentation patterns, see the -[Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). +[Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability). ## Support - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../SECURITY.md) ## Contributing @@ -288,8 +288,8 @@ or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any addi ## Additional Resources -- [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) +- [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) - [Design notes](docs/design.md) ## Trademarks diff --git a/agent-platforms/salesforce/apex-observability/docs/design.md b/agent-platforms/salesforce/apex-observability/docs/design.md index 7aff522e..f2564f1d 100644 --- a/agent-platforms/salesforce/apex-observability/docs/design.md +++ b/agent-platforms/salesforce/apex-observability/docs/design.md @@ -54,7 +54,7 @@ Dependency direction (no cycles): > **Background:** this uses Microsoft Entra **Agent ID** — an agent identity blueprint plus Federated > Managed Identity (FMI) and the `jwt-bearer` grant. For the identity model and OAuth grant types, see -> [Microsoft Entra Agent ID — Agent OAuth flows](https://learn.microsoft.com/en-us/entra/agent-id/agent-on-behalf-of-oauth-flow). +> [Microsoft Entra Agent ID — Agent OAuth flows](https://learn.microsoft.com/entra/agent-id/agent-on-behalf-of-oauth-flow). > The steps below show only what the Apex sample sends on the wire. MSAL is unavailable in Apex, so each hop is a raw `application/x-www-form-urlencoded` POST. The ingest diff --git a/dotnet/agent-framework/sample-agent/README.md b/dotnet/agent-framework/sample-agent/README.md index 4dfc2596..b64ef8b8 100644 --- a/dotnet/agent-framework/sample-agent/README.md +++ b/dotnet/agent-framework/sample-agent/README.md @@ -30,7 +30,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -163,7 +163,7 @@ through user secrets, or `Agent365Observability__BlueprintClientSecret` through All settings support the standard .NET double-underscore environment syntax. Never commit secrets. The [sample-local OBS provider](Observability/ObservabilityAppTokenProvider.cs) uses the -[documented app-only flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): +[documented app-only flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint `client_credentials` with `fmi_path=AgentId` and `api://AzureADTokenExchange/.default` produces T1; agent `client_credentials` uses T1 as `client_assertion` for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. The existing autonomous sample uses the same @@ -241,7 +241,7 @@ Set this in your local launch profile, deployment environment, or container conf ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](Agent-Code-Walkthrough.md). @@ -250,7 +250,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-dotnet/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/dotnet/autonomous/github-trending/sample-agent/README.md b/dotnet/autonomous/github-trending/sample-agent/README.md index a47c9d3b..e673ff19 100644 --- a/dotnet/autonomous/github-trending/sample-agent/README.md +++ b/dotnet/autonomous/github-trending/sample-agent/README.md @@ -16,7 +16,7 @@ This sample demonstrates a **purely autonomous agent** built with the Microsoft Every 60 seconds, the agent prompts Azure OpenAI to fetch trending GitHub repositories using a registered tool. The model calls the `GetTrendingRepositories` tool, which queries the GitHub Search API, then summarizes the results into a readable digest that is logged to the console. All operations are **manually instrumented** with Agent 365 observability using the tracing scopes (`InvokeAgentScope`, `InferenceScope`, `ExecuteToolScope`), making this a useful reference for instrumenting any non-interactive or custom agent loop. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -34,7 +34,7 @@ For comprehensive documentation, visit the [Microsoft Agent 365 Developer Docume - [.NET 9.0 SDK](https://dotnet.microsoft.com/download/dotnet/9.0) or higher - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role @@ -156,14 +156,14 @@ Each autonomous cycle produces three nested spans: an `InvokeAgentScope` wrappin The `ObservabilityTokenService` acquires tokens for the A365 exporter via a 3-hop FMI chain: the blueprint authenticates (MSI in production, client secret locally), exchanges for a T1 token targeting the agent identity via `.WithFmiPath`, then the agent identity uses T1 as an assertion to acquire an Observability API token. This token is cached in `ServiceTokenCache` and refreshed every 50 minutes. `UseManagedIdentity: true` in `appsettings.json` controls whether the managed identity path or the client secret path is used. -For details on the observability SDK and instrumentation patterns, see the [Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). +For details on the observability SDK and instrumentation patterns, see the [Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability). ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ## Contributing @@ -176,8 +176,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [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) +- [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) ## Trademarks diff --git a/dotnet/semantic-kernel/sample-agent/README.md b/dotnet/semantic-kernel/sample-agent/README.md index 556a72cf..698fd88b 100644 --- a/dotnet/semantic-kernel/sample-agent/README.md +++ b/dotnet/semantic-kernel/sample-agent/README.md @@ -27,7 +27,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -148,7 +148,7 @@ Typing indicators show a `...` animation in Teams while the agent is working. Th ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](Agent-Code-Walkthrough.md). @@ -157,7 +157,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-dotnet/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/dotnet/w365-computer-use/sample-agent/README.md b/dotnet/w365-computer-use/sample-agent/README.md index d29d988e..78a7c9b4 100644 --- a/dotnet/w365-computer-use/sample-agent/README.md +++ b/dotnet/w365-computer-use/sample-agent/README.md @@ -55,7 +55,7 @@ Response to User - Azure OpenAI resource with a CUA-capable model deployment: - `computer-use-preview` or `gpt-5.4` / `gpt-5.4-mini` - [Request access to gpt-5.4](https://aka.ms/OAI/gpt54access) if needed -- Access to the W365 Computer Use MCP server (via [Agent 365 MCP Platform](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/)) +- Access to the W365 Computer Use MCP server (via [Agent 365 MCP Platform](https://learn.microsoft.com/microsoft-agent-365/developer/)) - A bearer token with `Tools.ListInvoke.All` scope ## Setup @@ -189,7 +189,7 @@ client ID. For local development use `UseManagedIdentity=false` and supply `Agent365Observability__BlueprintClientSecret` through the environment. All keys support the .NET double-underscore environment format. Do not store a secret in checked-in configuration. -The sample-local provider implements the [documented app-only token flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): +The sample-local provider implements the [documented app-only token flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint `client_credentials` with `fmi_path=AgentId` and `api://AzureADTokenExchange/.default` produces T1; agent `client_credentials` uses T1 as `client_assertion` for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. No user token, `user_fic`, or OBO is used for OBS. @@ -425,6 +425,6 @@ The in-memory handoff store is single-process. If the web app is scaled out to m ## Links -- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - [Microsoft 365 Agents SDK](https://learn.microsoft.com/microsoft-365/agents-sdk/) -- [Azure OpenAI Computer Use Guide](https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/computer-use) +- [Azure OpenAI Computer Use Guide](https://learn.microsoft.com/azure/foundry-classic/openai/how-to/computer-use) diff --git a/nodejs/autonomous/github-trending/README.md b/nodejs/autonomous/github-trending/README.md index 5842d82e..280d6bbb 100644 --- a/nodejs/autonomous/github-trending/README.md +++ b/nodejs/autonomous/github-trending/README.md @@ -23,7 +23,7 @@ Every 60 seconds, the agent: All operations are **manually instrumented** with Agent 365 observability using the A365 Observability SDK tracing scopes (`InvokeAgentScope`, `InferenceScope`, `ExecuteToolScope`). This makes it a useful reference for instrumenting any non-interactive or custom agent loop. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -41,7 +41,7 @@ For comprehensive documentation, visit the [Microsoft Agent 365 Developer Docume - [Node.js 18](https://nodejs.org/) or higher - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role @@ -203,14 +203,14 @@ Production (MSI): The token is refreshed every 50 minutes and cached in `token-cache.ts`. -For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). +For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/microsoft-agent-365/developer/observability). ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ## Contributing @@ -225,8 +225,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) -- [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) +- [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) ## Trademarks diff --git a/nodejs/claude/quickstart-before/README.md b/nodejs/claude/quickstart-before/README.md index fb2758d0..b2d23051 100644 --- a/nodejs/claude/quickstart-before/README.md +++ b/nodejs/claude/quickstart-before/README.md @@ -105,7 +105,7 @@ npm run start:anon ## Documentation - [Claude Agent SDK](https://docs.claude.com/en/docs/agent-sdk/typescript) -- [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) +- [Microsoft 365 Agents SDK](https://learn.microsoft.com/microsoft-365/agents-sdk/) ## License diff --git a/nodejs/claude/sample-agent/README.md b/nodejs/claude/sample-agent/README.md index 154ce75a..9a4f4272 100644 --- a/nodejs/claude/sample-agent/README.md +++ b/nodejs/claude/sample-agent/README.md @@ -29,7 +29,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites > @@ -243,7 +243,7 @@ OTEL_SERVICE_NAME=Claude Sample Agent ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Troubleshooting @@ -313,7 +313,7 @@ AADSTS7000216: 'client_assertion', 'client_secret' or 'request' is required For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/copilot-studio/sample-agent/README.md b/nodejs/copilot-studio/sample-agent/README.md index 96c40ec5..acc392a4 100644 --- a/nodejs/copilot-studio/sample-agent/README.md +++ b/nodejs/copilot-studio/sample-agent/README.md @@ -108,7 +108,7 @@ Users must have access to chat with your Copilot Studio agent: > **Note:** Individual users cannot be granted access directly—you must use security groups or organization-wide sharing. Authentication must be configured with **Microsoft Entra ID** and **"Require users to sign in"** enabled. -For more details, see [Share agents with other users](https://learn.microsoft.com/en-us/microsoft-copilot-studio/admin-share-bots). +For more details, see [Share agents with other users](https://learn.microsoft.com/microsoft-copilot-studio/admin-share-bots). ### 3. Microsoft 365 Copilot License Requirement @@ -334,8 +334,8 @@ for await (const activity of client.sendActivityStreaming(userActivity)) { For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) -- **Copilot Studio**: See [Copilot Studio documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Copilot Studio**: See [Copilot Studio documentation](https://learn.microsoft.com/microsoft-copilot-studio/) - **Security**: For security issues, please see [SECURITY.md](../../../SECURITY.md) ## Contributing @@ -350,7 +350,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [@microsoft/agents-copilotstudio-client package](https://github.com/microsoft/Agents-for-js/tree/main/packages/agents-copilotstudio-client) -- [Copilot Studio documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/) +- [Copilot Studio documentation](https://learn.microsoft.com/microsoft-copilot-studio/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) ## Trademarks diff --git a/nodejs/devin/sample-agent/README.md b/nodejs/devin/sample-agent/README.md index 2a9d5d58..9497f11a 100644 --- a/nodejs/devin/sample-agent/README.md +++ b/nodejs/devin/sample-agent/README.md @@ -27,7 +27,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -129,18 +129,18 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Deploying the Agent -Refer to the [Deploy and publish agents](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/publish-deploy-agent?tabs=nodejs) guide for complete instructions. +Refer to the [Deploy and publish agents](https://learn.microsoft.com/microsoft-agent-365/developer/publish-deploy-agent?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/langchain/quickstart-before/README.md b/nodejs/langchain/quickstart-before/README.md index 660eec72..ef9da0d0 100644 --- a/nodejs/langchain/quickstart-before/README.md +++ b/nodejs/langchain/quickstart-before/README.md @@ -4,8 +4,8 @@ This directory contains a quickstart agent implementation using Node.js and Lang ## Demonstrates -This sample is used to demonstrate how to build an agent using the Microsoft Agent 365 SDK with Node.js and LangChain. The sample includes basic LangChain Agent SDK usage hosted with Agents SDK that is testable on [agentsplayground](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/test-with-toolkit-project?tabs=windows). -Please refer to this [quickstart guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/quickstart-nodejs-langchain) on how to extend your agent using Microsoft Agent 365 SDK. +This sample is used to demonstrate how to build an agent using the Microsoft Agent 365 SDK with Node.js and LangChain. The sample includes basic LangChain Agent SDK usage hosted with Agents SDK that is testable on [agentsplayground](https://learn.microsoft.com/microsoft-365/agents-sdk/test-with-toolkit-project?tabs=windows). +Please refer to this [quickstart guide](https://learn.microsoft.com/microsoft-agent-365/developer/quickstart-nodejs-langchain) on how to extend your agent using Microsoft Agent 365 SDK. ## Prerequisites diff --git a/nodejs/langchain/sample-agent/README.md b/nodejs/langchain/sample-agent/README.md index 3baf7fde..9e1ea005 100644 --- a/nodejs/langchain/sample-agent/README.md +++ b/nodejs/langchain/sample-agent/README.md @@ -30,7 +30,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites > @@ -144,7 +144,7 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](Agent-Code-Walkthrough.md). ## Support @@ -152,7 +152,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../SECURITY.md) ## Contributing diff --git a/nodejs/n8n/sample-agent/README.md b/nodejs/n8n/sample-agent/README.md index 4cdd6a08..3023fdad 100644 --- a/nodejs/n8n/sample-agent/README.md +++ b/nodejs/n8n/sample-agent/README.md @@ -58,7 +58,7 @@ This guide will walk you through creating an Agent 365 using n8n's Microsoft Age #### Step 1: Create Agent Blueprint Create your agent identity in the Microsoft Teams Developer Portal: -- Follow the [Agent Identity Blueprint guide](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#agent-identity-blueprint) +- Follow the [Agent Identity Blueprint guide](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#agent-identity-blueprint) #### Step 2: Publish to Microsoft Admin Center @@ -74,12 +74,12 @@ Publish your agent for administrative management: Configure authentication credentials: - Navigate to your app registration in the Azure Portal -- Follow the [credentials guide](https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-credentials?tabs=client-secret) to add a client secret +- Follow the [credentials guide](https://learn.microsoft.com/entra/identity-platform/how-to-add-credentials?tabs=client-secret) to add a client secret - Copy the **Client Secret** value (you'll only see this once) OR -Follow the [documentation](https://learn.microsoft.com/en-us/graph/api/agentidentityblueprint-addpassword?view=graph-rest-beta) to add and see the client secret. You can also run the following powershell script, replacing your TenantID with your tenant's id and the applicationID with your blueprint id. +Follow the [documentation](https://learn.microsoft.com/graph/api/agentidentityblueprint-addpassword?view=graph-rest-beta) to add and see the client secret. You can also run the following powershell script, replacing your TenantID with your tenant's id and the applicationID with your blueprint id. ```powershell Connect-MgGraph -Scopes "AgentIdentityBlueprint.AddRemoveCreds.All" -TenantId @@ -104,7 +104,7 @@ Write-Host "Secret Text: $($response.secretText)" #### Step 4: Grant Permissions for Agent -Grant your Agent Blueprint access to Microsoft 365 by following the [agent access guide](https://learn.microsoft.com/en-us/entra/agent-id/identity-professional/grant-agent-access-microsoft-365). You must also [enable inheritable permissions](https://learn.microsoft.com/en-us/entra/agent-id/identity-professional/configure-inheritable-permissions-blueprints) to allow the agent to act on behalf of users. +Grant your Agent Blueprint access to Microsoft 365 by following the [agent access guide](https://learn.microsoft.com/entra/agent-id/identity-professional/grant-agent-access-microsoft-365). You must also [enable inheritable permissions](https://learn.microsoft.com/entra/agent-id/identity-professional/configure-inheritable-permissions-blueprints) to allow the agent to act on behalf of users. Consent for the required scopes can be given as shown below, just replace your tenant id, and blueprint id in the specified places: @@ -171,13 +171,13 @@ For n8n workflow creation guidance, see the [n8n documentation](https://docs.n8n #### Step 6: Configure Backend URL Connect your agent blueprint to the n8n workflow: -- Return to the [Microsoft Teams Developer Portal](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#configure-the-agent-identity-blueprint) +- Return to the [Microsoft Teams Developer Portal](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#configure-the-agent-identity-blueprint) - Navigate to your Agent Blueprint → **Configuration** - Select **API Based** as the configuration type - Set the **Backend URL** to your n8n workflow's webhook URL from Step 5 #### Step 7: Hire an agent as a digital worker -- Follow the [documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/onboard) to hire an agent as a digital worker +- Follow the [documentation](https://learn.microsoft.com/microsoft-agent-365/onboard) to hire an agent as a digital worker Your agent is now ready to handle conversations through Microsoft 365! @@ -187,7 +187,7 @@ Your agent is now ready to handle conversations through Microsoft 365! For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../SECURITY.md) ## Contributing @@ -200,7 +200,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365](https://learn.microsoft.com/en-us/microsoft-agent-365/) +- [Microsoft Agent 365](https://learn.microsoft.com/microsoft-agent-365/) - [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [n8n documentation](https://docs.n8n.io/) diff --git a/nodejs/openai/sample-agent/README.md b/nodejs/openai/sample-agent/README.md index 001637de..f877e938 100644 --- a/nodejs/openai/sample-agent/README.md +++ b/nodejs/openai/sample-agent/README.md @@ -32,7 +32,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -152,14 +152,14 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/perplexity/sample-agent/README.md b/nodejs/perplexity/sample-agent/README.md index ed7b03e1..50cd834f 100644 --- a/nodejs/perplexity/sample-agent/README.md +++ b/nodejs/perplexity/sample-agent/README.md @@ -27,7 +27,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -130,14 +130,14 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/vercel-sdk/sample-agent/README.md b/nodejs/vercel-sdk/sample-agent/README.md index ce3fe23c..c5fd658b 100644 --- a/nodejs/vercel-sdk/sample-agent/README.md +++ b/nodejs/vercel-sdk/sample-agent/README.md @@ -29,7 +29,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -149,14 +149,14 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/prompts/Cursor IDE Prompt.md b/prompts/Cursor IDE Prompt.md index 44389ce3..d8626779 100644 --- a/prompts/Cursor IDE Prompt.md +++ b/prompts/Cursor IDE Prompt.md @@ -20,22 +20,22 @@ Cursor works best when you reference Microsoft Learn documentation directly in y When crafting your prompt, reference these Microsoft Learn pages by URL. Cursor will read them when you submit your prompt: -- **Agent 365 Developer Overview**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/?tabs=nodejs -- **Notifications**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/notification?tabs=nodejs -- **Tooling (MCP)**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/tooling?tabs=nodejs -- **Observability**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability?tabs=nodejs -- **Node.js + Claude Quickstart**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/quickstart-nodejs-claude +- **Agent 365 Developer Overview**: https://learn.microsoft.com/microsoft-agent-365/developer/?tabs=nodejs +- **Notifications**: https://learn.microsoft.com/microsoft-agent-365/developer/notification?tabs=nodejs +- **Tooling (MCP)**: https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=nodejs +- **Observability**: https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=nodejs +- **Node.js + Claude Quickstart**: https://learn.microsoft.com/microsoft-agent-365/developer/quickstart-nodejs-claude ## 4. Prompting Cursor Open the Composer and paste a prompt like this, including the Microsoft Learn documentation URLs: ``` Using these documentations: -https://learn.microsoft.com/en-us/microsoft-agent-365/developer/?tabs=nodejs -https://learn.microsoft.com/en-us/microsoft-agent-365/developer/notification?tabs=nodejs -https://learn.microsoft.com/en-us/microsoft-agent-365/developer/tooling?tabs=nodejs -https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability?tabs=nodejs -https://learn.microsoft.com/en-us/microsoft-agent-365/developer/quickstart-nodejs-claude +https://learn.microsoft.com/microsoft-agent-365/developer/?tabs=nodejs +https://learn.microsoft.com/microsoft-agent-365/developer/notification?tabs=nodejs +https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=nodejs +https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=nodejs +https://learn.microsoft.com/microsoft-agent-365/developer/quickstart-nodejs-claude Create a Microsoft Agent 365 agent in TypeScript with Claude as the orchestrator that can summarize unread emails and draft helpful email responses. The agent must: - Receive a user message diff --git a/python/agent-framework/sample-agent/README.md b/python/agent-framework/sample-agent/README.md index 93036df4..193e818e 100644 --- a/python/agent-framework/sample-agent/README.md +++ b/python/agent-framework/sample-agent/README.md @@ -32,7 +32,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites > @@ -167,7 +167,7 @@ Each `send_activity` call produces a separate Teams message. You can call it as ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](AGENT-CODE-WALKTHROUGH.md). @@ -176,7 +176,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/python/autonomous/github-trending/README.md b/python/autonomous/github-trending/README.md index fd1c19b0..572fa232 100644 --- a/python/autonomous/github-trending/README.md +++ b/python/autonomous/github-trending/README.md @@ -23,7 +23,7 @@ Every 60 seconds, the agent: All operations are **manually instrumented** with Agent 365 observability using the A365 Observability SDK tracing scopes (`InvokeAgentScope`, `InferenceScope`, `ExecuteToolScope`). This makes it a useful reference for instrumenting any non-interactive or custom agent loop. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -40,7 +40,7 @@ For comprehensive documentation, visit the [Microsoft Agent 365 Developer Docume - Python 3.11 or higher - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role @@ -190,14 +190,14 @@ Production (MSI): The token is refreshed every 50 minutes and cached in `token_cache.py`. -For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). +For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/microsoft-agent-365/developer/observability). ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ## Contributing @@ -211,8 +211,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources - [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) -- [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) +- [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) ## Trademarks diff --git a/python/claude/sample-agent/README.md b/python/claude/sample-agent/README.md index 12c7f27d..8411bddd 100644 --- a/python/claude/sample-agent/README.md +++ b/python/claude/sample-agent/README.md @@ -31,7 +31,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -143,7 +143,7 @@ finally: For detailed setup and running instructions, please refer to the official documentation: -- **[Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/)** - Complete setup and testing guide +- **[Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/)** - Complete setup and testing guide - **[AGENT-CODE-WALKTHROUGH.md](AGENT-CODE-WALKTHROUGH.md)** - Detailed code explanation and architecture walkthrough ## Architecture @@ -237,7 +237,7 @@ MCP tools require proper Azure authentication: For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) ## Contributing @@ -250,7 +250,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Resources - [Claude Agent SDK](https://anthropic.mintlify.app/en/api/agent-sdk/overview) -- [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) +- [Microsoft 365 Agents SDK](https://learn.microsoft.com/microsoft-365/agents-sdk/) ## Trademarks diff --git a/python/crewai/sample_agent/README.md b/python/crewai/sample_agent/README.md index 0cf027c3..5e5c253e 100644 --- a/python/crewai/sample_agent/README.md +++ b/python/crewai/sample_agent/README.md @@ -35,7 +35,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites @@ -310,7 +310,7 @@ For issues, questions, or feedback: - **CrewAI Documentation**: https://docs.crewai.com - **CrewAI GitHub**: https://github.com/joaomdmoura/crewai -- **Microsoft Agent 365 Documentation**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/ +- **Microsoft Agent 365 Documentation**: https://learn.microsoft.com/microsoft-agent-365/developer/ - **Discord**: https://discord.com/invite/X4JWnZnxPb ## Contributing diff --git a/python/google-adk/sample-agent/README.md b/python/google-adk/sample-agent/README.md index f0d93dfa..ea6f35c8 100644 --- a/python/google-adk/sample-agent/README.md +++ b/python/google-adk/sample-agent/README.md @@ -29,7 +29,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Observability S2S export @@ -62,7 +62,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. `observability_token_service.py` adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): +[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint credentials + `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance uses T1 as its client assertion to request `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants are @@ -137,7 +137,7 @@ The fastest way is the **AI-guided setup** — attach the instruction file to Gi Follow the steps in #file:a365-setup-instructions.md ``` -> See [AI-guided setup for Agent 365](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/ai-guided-setup) for full instructions and to download `a365-setup-instructions.md`. +> See [AI-guided setup for Agent 365](https://learn.microsoft.com/microsoft-agent-365/developer/ai-guided-setup) for full instructions and to download `a365-setup-instructions.md`. Alternatively, run the CLI manually: @@ -248,7 +248,7 @@ agentsplayground -e "http://localhost:3978/api/messages" -c "emulator" \ Run `agentsplayground --help` for all options. -> For full setup documentation see [Test your agent locally in Agents Playground](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/test-with-toolkit-project). +> For full setup documentation see [Test your agent locally in Agents Playground](https://learn.microsoft.com/microsoft-365/agents-sdk/test-with-toolkit-project). ### Testing checklist @@ -291,7 +291,7 @@ a365 publish ### Running on Azure App Service -See [Deploy agent to Azure](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) for full instructions. +See [Deploy agent to Azure](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) for full instructions. Set `messagingEndpoint` in `a365.config.json` to your Azure Web App URL and `"needDeployment": true` (see [configuration reference above](#3-initialize-a365-configuration)). @@ -331,7 +331,7 @@ All values below come from `a365.config.json` and `a365.generated.config.json` ( ### Running on GCP (Cloud Run) -See [Deploy agent to GCP](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-gcp) for full instructions. +See [Deploy agent to GCP](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-gcp) for full instructions. ```bash # Deploy to Cloud Run @@ -357,7 +357,7 @@ a365 setup blueprint --endpoint-only ### Messaging endpoint reference -See [Configure messaging endpoint](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-messaging-endpoint) for all hosting options. +See [Configure messaging endpoint](https://learn.microsoft.com/microsoft-agent-365/developer/agent-messaging-endpoint) for all hosting options. | Hosting | `messagingEndpoint` format | `needDeployment` | |---------|--------------------------|-----------------| @@ -389,7 +389,7 @@ After `a365 deploy` and `a365 publish` complete, the following steps require bro 4. Set **Bot ID** to your `agentBlueprintId` 5. Click **Save** -> See [Configure agent in Teams Developer Portal](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) and [Publish agent](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/publish) for full instructions. +> See [Configure agent in Teams Developer Portal](https://learn.microsoft.com/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) and [Publish agent](https://learn.microsoft.com/microsoft-agent-365/developer/publish) for full instructions. ### Step 2: Upload manifest to M365 Admin Center @@ -611,7 +611,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing @@ -626,13 +626,13 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [Google ADK API documentation](https://google.github.io/adk-docs/) -- [Configure messaging endpoint](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-messaging-endpoint) -- [Deploy agent to Azure](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) -- [Deploy agent to GCP](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-gcp) -- [Publish agent](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/publish) -- [Configure agent in Teams Developer Portal](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) -- [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=python) -- [Test your agent locally in Agents Playground](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/test-with-toolkit-project) +- [Configure messaging endpoint](https://learn.microsoft.com/microsoft-agent-365/developer/agent-messaging-endpoint) +- [Deploy agent to Azure](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) +- [Deploy agent to GCP](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-gcp) +- [Publish agent](https://learn.microsoft.com/microsoft-agent-365/developer/publish) +- [Configure agent in Teams Developer Portal](https://learn.microsoft.com/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) +- [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=python) +- [Test your agent locally in Agents Playground](https://learn.microsoft.com/microsoft-365/agents-sdk/test-with-toolkit-project) ## Trademarks diff --git a/python/observability-with-azure-monitor/README.md b/python/observability-with-azure-monitor/README.md index 650cb1f4..926c6625 100644 --- a/python/observability-with-azure-monitor/README.md +++ b/python/observability-with-azure-monitor/README.md @@ -119,7 +119,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. The sample-local `observability_token_service.py` adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow). +[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow). Blueprint credentials with `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance exchanges T1 as its client assertion for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants are diff --git a/python/observability-with-langgraph/README.md b/python/observability-with-langgraph/README.md index d41b9a5a..60f606f4 100644 --- a/python/observability-with-langgraph/README.md +++ b/python/observability-with-langgraph/README.md @@ -136,7 +136,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. The sample-local resolver adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow). +[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow). Blueprint credentials with `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance uses T1 as its client assertion for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants use diff --git a/python/observability-with-otlp/README.md b/python/observability-with-otlp/README.md index be1bf8c2..28d6900f 100644 --- a/python/observability-with-otlp/README.md +++ b/python/observability-with-otlp/README.md @@ -37,7 +37,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. The standalone `observability_token_service.py` adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): +[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint client credentials with `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance uses T1 as its client assertion for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants are diff --git a/python/openai/sample-agent/README.md b/python/openai/sample-agent/README.md index f2abcce6..2faa21ec 100644 --- a/python/openai/sample-agent/README.md +++ b/python/openai/sample-agent/README.md @@ -31,7 +31,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/en-us/microsoft-agent-365/developer/). +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/). ## Prerequisites > @@ -172,7 +172,7 @@ finally: ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](AGENT-CODE-WALKTHROUGH.md). @@ -181,7 +181,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing From 18c9231e6ddd1a1d5f9a7de8f8a2bc44d735e923 Mon Sep 17 00:00:00 2001 From: Jim Daly Date: Mon, 19 Oct 2026 16:23:40 -0700 Subject: [PATCH 3/4] Revert "Remove '/en-us' from links to learn.microsoft.com" This reverts commit 8cc525536f22921c368db4523b5b00e3e9f11433. --- .claude/skills/generate-readme/SKILL.md | 14 ++++---- CLAUDE.md | 2 +- README.md | 4 +-- .../salesforce/apex-observability/README.md | 14 ++++---- .../apex-observability/docs/design.md | 2 +- dotnet/agent-framework/sample-agent/README.md | 8 ++--- .../github-trending/sample-agent/README.md | 12 +++---- dotnet/semantic-kernel/sample-agent/README.md | 6 ++-- .../w365-computer-use/sample-agent/README.md | 8 ++--- nodejs/autonomous/github-trending/README.md | 12 +++---- nodejs/claude/quickstart-before/README.md | 2 +- nodejs/claude/sample-agent/README.md | 6 ++-- nodejs/copilot-studio/sample-agent/README.md | 8 ++--- nodejs/devin/sample-agent/README.md | 8 ++--- nodejs/langchain/quickstart-before/README.md | 4 +-- nodejs/langchain/sample-agent/README.md | 6 ++-- nodejs/n8n/sample-agent/README.md | 16 +++++----- nodejs/openai/sample-agent/README.md | 6 ++-- nodejs/perplexity/sample-agent/README.md | 6 ++-- nodejs/vercel-sdk/sample-agent/README.md | 6 ++-- prompts/Cursor IDE Prompt.md | 20 ++++++------ python/agent-framework/sample-agent/README.md | 6 ++-- python/autonomous/github-trending/README.md | 12 +++---- python/claude/sample-agent/README.md | 8 ++--- python/crewai/sample_agent/README.md | 4 +-- python/google-adk/sample-agent/README.md | 32 +++++++++---------- .../README.md | 2 +- python/observability-with-langgraph/README.md | 2 +- python/observability-with-otlp/README.md | 2 +- python/openai/sample-agent/README.md | 6 ++-- 30 files changed, 122 insertions(+), 122 deletions(-) diff --git a/.claude/skills/generate-readme/SKILL.md b/.claude/skills/generate-readme/SKILL.md index cbe406d8..1566bb32 100644 --- a/.claude/skills/generate-readme/SKILL.md +++ b/.claude/skills/generate-readme/SKILL.md @@ -34,7 +34,7 @@ The README MUST contain the following sections in this exact order. Do not add, <1–3 sentence description of what the sample demonstrates. State whether it is interactive or autonomous, what SDK/orchestrator it uses, and what makes it a useful reference.> -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ``` ### 2. What This Sample Demonstrates @@ -56,7 +56,7 @@ A table of patterns demonstrated and their file locations: - - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role - @@ -125,7 +125,7 @@ For Python and Node.js samples, include `ENABLE_A365_OBSERVABILITY_EXPORTER`, `E ``` -For interactive agents, reference the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing) guide and Microsoft 365 Agents Playground. +For interactive agents, reference the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing) guide and Microsoft 365 Agents Playground. ### 7. Deploying the Agent @@ -143,7 +143,7 @@ For interactive agents, reference the [Configure Agent Testing](https://learn.mi ``` -Keep this section concise — no ASCII art diagrams. Reference the [Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability) for details. +Keep this section concise — no ASCII art diagrams. Reference the [Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability) for details. ### 9. Support @@ -153,7 +153,7 @@ Keep this section concise — no ASCII art diagrams. Reference the [Agent observ For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ``` @@ -174,8 +174,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ```markdown ## 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 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) - - ``` diff --git a/CLAUDE.md b/CLAUDE.md index 5bd6050b..9675824d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -270,5 +270,5 @@ For language-specific design patterns, see: ## Official Documentation -- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - [Microsoft 365 Agents SDK Documentation](https://learn.microsoft.com/microsoft-365/agents-sdk/) diff --git a/README.md b/README.md index 64c4d71b..050b7c09 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ compatible SDK releases. Legacy Node.js samples pin their tested SDK family to preserve compatible tracing APIs and S2S exporter options. > #### Note: -> Use the information in this README to contribute to this open-source project. To learn about using this SDK in your projects, refer to the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +> Use the information in this README to contribute to this open-source project. To learn about using this SDK in your projects, refer to the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ## Survey @@ -44,7 +44,7 @@ This samples repository is currently in active development and contains: ## Documentation -For comprehensive documentation and guides, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +For comprehensive documentation and guides, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ### Microsoft Agent 365 SDK diff --git a/agent-platforms/salesforce/apex-observability/README.md b/agent-platforms/salesforce/apex-observability/README.md index 9d9db726..039c7028 100644 --- a/agent-platforms/salesforce/apex-observability/README.md +++ b/agent-platforms/salesforce/apex-observability/README.md @@ -12,7 +12,7 @@ description: "Emit native Agent 365 telemetry from Salesforce Apex with correlat # Salesforce Apex — Native Agent 365 Observability -This sample shows how **Salesforce Apex** can participate in [Microsoft Agent 365](https://learn.microsoft.com/microsoft-agent-365/developer/) +This sample shows how **Salesforce Apex** can participate in [Microsoft Agent 365](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) observability as a **first-class telemetry emitter**. When an Agent 365 agent calls into Salesforce (or an Agentforce agent runs a Salesforce action), the Apex code emits its **own** Agent 365 OTLP spans — correlated to the agent turn by a shared W3C trace id — so Salesforce proves it ran from @@ -31,7 +31,7 @@ identity, audience, registration and service policy instead of switching to OBO or automatically adding OBS permissions. Apex runtime tests require an authorized Salesforce test org; an offline source audit is not live authorization validation. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -107,7 +107,7 @@ for the exact per-hop requests and Named Credentials. via a Dev Hub, or a Developer Edition org) - An Entra tenant onboarded to Agent 365, with at minimum the **Agent ID Developer** role - An Agent 365 **agent** and its **blueprint** app registration (the blueprint sponsors the FMI chain). - See the [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) + See the [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (`a365 setup all`) for provisioning the blueprint + agent identity. ## Project Layout @@ -264,12 +264,12 @@ trace. `A365ObsSpan` emits the Agent 365 exporter wire shape exactly — see [OTLP wire shape](docs/design.md#otlp-wire-shape) for the field-level contract. For details on the observability SDK and instrumentation patterns, see the -[Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability). +[Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). ## Support - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../SECURITY.md) ## Contributing @@ -288,8 +288,8 @@ or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any addi ## 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 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) - [Design notes](docs/design.md) ## Trademarks diff --git a/agent-platforms/salesforce/apex-observability/docs/design.md b/agent-platforms/salesforce/apex-observability/docs/design.md index f2564f1d..7aff522e 100644 --- a/agent-platforms/salesforce/apex-observability/docs/design.md +++ b/agent-platforms/salesforce/apex-observability/docs/design.md @@ -54,7 +54,7 @@ Dependency direction (no cycles): > **Background:** this uses Microsoft Entra **Agent ID** — an agent identity blueprint plus Federated > Managed Identity (FMI) and the `jwt-bearer` grant. For the identity model and OAuth grant types, see -> [Microsoft Entra Agent ID — Agent OAuth flows](https://learn.microsoft.com/entra/agent-id/agent-on-behalf-of-oauth-flow). +> [Microsoft Entra Agent ID — Agent OAuth flows](https://learn.microsoft.com/en-us/entra/agent-id/agent-on-behalf-of-oauth-flow). > The steps below show only what the Apex sample sends on the wire. MSAL is unavailable in Apex, so each hop is a raw `application/x-www-form-urlencoded` POST. The ingest diff --git a/dotnet/agent-framework/sample-agent/README.md b/dotnet/agent-framework/sample-agent/README.md index b64ef8b8..4dfc2596 100644 --- a/dotnet/agent-framework/sample-agent/README.md +++ b/dotnet/agent-framework/sample-agent/README.md @@ -30,7 +30,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -163,7 +163,7 @@ through user secrets, or `Agent365Observability__BlueprintClientSecret` through All settings support the standard .NET double-underscore environment syntax. Never commit secrets. The [sample-local OBS provider](Observability/ObservabilityAppTokenProvider.cs) uses the -[documented app-only flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): +[documented app-only flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint `client_credentials` with `fmi_path=AgentId` and `api://AzureADTokenExchange/.default` produces T1; agent `client_credentials` uses T1 as `client_assertion` for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. The existing autonomous sample uses the same @@ -241,7 +241,7 @@ Set this in your local launch profile, deployment environment, or container conf ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](Agent-Code-Walkthrough.md). @@ -250,7 +250,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-dotnet/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/dotnet/autonomous/github-trending/sample-agent/README.md b/dotnet/autonomous/github-trending/sample-agent/README.md index e673ff19..a47c9d3b 100644 --- a/dotnet/autonomous/github-trending/sample-agent/README.md +++ b/dotnet/autonomous/github-trending/sample-agent/README.md @@ -16,7 +16,7 @@ This sample demonstrates a **purely autonomous agent** built with the Microsoft Every 60 seconds, the agent prompts Azure OpenAI to fetch trending GitHub repositories using a registered tool. The model calls the `GetTrendingRepositories` tool, which queries the GitHub Search API, then summarizes the results into a readable digest that is logged to the console. All operations are **manually instrumented** with Agent 365 observability using the tracing scopes (`InvokeAgentScope`, `InferenceScope`, `ExecuteToolScope`), making this a useful reference for instrumenting any non-interactive or custom agent loop. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -34,7 +34,7 @@ For comprehensive documentation, visit the [Microsoft Agent 365 Developer Docume - [.NET 9.0 SDK](https://dotnet.microsoft.com/download/dotnet/9.0) or higher - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role @@ -156,14 +156,14 @@ Each autonomous cycle produces three nested spans: an `InvokeAgentScope` wrappin The `ObservabilityTokenService` acquires tokens for the A365 exporter via a 3-hop FMI chain: the blueprint authenticates (MSI in production, client secret locally), exchanges for a T1 token targeting the agent identity via `.WithFmiPath`, then the agent identity uses T1 as an assertion to acquire an Observability API token. This token is cached in `ServiceTokenCache` and refreshed every 50 minutes. `UseManagedIdentity: true` in `appsettings.json` controls whether the managed identity path or the client secret path is used. -For details on the observability SDK and instrumentation patterns, see the [Agent observability guide](https://learn.microsoft.com/microsoft-agent-365/developer/observability). +For details on the observability SDK and instrumentation patterns, see the [Agent observability guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ## Contributing @@ -176,8 +176,8 @@ 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 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 698fd88b..556a72cf 100644 --- a/dotnet/semantic-kernel/sample-agent/README.md +++ b/dotnet/semantic-kernel/sample-agent/README.md @@ -27,7 +27,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -148,7 +148,7 @@ Typing indicators show a `...` animation in Teams while the agent is working. Th ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=dotnet) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](Agent-Code-Walkthrough.md). @@ -157,7 +157,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-dotnet/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/dotnet/w365-computer-use/sample-agent/README.md b/dotnet/w365-computer-use/sample-agent/README.md index 78a7c9b4..d29d988e 100644 --- a/dotnet/w365-computer-use/sample-agent/README.md +++ b/dotnet/w365-computer-use/sample-agent/README.md @@ -55,7 +55,7 @@ Response to User - Azure OpenAI resource with a CUA-capable model deployment: - `computer-use-preview` or `gpt-5.4` / `gpt-5.4-mini` - [Request access to gpt-5.4](https://aka.ms/OAI/gpt54access) if needed -- Access to the W365 Computer Use MCP server (via [Agent 365 MCP Platform](https://learn.microsoft.com/microsoft-agent-365/developer/)) +- Access to the W365 Computer Use MCP server (via [Agent 365 MCP Platform](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/)) - A bearer token with `Tools.ListInvoke.All` scope ## Setup @@ -189,7 +189,7 @@ client ID. For local development use `UseManagedIdentity=false` and supply `Agent365Observability__BlueprintClientSecret` through the environment. All keys support the .NET double-underscore environment format. Do not store a secret in checked-in configuration. -The sample-local provider implements the [documented app-only token flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): +The sample-local provider implements the [documented app-only token flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint `client_credentials` with `fmi_path=AgentId` and `api://AzureADTokenExchange/.default` produces T1; agent `client_credentials` uses T1 as `client_assertion` for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. No user token, `user_fic`, or OBO is used for OBS. @@ -425,6 +425,6 @@ The in-memory handoff store is single-process. If the web app is scaled out to m ## Links -- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - [Microsoft 365 Agents SDK](https://learn.microsoft.com/microsoft-365/agents-sdk/) -- [Azure OpenAI Computer Use Guide](https://learn.microsoft.com/azure/foundry-classic/openai/how-to/computer-use) +- [Azure OpenAI Computer Use Guide](https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/computer-use) diff --git a/nodejs/autonomous/github-trending/README.md b/nodejs/autonomous/github-trending/README.md index 280d6bbb..5842d82e 100644 --- a/nodejs/autonomous/github-trending/README.md +++ b/nodejs/autonomous/github-trending/README.md @@ -23,7 +23,7 @@ Every 60 seconds, the agent: All operations are **manually instrumented** with Agent 365 observability using the A365 Observability SDK tracing scopes (`InvokeAgentScope`, `InferenceScope`, `ExecuteToolScope`). This makes it a useful reference for instrumenting any non-interactive or custom agent loop. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -41,7 +41,7 @@ For comprehensive documentation, visit the [Microsoft Agent 365 Developer Docume - [Node.js 18](https://nodejs.org/) or higher - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role @@ -203,14 +203,14 @@ Production (MSI): The token is refreshed every 50 minutes and cached in `token-cache.ts`. -For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/microsoft-agent-365/developer/observability). +For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ## Contributing @@ -225,8 +225,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) -- [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 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/nodejs/claude/quickstart-before/README.md b/nodejs/claude/quickstart-before/README.md index b2d23051..fb2758d0 100644 --- a/nodejs/claude/quickstart-before/README.md +++ b/nodejs/claude/quickstart-before/README.md @@ -105,7 +105,7 @@ npm run start:anon ## Documentation - [Claude Agent SDK](https://docs.claude.com/en/docs/agent-sdk/typescript) -- [Microsoft 365 Agents SDK](https://learn.microsoft.com/microsoft-365/agents-sdk/) +- [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) ## License diff --git a/nodejs/claude/sample-agent/README.md b/nodejs/claude/sample-agent/README.md index 9a4f4272..154ce75a 100644 --- a/nodejs/claude/sample-agent/README.md +++ b/nodejs/claude/sample-agent/README.md @@ -29,7 +29,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites > @@ -243,7 +243,7 @@ OTEL_SERVICE_NAME=Claude Sample Agent ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Troubleshooting @@ -313,7 +313,7 @@ AADSTS7000216: 'client_assertion', 'client_secret' or 'request' is required For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/copilot-studio/sample-agent/README.md b/nodejs/copilot-studio/sample-agent/README.md index acc392a4..96c40ec5 100644 --- a/nodejs/copilot-studio/sample-agent/README.md +++ b/nodejs/copilot-studio/sample-agent/README.md @@ -108,7 +108,7 @@ Users must have access to chat with your Copilot Studio agent: > **Note:** Individual users cannot be granted access directly—you must use security groups or organization-wide sharing. Authentication must be configured with **Microsoft Entra ID** and **"Require users to sign in"** enabled. -For more details, see [Share agents with other users](https://learn.microsoft.com/microsoft-copilot-studio/admin-share-bots). +For more details, see [Share agents with other users](https://learn.microsoft.com/en-us/microsoft-copilot-studio/admin-share-bots). ### 3. Microsoft 365 Copilot License Requirement @@ -334,8 +334,8 @@ for await (const activity of client.sendActivityStreaming(userActivity)) { For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) -- **Copilot Studio**: See [Copilot Studio documentation](https://learn.microsoft.com/microsoft-copilot-studio/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) +- **Copilot Studio**: See [Copilot Studio documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/) - **Security**: For security issues, please see [SECURITY.md](../../../SECURITY.md) ## Contributing @@ -350,7 +350,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [@microsoft/agents-copilotstudio-client package](https://github.com/microsoft/Agents-for-js/tree/main/packages/agents-copilotstudio-client) -- [Copilot Studio documentation](https://learn.microsoft.com/microsoft-copilot-studio/) +- [Copilot Studio documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) ## Trademarks diff --git a/nodejs/devin/sample-agent/README.md b/nodejs/devin/sample-agent/README.md index 9497f11a..2a9d5d58 100644 --- a/nodejs/devin/sample-agent/README.md +++ b/nodejs/devin/sample-agent/README.md @@ -27,7 +27,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -129,18 +129,18 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Deploying the Agent -Refer to the [Deploy and publish agents](https://learn.microsoft.com/microsoft-agent-365/developer/publish-deploy-agent?tabs=nodejs) guide for complete instructions. +Refer to the [Deploy and publish agents](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/publish-deploy-agent?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/langchain/quickstart-before/README.md b/nodejs/langchain/quickstart-before/README.md index ef9da0d0..660eec72 100644 --- a/nodejs/langchain/quickstart-before/README.md +++ b/nodejs/langchain/quickstart-before/README.md @@ -4,8 +4,8 @@ This directory contains a quickstart agent implementation using Node.js and Lang ## Demonstrates -This sample is used to demonstrate how to build an agent using the Microsoft Agent 365 SDK with Node.js and LangChain. The sample includes basic LangChain Agent SDK usage hosted with Agents SDK that is testable on [agentsplayground](https://learn.microsoft.com/microsoft-365/agents-sdk/test-with-toolkit-project?tabs=windows). -Please refer to this [quickstart guide](https://learn.microsoft.com/microsoft-agent-365/developer/quickstart-nodejs-langchain) on how to extend your agent using Microsoft Agent 365 SDK. +This sample is used to demonstrate how to build an agent using the Microsoft Agent 365 SDK with Node.js and LangChain. The sample includes basic LangChain Agent SDK usage hosted with Agents SDK that is testable on [agentsplayground](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/test-with-toolkit-project?tabs=windows). +Please refer to this [quickstart guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/quickstart-nodejs-langchain) on how to extend your agent using Microsoft Agent 365 SDK. ## Prerequisites diff --git a/nodejs/langchain/sample-agent/README.md b/nodejs/langchain/sample-agent/README.md index 9e1ea005..3baf7fde 100644 --- a/nodejs/langchain/sample-agent/README.md +++ b/nodejs/langchain/sample-agent/README.md @@ -30,7 +30,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites > @@ -144,7 +144,7 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](Agent-Code-Walkthrough.md). ## Support @@ -152,7 +152,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../SECURITY.md) ## Contributing diff --git a/nodejs/n8n/sample-agent/README.md b/nodejs/n8n/sample-agent/README.md index 3023fdad..4cdd6a08 100644 --- a/nodejs/n8n/sample-agent/README.md +++ b/nodejs/n8n/sample-agent/README.md @@ -58,7 +58,7 @@ This guide will walk you through creating an Agent 365 using n8n's Microsoft Age #### Step 1: Create Agent Blueprint Create your agent identity in the Microsoft Teams Developer Portal: -- Follow the [Agent Identity Blueprint guide](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#agent-identity-blueprint) +- Follow the [Agent Identity Blueprint guide](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#agent-identity-blueprint) #### Step 2: Publish to Microsoft Admin Center @@ -74,12 +74,12 @@ Publish your agent for administrative management: Configure authentication credentials: - Navigate to your app registration in the Azure Portal -- Follow the [credentials guide](https://learn.microsoft.com/entra/identity-platform/how-to-add-credentials?tabs=client-secret) to add a client secret +- Follow the [credentials guide](https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-credentials?tabs=client-secret) to add a client secret - Copy the **Client Secret** value (you'll only see this once) OR -Follow the [documentation](https://learn.microsoft.com/graph/api/agentidentityblueprint-addpassword?view=graph-rest-beta) to add and see the client secret. You can also run the following powershell script, replacing your TenantID with your tenant's id and the applicationID with your blueprint id. +Follow the [documentation](https://learn.microsoft.com/en-us/graph/api/agentidentityblueprint-addpassword?view=graph-rest-beta) to add and see the client secret. You can also run the following powershell script, replacing your TenantID with your tenant's id and the applicationID with your blueprint id. ```powershell Connect-MgGraph -Scopes "AgentIdentityBlueprint.AddRemoveCreds.All" -TenantId @@ -104,7 +104,7 @@ Write-Host "Secret Text: $($response.secretText)" #### Step 4: Grant Permissions for Agent -Grant your Agent Blueprint access to Microsoft 365 by following the [agent access guide](https://learn.microsoft.com/entra/agent-id/identity-professional/grant-agent-access-microsoft-365). You must also [enable inheritable permissions](https://learn.microsoft.com/entra/agent-id/identity-professional/configure-inheritable-permissions-blueprints) to allow the agent to act on behalf of users. +Grant your Agent Blueprint access to Microsoft 365 by following the [agent access guide](https://learn.microsoft.com/en-us/entra/agent-id/identity-professional/grant-agent-access-microsoft-365). You must also [enable inheritable permissions](https://learn.microsoft.com/en-us/entra/agent-id/identity-professional/configure-inheritable-permissions-blueprints) to allow the agent to act on behalf of users. Consent for the required scopes can be given as shown below, just replace your tenant id, and blueprint id in the specified places: @@ -171,13 +171,13 @@ For n8n workflow creation guidance, see the [n8n documentation](https://docs.n8n #### Step 6: Configure Backend URL Connect your agent blueprint to the n8n workflow: -- Return to the [Microsoft Teams Developer Portal](https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#configure-the-agent-identity-blueprint) +- Return to the [Microsoft Teams Developer Portal](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/manage-your-apps-in-developer-portal#configure-the-agent-identity-blueprint) - Navigate to your Agent Blueprint → **Configuration** - Select **API Based** as the configuration type - Set the **Backend URL** to your n8n workflow's webhook URL from Step 5 #### Step 7: Hire an agent as a digital worker -- Follow the [documentation](https://learn.microsoft.com/microsoft-agent-365/onboard) to hire an agent as a digital worker +- Follow the [documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/onboard) to hire an agent as a digital worker Your agent is now ready to handle conversations through Microsoft 365! @@ -187,7 +187,7 @@ Your agent is now ready to handle conversations through Microsoft 365! For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../SECURITY.md) ## Contributing @@ -200,7 +200,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources -- [Microsoft Agent 365](https://learn.microsoft.com/microsoft-agent-365/) +- [Microsoft Agent 365](https://learn.microsoft.com/en-us/microsoft-agent-365/) - [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [n8n documentation](https://docs.n8n.io/) diff --git a/nodejs/openai/sample-agent/README.md b/nodejs/openai/sample-agent/README.md index f877e938..001637de 100644 --- a/nodejs/openai/sample-agent/README.md +++ b/nodejs/openai/sample-agent/README.md @@ -32,7 +32,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -152,14 +152,14 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/perplexity/sample-agent/README.md b/nodejs/perplexity/sample-agent/README.md index 50cd834f..ed7b03e1 100644 --- a/nodejs/perplexity/sample-agent/README.md +++ b/nodejs/perplexity/sample-agent/README.md @@ -27,7 +27,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -130,14 +130,14 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/nodejs/vercel-sdk/sample-agent/README.md b/nodejs/vercel-sdk/sample-agent/README.md index c5fd658b..ce3fe23c 100644 --- a/nodejs/vercel-sdk/sample-agent/README.md +++ b/nodejs/vercel-sdk/sample-agent/README.md @@ -29,7 +29,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [@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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -149,14 +149,14 @@ try { ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=nodejs) guide for complete instructions. ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/prompts/Cursor IDE Prompt.md b/prompts/Cursor IDE Prompt.md index d8626779..44389ce3 100644 --- a/prompts/Cursor IDE Prompt.md +++ b/prompts/Cursor IDE Prompt.md @@ -20,22 +20,22 @@ Cursor works best when you reference Microsoft Learn documentation directly in y When crafting your prompt, reference these Microsoft Learn pages by URL. Cursor will read them when you submit your prompt: -- **Agent 365 Developer Overview**: https://learn.microsoft.com/microsoft-agent-365/developer/?tabs=nodejs -- **Notifications**: https://learn.microsoft.com/microsoft-agent-365/developer/notification?tabs=nodejs -- **Tooling (MCP)**: https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=nodejs -- **Observability**: https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=nodejs -- **Node.js + Claude Quickstart**: https://learn.microsoft.com/microsoft-agent-365/developer/quickstart-nodejs-claude +- **Agent 365 Developer Overview**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/?tabs=nodejs +- **Notifications**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/notification?tabs=nodejs +- **Tooling (MCP)**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/tooling?tabs=nodejs +- **Observability**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability?tabs=nodejs +- **Node.js + Claude Quickstart**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/quickstart-nodejs-claude ## 4. Prompting Cursor Open the Composer and paste a prompt like this, including the Microsoft Learn documentation URLs: ``` Using these documentations: -https://learn.microsoft.com/microsoft-agent-365/developer/?tabs=nodejs -https://learn.microsoft.com/microsoft-agent-365/developer/notification?tabs=nodejs -https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=nodejs -https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=nodejs -https://learn.microsoft.com/microsoft-agent-365/developer/quickstart-nodejs-claude +https://learn.microsoft.com/en-us/microsoft-agent-365/developer/?tabs=nodejs +https://learn.microsoft.com/en-us/microsoft-agent-365/developer/notification?tabs=nodejs +https://learn.microsoft.com/en-us/microsoft-agent-365/developer/tooling?tabs=nodejs +https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability?tabs=nodejs +https://learn.microsoft.com/en-us/microsoft-agent-365/developer/quickstart-nodejs-claude Create a Microsoft Agent 365 agent in TypeScript with Claude as the orchestrator that can summarize unread emails and draft helpful email responses. The agent must: - Receive a user message diff --git a/python/agent-framework/sample-agent/README.md b/python/agent-framework/sample-agent/README.md index 193e818e..93036df4 100644 --- a/python/agent-framework/sample-agent/README.md +++ b/python/agent-framework/sample-agent/README.md @@ -32,7 +32,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites > @@ -167,7 +167,7 @@ Each `send_activity` call produces a separate Teams message. You can call it as ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](AGENT-CODE-WALKTHROUGH.md). @@ -176,7 +176,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing diff --git a/python/autonomous/github-trending/README.md b/python/autonomous/github-trending/README.md index 572fa232..fd1c19b0 100644 --- a/python/autonomous/github-trending/README.md +++ b/python/autonomous/github-trending/README.md @@ -23,7 +23,7 @@ Every 60 seconds, the agent: All operations are **manually instrumented** with Agent 365 observability using the A365 Observability SDK tracing scopes (`InvokeAgentScope`, `InferenceScope`, `ExecuteToolScope`). This makes it a useful reference for instrumenting any non-interactive or custom agent loop. -For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/). +For comprehensive documentation, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/). ## What This Sample Demonstrates @@ -40,7 +40,7 @@ For comprehensive documentation, visit the [Microsoft Agent 365 Developer Docume - Python 3.11 or higher - [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) -- [Agent 365 CLI](https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) +- [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) (install: `dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease`) - An Azure OpenAI resource with a deployed model (e.g., `gpt-4o`) - An Entra tenant with at minimum the **Agent ID Developer** role @@ -190,14 +190,14 @@ Production (MSI): The token is refreshed every 50 minutes and cached in `token_cache.py`. -For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/microsoft-agent-365/developer/observability). +For more details, see [Agent observability — Microsoft Learn](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/observability). ## Support For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-Samples/issues) section -- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](../../../../SECURITY.md) ## Contributing @@ -211,8 +211,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources - [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) -- [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 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/python/claude/sample-agent/README.md b/python/claude/sample-agent/README.md index 8411bddd..12c7f27d 100644 --- a/python/claude/sample-agent/README.md +++ b/python/claude/sample-agent/README.md @@ -31,7 +31,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -143,7 +143,7 @@ finally: For detailed setup and running instructions, please refer to the official documentation: -- **[Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/)** - Complete setup and testing guide +- **[Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/)** - Complete setup and testing guide - **[AGENT-CODE-WALKTHROUGH.md](AGENT-CODE-WALKTHROUGH.md)** - Detailed code explanation and architecture walkthrough ## Architecture @@ -237,7 +237,7 @@ MCP tools require proper Azure authentication: For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) ## Contributing @@ -250,7 +250,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Resources - [Claude Agent SDK](https://anthropic.mintlify.app/en/api/agent-sdk/overview) -- [Microsoft 365 Agents SDK](https://learn.microsoft.com/microsoft-365/agents-sdk/) +- [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) ## Trademarks diff --git a/python/crewai/sample_agent/README.md b/python/crewai/sample_agent/README.md index 5e5c253e..0cf027c3 100644 --- a/python/crewai/sample_agent/README.md +++ b/python/crewai/sample_agent/README.md @@ -35,7 +35,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites @@ -310,7 +310,7 @@ For issues, questions, or feedback: - **CrewAI Documentation**: https://docs.crewai.com - **CrewAI GitHub**: https://github.com/joaomdmoura/crewai -- **Microsoft Agent 365 Documentation**: https://learn.microsoft.com/microsoft-agent-365/developer/ +- **Microsoft Agent 365 Documentation**: https://learn.microsoft.com/en-us/microsoft-agent-365/developer/ - **Discord**: https://discord.com/invite/X4JWnZnxPb ## Contributing diff --git a/python/google-adk/sample-agent/README.md b/python/google-adk/sample-agent/README.md index ea6f35c8..f0d93dfa 100644 --- a/python/google-adk/sample-agent/README.md +++ b/python/google-adk/sample-agent/README.md @@ -29,7 +29,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Observability S2S export @@ -62,7 +62,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. `observability_token_service.py` adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): +[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint credentials + `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance uses T1 as its client assertion to request `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants are @@ -137,7 +137,7 @@ The fastest way is the **AI-guided setup** — attach the instruction file to Gi Follow the steps in #file:a365-setup-instructions.md ``` -> See [AI-guided setup for Agent 365](https://learn.microsoft.com/microsoft-agent-365/developer/ai-guided-setup) for full instructions and to download `a365-setup-instructions.md`. +> See [AI-guided setup for Agent 365](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/ai-guided-setup) for full instructions and to download `a365-setup-instructions.md`. Alternatively, run the CLI manually: @@ -248,7 +248,7 @@ agentsplayground -e "http://localhost:3978/api/messages" -c "emulator" \ Run `agentsplayground --help` for all options. -> For full setup documentation see [Test your agent locally in Agents Playground](https://learn.microsoft.com/microsoft-365/agents-sdk/test-with-toolkit-project). +> For full setup documentation see [Test your agent locally in Agents Playground](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/test-with-toolkit-project). ### Testing checklist @@ -291,7 +291,7 @@ a365 publish ### Running on Azure App Service -See [Deploy agent to Azure](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) for full instructions. +See [Deploy agent to Azure](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) for full instructions. Set `messagingEndpoint` in `a365.config.json` to your Azure Web App URL and `"needDeployment": true` (see [configuration reference above](#3-initialize-a365-configuration)). @@ -331,7 +331,7 @@ All values below come from `a365.config.json` and `a365.generated.config.json` ( ### Running on GCP (Cloud Run) -See [Deploy agent to GCP](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-gcp) for full instructions. +See [Deploy agent to GCP](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-gcp) for full instructions. ```bash # Deploy to Cloud Run @@ -357,7 +357,7 @@ a365 setup blueprint --endpoint-only ### Messaging endpoint reference -See [Configure messaging endpoint](https://learn.microsoft.com/microsoft-agent-365/developer/agent-messaging-endpoint) for all hosting options. +See [Configure messaging endpoint](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-messaging-endpoint) for all hosting options. | Hosting | `messagingEndpoint` format | `needDeployment` | |---------|--------------------------|-----------------| @@ -389,7 +389,7 @@ After `a365 deploy` and `a365 publish` complete, the following steps require bro 4. Set **Bot ID** to your `agentBlueprintId` 5. Click **Save** -> See [Configure agent in Teams Developer Portal](https://learn.microsoft.com/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) and [Publish agent](https://learn.microsoft.com/microsoft-agent-365/developer/publish) for full instructions. +> See [Configure agent in Teams Developer Portal](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) and [Publish agent](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/publish) for full instructions. ### Step 2: Upload manifest to M365 Admin Center @@ -611,7 +611,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing @@ -626,13 +626,13 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [Google ADK API documentation](https://google.github.io/adk-docs/) -- [Configure messaging endpoint](https://learn.microsoft.com/microsoft-agent-365/developer/agent-messaging-endpoint) -- [Deploy agent to Azure](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) -- [Deploy agent to GCP](https://learn.microsoft.com/microsoft-agent-365/developer/deploy-agent-gcp) -- [Publish agent](https://learn.microsoft.com/microsoft-agent-365/developer/publish) -- [Configure agent in Teams Developer Portal](https://learn.microsoft.com/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) -- [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=python) -- [Test your agent locally in Agents Playground](https://learn.microsoft.com/microsoft-365/agents-sdk/test-with-toolkit-project) +- [Configure messaging endpoint](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-messaging-endpoint) +- [Deploy agent to Azure](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-azure?tabs=dotnet) +- [Deploy agent to GCP](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/deploy-agent-gcp) +- [Publish agent](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/publish) +- [Configure agent in Teams Developer Portal](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/create-instance#1-configure-agent-in-teams-developer-portal) +- [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=python) +- [Test your agent locally in Agents Playground](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/test-with-toolkit-project) ## Trademarks diff --git a/python/observability-with-azure-monitor/README.md b/python/observability-with-azure-monitor/README.md index 926c6625..650cb1f4 100644 --- a/python/observability-with-azure-monitor/README.md +++ b/python/observability-with-azure-monitor/README.md @@ -119,7 +119,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. The sample-local `observability_token_service.py` adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow). +[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow). Blueprint credentials with `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance exchanges T1 as its client assertion for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants are diff --git a/python/observability-with-langgraph/README.md b/python/observability-with-langgraph/README.md index 60f606f4..d41b9a5a 100644 --- a/python/observability-with-langgraph/README.md +++ b/python/observability-with-langgraph/README.md @@ -136,7 +136,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. The sample-local resolver adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow). +[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow). Blueprint credentials with `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance uses T1 as its client assertion for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants use diff --git a/python/observability-with-otlp/README.md b/python/observability-with-otlp/README.md index 28d6900f..be1bf8c2 100644 --- a/python/observability-with-otlp/README.md +++ b/python/observability-with-otlp/README.md @@ -37,7 +37,7 @@ Absent or empty `roles` are accepted only with `idtyp=app`, or without `idtyp` w `idtyp`; any `scp` claim is rejected. The standalone `observability_token_service.py` adapts the autonomous sample's -[two-step FMI flow](https://learn.microsoft.com/entra/agent-id/autonomous-agent-authentication-authorization-flow): +[two-step FMI flow](https://learn.microsoft.com/en-us/entra/agent-id/autonomous-agent-authentication-authorization-flow): blueprint client credentials with `fmi_path=agent instance client ID` acquire T1 for `api://AzureADTokenExchange/.default`; the instance uses T1 as its client assertion for `api://9b975845-388f-4429-889e-eab1ef63949c/.default`. Both grants are diff --git a/python/openai/sample-agent/README.md b/python/openai/sample-agent/README.md index 2faa21ec..f2abcce6 100644 --- a/python/openai/sample-agent/README.md +++ b/python/openai/sample-agent/README.md @@ -31,7 +31,7 @@ This sample uses the following Microsoft Agents and Agent 365 packages: - [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/). +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/en-us/microsoft-agent-365/developer/). ## Prerequisites > @@ -172,7 +172,7 @@ finally: ## Running the Agent -To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. +To set up and test this agent, refer to the [Configure Agent Testing](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/testing?tabs=python) guide for complete instructions. For a detailed explanation of the agent code and implementation, see the [Agent Code Walkthrough](AGENT-CODE-WALKTHROUGH.md). @@ -181,7 +181,7 @@ For a detailed explanation of the agent code and implementation, see the [Agent For issues, questions, or feedback: - **Issues**: Please file issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section -- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/microsoft-agent-365/developer/) +- **Documentation**: See the [Microsoft Agents 365 Developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) - **Security**: For security issues, please see [SECURITY.md](SECURITY.md) ## Contributing From 07ebdcaa4c82defff05a180b29afa5af8d6b5a3b Mon Sep 17 00:00:00 2001 From: Jim Daly Date: Mon, 19 Oct 2026 16:37:45 -0700 Subject: [PATCH 4/4] restore links to Microsoft Agent 365 SDK repositories in sample README files Additional Resources sections --- dotnet/agent-framework/sample-agent/README.md | 1 + dotnet/autonomous/github-trending/sample-agent/README.md | 1 + dotnet/semantic-kernel/sample-agent/README.md | 1 + nodejs/claude/sample-agent/README.md | 1 + nodejs/copilot-studio/sample-agent/README.md | 1 + nodejs/devin/sample-agent/README.md | 1 + nodejs/langchain/sample-agent/README.md | 1 + nodejs/openai/sample-agent/README.md | 1 + nodejs/perplexity/sample-agent/README.md | 1 + nodejs/vercel-sdk/sample-agent/README.md | 1 + python/agent-framework/sample-agent/README.md | 1 + python/crewai/sample_agent/README.md | 1 + python/google-adk/sample-agent/README.md | 1 + python/openai/sample-agent/README.md | 1 + 14 files changed, 14 insertions(+) diff --git a/dotnet/agent-framework/sample-agent/README.md b/dotnet/agent-framework/sample-agent/README.md index 4dfc2596..38f2355e 100644 --- a/dotnet/agent-framework/sample-agent/README.md +++ b/dotnet/agent-framework/sample-agent/README.md @@ -263,6 +263,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - .NET repository](https://github.com/microsoft/Agent365-dotnet) - [Microsoft 365 Agents SDK - .NET repository](https://github.com/Microsoft/Agents-for-net) - [Semantic Kernel documentation](https://learn.microsoft.com/semantic-kernel/) - [.NET API documentation](https://learn.microsoft.com/dotnet/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/dotnet/autonomous/github-trending/sample-agent/README.md b/dotnet/autonomous/github-trending/sample-agent/README.md index a47c9d3b..9ee81d5e 100644 --- a/dotnet/autonomous/github-trending/sample-agent/README.md +++ b/dotnet/autonomous/github-trending/sample-agent/README.md @@ -176,6 +176,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [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) diff --git a/dotnet/semantic-kernel/sample-agent/README.md b/dotnet/semantic-kernel/sample-agent/README.md index 556a72cf..2ffd4fd0 100644 --- a/dotnet/semantic-kernel/sample-agent/README.md +++ b/dotnet/semantic-kernel/sample-agent/README.md @@ -170,6 +170,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - .NET repository](https://github.com/microsoft/Agent365-dotnet) - [Microsoft 365 Agents SDK - .NET repository](https://github.com/Microsoft/Agents-for-net) - [Semantic Kernel documentation](https://learn.microsoft.com/semantic-kernel/) - [.NET API documentation](https://learn.microsoft.com/dotnet/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/claude/sample-agent/README.md b/nodejs/claude/sample-agent/README.md index 154ce75a..a0fc83ff 100644 --- a/nodejs/claude/sample-agent/README.md +++ b/nodejs/claude/sample-agent/README.md @@ -326,6 +326,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Claude API documentation](https://docs.anthropic.com/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/copilot-studio/sample-agent/README.md b/nodejs/copilot-studio/sample-agent/README.md index 96c40ec5..50ae3045 100644 --- a/nodejs/copilot-studio/sample-agent/README.md +++ b/nodejs/copilot-studio/sample-agent/README.md @@ -348,6 +348,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [@microsoft/agents-copilotstudio-client package](https://github.com/microsoft/Agents-for-js/tree/main/packages/agents-copilotstudio-client) - [Copilot Studio documentation](https://learn.microsoft.com/en-us/microsoft-copilot-studio/) diff --git a/nodejs/devin/sample-agent/README.md b/nodejs/devin/sample-agent/README.md index 2a9d5d58..f9d7ce21 100644 --- a/nodejs/devin/sample-agent/README.md +++ b/nodejs/devin/sample-agent/README.md @@ -153,6 +153,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Devin API documentation](https://docs.devin.ai/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/langchain/sample-agent/README.md b/nodejs/langchain/sample-agent/README.md index 3baf7fde..8bce8f3c 100644 --- a/nodejs/langchain/sample-agent/README.md +++ b/nodejs/langchain/sample-agent/README.md @@ -165,6 +165,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [LangChain documentation](https://js.langchain.com/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/openai/sample-agent/README.md b/nodejs/openai/sample-agent/README.md index 001637de..735f0ea7 100644 --- a/nodejs/openai/sample-agent/README.md +++ b/nodejs/openai/sample-agent/README.md @@ -172,6 +172,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [OpenAI API documentation](https://platform.openai.com/docs/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/perplexity/sample-agent/README.md b/nodejs/perplexity/sample-agent/README.md index ed7b03e1..4d07893a 100644 --- a/nodejs/perplexity/sample-agent/README.md +++ b/nodejs/perplexity/sample-agent/README.md @@ -150,6 +150,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Perplexity API documentation](https://docs.perplexity.ai/) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/nodejs/vercel-sdk/sample-agent/README.md b/nodejs/vercel-sdk/sample-agent/README.md index ce3fe23c..4bebeb53 100644 --- a/nodejs/vercel-sdk/sample-agent/README.md +++ b/nodejs/vercel-sdk/sample-agent/README.md @@ -169,6 +169,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Node.js repository](https://github.com/microsoft/Agent365-nodejs) - [Microsoft 365 Agents SDK - Node.js repository](https://github.com/Microsoft/Agents-for-js) - [Vercel AI SDK documentation](https://sdk.vercel.ai/docs) - [Node.js API documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/python/agent-framework/sample-agent/README.md b/python/agent-framework/sample-agent/README.md index 93036df4..6954a800 100644 --- a/python/agent-framework/sample-agent/README.md +++ b/python/agent-framework/sample-agent/README.md @@ -189,6 +189,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [Agent Framework documentation](https://github.com/microsoft/Agent365-python/tree/main/packages/agent-framework) - [Python API documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/python/crewai/sample_agent/README.md b/python/crewai/sample_agent/README.md index 0cf027c3..54c49b3e 100644 --- a/python/crewai/sample_agent/README.md +++ b/python/crewai/sample_agent/README.md @@ -323,6 +323,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [CrewAI API documentation](https://docs.crewai.com) - [Python API documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true) diff --git a/python/google-adk/sample-agent/README.md b/python/google-adk/sample-agent/README.md index f0d93dfa..9e231f75 100644 --- a/python/google-adk/sample-agent/README.md +++ b/python/google-adk/sample-agent/README.md @@ -624,6 +624,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [Google ADK API documentation](https://google.github.io/adk-docs/) - [Configure messaging endpoint](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-messaging-endpoint) diff --git a/python/openai/sample-agent/README.md b/python/openai/sample-agent/README.md index f2abcce6..c088386e 100644 --- a/python/openai/sample-agent/README.md +++ b/python/openai/sample-agent/README.md @@ -194,6 +194,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope ## Additional Resources +- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python) - [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python) - [OpenAI API documentation](https://platform.openai.com/docs/) - [Python API documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true)