mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00

Files

T

SergeyMenshykh 3fc1d00026 .NET: skill as class (#5027 )

* add class-based skills

* address formating issues

* Remove generated filtered-unit.slnx and add to .gitignore

The filtered solution file is generated dynamically by
eng/scripts/New-FilteredSolution.ps1 during CI. Checking it in
risks it becoming stale and out-of-sync with the real solution.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove generated filtered-unit.slnx and add to .gitignore

The filtered solution file is generated dynamically by
eng/scripts/New-FilteredSolution.ps1 during CI. Checking it in
risks it becoming stale and out-of-sync with the real solution.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* consolidate DI samples into one

* fix file encoding

* suppress compatibility warning

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

3fc1d00026 · 2026-04-03 11:27:36 +00:00

History

skills/unit-converter

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

Agent_Step01_FileBasedSkills.csproj

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

Program.cs

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

README.md

.NET: skill as class (#5027 )

2026-04-03 11:27:36 +00:00

README.md

File-Based Agent Skills Sample

This sample demonstrates how to use file-based Agent Skills with a ChatClientAgent.

What it demonstrates

Discovering skills from SKILL.md files on disk via AgentFileSkillsSource
The progressive disclosure pattern: advertise → load → read resources → run scripts
Using the AgentSkillsProvider constructor with a skill directory path and script runner
Running file-based scripts (Python) via a subprocess-based executor

Skills Included

unit-converter

Converts between common units (miles↔km, pounds↔kg) using a multiplication factor.

references/conversion-table.md — Conversion factor table
scripts/convert.py — Python script that performs the conversion

Running the Sample

Prerequisites

.NET 10.0 SDK
Azure OpenAI endpoint with a deployed model
Python 3 installed and available as python3 on your PATH

Setup

export AZURE_OPENAI_ENDPOINT="https://your-endpoint.openai.azure.com/"
export AZURE_OPENAI_DEPLOYMENT_NAME="gpt-4o-mini"

Run

dotnet run

Expected Output

Converting units with file-based skills
------------------------------------------------------------
Agent: Here are your conversions:

1. **26.2 miles → 42.16 km** (a marathon distance)
2. **75 kg → 165.35 lbs**