# custom-agents

Субагент custom-agents для построения пользовательских агентов на базе Microsoft Agent Framework. Позволяет наследовать класс AIAgent и реализовать логику обработки сообщений.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 521 у репозитория
- Автор: westey-m
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/concepts/agents/custom-agents.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/custom-agents

## Что делает

custom-agents показывает, как создать агента, наследуя класс `AIAgent` и реализуя методы сессии и обработки сообщений. Фреймворк поддерживает управление состоянием через базовые классы вроде `InMemoryAgentSession` и `ServiceIdAgentSession` — они хранят историю чата и другое состояние диалога.

Агент требует реализации двух заводских методов: `CreateSessionCoreAsync` для создания новой сессии и `DeserializeSessionCoreAsync` для восстановления из сохранённого состояния. Это даёт агенту контроль над жизненным циклом сессии и позволяет прикреплять дополнительное поведение.

Для логики обработки нужно реализовать `RunCoreAsync` (синхронный ответ) и `RunCoreStreamingAsync` (потоковый ответ). В обоих методах следует получить сообщения из хранилища истории через `ChatHistoryProvider` на сессии, иначе агент не сможет вести многоходовой диалог. Требуется пакет `Microsoft.Agents.AI.Abstractions`.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/agents/custom-agents.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/custom-agents.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/custom-agents.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/concepts/agents/custom-agents.md

## Когда брать
- создать собственного агента с обработкой сообщений
- управлять состоянием сессии и историей диалога
- реализовать синхронный и потоковый ответ агента
- сохранять и восстанавливать состояние сессии из JSON

## Примеры запросов агенту
- Создай агента, который преобразует входящие сообщения в UPPERCASE
- Реализуй сессию для хранения истории чата в памяти
- Напиши методы `CreateSessionCoreAsync` и `DeserializeSessionCoreAsync` для управления жизненным циклом

## Похожие
- [logicapps-custom-code-net10-migration](https://affpapa.org/nevibecode/skills/logicapps-custom-code-net10-migration.md) — скилл · ★ 41430 у репозитория
- [clean-architecture](https://affpapa.org/nevibecode/skills/codewithmukesh-clean-architecture.md) — скилл · 4200 установок
- [ddd](https://affpapa.org/nevibecode/skills/ddd.md) — скилл · 4100 установок
- [azure-ai-openai-dotnet](https://affpapa.org/nevibecode/skills/azure-ai-openai-dotnet.md) — скилл · 2 установки
- [azure-search-documents-dotnet](https://affpapa.org/nevibecode/skills/azure-search-documents-dotnet.md) — скилл · 1 установка
- [csharp-mcp-server](https://affpapa.org/nevibecode/rules/csharp-mcp-server.md) — правило · ★ 41430 у репозитория

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

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

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