> For the complete documentation index, see [llms.txt](https://docs.skillzrun.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skillzrun.com/administruvannya/shtuchnii-intelekt/vchitel-zi-shtuchnim-intelektom-shi-agent.md).

# Вчитель зі штучним інтелектом (ШІ-агент)

Співробітник-бот, який спілкується з учнями в чаті та відповідає на питання виключно за змістом вашого курсу

Це окрема роль у списку [співробітників](https://docs.skillzrun.com/administruvannya/spivrobitniki), створена під одну-єдину задачу — спілкування з учнями в [чаті](https://docs.skillzrun.com/vzayemodiya/chat) застосунку. Для учня він виглядає як звичайний співрозмовник у списку чатів.

## Як створити агента

Агент створюється так само, як звичайний співробітник — у розділі **«Співробітники»** з роллю **«Вчитель зі штучним інтелектом»**. Заповнюються:

* **Ім'я** та **фото** — те, як агент підписаний у чаті в учня.
* **Роль** — вчитель зі штучним інтелектом.
* **Предмети** — з якими курсами він працює.
* **Інструкції** — найважливіше поле (див. нижче).

## Інструкції — це характер агента

Інструкції визначають, як саме агент спілкується: ким він себе представляє, якою мовою відповідає, якої термінології тримається, що робить і як відповідає учням.

Наприклад, можна вказати, що агент завжди відповідає англійською — незалежно від того, якою мовою до нього звертаються, — і що він має використовувати медичну термінологію. Агент цих інструкцій тримається.

## Правила прив'язки до предметів

* Агентів можна створювати безліч.
* У **одного агента може бути багато предметів**.
* Але в **одного предмета може бути лише один агент**.

{% hint style="warning" %}
Після створення агента перелік його предметів змінити вже не можна — він зафіксований. Тому продумайте набір предметів заздалегідь. Якщо у вас курси різної тематики, зручніше зробити окремого агента під кожен предмет із своїми інструкціями.
{% endhint %}

## Коли учень бачить агента в чаті

Агент з'являється в списку співрозмовників лише в того учня, який має доступ до предмета, закріпленого за цим агентом. Якщо учень агента не бачить — перевірте, чи відкритий йому відповідний предмет (через групу та набір рівнів у профілі учня).

## Звідки агент бере відповіді

Агент має доступ до контенту тих предметів, які йому надані, і відповідає саме за ним. На загальні питання, не пов'язані з курсом, він не відповідає — а ввічливо повертає учня до теми.

{% hint style="danger" %}
У знання агента потрапляє **лише та теорія, яка була розпізнана штучним інтелектом**. У уроці видно позначку, чи проаналізована теорія.

Теорія, додана зовні — наприклад, створена штучним інтелектом через [MCP-сервер](https://docs.skillzrun.com/administruvannya/shtuchnii-intelekt/mcp-server-keruvannya-kontentom-cherez-shi), — не розпізнається автоматично і в базу знань агента не потрапляє. Якщо агент «не знає» матеріалу, який точно є в курсі, — перш за все перевірте це.
{% endhint %}

## Витрати на агента

Кожна відповідь агента витрачає токени з вашого OpenAI-ключа. Ці витрати видно у вкладці [«ШІ токени»](https://docs.skillzrun.com/navchannya/nalashtuvannya-predmeta#shi-tokeni) налаштувань предмета — запити агента позначені функцією `support`. Як підключити ключ — на сторінці [Open AI](https://docs.skillzrun.com/administruvannya/shtuchnii-intelekt/open-ai-shi-perevirka-zavdan-generaciya-vprav).

## Живі люди поруч із агентом

ШІ-агент не замінює живе спілкування, а доповнює його: у тому самому чаті учень може писати і живим співробітникам. Ви самі вирішуєте, де підтримку надає штучний інтелект, а де — людина. Деталі — на сторінці [Чат](https://docs.skillzrun.com/vzayemodiya/chat).

## Добовий ліміт токенів

Для ШІ-вчителя можна задати, скільки токенів учень використовує в чаті протягом доби. Типове значення — **50 000 токенів на день для кожного учня окремо**. Коли учень вичерпав свій ліміт, спілкування з агентом стає недоступним до оновлення добового ліміту.

Щоб змінити значення, відкрийте меню свого аватара у правому верхньому куті, перейдіть до **«Співробітники»**, оберіть ШІ-вчителя й знайдіть поле **«Ліміт токенів»**. Значення **0** прибирає обмеження.