Проєкти¶

Дайте кожній справі свою полицю. Проєкт — це окрема тека на сервері агента з власними файлами, власними інструкціями та власними розмовами. Ремонт — окремо, диплом — окремо, і все це на одному агенті.

🏠 Загальнийваша основна тека

💬План на тиждень
💬Питання щодо податків

📁 Ремонтнові чати починаються тут

📝«Бюджет 15 000 €, завжди порівнювати три кошториси»
📄кошториси.pdf · планування.png
💬Плитка для кухні
💬Графік електрика

📁 Сімейна подорож👥 спільний

📄квитки.pdf
💬План по днях

Що дає проєкт¶

Власна тека

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

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

Список розмов показує проєкт, у якому ви зараз перебуваєте, і кожен новий чат починається в ньому. Нічого не треба запам’ятовувати й потім розкладати по місцях.
Особистий або спільний

На агенті, яким ви ділитеся з іншими, проєкт може належати лише вам або бути спільним для всіх — разом із файлами та розмовами.

Усе інше однакове в усіх проєктах: пам’ять і персона агента, його навички, модель і налаштування, ключі та підключені облікові записи, а також ваш кредит. Файловий менеджер і Термінал у панелі завжди показують увесь сервер. Перемикаючи проєкти, ви змінюєте те, де агент працює, а не те, ким він є.

1 Увімкніть проєкти¶

Проєкти вимкнені, доки хтось їх не ввімкне, і поки вони вимкнені, їх ніде не видно: усі розмови працюють у вашій основній теці. Функція нова, тож у панелі вона позначена як Бета.

Панель: Налаштування → Проєкти → Використовувати проєкти.
Telegram: надішліть /projects і натисніть ▶️ Увімкнути проєкти.

Перемикач спільний для всього агента: увімкнути чи вимкнути його може будь-хто, хто ним користується, — власник або запрошений користувач. Вимкнення не чіпає жодної теки. Розмови, розпочаті в проєкті, і далі працюють там; до основної теки повертаються лише нові.

2 Створіть проєкт¶

Панель: відкрийте перемикач проєктів угорі бічної панелі й виберіть Новий проєкт. Введіть назву, натисніть Додати проєкт — і ви вже в ньому, а на вас чекає новий чат.
Telegram: /projects → ➕ Новий проєкт, потім надішліть назву. Бот створить проєкт і одразу перемкне вас у нього.
Налаштування → Проєкти → + Новий проєкт створює проєкт, не виводячи вас із поточного.

Кожен проєкт отримує власну теку на сервері агента.

💡 Якщо на вашому агенті ввімкнено Дозволити додаткових користувачів, панель також запитає, Хто його бачить: Лише я чи Усі користувачі цього агента. Це можна змінити пізніше, див. Проєкти на спільному агенті. Проєкт, створений у Telegram, спочатку особистий.

3 Перемикайтеся між проєктами¶

У панелі перемикач над списком розмов показує, у якому проєкті ви зараз. Виберіть інший — і список заповниться його розмовами, а нові чати починатимуться там. Керування проєктами внизу того самого меню відкриває налаштування.

У Telegram команда /projects (або /menu → Налаштування → 📁 Проєкти) показує ваші проєкти: 🏠 основну теку, 📁 ваші власні, 👥 спільні, а біля активного стоїть ✅. Торкніться іншого, щоб перемкнутися. Якщо чат, у якому ви зараз, належить до іншого проєкту, у вибраному одразу розпочнеться нова розмова, і її закріплений заголовок починатиметься з назви проєкту. /sessions після цього покаже розмови цього проєкту, а його назву — вгорі.

Перейменування, спільний доступ, інструкції та видалення — у панелі.

Варто знати:

Розмова залишається там, де почалася. Перемикання ніколи не переносить чат, що вже триває. У нього лишаються свій проєкт, своя тека та свої інструкції, а перемикач вирішує, де почнеться наступний.
Панель і Telegram обирають окремо. У Telegram у вас може бути вибраний Ремонт, а в панелі — Диплом. Кожен пам’ятає свій вибір.

4 Дайте проєкту інструкції¶

Налаштування → Проєкти → ⋯ біля проєкту → Інструкції…

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

Наприклад

«Ремонт нашої квартири. Бюджет 15 000 €, завершити до березня. Завжди порівнювати щонайменше три кошториси. Вести зведену таблицю витрат у витрати.xlsx і оновлювати її щоразу, коли надходить нова пропозиція».

Головне — на початок

Розмова, що вже триває, зберігає інструкції, з якими почалася, тому зміни діють із наступного чату. Довгі інструкції — не проблема, але безпосередньо до агента потрапляють перші кілька тисяч символів, а решту він за потреби дочитує з файлу.

