Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
dcb96cf
Refactor of SK Sample to add more OTEL and Refactor for behavior of T…
MattB-msft Nov 14, 2025
67f2e9c
Update devin agent sample (#48)
walterluna Nov 14, 2025
10f3bd1
Add streaming support and refactor Agent365 logic
MattB-msft Nov 14, 2025
2916688
Update LocalPackages path in nuget.config
MattB-msft Nov 15, 2025
8b508ae
Comment out `EnabledOtlpExporter` configuration
MattB-msft Nov 15, 2025
d8899e0
Add copyright headers and clean up unused directives
MattB-msft Nov 15, 2025
e826736
updating samples read me docs (#47)
abdulanu0 Nov 15, 2025
9751074
Update Node.js OpenAI sample (#50)
pontemonti Nov 17, 2025
c7451e9
Introducing thinking indicator in Perplexity sample agent (#37)
aubreyquinn Nov 17, 2025
38aa59c
updating auth handler (#53)
abdulanu0 Nov 18, 2025
caece1a
Update Python Agent Framework sample (#58)
pontemonti Nov 18, 2025
3e650a1
Update Python OpenAI sample agent (#57)
pontemonti Nov 18, 2025
c0ba1ea
Introducing observability in Perplexity agent (#44)
aubreyquinn Nov 18, 2025
a8cf16a
Add prompt injection defense to agent system prompt (#40)
efpiva Nov 18, 2025
a819085
Update Package References to Use npm Registry + Remove local preinsta…
JesuTerraz Nov 18, 2025
41cbe76
Add temporariy thumbnails to the related samples (#63)
Alive-Fish Nov 18, 2025
6c3516d
Update .NET Semantic Kernel Sample Agent (#61)
pontemonti Nov 19, 2025
df09bfd
Replace SemanticKernelSampleAgent with WeatherAgent
MattB-msft Nov 19, 2025
e9b1283
Update tooling manifest (#60)
pontemonti Nov 19, 2025
c1306c8
Introducing Microsoft Teams manifest file for Perplexity (#51)
aubreyquinn Nov 19, 2025
dad4562
Refactor auth handlers and improve observability logic
MattB-msft Nov 19, 2025
2f41b20
Add manifest template for n8n Sample (#49)
rbrighenti Nov 19, 2025
1006ab1
Potential fix for code scanning alert no. 1: Workflow does not contai…
pontemonti Nov 19, 2025
6206e14
Add CI workflow for Node.js OpenAI sample agent (#65)
pontemonti Nov 19, 2025
a228c22
Remove local reference in python samples (#62)
JesuTerraz Nov 19, 2025
1ecfaab
Google ADK Sample with Tooling (#70)
JesuTerraz Nov 20, 2025
a913033
Updated formatting on readme file (#71)
aubreyquinn Nov 20, 2025
21372bc
Perplexity: introducing the published agents-a365 packages (#72)
aubreyquinn Nov 20, 2025
1942933
Add Devin Agent's manifest sample (#52)
walterluna Nov 20, 2025
ed5456b
reference public package dependencies (#64)
walterluna Nov 20, 2025
40b5ced
Perplexity: added telemetry markers to all paths in the code (#73)
aubreyquinn Nov 20, 2025
e3a96e0
Remove `Assets` project and `nuget.config` from solutions
MattB-msft Nov 21, 2025
552c146
Refactor of SK Sample to add more OTEL and Refactor for behavior of T…
MattB-msft Nov 14, 2025
ec574fb
Add streaming support and refactor Agent365 logic
MattB-msft Nov 14, 2025
6f43e2b
Update LocalPackages path in nuget.config
MattB-msft Nov 15, 2025
7a8dbd4
Comment out `EnabledOtlpExporter` configuration
MattB-msft Nov 15, 2025
606af84
Add copyright headers and clean up unused directives
MattB-msft Nov 15, 2025
d721e21
Replace SemanticKernelSampleAgent with WeatherAgent
MattB-msft Nov 19, 2025
86c94fc
Refactor auth handlers and improve observability logic
MattB-msft Nov 19, 2025
a5b39f8
Remove `Assets` project and `nuget.config` from solutions
MattB-msft Nov 21, 2025
07159dc
Rebase
MattB-msft Nov 21, 2025
c328b68
Rebasing fixes.
MattB-msft Nov 21, 2025
824be09
fix path on build.
MattB-msft Nov 21, 2025
79d8fc7
Remove Warnings.
MattB-msft Nov 21, 2025
7afde0e
Renamed AgentFramework Sample. Project names
MattB-msft Nov 21, 2025
2377345
Renamed Weather agent to MyAgent
MattB-msft Nov 21, 2025
581e5c8
Updated Names
MattB-msft Nov 21, 2025
5413fa6
Update CI workflow for .NET Agent Framework solution
MattB-msft Nov 21, 2025
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
40 changes: 40 additions & 0 deletions .github/workflows/ci-dotnet-agentframework-sampleagent.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
name: CI - Build .NET Agent Framework Sample Agent
permissions:
contents: read

on:
push:
branches: [ main, master ]
paths:
- 'dotnet/agent-framework/sample-agent/**/*'
pull_request:
branches: [ main, master ]
paths:
- 'dotnet/agent-framework/sample-agent/**/*'

jobs:
dotnet-agentframework-sampleagent:
name: .NET Agent Framework Sample Agent
runs-on: ubuntu-latest
defaults:
run:
working-directory: ./dotnet/agent-framework

strategy:
matrix:
dotnet-version: ['8.0.x']

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Setup .NET ${{ matrix.dotnet-version }}
uses: actions/setup-dotnet@v4
with:
dotnet-version: ${{ matrix.dotnet-version }}

- name: Restore dependencies
run: dotnet restore AgentFrameworkSample.sln

- name: Build solution
run: dotnet build AgentFrameworkSample.sln --no-restore --configuration Release
40 changes: 40 additions & 0 deletions .github/workflows/ci-dotnet-semantickernel-sampleagent.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
name: CI - Build .NET Semantic Kernel Sample Agent
permissions:
contents: read

on:
push:
branches: [ main, master ]
paths:
- 'dotnet/semantic-kernel/sample-agent/**/*'
pull_request:
branches: [ main, master ]
paths:
- 'dotnet/semantic-kernel/sample-agent/**/*'

jobs:
dotnet-semantickernel-sampleagent:
name: .NET Semantic Kernel Sample Agent
runs-on: ubuntu-latest
defaults:
run:
working-directory: ./dotnet/semantic-kernel

strategy:
matrix:
dotnet-version: ['8.0.x']

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Setup .NET ${{ matrix.dotnet-version }}
uses: actions/setup-dotnet@v4
with:
dotnet-version: ${{ matrix.dotnet-version }}

- name: Restore dependencies
run: dotnet restore SemanticKernelSampleAgent.sln

- name: Build solution
run: dotnet build SemanticKernelSampleAgent.sln --no-restore --configuration Release
45 changes: 45 additions & 0 deletions .github/workflows/ci-nodejs-openai-sampleagent.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Copyright (c) Microsoft Corporation.
# Licensed under the MIT License.

name: CI - Build Node.js OpenAI Sample Agent

on:
push:
branches: [ main, master ]
paths:
- 'nodejs/openai/sample-agent/**/*'
pull_request:
branches: [ main, master ]
paths:
- 'nodejs/openai/sample-agent/**/*'

jobs:
nodejs-openai-sampleagent:
name: Node.js OpenAI Sample Agent
permissions:
contents: read
runs-on: ubuntu-latest
defaults:
run:
working-directory: ./nodejs/openai/sample-agent

strategy:
matrix:
node-version: ['18', '20']

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Set up Node.js ${{ matrix.node-version }}
uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node-version }}
cache: 'npm'
cache-dependency-path: '**/package-lock.json'

- name: Install dependencies
run: npm install

- name: Build
run: npm run build
7 changes: 6 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -101,4 +101,9 @@ coverage/

# OS-specific files
.DS_Store
Thumbs.db
Thumbs.db

# agents SDK Transcript logger.
agents_*/
*transcript.json
msteams*/
59 changes: 56 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,64 @@
# Agent 365 SDK Samples
# Microsoft Agent 365 SDK Samples and Prompts

This repository contains sample agents and prompts for building with the Microsoft Agent 365 SDK. The Microsoft Agent 365 SDK extends the Microsoft 365 Agents SDK with enterprise-grade capabilities for building sophisticated agents. It provides comprehensive tooling for observability, notifications, runtime utilities, and development tools that help developers create production-ready agents for platforms including M365, Teams, Copilot Studio, and Webchat.

- **Sample agents** are available in C# (.NET), Python, and Node.js/TypeScript
- **Prompts** to help you get started with AI-powered development tools like Cursor IDE

## 📋 **Telemetry**
> #### 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/).

Data Collection. The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
## Current Repository State

This samples repository is currently in active development and contains:
- **Sample Agents**: Production-ready examples in C#/.NET, Python, and Node.js/TypeScript demonstrating observability, notifications, tooling, and hosting patterns
- **Prompts**: Guides for using AI-powered development tools (e.g., Cursor IDE) to accelerate agent development

## Documentation

For comprehensive documentation and guides, visit the [Microsoft Agent 365 Developer Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/).

### Microsoft Agent 365 SDK

The sample agents in this repository use the Microsoft Agent 365 SDK, which provides enterprise-grade extensions for observability, notifications, runtime utilities, and developer tools. Explore the SDK repositories below:

- [Microsoft Agent 365 SDK - C# /.NET repository](https://github.com/microsoft/Agent365-dotnet)
- [Microsoft Agent 365 SDK - Python repository](https://github.com/microsoft/Agent365-python)
- [Microsoft Agent 365 SDK - Node.js/TypeScript repository](https://github.com/microsoft/Agent365-nodejs)
- [Microsoft Agent 365 SDK Samples repository](https://github.com/microsoft/Agent365-Samples) - You are here

## Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

## Useful Links

### Microsoft 365 Agents SDK

The core SDK for building conversational AI agents for Microsoft 365 platforms.

- [Microsoft 365 Agents SDK - C# /.NET repository](https://github.com/Microsoft/Agents-for-net)
- [Microsoft 365 Agents SDK - NodeJS /TypeScript repository](https://github.com/Microsoft/Agents-for-js)
- [Microsoft 365 Agents SDK - Python repository](https://github.com/Microsoft/Agents-for-python)
- [Microsoft 365 Agents documentation](https://learn.microsoft.com/microsoft-365/agents-sdk/)

## Additional Resources

For language-specific documentation and additional resources, explore the following links:

- [.NET documentation](https://learn.microsoft.com/dotnet/api/?view=m365-agents-sdk&preserve-view=true)
- [Node.js documentation](https://learn.microsoft.com/javascript/api/?view=m365-agents-sdk&preserve-view=true)
- [Python documentation](https://learn.microsoft.com/python/api/?view=m365-agents-sdk&preserve-view=true)

## Trademarks

*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*

## License
Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT License - see the LICENSE file for details.
25 changes: 25 additions & 0 deletions dotnet/agent-framework/AgentFrameworkSample.sln
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.14.36623.8
MinimumVisualStudioVersion = 10.0.40219.1
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AgentFrameworkSampleAgent", "sample-agent\AgentFrameworkSampleAgent.csproj", "{C05BF552-56C0-8F74-98D5-F51053881902}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Release|Any CPU = Release|Any CPU
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{C05BF552-56C0-8F74-98D5-F51053881902}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{C05BF552-56C0-8F74-98D5-F51053881902}.Debug|Any CPU.Build.0 = Debug|Any CPU
{C05BF552-56C0-8F74-98D5-F51053881902}.Release|Any CPU.ActiveCfg = Release|Any CPU
{C05BF552-56C0-8F74-98D5-F51053881902}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {A13DF873-5DE4-4F7D-9734-FA05F32F218E}
EndGlobalSection
EndGlobal
Loading