---
title: "Як налаштувати доступ до AI Помічника"
description: "Увімкнення AI Помічника на інстансі, read-only режим і права ролей."
---

# Як налаштувати доступ до AI Помічника?

Доступ до AI Помічника налаштовується на двох рівнях: **інстанс** (глобально для організації) і **роль** (хто бачить кнопку і хто може дозволити автоматичні зміни даних).

## Коли знадобиться

- Потрібно увімкнути AI Помічник для команди на платформі.
- Треба дати доступ лише на перегляд і пояснення — без змін через помічника.
- Потрібно обмежити складні дії для окремих ролей (наприклад, оператори — питання, адміни — редагування).

## Що важливо знати

- Глобальне вмикання робить **root-адміністратор** у **Налаштування інстансу**.
- Хто бачить кнопку **«іскра»** і чи може агент змінювати дані — задається в **Ролях** для модуля **AI-асистент**.
- **Agent Read-Only Mode** на інстансі блокує зміни для **усіх**, незалежно від ролі.

## Перед початком

- [x] Ви root-адміністратор (для налаштувань інстансу) або адміністратор з правом редагування ролей.

## Покрокова інструкція

### 1. Увімкнути AI Помічник на інстансі (root)

1. Перейдіть через **Меню → Налаштування** до розділу **«Налаштування інстансу»**.
2. У блоці перемикачів функцій розгорніть категорію **Instance Agent**.
3. Увімкніть **Instance Agent Integration**.
4. За потреби:
   - **Agent Debug Mode** — показувати в чаті деталі роботи помічника (для налагодження);
   - **Agent Read-Only Mode** — лише читання: помічник не створює і не змінює дані, лише пояснює через UI та тури;
   - **Instance Agent: Web Search** / **Instance Agent: Fetch URL** — пошук у публічному інтернеті та читання публічних URL (детально — [окрема інструкція](./enable-ai-assistant-web-research.md)).

Детальніше про інші параметри інстансу — [Налаштувати параметри інстансу](../../settings/how-to/configure-instance.md).

### 2. Налаштувати права ролі

1. Перейдіть через **Меню → Налаштування → Користувачі → Ролі**.
2. Відкрийте роль для редагування.
3. Знайдіть модуль **AI-асистент (Instance Agent)**.
4. Увімкніть доступ до модуля, щоб користувачі ролі бачили кнопку AI Помічника.
5. Окремо визначте право **«Дозволити агенту створювати, змінювати та видаляти дані (режим редагування)»**:
   - **Увімкнено** — помічник може виконувати дії в системі (якщо не увімкнено **Agent Read-Only Mode** на інстансі);
   - **Вимкнено** — лише відповіді, перегляд і пояснення; зміни користувач робить сам у інтерфейсі.
6. За потреби увімкніть **веб-пошук** та **читання публічних URL** — окремі права в тому ж модулі (див. [Увімкнути веб-пошук і читання URL](./enable-ai-assistant-web-research.md)).

7. Збережіть роль.

### 3. Перевірити доступ

1. Увійдіть під користувачем тестової ролі.
2. Переконайтеся, що в верхній панелі є кнопка **«іскра»**.
3. Надішліть тестовий запит на зміну налаштувань:
   - з правом редагування — помічник може запропонувати виконати дію;
   - без права або з **Agent Read-Only Mode** — лише інструкція або UI-тур.

## Що відбувається після

- Користувачі з відповідною роллю бачать AI Помічник у ConnectiveOne.
- Обмеження read-only застосовуються до кожного запиту автоматично.

## Пов’язані матеріали

- [Що таке AI Помічник](../explanation/what-is-ai-assistant.md)
- [Як користуватися AI Помічником](./use-ai-assistant.md)
- [Веб-пошук і читання сайтів у AI Помічнику](./use-ai-assistant-web-research.md)
- [Увімкнути веб-пошук і читання URL](./enable-ai-assistant-web-research.md)
- [Налаштувати ролі](../../settings/how-to/configure-roles.md)
- [Довідник термінів: AI Помічник](../../product-glossary.md#ai-помічник)