Інструкції зберігаються в теці проєкту як звичайний файл (AGENTS.md), тож можна попросити агента написати чи оновити їх за вас.

Ваша основна тека¶

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

Загальний — це ваш дім, а не проєкт: його не можна перейменувати, відкрити іншим чи видалити. Це також місце для роботи, яка охоплює кілька проєктів. У проєкті агент не виходить за межі його теки, а із Загального може зазирнути в будь-яку з них.

Проєкти на спільному агенті¶

Коли ви ділитеся агентом з іншими людьми, кожен отримує власну основну теку та власні проєкти. Кожен проєкт буває одного з двох видів:

Особистий (за замовчуванням)

Видно у списку лише вам, і туди потрапляють лише ваші розмови.
Спільний

Видно у списку в усіх користувачів агента з позначкою Спільний. Усі працюють із тими самими файлами та інструкціями, і розмови в ньому теж спільні.

У спільному проєкті розмови — спільна територія. Усі бачать їх у списку проєкту й можуть читати, продовжувати, перейменовувати чи видаляти, тож в одному чаті можуть працювати кілька людей: у панелі або в Telegram, де /sessions позначає такі розмови значком 👥, а торкання приєднує до потрібної. Біля кожного повідомлення видно, хто його написав, і агент знає, кому відповідає. Відповідає він на одне повідомлення за раз: якщо саме триває відповідь на чуже повідомлення, панель або бот повідомлять вам про це, і ви надішлете своє, коли відповідь надійде.

Відкрити всім чи зробити особистим можна в меню ⋯ проєкту: Відкрити всім користувачам або Зробити особистим. Проєкт, що став особистим, зникає зі списків інших, а їхні розмови з нього тривають у їхній власній основній теці.
Хто керує спільним проєктом: той, хто його створив, і власник агента. Перейменування та видалення — за ними. Знову зробити проєкт особистим може лише його творець.
Фонові завдання у спільному проєкті належать усім. Кожен користувач бачить їх у розділі Налаштування → Фонові завдання, може їх змінювати й отримує їхні сповіщення в панелі та в Telegram.
Коли користувача видаляють, проєкти, які він відкрив усім, лишаються спільними й переходять до власника. Його особисті проєкти зникають зі списків, а файли лишаються на сервері.

Особистий — означає прихований зі списків, а не замкнений

Запрошені користувачі — це довірені користувачі. Робота всіх іде під тим самим обліковим записом на сервері агента, тож особистий проєкт прихований зі списків інших людей, але це не сейф. Усе справді таємне не тримайте на спільному агенті.

Прибрати проєкт або видалити його назавжди¶

Видалення відбувається у два кроки, щоб нічого не зникло випадково:

⋯ → Прибрати зі списку. Проєкт зникає зі списків, але його файли й розмови лишаються на сервері, а ваші розмови з нього з’являються в Загальному. Сам проєкт ви знайдете в блоці Вилучені проєкти внизу сторінки Налаштування → Проєкти, де Повернути до списку повертає його назад.
Вилучені проєкти → ⋯ → Видалити назавжди… Це видаляє теку з усіма файлами та всі розмови, що в ній велися, і скасувати це неможливо. Для підтвердження треба ввести назву теки. Для спільного проєкту панель також покаже, скільки ще користувачів мають у ньому розмови.

Варто знати¶

Перейменування змінює лише назву. Тека зберігає ім’я, з яким її було створено, тож посилання, скрипти й інструменти, що її використовують, і далі працюють. У вікні інструкцій показано справжню назву теки.
Надіслані файли лишаються в проєкті. Файл, який ви надсилаєте в розмові проєкту, копіюється в uploads теки проєкту, і агент працює з ним просто там. Коли проєкти вимкнені, файли зберігаються як і раніше.
Фонові завдання виконуються в проєкті. У розділі Налаштування → Фонові завдання перше поле завдання — його проєкт, а нове завдання створюється в тому, який у вас відкритий. Завдання, про яке ви просите агента в розмові проєкту, виконується в цьому проєкті. Завдання спільного проєкту сповіщає всіх, хто користується агентом, будь-яке інше — лише вас. Поки проєкти вимкнені, кожне завдання сповіщає лише того, кому воно належить.
Пошук охоплює все. Агент шукає в історії всіх ваших розмов, хоч у якому проєкті вони були б, і може сказати, з якого проєкту знайдене.
API працює в Загальному. Виклики через OpenAI-сумісний API агента завжди працюють в основній теці того, хто їх робить.
До 50 проєктів на одного агента, з урахуванням проєктів усіх користувачів. Назва може містити до 60 символів.