Skip to content
Back to search

microsoft-agents-sdk

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoft--agents/badge.svg)](/listings/microsoft--agents)

HTML

<a href="/listings/microsoft--agents"><img src="/api/listings/microsoft--agents/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 33 lines
  1. {
  2. "name": "microsoft-agents-sdk",
  3. "owner": { "name": "Microsoft" },
  4. "metadata": {
  5. "description": "Claude Code skills for building agents with the Microsoft Agents SDK"
  6. },
  7. "plugins": [
  8. {
  9. "name": "agents-sdk-common",
  10. "source": "./agent-plugins/agents-sdk-common",
  11. "description": "Shared skills for building agents with the Microsoft 365 Agents SDK (all languages)",
  12. "version": "1.1.2"
  13. },
  14. {
  15. "name": "agents-for-js",
  16. "source": "./agent-plugins/agents-for-js",
  17. "description": "Skills for building agents with the Microsoft 365 Agents SDK for TypeScript/JavaScript",
  18. "version": "1.3.0"
  19. },
  20. {
  21. "name": "agents-for-net",
  22. "source": "./agent-plugins/agents-for-net",
  23. "description": "Skills for building agents with the Microsoft 365 Agents SDK for DotNet",
  24. "version": "1.2.2"
  25. },
  26. {
  27. "name": "agents-for-python",
  28. "source": "./agent-plugins/agents-for-python",
  29. "description": "Skills for building agents with the Microsoft 365 Agents SDK for Python",
  30. "version": "1.2.0"
  31. }
  32. ]
  33. }
README.md · README · 141 lines
  1. # Microsoft 365 Agents SDK
  2. With the Microsoft 365 Agents SDK, you can create agents deployable to channels of your choice, such as Microsoft 365 Copilot, Microsoft Teams, Web & Custom Apps and more, with scaffolding to handle the required communication. Developers can use the AI Services of their choice, and make the agents they build available using the channel management capabilities of the SDK.
  3. Developers need the flexibility to integrate agents from any provider or technology stack into their enterprise systems. The Agents SDK simplifies the implementation of agentic patterns using the AI of their choice, allowing them to select one or more services, models, or agents to meet their specific requirements.
  4. Use the Agents SDK to:
  5. - Quickly build an agent 'container' with state, storage, and the ability to manage activities and events. Deploy this container across any channel, such as Microsoft 365 Copilot or Microsoft Teams.
  6. - Implement agentic patterns without being restricted to a specific technology stack. The Agents SDK is agnostic regarding the AI you choose.
  7. - Customize your agent to align with the specific behaviors of clients, such as Microsoft Teams.
  8. ## Get Started
  9. You can get started right here by scolling up and clicking the 'samples' folder in this repo, selecting your language and reviewing the samples list before picking which one you want to start with (QuickStart is recommended for fundamentals).
  10. Microsoft 365 Copilot is one of many channels supported by this SDK, and a *Microsoft 365 Copilot subscription is *not* required* to get started with or use this SDK unless your working specifically with that channel (or others, that require a subscription/service to use their client).
  11. ## C#, JavaScript, & Python Repository links
  12. The source for the client libraries exists for the most part in repositories for each language. This repository is meant to be a jumping off point into those language specific repositories. Issues related to a specific language should be opened in the corresponding repository but cross cutting issues can be opened in this repository.
  13. | Language | Repo |
  14. |:--------------------|:------------------------------:|
  15. | General (This repo) | [Agents Repository] |
  16. | C# /.NET | [Agents-for-net Repository] |
  17. | JavaScript | [Agents-for-js Repository] |
  18. | Python | [Agents-for-python Repository] |
  19. ## Agent Plugins (Skills)
  20. The Agents SDK provides AI coding assistant plugins that give your assistant
  21. deep knowledge of SDK APIs, patterns, and common mistakes. Skills activate
  22. automatically based on the language and task you are working on.
  23. The plugins are hosted in
  24. [microsoft/Agents — agent-plugins](https://github.com/microsoft/Agents/tree/main/agent-plugins).
  25. **Available plugins across the SDKs:**
  26. | Plugin | SDKs | Skills Included |
  27. |--------|------|-----------------|
  28. | `agents-sdk-common` | All languages | Azure provisioning, identity credentials, and OAuth setup through the `az` CLI |
  29. | `agents-for-js` | TypeScript/JavaScript | Building agents, debugging authentication and startup issues, and configuring OpenTelemetry observability |
  30. | `agents-for-net` | C#/.NET | Building agents, debugging, OpenTelemetry observability, Bot Framework migration, and `ActivityHandler`-to-`AgentApplication` migration |
  31. | `agents-for-python` | Python | Configuring and troubleshooting OpenTelemetry observability |
  32. **Installation (GitHub Copilot CLI or Claude Code):**
  33. ```text
  34. /plugin marketplace add microsoft/Agents
  35. /plugin install agents-sdk-common@microsoft-agents-sdk
  36. /plugin install agents-for-js@microsoft-agents-sdk
  37. /plugin install agents-for-net@microsoft-agents-sdk
  38. /plugin install agents-for-python@microsoft-agents-sdk
  39. ```
  40. Install the common plugin and the plugins for the SDKs you use. Skills activate
  41. automatically—no manual loading is needed. Run `/plugin` to verify installation.
  42. ## Documentation
  43. To learn more about the Agents SDK, you can read our official docs here: [Agents SDK Documentation](https://aka.ms/M365-Agents-SDK-Docs)
  44. The [configuration schema preview](schema/README.md) defines a canonical JSON
  45. document for structural validation in downstream projects. It does not establish
  46. runtime support or replace SDK-specific configuration loading.
  47. ## Related SDKs and Agent Platforms
  48. - **Semantic Kernel**. [Semantic Kernel](https://learn.microsoft.com/en-us/semantic-kernel/overview/)
  49. is an SDK that integrates Large Language Models (LLMs) like
  50. [OpenAI](https://platform.openai.com/docs/introduction),
  51. [Azure OpenAI](https://azure.microsoft.com/en-us/products/ai-services/openai-service),
  52. and [Hugging Face](https://huggingface.co/)
  53. with conventional programming languages like C#, Python, and Java. Semantic Kernel achieves this
  54. by allowing you to define [plugins](https://learn.microsoft.com/en-us/semantic-kernel/concepts/plugins)
  55. that can be chained together
  56. in just a [few lines of code](https://learn.microsoft.com/en-us/semantic-kernel/ai-orchestration/chaining-functions?tabs=Csharp#using-the-runasync-method-to-simplify-your-code).
  57. - **Azure AI Foundry**. Provides the core backend agent functionality, providing reasoning, retrieval augmentation, observability, among other core functions. Developers can leverage the Azure AI Agent Service or build their agent functionality with individual components from this SDK.
  58. - **Copilot Studio**. Copilot Studio is an agent building platform that can be used with the Microsoft 365 Agents SDK to integrate your agent into your applications & create multi-agent patterns with Copilot Studio Agents. To get started, go to the samples folder in this repo and select the Copilot Studio Client sample in your chosen language.
  59. The Microsoft 365 Agents SDK brings together core components to allow for developers to create, manage and utilize AI Services and third-party SDKs to power orchestration and develop custom agent logic functionality.
  60. ## Using other services with the Agents SDK
  61. Your use of other services in connection with the Microsoft 365 Agents SDK is governed by the respective agreements for those services, which may include codes of conduct and other restrictions
  62. ## Contributing
  63. ### Note for Microsoft internal developers
  64. - Internal Microsoft Developers should join the Core identity group [Agents SDK Contrib](https://coreidentity.microsoft.com/manage/Entitlement/entitlement/agentssdkint-upyj)
  65. ### Non-Microsoft developers
  66. - This project welcomes contributions and suggestions. Most contributions require you to agree to a
  67. Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
  68. the rights to use your contribution. For details, visit <https://cla.opensource.microsoft.com>.
  69. - When you submit a pull request, a CLA bot will automatically determine whether you need to provide
  70. a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
  71. provided by the bot. You will only need to do this once across all repos using our CLA.
  72. This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
  73. For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
  74. contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
  75. ## Recommended VS Code Extensions
  76. To ensure a consistent development environment, we recommend using the following VS Code extensions:
  77. |Extension | Description |
  78. |----------|-------------|
  79. |[ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)|Integrates [ESLint](https://eslint.org/) into VS Code. Allows you to find and fix problems in JavaScript code.|
  80. |[GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)|[GitHub Copilot](https://code.visualstudio.com/docs/copilot/overview) is an AI peer programming tool that helps you write code faster and smarter.|
  81. |[GitHub Codespaces](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)|[GitHub Codespaces](https://github.com/features/codespaces) provides cloud-hosted development environments for any activity - whether it's a long-term project, or a short-term task like reviewing a pull request.|
  82. |[C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)|C# Dev Kit helps you manage your code with a solution explorer and test your code with integrated unit test discovery and execution, elevating your C# development experience wherever you like to develop (Windows, macOS, Linux, and even in a Codespace).|
  83. |[Adaptive Card Previewer](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.vscode-adaptive-cards)|The Microsoft Adaptive Card Previewer uses the latest rendering stack for Microsoft Teams to provide a more accurate preview of Adaptive Cards. You can open a side-by-side preview to view changes live, toggle between light, dark, and high-contrast themes.|
  84. These are listed in `.vscode/extensions.json`, so VS Code should prompt you to install them when you open the project.
  85. ## Trademarks
  86. This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
  87. trademarks or logos is subject to and must follow
  88. [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
  89. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
  90. Any use of third-party trademarks or logos is subject to those third-party's policies.
  91. [Agents Repository]: https://github.com/Microsoft/Agents
  92. [Agents-for-net Repository]: https://github.com/Microsoft/Agents-for-net
  93. [Agents-for-js Repository]: https://github.com/Microsoft/Agents-for-js
  94. [Agents-for-python Repository]: https://github.com/Microsoft/Agents-for-python
  95. [Official Agents Documentation]: https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/
  96. [.NET Documentation]: https://learn.microsoft.com/en-us/dotnet/api/?view=m365-agents-sdk&preserve-view=true
  97. [JavaScript Documentation]: https://learn.microsoft.com/en-us/javascript/api/overview/agents-overview?view=agents-sdk-js-latest&preserve-view=true
  98. [Python Documentation]: https://learn.microsoft.com/en-us/python/api/agent-sdk-python/agents-overview?view=agent-sdk-python-latest&preserve-view=true

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.