К основному содержанию
скилл CX Codex

microsoft-extensions-ai — скилл для Claude Code

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

MIT ★ 521 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add managedcode/dotnet-skills --skill microsoft-extensions-ai -a claude-code
Открыть на GitHub

Что делает 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, а не самописные обёртки.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить microsoft-extensions-ai

1Через Skills CLI (Vercel)

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/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о microsoft-extensions-ai

Как установить microsoft-extensions-ai в Claude Code?

Выполни npx skills add managedcode/dotnet-skills --skill microsoft-extensions-ai -a claude-code, скилл появится в ~/.claude/skills/microsoft-extensions-ai/SKILL.md.

Что делает скилл microsoft-extensions-ai?

Помогает писать и проверять код на Microsoft.Extensions.AI: чат-клиенты, эмбеддинги, tool calling, structured output, middleware, векторный поиск и оценку результатов. Агент правит файлы, запускает сборку и тесты.

Когда нужен microsoft-agent-framework вместо этого скилла?

Когда требуется оркестрация нескольких агентов, потоки диалогов, долгоживущее выполнение или удалённый хостинг агентов. Для провайдер-агностичного чата, эмбеддингов и инструментов достаточно Microsoft.Extensions.AI.

Исходный текст

SKILL.md · MIT
---
name: microsoft-extensions-ai
description: "Build provider-agnostic .NET AI integrations with `Microsoft.Extensions.AI`, `IChatClient`, embeddings, middleware, structured output, vector search, and evaluation. USE FOR: building or reviewing .NET code that uses Microsoft.Extensions.AI, Microsoft.Extensions.AI.Abstractions, IChatClient, IEmbeddingGenerator, ChatOptions, or AIFunction;. DO NOT USE FOR: unrelated stacks; generic tasks that do not need this specific guidance. INVOKES: inspect the repository context, edit targeted files, and run relevant build, test, lint, or validation commands when changes are made."
compatibility: "Requires `Microsoft.Extensions.AI` or a .NET AI application that needs model, embedding, tool-calling, or evaluation composition without full agent orchestration."
---

# Microsoft.Extensions.AI

## Trigger On

- building or reviewing `.NET` code that uses `Microsoft.Extensions.AI`, `Microsoft.Extensions.AI.Abstractions`, `IChatClient`, `IEmbeddingGenerator`, `ChatOptions`, or `AIFunction`
- adding `IImageGenerator`, local-model chat via Ollama, AI app templates, or the `.NET AI` quickstarts for assistants and MCP
- choosing between low-level AI abstractions, provider SDKs, vector-search composition, evaluation libraries, and a fuller agent framework
- adding streaming chat, structured output, embeddings, tool calling, telemetry, caching, or DI-based AI middleware
- wiring `Microsoft.Extensions.VectorData`, `Microsoft.Extensions.DataIngestion`, MCP tooling, or evaluation packages around a provider-agnostic AI app

## Workflow

1. Classify the request first: plain model access, tool calling, embeddings/vector search, evaluation, image generation, local-model prototyping, MCP bootstrap, or true agent orchestration.
2. Default to `Microsoft.Extensions.AI` for application and service code that needs provider-agnostic chat, embeddings, middleware, structured output, and testability.
3. Reference `Microsoft.Extensions.AI.Abstractions` directly only when authoring provider libraries or lower-level reusable integration packages.
4. Model `IChatClient` and `IEmbeddingGenerator` composition explicitly in DI. Keep options, caching, telemetry, logging, and tool invocation inspectable in the pipeline.
5. Treat chat state deliberately. For stateless providers, resend history. For stateful providers, propagate `ConversationId` rather than assuming all providers behave the same way.
6. Use `Microsoft.Extensions.VectorData` and `Microsoft.Extensions.DataIngestion` as adjacent building blocks for RAG instead of hand-rolling store abstractions prematurely. Treat the embedding model, vector dimensions, and collection schema as one owned contract: changing any of them means reindexing rather than reusing old vector data. Keep vector API source-breaking notes version-aware; in the 10.5+ line, named-argument usage of `VectorStoreVectorAttribute` uses `dimensions:`.
7. Treat the `.NET AI` quickstarts as bootstrap paths, not finished architecture. They now cover minimal assistants, MCP client/server flows, local models, app templates, and image generation. Start there for a vertical slice, then harden the DI, telemetry, and evaluation story here.
8. Escalate to `microsoft-agent-framework` when the requirement becomes agent threads, multi-agent orchestration, higher-order workflows, durable execution, or remote agent hosting.
9. Validate with real providers, realistic prompts, and evaluation gates so the abstraction layer actually buys portability and reliability.

