# azure-search-documents-dotnet

Скилл обучает агента работе с библиотекой Azure.Search.Documents в .NET: полнотекстовый, векторный и гибридный поиск, фасеты и создание индексов в C#.

- скилл · `type=skill` · Claude Code, GitHub Copilot · 1 установка · ★ 3149
- Автор: Microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/azure-sdk-dotnet/skills/azure-search-documents-dotnet/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/azure-search-documents-dotnet

## Что делает

Скилл содержит практические паттерны для работы с официальным пакетом `Azure.Search.Documents` версий v11.7.0 и preview v11.8.0-beta.1. Он ориентирует агента в выборе нужного клиента: `SearchClient` отвечает за запросы и CRUD документов, `SearchIndexClient` управляет индексами, а `SearchIndexerClient` настраивает источники данных и пайплайны индексации.

В инструкциях показаны два подхода к описанию схем: декларативный через `FieldBuilder` с атрибутами вроде `[SimpleField]` и `[VectorSearchField]`, а также ручное объявление полей. Для выборки приведены примеры базовой фильтрации, автодополнения, фасетов и векторного поиска по HNSW-алгоритму через `VectorizedQuery`.

Код опирается на библиотеку `Azure.Identity`. Для работы обязательны переменные окружения `SEARCH_ENDPOINT` и `SEARCH_INDEX_NAME`, а при авторизации в продакшене через Entra ID требуется задать `AZURE_TOKEN_CREDENTIALS=prod`. Без корректных параметров окружения подключение к сервису завершится ошибкой.

## Требования
- Работает с: Azure

## Установка

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

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/skills azure-search-documents-dotnet
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/microsoft/skills --path .github/plugins/azure-sdk-dotnet/skills/azure-search-documents-dotnet
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/azure-sdk-dotnet/skills/azure-search-documents-dotnet/SKILL.md

## Когда брать
- настроить подключение к Azure AI Search через Entra ID или API-ключ
- описать схему индекса с помощью `FieldBuilder` и атрибутов C#
- выполнить пакетную загрузку или удаление документов через `IndexDocumentsBatch`
- добавить фасетную фильтрацию и векторный поиск в приложение

## Примеры запросов агенту
- Настрой векторный поиск через `SearchClient` в C# для модели отелей.
- Создай индекс Azure AI Search с помощью `FieldBuilder` и HNSW-профиля.
- Покажи пример пакетного обновления документов через `IndexDocumentsBatch`.

## Похожие
- [caveman-manage](https://affpapa.org/nevibecode/skills/caveman-manage.md) — скилл · 104200 установок
- [workers-best-practices](https://affpapa.org/nevibecode/skills/cloudflare-workers-best-practices.md) — скилл · 126100 установок
- [cloudflare-email-service](https://affpapa.org/nevibecode/skills/cloudflare-email-service.md) — скилл · 102300 установок
- [firebase-basics](https://affpapa.org/nevibecode/skills/firebase-basics.md) — скилл · 14100 установок
- [cloudflare-one](https://affpapa.org/nevibecode/skills/cloudflare-one.md) — скилл · 93100 установок
- [cloudflare-one-migrations](https://affpapa.org/nevibecode/skills/cloudflare-one-migrations.md) — скилл · 89500 установок

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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