Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions .claude/skills/generate-readme/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -56,7 +56,7 @@ A table of patterns demonstrated and their file locations:

- <Runtime/SDK version>
- [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
- <Any additional prerequisites specific to the sample>
Expand Down Expand Up @@ -125,7 +125,7 @@ For Python and Node.js samples, include `ENABLE_A365_OBSERVABILITY_EXPORTER`, `E
<Full setup with A365 credentials and observability export.>
```

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

Expand All @@ -143,7 +143,7 @@ For interactive agents, reference the [Configure Agent Testing](https://learn.mi
<Describe the tracing spans produced by the agent (e.g., InvokeAgentScope, InferenceScope, ExecuteToolScope). For agents with a custom token flow, describe the FMI chain briefly. Link to the observability guide.>
```

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

Expand All @@ -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)
```

Expand All @@ -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)
- <Language-specific SDK repository link>
- <Any other relevant links>
```
Expand Down
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/)
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

Expand Down
14 changes: 7 additions & 7 deletions agent-platforms/salesforce/apex-observability/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions dotnet/agent-framework/sample-agent/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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).

Expand All @@ -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
Expand Down
12 changes: 6 additions & 6 deletions dotnet/autonomous/github-trending/sample-agent/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

Expand Down Expand Up @@ -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
Expand All @@ -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

Expand Down
6 changes: 3 additions & 3 deletions dotnet/semantic-kernel/sample-agent/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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).

Expand All @@ -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
Expand Down
Loading
Loading