# azure-ai-language-conversations-py

Скилл для работы с Conversational Language Understanding через Python SDK: разбор интентов и сущностей в диалогах. Пригодится, если пишешь NLP-фичи на Azure.

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

## Что делает

Скилл превращает Claude в помощника по `azure-ai-language-conversations`. Внутри — системный промпт, который задаёт роль эксперта по Azure AI Services и NLP, и набор правил: брать свежую версию SDK, работать через `ConversationAnalysisClient`, показывать структуру payload для анализа диалога и обрабатывать исключения.

Аутентификация — через `DefaultAzureCredential`. Он одинаково работает локально (Azure CLI, VS Code, Developer CLI) и в Azure (managed identity, workload identity), поэтому код не придётся переписывать при переезде в прод. Для продакшена скилл советует выставить `AZURE_TOKEN_CREDENTIALS=prod`, чтобы сузить цепочку до безопасных учёток. `AzureKeyCredential` оставлен для уже существующих keyed-развёртываний, которые ещё не перешли на Entra ID.

Ещё одно требование — оборачивать клиент в контекстный менеджер: `with ConversationAnalysisClient(...) as client:` для синхронного кода и `async with` для асинхронного, вместе с `async with DefaultAzureCredential()`. Иначе сокеты и кэш токенов освобождаются не сразу. Смешивать синхронные клиенты `azure.ai.language.conversations` с асинхронными из `.aio` в одном пути вызова нельзя — выбери один режим на модуль. Понадобятся переменные окружения для endpoint, имени проекта и deployment.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/skills --skill azure-ai-language-conversations-py -a claude-code
```

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/skills azure-ai-language-conversations-py
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/microsoft/skills --path .github/plugins/azure-sdk-python/skills/azure-ai-language-conversations-py
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- разобрать интент и сущности в реплике пользователя
- собрать payload для `analyze_conversation` без ошибок в структуре
- перевести аутентификацию с API-ключа на `DefaultAzureCredential`
- выбрать между синхронным и асинхронным клиентом и не смешать их
- закрывать HTTP-транспорты и кэш токенов через контекстный менеджер

## Примеры запросов агенту
- Покажи, как через `ConversationAnalysisClient` разобрать интент в фразе про встречу
- Перепиши этот код на `DefaultAzureCredential` вместо `AzureKeyCredential`
- Сделай асинхронный вариант анализа диалога с `async with` для клиента и credential

## Похожие
- [python-azure-iot-edge-modules](https://affpapa.org/nevibecode/skills/python-azure-iot-edge-modules.md) — скилл · 47 установок
- [azure-speech-to-text](https://affpapa.org/nevibecode/skills/azure-speech-to-text.md) — скилл · 775 установок
- [azure-text-to-speech](https://affpapa.org/nevibecode/skills/azure-text-to-speech.md) — скилл · 601 установка
- [azure-architecture](https://affpapa.org/nevibecode/skills/azure-architecture.md) — скилл · 413 установок
- [azure-functions](https://affpapa.org/nevibecode/skills/microsoftdocs-azure-functions.md) — скилл · 378 установок
- [dataverse-python-best-practices](https://affpapa.org/nevibecode/rules/dataverse-python-best-practices.md) — правило · ★ 40418

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

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

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