mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
SergeyMenshykh
ab09246dc4
* Fix Skill docstring consistency and spelling - Add ClassSkill to Skill class docstring concrete implementations list - Normalize 'defence' to 'defense' for American English consistency - Remove extra blank line in InlineSkill docstring example Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix E501 line-too-long lint error in test_skills.py Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix stale test section header to reflect SkillFrontmatter API Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix metadata children overriding top-level frontmatter fields Scope YAML_KV_RE to column-0 keys only so indented children under metadata: are not mistakenly parsed as top-level fields. Add regression test and spec fields to sample SKILL.md files. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
ab09246dc4
·
2026-05-13 20:35:52 +00:00
History
Code-Defined Agent Skills
This sample demonstrates how to create Agent Skills in Python code, without needing SKILL.md files on disk. A unit-converter skill shows three approaches:
What's Demonstrated
- Static Resources — Pass inline content via the
resourcesparameter when constructing aSkill - Dynamic Resources — Attach callable functions via the
@skill.resourcedecorator that return content computed at runtime - Dynamic Scripts — Attach callable scripts via the
@skill.scriptdecorator (unit conversion via a single factor parameter)
All three can be combined with file-based skills in a single SkillsProvider.
Project Structure
code_defined_skill/
├── code_defined_skill.py
└── README.md
Running the Sample
Prerequisites
- An Azure AI Foundry project with a deployed model (e.g.
gpt-4o-mini)
Environment Variables
Set the required environment variables in a .env file (see python/.env.example):
FOUNDRY_PROJECT_ENDPOINT: Your Azure AI Foundry project endpointAZURE_OPENAI_MODEL: The name of your model deployment (defaults togpt-4o-mini)
Authentication
This sample uses AzureCliCredential for authentication. Run az login in your terminal before running the sample.
Run
cd python
uv run samples/02-agents/skills/code_defined_skill/code_defined_skill.py