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 7c519f8e..1842231c 100644 --- a/dotnet/agent-framework/sample-agent/README.md +++ b/dotnet/agent-framework/sample-agent/README.md @@ -23,7 +23,7 @@ It covers: This sample uses the [Microsoft Agent 365 SDK for .NET](https://github.com/microsoft/Agent365-dotnet). -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 @@ -156,7 +156,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 @@ -234,7 +234,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). @@ -243,7 +243,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 bebeaac8..fbc4a575 100644 --- a/dotnet/semantic-kernel/sample-agent/README.md +++ b/dotnet/semantic-kernel/sample-agent/README.md @@ -21,7 +21,7 @@ This sample demonstrates how to build an agent using Semantic Kernel in C#/.NET This sample uses the [Microsoft Agent 365 SDK for .NET](https://github.com/microsoft/Agent365-dotnet). -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 @@ -142,7 +142,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). @@ -151,7 +151,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 9a60b8ac..0395d6aa 100644 --- a/nodejs/claude/sample-agent/README.md +++ b/nodejs/claude/sample-agent/README.md @@ -22,7 +22,7 @@ This sample demonstrates how to build an agent using Claude in Node.js with the This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). -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 > @@ -236,7 +236,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 @@ -306,7 +306,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 39291ac9..e0e68f21 100644 --- a/nodejs/copilot-studio/sample-agent/README.md +++ b/nodejs/copilot-studio/sample-agent/README.md @@ -101,7 +101,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 @@ -327,8 +327,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 @@ -344,7 +344,7 @@ 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/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 f11d5782..463a2b84 100644 --- a/nodejs/devin/sample-agent/README.md +++ b/nodejs/devin/sample-agent/README.md @@ -21,7 +21,7 @@ This sample demonstrates how to build an agent using Devin in Node.js with the M This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). -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 @@ -123,18 +123,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 85dc060b..9e47bdf6 100644 --- a/nodejs/langchain/sample-agent/README.md +++ b/nodejs/langchain/sample-agent/README.md @@ -22,7 +22,7 @@ This sample demonstrates how to build an agent using LangChain in Node.js with t This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). -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 > @@ -136,7 +136,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 @@ -144,7 +144,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 4fe81624..0a9eabf1 100644 --- a/nodejs/n8n/sample-agent/README.md +++ b/nodejs/n8n/sample-agent/README.md @@ -46,7 +46,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 @@ -62,12 +62,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 @@ -92,7 +92,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: @@ -159,13 +159,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! @@ -175,7 +175,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 @@ -188,7 +188,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 2bfdac37..004abe1c 100644 --- a/nodejs/openai/sample-agent/README.md +++ b/nodejs/openai/sample-agent/README.md @@ -22,7 +22,7 @@ This sample demonstrates how to build an agent using OpenAI in Node.js with the This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). -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 @@ -142,14 +142,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 fba44a4e..699c66e7 100644 --- a/nodejs/perplexity/sample-agent/README.md +++ b/nodejs/perplexity/sample-agent/README.md @@ -22,7 +22,7 @@ This sample demonstrates how to build an agent using Perplexity in Node.js with This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). -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 @@ -125,14 +125,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 d1e6bae7..ad74e7ae 100644 --- a/nodejs/vercel-sdk/sample-agent/README.md +++ b/nodejs/vercel-sdk/sample-agent/README.md @@ -22,7 +22,7 @@ This sample demonstrates how to build an agent using Vercel AI SDK in Node.js wi This sample uses the [Microsoft Agent 365 SDK for Node.js](https://github.com/microsoft/Agent365-nodejs). -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 @@ -142,14 +142,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 4b4b13cc..9d67a72f 100644 --- a/python/agent-framework/sample-agent/README.md +++ b/python/agent-framework/sample-agent/README.md @@ -21,7 +21,7 @@ This sample demonstrates how to build an agent using Agent Framework in Python w This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). -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 > @@ -156,7 +156,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). @@ -165,7 +165,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 c157e2a6..f37c692e 100644 --- a/python/claude/sample-agent/README.md +++ b/python/claude/sample-agent/README.md @@ -21,7 +21,7 @@ This directory contains a sample agent implementation using Python and Anthropic This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). -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 @@ -133,7 +133,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 @@ -227,7 +227,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 @@ -240,7 +240,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/) - [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..e5cc94d5 100644 --- a/python/crewai/sample_agent/README.md +++ b/python/crewai/sample_agent/README.md @@ -25,7 +25,7 @@ This sample demonstrates how to build a multi-agent system using CrewAI while in This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). -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 @@ -300,7 +300,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 4f9581d3..395782d2 100644 --- a/python/google-adk/sample-agent/README.md +++ b/python/google-adk/sample-agent/README.md @@ -21,7 +21,7 @@ This sample demonstrates how to build an agent using Google ADK in Python with t This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). -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 @@ -54,7 +54,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 @@ -129,7 +129,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: @@ -240,7 +240,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 @@ -283,7 +283,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)). @@ -323,7 +323,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 @@ -349,7 +349,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` | |---------|--------------------------|-----------------| @@ -381,7 +381,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 @@ -603,7 +603,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 @@ -619,13 +619,13 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope - [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) -- [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 f88b5f38..6cecc7a7 100644 --- a/python/observability-with-azure-monitor/README.md +++ b/python/observability-with-azure-monitor/README.md @@ -114,7 +114,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 8b59f266..f2a88292 100644 --- a/python/observability-with-langgraph/README.md +++ b/python/observability-with-langgraph/README.md @@ -131,7 +131,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 0843c810..77ab19a3 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 2052a202..f1c72d3b 100644 --- a/python/openai/sample-agent/README.md +++ b/python/openai/sample-agent/README.md @@ -21,7 +21,7 @@ This sample demonstrates how to build an agent using OpenAI in Python with the M This sample uses the [Microsoft Agent 365 SDK for Python](https://github.com/microsoft/Agent365-python). -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 > @@ -162,7 +162,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). @@ -171,7 +171,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