Проекты¶

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

🏠 Общееваша основная папка

💬План на неделю
💬Вопросы по налогам

📁 Ремонтновые чаты начинаются здесь

📝«Бюджет 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 символов.