# microsoft-extensions-ai

Скилл для работы с Microsoft.Extensions.AI в .NET: чат-клиенты, эмбеддинги, инструменты, структурированный вывод и оценка без привязки к одному провайдеру.

- скилл · `type=skill` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 521 у репозитория
- Автор: managedcode
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Libraries/Microsoft-Extensions-AI/skills/microsoft-extensions-ai/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/microsoft-extensions-ai

## Что делает

Скилл помогает строить и проверять код на `Microsoft.Extensions.AI` — абстракции Microsoft для AI-приложений на .NET. Внутри: работа с `IChatClient` и `IEmbeddingGenerator`, настройка middleware для кеширования, логирования и телеметрии, вызов инструментов через `AIFunction`, композиция векторного поиска и оценка результатов. Агент читает контекст репозитория, правит файлы, запускает сборку и тесты.

Скилл различает простой доступ к модели, tool calling, эмбеддинги, генерацию изображений, локальные модели через Ollama и полноценную оркестрацию агентов. Для последней он отправляет к `microsoft-agent-framework`. Для stateless-провайдеров агент досылает историю, для stateful — прокидывает `ConversationId`. При работе с векторами скилл трактует модель эмбеддингов, размерность и схему коллекции как единый контракт: смена любого из них требует переиндексации.

Описания инструментов расходуют токены запроса — скилл регистрирует только те, что нужны в текущем разговоре. Для RAG он подключает `Microsoft.Extensions.VectorData` и `Microsoft.Extensions.DataIngestion`, а не самописные обёртки.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add managedcode/dotnet-skills --skill microsoft-extensions-ai -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/microsoft-extensions-ai/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/microsoft-extensions-ai/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add managedcode/dotnet-skills --skill microsoft-extensions-ai -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/microsoft-extensions-ai/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add managedcode/dotnet-skills --skill microsoft-extensions-ai -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/microsoft-extensions-ai/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install managedcode/dotnet-skills catalog/Libraries/Microsoft-Extensions-AI/skills/microsoft-extensions-ai
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/microsoft-extensions-ai/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add managedcode/dotnet-skills --skill microsoft-extensions-ai -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/managedcode/dotnet-skills --path catalog/Libraries/Microsoft-Extensions-AI/skills/microsoft-extensions-ai
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/microsoft-extensions-ai/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Libraries/Microsoft-Extensions-AI/skills/microsoft-extensions-ai/SKILL.md

## Когда брать
- написать чат-клиент без привязки к одному AI-провайдеру
- добавить вызов инструментов и structured output в .NET AI-приложение
- настроить middleware для кеширования, логирования и телеметрии чата
- построить RAG-пайплайн с векторным поиском и эмбеддингами
- протестировать AI-интеграцию с локальной моделью Ollama

## Примеры запросов агенту
- Добавь `IChatClient` в DI с кешированием и логированием, используй провайдер OpenAI
- Зарегистрируй функцию .NET как `AIFunction` для вызова из модели
- Построй RAG-пайплайн: читай документы, чанки, эмбеддинги, запись в `VectorStore`

## Похожие
- [microsoft-extensions-configuration](https://affpapa.org/nevibecode/skills/microsoft-extensions-configuration.md) — скилл · 621 установка
- [microsoft-azure-webjobs-extensions-authentication-events-dotnet](https://affpapa.org/nevibecode/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet.md) — скилл · 1 установка
- [rag-architect](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-rag-architect.md) — скилл · 5100 установок
- [langchain4j-rag-implementation-patterns](https://affpapa.org/nevibecode/skills/langchain4j-rag-implementation-patterns.md) — скилл · 3900 установок
- [AgentDB Vector Search](https://affpapa.org/nevibecode/skills/agentdb-vector-search.md) — скилл · 1100 установок
- [upstash-vector-db-skills](https://affpapa.org/nevibecode/skills/upstash-vector-db-skills.md) — скилл · 369 установок

Из того же набора: [managedcode/dotnet-skills](https://affpapa.org/nevibecode/by/managedcode/dotnet-skills.md) — 38 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
