Адміністрування робочого простору та організації
Доступ до робочого простору визначається автентифікованим користувачем і межею робочого простору або організації. В організації адміністратори можуть керувати учасниками організації, запрошеннями та ролями у розділі Загін: виберіть Уся організація в рядку фільтрів.
Надавайте найменші необхідні повноваження:
- Надавайте учасникам доступ лише до потрібного їм робочого простору й інформації.
- Надавайте адміністративні ролі лише тим, хто керує учасниками, налаштуваннями або діями, що мають значний вплив.
- Регулярно перевіряйте запрошення до організації та ролі учасників.
- Негайно скасовуйте доступ, коли завершується співпраця з підрядником, клієнтом або трудові відносини.
Ключі API
Відкрийте Агенти та API → Ключі API (вкладка Ключі API вгорі розділу), щоб створювати ключі API та керувати ними.
| Дозвіл | Доступ |
|---|---|
workspace:read | Читання даних проєкту. |
workspace:write | Зміна даних проєкту. |
strategy:read / strategy:write | Читання або зміна стратегії проєкту. |
content:read / content:write | Читання, створення та зміна контенту. |
reports:read | Читання звітів. |
admin | Повний доступ. Використовуйте ощадливо. |
За можливості надавайте перевагу ключу з обмеженням на проєкт, а не ключу для кількох проєктів. Секретне значення показується лише під час створення. Зберігайте його в належному менеджері секретів або схваленому середовищі інструменту, а не на сторінці, у чаті, завантаженому файлі, знімку екрана чи репозиторії вихідного коду.
Негайно відкликайте ключ, якщо він міг бути розкритий, більше не потрібний або належить учаснику, який вибуває. Також можна видалити відкликаний ключ, щоб прибрати його зі списку.
Ключі API та агенти
На сторінці Ключі API кожен агент показаний один раз: як він потрапляє до ActVox (через ActVox CLI, застосунок або ключ), у яких робочих просторах він є і коли востаннє був активний. Ключі, що не належать жодному агентові, лежать у списку Звичайні ключі. Кнопки Керування і Видати API-ключ видно лише біля агентів, якими ви можете керувати: це той, хто підключив агента, або власник чи адміністратор кожного робочого простору, де він є.
- Керування відкриває панель поруч зі списком: дозволи й робочі простори агента, його ключі та підключення і кнопка Відкликати агента. Зміна дозволів там змінює їх для всіх способів, якими агент підключається.
- Видати API-ключ дає агентові ключ, не чіпаючи його інших підключень: працюють і ключ, і вони. Ключ має ті самі дозволи, що й агент.
- Замінити ключ створює новий ключ з тією самою назвою та дозволами, а потім відкликає старий. Ключ зберігається лише як геш, тому ActVox не може показати його знову: скопіюйте новий ключ або рядок
export ACTVOX_API_KEY=поруч із ним, поки вони на екрані. Якщо старий ключ відкликати не вдалося, сторінка повідомляє, що він досі активний. - Відключити завершує одне підключення. Якщо підключити того самого агента знову з того самого застосунку, воно замінить попереднє підключення, а не додасться другим.
- Агент на сервері без збереженого входу може виконати
actvox auth login --device --agent <handle>. Ви підтверджуєте вхід як цього агента, тому він зберігає свою ідентичність, а не повертається новим агентом.
Використання API
Відкрийте Агенти та API → Використання, щоб побачити запити, які агенти, ключі та підключення надіслали до API та MCP ActVox.
- Виберіть дні, ключ або агента та інструмент. Адреса зберігає фільтри, тому скопійоване посилання відкриває той самий вигляд.
- Графік показує запити за кожен день за UTC з розбивкою на MCP, CLI та API. Запит з’являється приблизно за хвилину. Використання зберігається 90 днів.
- За ключем або агентом перелічує кожного агента та ваші власні ключі. Виберіть агента, щоб побачити його ключі та підключення. За інструментом перелічує кожен інструмент. Виберіть інструмент, щоб відфільтрувати за ним.
- Відхилено або з помилкою рахує відповіді HTTP 4xx і 5xx та перевищення ліміту. Інструмент MCP, який повернув помилку всередині виконаного запиту, не враховується.
- Власник або адміністратор бачить назву кожного ключа й підключення агента. Інші учасники бачать агентів, якими можуть користуватися, і свої ключі та підключення. Решту показано як Інші ключі. Підсумки однакові для всіх.
- Не враховуються: дії чат-агента в застосунку та запити з ключем, який не прив’язаний до цього простору. Запит через підключення MCP враховується в просторі, де підключення створено.
- Рядок угорі показує, яку частину тарифу використано в цьому періоді. Відкрити оплату відкриває Налаштування › Оплата.
Журнал API
Відкрийте Агенти та API → Журнал, щоб побачити кожен запит, який агенти, ключі та підключення надіслали до API та MCP ActVox, спершу нові.
- У кожному рядку — час, ключ або агент, інструмент, об’єкт, статус і тривалість запиту. Час указано у вашому часовому поясі.
- Виберіть останні 24 години, 7 або 30 днів, ключ або агента та інструмент. Адреса зберігає фільтри, тому скопійоване посилання відкриває той самий вигляд.
- Сторінка з новими запитами оновлюється сама. Натисніть Старіші, щоб побачити ранніші запити, і Нові, щоб повернутися.
- Об’єкт — це id того, до чого звернувся запит, наприклад сторінки або рядка бази даних. Його видно лише поруч із ключем або підключенням, ім’я якого вам видно.
- Статус — це відповідь HTTP: OK, Відхилено (4xx), Ліміт запитів (429) або Помилка (5xx).
- Власник або адміністратор бачить ім’я кожного ключа й підключення агента. Інші учасники бачать агентів, якими можуть користуватися, і свої ключі та підключення. Решту показано як Інші ключі, без об’єкта.
- Запити зберігаються 30 днів. Запит з’являється приблизно за хвилину після надсилання. Журнал зберігає лише id: ніколи ключ, токен або вміст запиту.
Безпека облікового запису та поширення
- Відкрийте Керування обліковим записом у меню облікового запису: відкриється Налаштування → Обліковий запис з іменем, адресами email, підключеними обліковими записами, паролем, passkey, активними пристроями та видаленням облікового запису. Адміністратори організації відкривають Налаштування → Організація через шестірню на рядку організації: назва, логотип, вихід з організації або її видалення та хто може створювати робочі простори. Використання й платежі розташовані в Налаштування → Оплата.
- Запрошуйте, змінюйте та вилучайте людей у розділі Загін. Запросити людину надсилає запрошення. Уся організація в рядку фільтрів показує всіх в організації, запрошення в очікуванні, кожне з Надіслати знову і Відкликати, та агентів. Відкрийте профіль людини, щоб задати її роль і рівень у кожному просторі. У Налаштування → Доступ лишаються режим доступу до простору та рівні агентів.
- Використовуйте елементи керування безпекою облікового запису для особистих налаштувань безпеки.
- Використовуйте Налаштування → Спільні посилання, щоб перевірити, що саме зараз доступне зовні.
- Ставтеся до публічних посилань як до публічних. Не покладайтеся на прихованість URL як на засіб безпеки.
- Змінюйте посилання, змінивши його аудиторію, або відкличте його та створіть нове.
- Використовуйте посилання лише для організації, коли матеріал призначений виключно для вашої організації.
Ліміти тарифів
Тариф Free обмежує кількість блоків у ваших просторах. На всіх платних тарифах блоків без обмежень. Тариф визначає, скільки місця для файлів доступно вашим просторам. Сховище особистого тарифу спільне для всіх ваших просторів. У Team Starter, Team і Grow кожне оплачене місце поповнює одне спільне сховище організації: наприклад, два оплачені місця Team дають їй 20 ГБ.
| Тариф | Блоки | Сховище файлів |
|---|---|---|
| Free | 1 000 | 1 ГБ |
| Starter | Без обмежень | 2 ГБ |
| Personal | Без обмежень | 5 ГБ |
| Pro | Без обмежень | 20 ГБ |
| Ultra | Без обмежень | 50 ГБ |
| Освіта | Без обмежень | 20 ГБ |
| Team Starter | Без обмежень | 5 ГБ на оплачене місце |
| Team | Без обмежень | 10 ГБ на оплачене місце |
| Grow | Без обмежень | 20 ГБ на оплачене місце |
- Блок — це абзац, заголовок, пункт списку, зображення, вбудовування, рядок бази даних або елемент дошки. Порожні сторінки, бази даних і дошки не витрачають блоків. Видалення вмісту звільняє блоки.
- У сховищі враховуються всі файли ваших просторів: завантаження, створені зображення та відео, вкладення, збережені версії та файли в кошику.
- ШІ-конектори (Claude, ChatGPT, Grok та інші ШІ-продукти): Free — 3, Starter — 5, Personal — 15, Team Starter — 5 на оплачене місце, Team — 15 на оплачене місце. У Pro, Ultra, «Освіти» і Grow немає ліміту ШІ-конекторів. Інші інтеграції не враховуються.
- Бічна панель показує ліміт, коли ви використовуєте 60% від нього. У розділі Оплата видно, скільки місця для файлів зайнято з ліміту і наскільки його перевищено.