# operating-livekit-agents

Скилл помогает развернуть агента в LiveKit Cloud, настроить предзагрузку моделей в воркерах, откат версий и корректное завершение звонков.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 366 установок · ★ 74
- Автор: livekit
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/livekit/agent-skills/tree/HEAD/skills/operating-livekit-agents/SKILL.md
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/skills/operating-livekit-agents

## Что делает

Скилл описывает эксплуатацию голосовых агентов через интерфейс `lk agent` и файл конфигурации `livekit.toml`. Развёртывание происходит в виде контейнера. Секреты передаются через переменные окружения, а история релизов позволяет быстро выполнить откат. Перед отправкой в облако скилл предлагает запускать контейнер локально через `lk agent start`: это включает продакшен-режим с обработкой завершения вызовов, чего нет в обычном `dev`.

Основное внимание уделено архитектуре процессов. Родительский воркер выполняет предварительную загрузку (prewarm) тяжёлых неизменяемых ресурсов — например, моделей VAD и детекции реплик. Дочерние процессы наследуют эти объекты без повторного выделения памяти. Фреймворк сам управляет циклом событий. Создание собственных асинхронных рантаймов или блокирующие вызовы внутри синхронных конструкторов приводят к падению соединений с ошибками о закрытом event loop.

В продакшене таймаут завершения работы (drain timeout) обязан совпадать со временем ожидания оркестратора, иначе звонки оборвутся на полуслове. При сбоях провайдеров STT, TTS или LLM скилл ориентирует систему на понятный голосовой ответ пользователю вместо зависания и тишины в канале.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install livekit/agent-skills operating-livekit-agents
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/livekit/agent-skills --path skills/operating-livekit-agents
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add livekit/agent-skills --skill operating-livekit-agents -a opencode
```

### Claude.ai

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

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

## Когда брать
- развернуть агента в LiveKit Cloud и настроить откат версий
- устранить ошибки привязки event loop и зависания воркеров
- настроить prewarm для VAD без лишнего расхода оперативной памяти
- обеспечить graceful shutdown без обрыва текущих разговоров

## Примеры запросов агенту
- Помоги настроить graceful shutdown для агента LiveKit, чтобы вызовы не обрывались при перезапуске контейнера.
- Почему первый звонок после старта воркера отвечает с задержкой и как вынести VAD в prewarm?
- Разверни новую версию агента в LiveKit Cloud и проверь логи развёртывания.

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

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

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