## Architecture

```mermaid
flowchart LR
  A["Task"] --> B{"Need agent threads, multi-agent orchestration, or remote agent hosting?"}
  B -->|Yes| C["Use Microsoft Agent Framework on top of `Microsoft.Extensions.AI.Abstractions`"]
  B -->|No| D{"Need provider-agnostic chat, embeddings, tools, typed output, or evaluation?"}
  D -->|Yes| E["Use `Microsoft.Extensions.AI`"]
  E --> F["Compose `IChatClient` / `IEmbeddingGenerator` in DI"]
  F --> G["Add caching, telemetry, tools, vector data, and evaluation deliberately"]
  D -->|No| H["Use plain provider SDKs or deterministic .NET code"]
```

## Core Knowledge

- `Microsoft.Extensions.AI.Abstractions` contains the core exchange contracts such as `IChatClient`, `IEmbeddingGenerator<TInput, TEmbedding>`, message/content types, and tool abstractions.
- `Microsoft.Extensions.AI` adds the higher-level application surface: middleware builders, automatic function invocation, caching, logging, and OpenTelemetry integration.
- Most apps and services should reference `Microsoft.Extensions.AI`; provider and connector libraries usually reference only the abstractions package.
- `IChatClient` centers on `GetResponseAsync` and `GetStreamingResponseAsync`. The returned `ChatResponse` or `ChatResponseUpdate` objects carry messages, tool-related content, metadata, and optional conversation identifiers.
- Local-model quickstarts still route through the same `IChatClient` abstraction. Ollama-backed clients are useful for low-cost prototyping, offline dev loops, and portability testing, but you still own chat history replay, latency, and model-quality tradeoffs.
- `ChatOptions` is the normal control plane for model ID, temperature, tools, `AdditionalProperties`, and provider-specific raw options.
- Tool calling is modeled with `AIFunction`, `AIFunctionFactory`, and `FunctionInvokingChatClient`. Ambient data can flow through closures, `AdditionalProperties`, `AIFunctionArguments.Context`, or DI.
- Tool calling can target local .NET methods, external APIs, or MCP-backed tools. The model requests calls; your app still owns execution, validation, and side-effect boundaries.
- Tool definitions consume request tokens. Keep tool descriptions short and register only the tools relevant for the current conversation or workflow.
- `FunctionInvokingChatClient` can handle the tool-invocation loop and parallel tool-call responses automatically when the provider/model supports that shape.
- `IEmbeddingGenerator` is the standard abstraction for semantic search, vector indexing, similarity, and cache-key generation. Pair it with `Microsoft.Extensions.VectorData.Abstractions` for vector store operations, and keep the embedding model, collection dimensions, and chunking/versioning story aligned so reindexing stays explicit.
- `IImageGenerator` is the experimental MEAI image surface. Treat `MEAI001` as an intentional opt-in, keep image generation separate from chat concerns, and compose logging/caching/hosting middleware around it the same way you would for `IChatClient`.
- `Microsoft.Extensions.DataIngestion` gives you the document-side RAG pipeline: `IngestionDocument`, document readers like MarkItDown/Markdig, document processors such as `ImageAlternativeTextEnricher`, chunkers, chunk processors, `VectorStoreWriter<T>`, and `IngestionPipeline<T>` for end-to-end composition.
- `IngestionPipeline<T>.ProcessAsync` is partial-success oriented. Handle `IAsyncEnumerable<IngestionResult>` deliberately instead of assuming one failed document should automatically crash the whole ingestion run.
- `Microsoft.Extensions.AI.Evaluation.*` gives you quality, NLP, safety, caching, and reporting layers for regression checks and CI gates.
- `dotnet/extensions` `v10.9.0` adds experimental `RoutingChatClient`/`SemanticRoutingChatClient` and `FailoverChatClient`/`OrderedFailoverChatClient` pipelines. Keep routing policy, fallback order, retry ownership, cost, and telemetry explicit; do not compose nested retry and failover layers without bounded attempts.
- Experimental failover switches clients only when the failed attempt has produced no output. Once streaming output has been emitted, surface the failure instead of replaying the response through another model and duplicating visible text or tool work. Test both failure-before-first-update and failure-after-first-update paths; keep fallback attempts bounded.
- The same release redesigns AI evaluation reports and refreshes their viewer. Treat report shape as a versioned CI artifact, and revalidate downstream parsers or publishing jobs before upgrading evaluation packages.
- The prior `v10.8.4` templates remove GitHub Models and require an explicit `--provider azureopenai`, `--provider ollama`, or `--provider openai`; update scaffolding scripts and provider-authentication tests instead of relying on the old default.
- The preceding `v10.8.0` release moved `Microsoft.Extensions.AI.OpenAI` to OpenAI 2.12.0, added speech-format auto-detection, and fixed `ImageGeneratingChatClient` content ordering. Keep multimodal and speech fixtures alongside the new approval/state tests.
- `AIFunctionNameAttribute`, `AIParameterNameAttribute`, and `ToolApprovalRequestContent.RequiresConfirmation` are new experimental `MEAI001` APIs. Opt in deliberately and keep approval decisions at the side-effect boundary.
- The August 2026 local official-docs snapshot mirrors the current 64-page `.NET AI` markdown tree, including the renamed tool-calling concept, MEDI/MEVD concepts, quickstart include fragments, and the dedicated vector-store section. Use `mcp` when the protocol itself becomes the design problem; stay here when you still mostly need app composition around `IChatClient` and friends.
- The current `.NET AI` ecosystem guidance separates direct MEAI composition, MCP interoperability, a prebuilt Copilot SDK harness, and Microsoft Agent Framework orchestration. Use `Microsoft Agent Framework` when you need autonomous orchestration, threads, workflows, hosting, or multi-agent collaboration instead of just model composition.

