# creating-internal-agents

Скилл creating-internal-agents для сборки внутреннего AI-агента в админке Medusa: модели, модульный сервис, рантайм на streamText(), NDJSON-стрим и страница чата.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 500 установок · ★ 237 у репозитория
- Автор: medusajs
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/medusa-dev/skills/creating-internal-agents/SKILL.md
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/creating-internal-agents

## Что делает

Скилл разбирает полный стек внутреннего агента для админки Medusa: модели `AgentSession` и `AgentMessage`, модульный сервис с клиентом Anthropic и методом `stream()`, рантайм на `streamText()`, POST-маршрут с NDJSON-стримом и страницу чата в админке. Данные агент трогает через MedusaExec: он пишет TypeScript и исполняет его, поэтому кастомный инструмент нужен только там, где кодом не обойтись, например для внешнего API с секретным ключом.

Сессии и сообщения общие для всех агентов, различаются они полем `agent_type`. Отдельные модели под каждый агент создавать не надо, а контейнер передаётся через `experimental_context` — прямой импорт сервисов в файлах инструментов даёт циклические зависимости.

Аутентификация обязательна. Маршруты живут в `src/api/admin/` и принимают `AuthenticatedMedusaRequest`, потому что MedusaExec исполняет произвольный код с доступом к базе: открытый без проверки эндпоинт — это удалённое исполнение кода. После правки моделей нужны миграции `npx medusa db:generate agent && npx medusa db:migrate`. Перед кодом скилл требует загрузить референс под текущую задачу — `reference/agent-setup.md`, `reference/streaming.md` и остальные из таблицы.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install medusajs/medusa-agent-skills plugins/medusa-dev/skills/creating-internal-agents
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-dev/skills/creating-internal-agents
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/medusa-dev/skills/creating-internal-agents/SKILL.md

## Когда брать
- собрать модели сессий и сообщений для чат-агента в админке Medusa
- поднять модульный сервис с клиентом Anthropic и методом `stream()`
- отдать ответ агента потоком NDJSON из POST-маршрута
- встроить страницу чата в админку Medusa
- дать агенту исполнять TypeScript через MedusaExec

## Примеры запросов агенту
- Собери модуль `agent` с моделями `AgentSession` и `AgentMessage` и полем `agent_type`
- Сделай POST-маршрут в `src/api/admin/agent/` с `AuthenticatedMedusaRequest` и NDJSON-стримом
- Добавь страницу чата в админку для агента складских операций

## Похожие
- [creating-plugins](https://affpapa.org/nevibecode/skills/creating-plugins.md) — скилл · 1600 установок
- [convex-agents](https://affpapa.org/nevibecode/skills/convex-agents.md) — скилл · 1500 установок
- [medusa](https://affpapa.org/nevibecode/skills/medusa.md) — скилл · 285 установок
- [mastra-hono](https://affpapa.org/nevibecode/skills/mastra-hono.md) — скилл · 397 установок
- [convex](https://affpapa.org/nevibecode/skills/convex.md) — скилл · 116100 установок
- [developing-genkit-js](https://affpapa.org/nevibecode/skills/developing-genkit-js.md) — скилл · 3600 установок

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

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