feat: Add Official Microsoft & Gemini Skills (845+ Total)
🚀 Impact Significantly expands the capabilities of **Antigravity Awesome Skills** by integrating official skill collections from **Microsoft** and **Google Gemini**. This update increases the total skill count to **845+**, making the library even more comprehensive for AI coding assistants. ✨ Key Changes 1. New Official Skills - **Microsoft Skills**: Added a massive collection of official skills from [microsoft/skills](https://github.com/microsoft/skills). - Includes Azure, .NET, Python, TypeScript, and Semantic Kernel skills. - Preserves the original directory structure under `skills/official/microsoft/`. - Includes plugin skills from the `.github/plugins` directory. - **Gemini Skills**: Added official Gemini API development skills under `skills/gemini-api-dev/`. 2. New Scripts & Tooling - **`scripts/sync_microsoft_skills.py`**: A robust synchronization script that: - Clones the official Microsoft repository. - Preserves the original directory heirarchy. - Handles symlinks and plugin locations. - Generates attribution metadata. - **`scripts/tests/inspect_microsoft_repo.py`**: Debug tool to inspect the remote repository structure. - **`scripts/tests/test_comprehensive_coverage.py`**: Verification script to ensure 100% of skills are captured during sync. 3. Core Improvements - **`scripts/generate_index.py`**: Enhanced frontmatter parsing to safely handle unquoted values containing `@` symbols and commas (fixing issues with some Microsoft skill descriptions). - **`package.json`**: Added `sync:microsoft` and `sync:all-official` scripts for easy maintenance. 4. Documentation - Updated `README.md` to reflect the new skill counts (845+) and added Microsoft/Gemini to the provider list. - Updated `CATALOG.md` and `skills_index.json` with the new skills. 🧪 Verification - Ran `scripts/tests/test_comprehensive_coverage.py` to verify all Microsoft skills are detected. - Validated `generate_index.py` fixes by successfully indexing the new skills.
This commit is contained in:
Ahmed Rehan
290
skills/official/microsoft/dotnet/m365/m365-agents/SKILL.md
Normal file
290
skills/official/microsoft/dotnet/m365/m365-agents/SKILL.md
Normal file
@@ -0,0 +1,290 @@
|
||||
---
|
||||
name: m365-agents-dotnet
|
||||
description: |
|
||||
Microsoft 365 Agents SDK for .NET. Build multichannel agents for Teams/M365/Copilot Studio with ASP.NET Core hosting, AgentApplication routing, and MSAL-based auth. Triggers: "Microsoft 365 Agents SDK", "Microsoft.Agents", "AddAgentApplicationOptions", "AgentApplication", "AddAgentAspNetAuthentication", "Copilot Studio client", "IAgentHttpAdapter".
|
||||
package: Microsoft.Agents.Hosting.AspNetCore, Microsoft.Agents.Authentication.Msal, Microsoft.Agents.CopilotStudio.Client
|
||||
---
|
||||
|
||||
# Microsoft 365 Agents SDK (.NET)
|
||||
|
||||
## Overview
|
||||
Build enterprise agents for Microsoft 365, Teams, and Copilot Studio using the Microsoft.Agents SDK with ASP.NET Core hosting, agent routing, and MSAL-based authentication.
|
||||
|
||||
## Before implementation
|
||||
- Use the microsoft-docs MCP to verify the latest APIs for AddAgent, AgentApplication, and authentication options.
|
||||
- Confirm package versions in NuGet for the Microsoft.Agents.* packages you plan to use.
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
dotnet add package Microsoft.Agents.Hosting.AspNetCore
|
||||
dotnet add package Microsoft.Agents.Authentication.Msal
|
||||
dotnet add package Microsoft.Agents.Storage
|
||||
dotnet add package Microsoft.Agents.CopilotStudio.Client
|
||||
dotnet add package Microsoft.Identity.Client.Extensions.Msal
|
||||
```
|
||||
|
||||
## Configuration (appsettings.json)
|
||||
|
||||
```json
|
||||
{
|
||||
"TokenValidation": {
|
||||
"Enabled": true,
|
||||
"Audiences": [
|
||||
"{{ClientId}}"
|
||||
],
|
||||
"TenantId": "{{TenantId}}"
|
||||
},
|
||||
"AgentApplication": {
|
||||
"StartTypingTimer": false,
|
||||
"RemoveRecipientMention": false,
|
||||
"NormalizeMentions": false
|
||||
},
|
||||
"Connections": {
|
||||
"ServiceConnection": {
|
||||
"Settings": {
|
||||
"AuthType": "ClientSecret",
|
||||
"ClientId": "{{ClientId}}",
|
||||
"ClientSecret": "{{ClientSecret}}",
|
||||
"AuthorityEndpoint": "https://login.microsoftonline.com/{{TenantId}}",
|
||||
"Scopes": [
|
||||
"https://api.botframework.com/.default"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"ConnectionsMap": [
|
||||
{
|
||||
"ServiceUrl": "*",
|
||||
"Connection": "ServiceConnection"
|
||||
}
|
||||
],
|
||||
"CopilotStudioClientSettings": {
|
||||
"DirectConnectUrl": "",
|
||||
"EnvironmentId": "",
|
||||
"SchemaName": "",
|
||||
"TenantId": "",
|
||||
"AppClientId": "",
|
||||
"AppClientSecret": ""
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Core Workflow: ASP.NET Core agent host
|
||||
|
||||
```csharp
|
||||
using Microsoft.Agents.Builder;
|
||||
using Microsoft.Agents.Hosting.AspNetCore;
|
||||
using Microsoft.Agents.Storage;
|
||||
using Microsoft.AspNetCore.Builder;
|
||||
using Microsoft.AspNetCore.Http;
|
||||
using Microsoft.Extensions.DependencyInjection;
|
||||
using Microsoft.Extensions.Hosting;
|
||||
|
||||
var builder = WebApplication.CreateBuilder(args);
|
||||
|
||||
builder.Services.AddHttpClient();
|
||||
builder.AddAgentApplicationOptions();
|
||||
builder.AddAgent<MyAgent>();
|
||||
builder.Services.AddSingleton<IStorage, MemoryStorage>();
|
||||
|
||||
builder.Services.AddControllers();
|
||||
builder.Services.AddAgentAspNetAuthentication(builder.Configuration);
|
||||
|
||||
WebApplication app = builder.Build();
|
||||
|
||||
app.UseAuthentication();
|
||||
app.UseAuthorization();
|
||||
|
||||
app.MapGet("/", () => "Microsoft Agents SDK Sample");
|
||||
|
||||
var incomingRoute = app.MapPost("/api/messages",
|
||||
async (HttpRequest request, HttpResponse response, IAgentHttpAdapter adapter, IAgent agent, CancellationToken ct) =>
|
||||
{
|
||||
await adapter.ProcessAsync(request, response, agent, ct);
|
||||
});
|
||||
|
||||
if (!app.Environment.IsDevelopment())
|
||||
{
|
||||
incomingRoute.RequireAuthorization();
|
||||
}
|
||||
else
|
||||
{
|
||||
app.Urls.Add("http://localhost:3978");
|
||||
}
|
||||
|
||||
app.Run();
|
||||
```
|
||||
|
||||
## AgentApplication routing
|
||||
|
||||
```csharp
|
||||
using Microsoft.Agents.Builder;
|
||||
using Microsoft.Agents.Builder.App;
|
||||
using Microsoft.Agents.Builder.State;
|
||||
using Microsoft.Agents.Core.Models;
|
||||
using System;
|
||||
using System.Threading;
|
||||
using System.Threading.Tasks;
|
||||
|
||||
public sealed class MyAgent : AgentApplication
|
||||
{
|
||||
public MyAgent(AgentApplicationOptions options) : base(options)
|
||||
{
|
||||
OnConversationUpdate(ConversationUpdateEvents.MembersAdded, WelcomeAsync);
|
||||
OnActivity(ActivityTypes.Message, OnMessageAsync, rank: RouteRank.Last);
|
||||
OnTurnError(OnTurnErrorAsync);
|
||||
}
|
||||
|
||||
private static async Task WelcomeAsync(ITurnContext turnContext, ITurnState turnState, CancellationToken ct)
|
||||
{
|
||||
foreach (ChannelAccount member in turnContext.Activity.MembersAdded)
|
||||
{
|
||||
if (member.Id != turnContext.Activity.Recipient.Id)
|
||||
{
|
||||
await turnContext.SendActivityAsync(
|
||||
MessageFactory.Text("Welcome to the agent."),
|
||||
ct);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private static async Task OnMessageAsync(ITurnContext turnContext, ITurnState turnState, CancellationToken ct)
|
||||
{
|
||||
await turnContext.SendActivityAsync(
|
||||
MessageFactory.Text($"You said: {turnContext.Activity.Text}"),
|
||||
ct);
|
||||
}
|
||||
|
||||
private static async Task OnTurnErrorAsync(
|
||||
ITurnContext turnContext,
|
||||
ITurnState turnState,
|
||||
Exception exception,
|
||||
CancellationToken ct)
|
||||
{
|
||||
await turnState.Conversation.DeleteStateAsync(turnContext, ct);
|
||||
|
||||
var endOfConversation = Activity.CreateEndOfConversationActivity();
|
||||
endOfConversation.Code = EndOfConversationCodes.Error;
|
||||
endOfConversation.Text = exception.Message;
|
||||
await turnContext.SendActivityAsync(endOfConversation, ct);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Copilot Studio direct-to-engine client
|
||||
|
||||
### DelegatingHandler for token acquisition (interactive flow)
|
||||
|
||||
```csharp
|
||||
using System.Net.Http.Headers;
|
||||
using Microsoft.Agents.CopilotStudio.Client;
|
||||
using Microsoft.Identity.Client;
|
||||
|
||||
internal sealed class AddTokenHandler : DelegatingHandler
|
||||
{
|
||||
private readonly SampleConnectionSettings _settings;
|
||||
|
||||
public AddTokenHandler(SampleConnectionSettings settings) : base(new HttpClientHandler())
|
||||
{
|
||||
_settings = settings;
|
||||
}
|
||||
|
||||
protected override async Task<HttpResponseMessage> SendAsync(
|
||||
HttpRequestMessage request,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
if (request.Headers.Authorization is null)
|
||||
{
|
||||
string[] scopes = [CopilotClient.ScopeFromSettings(_settings)];
|
||||
|
||||
IPublicClientApplication app = PublicClientApplicationBuilder
|
||||
.Create(_settings.AppClientId)
|
||||
.WithAuthority(AadAuthorityAudience.AzureAdMyOrg)
|
||||
.WithTenantId(_settings.TenantId)
|
||||
.WithRedirectUri("http://localhost")
|
||||
.Build();
|
||||
|
||||
AuthenticationResult authResponse;
|
||||
try
|
||||
{
|
||||
var account = (await app.GetAccountsAsync()).FirstOrDefault();
|
||||
authResponse = await app.AcquireTokenSilent(scopes, account).ExecuteAsync(cancellationToken);
|
||||
}
|
||||
catch (MsalUiRequiredException)
|
||||
{
|
||||
authResponse = await app.AcquireTokenInteractive(scopes).ExecuteAsync(cancellationToken);
|
||||
}
|
||||
|
||||
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", authResponse.AccessToken);
|
||||
}
|
||||
|
||||
return await base.SendAsync(request, cancellationToken);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Console host with CopilotClient
|
||||
|
||||
```csharp
|
||||
using Microsoft.Agents.CopilotStudio.Client;
|
||||
using Microsoft.Extensions.DependencyInjection;
|
||||
using Microsoft.Extensions.Hosting;
|
||||
|
||||
HostApplicationBuilder builder = Host.CreateApplicationBuilder(args);
|
||||
|
||||
var settings = new SampleConnectionSettings(
|
||||
builder.Configuration.GetSection("CopilotStudioClientSettings"));
|
||||
|
||||
builder.Services.AddHttpClient("mcs").ConfigurePrimaryHttpMessageHandler(() =>
|
||||
{
|
||||
return new AddTokenHandler(settings);
|
||||
});
|
||||
|
||||
builder.Services
|
||||
.AddSingleton(settings)
|
||||
.AddTransient<CopilotClient>(sp =>
|
||||
{
|
||||
var logger = sp.GetRequiredService<ILoggerFactory>().CreateLogger<CopilotClient>();
|
||||
return new CopilotClient(settings, sp.GetRequiredService<IHttpClientFactory>(), logger, "mcs");
|
||||
});
|
||||
|
||||
IHost host = builder.Build();
|
||||
var client = host.Services.GetRequiredService<CopilotClient>();
|
||||
|
||||
await foreach (var activity in client.StartConversationAsync(emitStartConversationEvent: true))
|
||||
{
|
||||
Console.WriteLine(activity.Type);
|
||||
}
|
||||
|
||||
await foreach (var activity in client.AskQuestionAsync("Hello!", null))
|
||||
{
|
||||
Console.WriteLine(activity.Type);
|
||||
}
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. Use AgentApplication subclasses to centralize routing and error handling.
|
||||
2. Use MemoryStorage only for development; use persisted storage in production.
|
||||
3. Enable TokenValidation in production and require authorization on /api/messages.
|
||||
4. Keep auth secrets in configuration providers (Key Vault, managed identity, env vars).
|
||||
5. Reuse HttpClient from IHttpClientFactory and cache MSAL tokens.
|
||||
6. Prefer async handlers and pass CancellationToken to SDK calls.
|
||||
|
||||
## Reference Files
|
||||
|
||||
| File | Contents |
|
||||
| --- | --- |
|
||||
| [references/acceptance-criteria.md](references/acceptance-criteria.md) | Import paths, hosting pipeline, Copilot Studio client patterns, anti-patterns |
|
||||
|
||||
## Reference Links
|
||||
|
||||
| Resource | URL |
|
||||
| --- | --- |
|
||||
| Microsoft 365 Agents SDK | https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/ |
|
||||
| AddAgent API | https://learn.microsoft.com/en-us/dotnet/api/microsoft.agents.hosting.aspnetcore.servicecollectionextensions.addagent?view=m365-agents-sdk |
|
||||
| AgentApplication API | https://learn.microsoft.com/en-us/dotnet/api/microsoft.agents.builder.app.agentapplication?view=m365-agents-sdk |
|
||||
| Auth configuration options | https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/microsoft-authentication-library-configuration-options |
|
||||
| Copilot Studio integration | https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/integrate-with-mcs |
|
||||
| GitHub samples | https://github.com/microsoft/agents |
|
||||
Reference in New Issue
Block a user