## Decision Cheatsheet

| If you need | Default choice | Why |
|---|---|---|
| App-level provider abstraction with middleware | `Microsoft.Extensions.AI` | Highest leverage for apps and services |
| A reusable provider or connector library | `Microsoft.Extensions.AI.Abstractions` | Keeps your package at the contract layer |
| Typed chat or UI streaming | `IChatClient` with `GetResponseAsync` / `GetStreamingResponseAsync` | Common request/response shape across providers |
| Tool calling from .NET methods | `AIFunction` + `FunctionInvokingChatClient` | Native function metadata and invocation pipeline |
| Typed structured output | `IChatClient.GetResponseAsync<T>` extensions | Keeps schema intent in code instead of prompt parsing |
| Vector search or RAG | `IEmbeddingGenerator` + `Microsoft.Extensions.VectorData.Abstractions` | Standardizes embeddings and store access |
| Local model prototyping | `IChatClient` with an Ollama-backed implementation | Keeps the app on the MEAI abstractions while you validate prompts or UX locally |
| Text-to-image or image-generation middleware | `IImageGenerator` | Use the dedicated image abstraction instead of overloading chat APIs |
| Evaluation and regression gates | `Microsoft.Extensions.AI.Evaluation.*` | Relevance, safety, task adherence, caching, reports |
| Agent threads or multi-step autonomous orchestration | `microsoft-agent-framework` | This is beyond plain provider abstraction |

## Common Failure Modes

- Referencing only `Microsoft.Extensions.AI.Abstractions` in an app and then rebuilding middleware, telemetry, or function invocation by hand.
- Treating `IChatClient` as if it already gives you durable agent threads, orchestration, or hosted-agent semantics.
- Mixing provider-specific assistants APIs with `IChatClient` as if they were the same runtime contract.
- Forgetting to distinguish stateless history replay from stateful `ConversationId` flows.
- Hiding important chat behavior in singleton service fields instead of explicit message history, options, or persistent storage.
- Adding tool calling without validating parameter binding, invalid input behavior, side effects, or DI-scoped dependencies.
- Building RAG without stable chunking, embedding-model/version tracking, or vector dimension discipline.
- Shipping AI features without evaluation baselines, safety checks, or telemetry for prompt/model drift.

## Deliver

- a justified package and abstraction choice: `Abstractions` only vs full `Microsoft.Extensions.AI`
- a concrete `IChatClient` / `IEmbeddingGenerator` composition strategy
- explicit tool-calling, options, state, caching, logging, and telemetry decisions
- vector-search, evaluation, or MCP integration guidance when the scenario needs it
- a clear escalation path to Agent Framework when the problem exceeds provider abstraction

## Validate

- the abstraction layer solves a real portability, testability, or composition problem
- provider registration and middleware order stay explicit in DI
- chat state management matches whether the provider is stateless or stateful
- structured output, tool invocation, and embedding flows are typed and observable
- vector store, embedding model, and chunking strategy are consistent
- evaluation or safety gates exist for important prompts and agent-like behaviors
- agentic requirements are not being under-modeled as a simple `IChatClient` integration

