Для чого
Агент говорить за допомогою сервісів OpenAI, Anthropic, Deepgram, ElevenLabs і LiveKit, і працює з вашими обліковими записами в них — тому рахунок за ці сервіси приходить вам. Тут ви вводите ключі доступу до них і бачите, які вже задані. Сторінка відкрита лише адміністратору: ключ — це доступ до рахунку компанії.
Що на екрані
- 1
Набори ключів
Ключі згруповані за призначенням: Realtime (OpenAI), Каскад (Deepgram + Anthropic), синтез голосу для української, телефонія і сховище записів. Позначка «чинний профіль» — набір, на якому агент працює зараз; другий профіль перемикається в «Налаштуваннях агента» → «Голос і мови».
- 2
Картка ключа
Стан ключа — «збережено в системі», «з оточення процесу» (ключ задано на сервері під час встановлення) або «не задано» — і чотири останні символи, щоб звірити, той це ключ чи інший. Нижче — що перестане працювати без ключа, де його взяти, хто і коли його змінював.
- 3
Доступ до моделей
Перевірка в самого провайдера: чи відкриває ваш ключ моделі, призначені агенту. Червоний значок означає, що ключ правильний, але модель у вашому проєкті OpenAI не ввімкнена — і дзвінок зірветься вже тоді, коли клієнт на лінії.
- 4
Як зберігаються ключі
Ключ шифрується перед записом у базу, а ключа для розшифрування в базі немає. Кожна зміна потрапляє в «Журнал дій» з іменем і часом, але саме значення — ні.
Типові дії
Підключити голос агента через OpenAI
- Створіть ключ на platform.openai.com → API keys.
- У наборі «Realtime (OpenAI)» вставте його в поле «OpenAI API Key» і натисніть «Зберегти».
- Зачекайте хвилину — ключ підхоплюється без перезапуску.
- Перевірте картку «Доступ до моделей» і поговоріть з агентом у «Тестовому дзвінку».
Налаштувати сховище для записів розмов
- Створіть приватний бакет (окреме сховище файлів) в AWS S3, Cloudflare R2, Backblaze B2 чи MinIO.
- У наборі «Сховище записів розмов» заповніть «Назва бакета», «Access Key» і «Secret Key»; для R2, Backblaze чи MinIO — ще й «Endpoint» і «Регіон».
- Натисніть «Зберегти» біля кожного поля окремо.
- Відкрийте «Запис розмов» — якщо запис входить у ваш тариф, кнопка «Увімкнути запис» стане доступною.
Замінити ключ, який міг потрапити в чужі руки
- Створіть новий ключ у кабінеті провайдера.
- Вставте його в потрібне поле й натисніть «Зберегти» — старе значення буде замінено.
- Звірте чотири останні символи біля назви ключа.
- Видаліть старий ключ у кабінеті провайдера, щоб ним більше ніхто не скористався.
Часті питання
Де зберігаються ключі і хто їх бачить?
У базі даних у зашифрованому вигляді; ключа для розшифрування там немає, тож сама копія бази ваших ключів не видає. Введене значення більше ніде не показується — ні тут, ні в журналі, лише чотири останні символи. Відкрити цю сторінку може тільки адміністратор воркспейсу.
Що означає «з оточення процесу»?
Ключ задали на сервері під час встановлення системи, і поки ви не введете свій, працює він. Щойно ви збережете власний ключ, система братиме ваш. «видалити збережене значення» (після підтвердження) повертає до серверного ключа, а не вимикає сервіс.
Чи потрібні ключі обох профілів?
Ні, достатньо набору чинного профілю й ключів телефонії (LiveKit). Але ключ OpenAI знадобиться й у каскадному профілі: ним користуються фонові задачі — витяг фактів, підсумки, оцінка лідів і пошук у базі знань. ElevenLabs необовʼязковий — без нього українською, польською й чеською говорить голос OpenAI, з помітним акцентом.
Я натиснув «Зберегти» з порожнім полем. Що сталося?
Нічого: порожнє поле означає «не змінювати», і збережений ключ лишається на місці. Щоб видалити ключ, натисніть під полем «видалити збережене значення» й підтвердьте — тоді запрацює серверний ключ, якщо він є, а якщо ні, позначка зміниться на «не задано».
Чому ключі не перенеслися в новий воркспейс?
Копія воркспейсу навмисно не переносить ключі: за дзвінки нового напряму має платити той, чий це рахунок. Введіть ключі в новому воркспейсі окремо.