# API Architect

Субагент собирает требования к подключению сервиса к внешнему API, затем проектирует слои и пишет рабочий код. Генерация начинается только после команды generate.

- субагент · `type=agent` · GitHub Copilot · ★ 40451
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/api-architect.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/api-architect

## Что делает

Сначала API Architect просит указать язык программирования, URL конечной точки и хотя бы один REST-метод. DTO запроса и ответа можно передать отдельно; если их нет, субагент подготовит макеты. Также можно задать параметры отказоустойчивости и тестовые случаи.

После команды `generate` субагент формирует решение из трёх слоёв: service для REST-запросов, manager для конфигурации и тестирования, resilience для заданных механизмов отказоустойчивости. Он должен написать код для всех слоёв и использовать Code Interpreter. Пока вы не передали обязательные сведения и команду запуска, код не генерируется.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/agents/api-architect.agent.md`

### Claude Code

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/agents/api-architect.agent.md

## Когда брать
- собрать требования для подключения клиентского сервиса к внешнему API
- спроектировать разделение API-кода на три слоя
- описать REST-операции для конечной точки
- добавить заданные механизмы отказоустойчивости и тестовые случаи

## Примеры запросов агенту
- Подготовь подключение к внешнему API: сначала запроси у меня обязательные параметры и нужные REST-методы.
- Вот язык, URL конечной точки и нужные REST-методы. Предложи DTO и параметры отказоустойчивости, которые нужно уточнить.
- Сформируй рабочий код для согласованных требований: `generate`.

## Похожие
- [api-testing-patterns](https://affpapa.org/nevibecode/skills/api-testing-patterns.md) — скилл · 605 установок
- [api-testing](https://affpapa.org/nevibecode/skills/api-testing.md) — скилл · 1300 установок
- [api-security-testing](https://affpapa.org/nevibecode/skills/api-security-testing.md) — скилл · 121 установка
- [api-security-audit](https://affpapa.org/nevibecode/agents/api-security-audit.md) — субагент · 3202 установки
- [api-integration-surface-strategy](https://affpapa.org/nevibecode/skills/api-integration-surface-strategy.md) — скилл · 8000 установок
- [recoup-platform-api-access](https://affpapa.org/nevibecode/skills/recoup-platform-api-access.md) — скилл · 4900 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 949 карточек

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

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