When exact wording, edge-case API behavior, or less-common examples matter, check the local official docs snapshot before relying on summaries.

## References

- [official-docs-index.md](references/official-docs-index.md) - Slim local snapshot map with direct links to every mirrored `.NET AI` docs page plus API-reference pointers
- [patterns.md](references/patterns.md) - Package choice, `IChatClient`, embeddings, DI pipelines, tool-calling, and Agent Framework escalation guidance
- [examples.md](references/examples.md) - Quickstart-to-task map covering chat, structured output, function calling, vector search, local models, MCP, and assistants
- [evaluation.md](references/evaluation.md) - Quality, NLP, safety, caching, reporting, and CI-oriented evaluation guidance

© managedcode · MIT · managedcode/dotnet-skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
microsoft-extensions-configuration Aaronontheweb Скилл microsoft-extensions-configuration для Claude и других ИИ-редакторов: подсказывает, как привязывать конфигурацию из appsettings.json к типизированным классам и проверять её на старте приложения. CX Codex +1 621установок microsoft-azure-webjobs-extensions-authentication-events-dotnet Microsoft Скилл microsoft-azure-webjobs-extensions-authentication-events-dotnet для Claude Code помогает писать обработчики событий аутентификации Microsoft Entra в Azure Functions на .NET. CX Codex +1 1установок rag-architect https://github.com/Jeffallan Скилл rag-architect проектирует RAG-системы: разбивает документы на чанки, генерирует эмбеддинги, настраивает векторные базы, строит гибридный поиск и оценивает качество извлечения контекста. CX Codex +1 5 100установок langchain4j-rag-implementation-patterns giuseppe-trisciuoglio Скилл langchain4j-rag-implementation-patterns для ИИ-кодинга, который разворачивает RAG-пайплайны на LangChain4j: загрузка документов, эмбеддинги, векторный поиск и ответы по базе знаний. CX Codex +1 3 900установок AgentDB Vector Search ruvnet Скилл AgentDB Vector Search для быстрого семантического поиска документов через векторную базу AgentDB. Используй для RAG-систем, поисковых движков и баз знаний, где нужна релевантная выборка из больших объёмов текста. CX Codex +1 1 100установок upstash-vector-db-skills gocallum Скилл upstash-vector-db-skills для Claude Code ведёт агента по настройке Upstash Vector: создание индекса, загрузка документов, семантический поиск и неймспейсы. Закрывает поиск по смыслу на Vercel. CX Codex +1 369установок

Из того же набора38

Весь набор →
signalr Помогает проектировать хабы SignalR, настраивать стриминг, группы и обработку разрывов связи в ASP.NET Core. CX Codex +1 ★ 521звёзд репо code-testing-implementer Субагент code-testing-implementer реализует один этап плана тестирования: добавляет тесты и проверяет, что они собираются и проходят. Подключайте его для выполнения этапа или цикла сборки и исправления тестов. CX Codex ★ 521звёзд репо mcp Помогает создавать и подключать MCP-серверы и клиенты на C# в среде .NET 8+, настраивая stdio, Streamable HTTP и обмен инструментами. CX Codex +1 ★ 521звёзд репо unit-test-generation Промпт unit-test-generation для Claude Code помогает писать компактные модульные тесты, проверяющие поведение и выявляющие правдоподобные ошибки. Тестирует новый код и расширяет существующий набор. CX Codex +1 ★ 521звёзд репо wpf Готовые правила и паттерны для WPF-приложений: биндинги, команды, потоки, стили. Пригодится при работе с UI, MVVM или переносе проекта с .NET Framework на .NET. CX Codex +1 ★ 521звёзд репо worker-services Скилл worker-services помогает создавать фоновые службы .NET на базе BackgroundService и Generic Host с корректным graceful shutdown и скоупами зависимостей. CX Codex +1 ★ 521звёзд репо aspire Скилл помогает создавать и обновлять AppHost для распределённых приложений на C# или TypeScript. Он пригодится для подключения сервисов, интеграций и тестов Aspire. CX Codex +1 ★ 521звёзд репо improve-skill-quality Скилл improve-skill-quality для Claude Code, диагностирующий и исправляющий скиллы dotnet/skills репозитория, которые теряют к собственному базелайну, не активируются, зависают или возвращают «нет улучшения». CX Codex +1 ★ 521звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой