Справочник

Проекты

Проект — это названная часть работы: клиент, кампания, эксперимент — и те профили, прокси, наборы cookie, автоматизации и датасеты, которые её обслуживают. Папка — это ящик одной вкладки; проект охватывает сразу все, и один и тот же общий прокси может принадлежать нескольким.

Содержание

Проект — это одна часть работы

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

Дайте ему имя, цвет и цель в одну строку, а потом добавьте то, что ему служит. Карточка показывает, что в нём лежит, — «3 профиля · 2 прокси», — а открыв его, вы увидите его состав, его правила и его память рядом друг с другом.

профилипроксинаборы cookieавтоматизациидатасетызаписи расписания

Проект — это не папка

В приложении есть и то и другое, потому что ни одно не делает работу второго. Папка отвечает на вопрос «куда это положить»: профиль лежит ровно в одной папке профилей, прокси — ровно в одной папке прокси, и два списка никогда не смешиваются; именно поэтому «EU residential» не появляется в панели профилей.

Проект отвечает на вопрос «для чего это». Он охватывает все вкладки, и одна и та же вещь может принадлежать не одному проекту, поэтому общий европейский прокси обслуживает двух клиентов, не будучи скопированным. Папками наводят порядок в одном списке, проектом — держат вместе одну работу.

Что входит и что выходит

Членство — это связь, а не перемещение. Добавление профиля в проект не вынимает его из папки, не меняет его и не мешает ему работать где-то ещё. Удаление из проекта убирает только связь.

Удаление проекта устроено так же: удаляются группировка и собственные заметки проекта, а каждый профиль, прокси, набор cookie, автоматизация и датасет, что были в нём, продолжают существовать и работать. Если работа закончена, но её хочется сохранить, отправьте проект в архив: архивация ничего не разрушает и просто убирает проект из сетки.

Скраперы — единственная вкладка, чьи строки не бывают участниками проекта. Скрапер — это карточка в каталоге, общем для всего рабочего пространства: каждый существует в одном экземпляре и не принадлежит клиенту, — поэтому в проект входит таблица, которую записал его запуск, а это обычный датасет. На практике это одно и то же: направьте шаг запуска скрапера в названную вами таблицу, добавьте эту таблицу в проект — и сбор с этого момента внутри проекта.

Каждая вкладка, суженная

Выберите проект на любой вкладке — и вкладка сузится до его вещей: «Профили», «Прокси», «Cookie», «Автоматизации» и «Данные» отфильтруются до того, что держит проект, так что работа клиента в один клик становится единственным, что есть на экране. Записи расписания тоже могут принадлежать проекту — именно так сегодняшний календарь читается как день одного клиента.

Именно это делает проект ценным в загруженном рабочем пространстве: тот же список, в котором вы и так работаете, но без всего, что не относится к этой задаче. Поставьте запись в календарь — она тоже может принадлежать проекту.

Правила, которые соблюдаются, а не запрашиваются

Проект может ограничивать то, что ассистенту позволено делать внутри него. Его бриф начинается с небольшого блока: цель в одну строку, которую ассистент видит здесь на каждом ходу; уровень автономии — только смотреть, сначала спрашивать или действовать; список инструментов, которые в этом проекте вызывать нельзя никогда; и часы по стенным часам, вне которых ему нельзя ничего менять.

read-onlyproposeact

Это не пожелания внутри промпта. Список запретов и часы работы проверяются в собственном коде приложения до того, как инструмент отработает, поэтому отказ не зависит от того, заметит ли модель правило и согласится ли с ним. Чтение не блокируется никогда — задать вопрос о проекте можно всегда, — а всё, что не удалось прочитать, откатывается к режиму «сначала спросить».

Это разница между системным промптом и замком. Ассистент достаточно способен, чтобы его стоило ограничивать, а ограничение, которое держится, только пока модель согласна сотрудничать, — не ограничение.

Память проекта

У каждого проекта есть небольшой набор документов, которые ассистент читает и пишет: бриф, правила, которых он обязан держаться, заметки о том, что он узнал — селектор, который переехал, особенность аккаунта, — и руководства по процедуре, которая сработала.

Эта память живёт на этом компьютере и с коллегами не делится, тогда как сами проекты — делятся: все в рабочем пространстве видят одни и те же проекты и один и тот же состав. Это рабочая память одной машины, а разошедшаяся по команде неверная заметка — отказ куда более дорогой, чем повторный набор верной.

Ассистент никогда не пишет туда, не показав, что именно он хочет сохранить, и не дождавшись вас. Написанному он будет верить на каждом следующем ходу — именно поэтому ничто не попадает туда без проверки. В его промпт уходят только заголовки документов; тело подтягивается тогда, когда оно действительно нужно, поэтому проект может накопить сотню заметок, не делая дороже каждое сообщение.

Проекты через API

Проект — это названная работа и всё, что ей служит: профили, прокси, наборы cookie, автоматизации и датасеты, плюс бриф и набор правил, которые хранятся на этой машине. Каждому маршруту здесь нужен ключ без ограничения по папкам: проект намеренно живёт поперёк папок, и учесть такое ограничение значило бы отдать половину проекта. Чтение одного документа — единственный маршрут без инструмента для агента: за ним стоит ресурс MCP, так что тело документа запрашивается только после того, как клиент решил, что оно ему нужно.

GET/v1/projectsargus_list_projectsключ без папкиThe workspace's projects, what each holds, and the index of its brain
GET/v1/projects/{id}/contextargus_project_contextключ без папкиOne project's goal, brief and rules, plus the titles of its other documents
GET/v1/projects/{id}/docs/{path}ключ без папкиOne document from a project's brain, by path
POST/v1/projects/{id}/delegateargus_delegateключ без папкиHand a goal to Argus's own orchestrator, inside a project's context
POST/v1/projects/createargus_create_projectключ без папкиStart a project
POST/v1/projects/addargus_add_to_projectключ без папкиPut records into a project
POST/v1/projects/removeargus_remove_from_projectключ без папкиTake records out of a project
POST/v1/projects/doc/readargus_read_project_docRead one project document
POST/v1/projects/doc/writeargus_write_project_docключ без папкиWrite a project document
POST/v1/projects/doc/deleteargus_delete_project_docключ без папкиDelete a project document
POST/v1/orchestration/planargus_make_planLay out a multi-step plan
POST/v1/orchestration/delegate-manyargus_delegate_manyключ без папкиHand several goals to subagents at once

Ключу, ограниченному папкой, отказывают сразу, а не отдают частичный ответ, который он не отличит от полного. Маршрут документа доступен как argus://project/<id>/<path> — это ресурс, а не инструмент, поэтому тело стоит контекста только тогда, когда клиент решил, что оно ему нужно.

Делегирование передаёт цель собственному оркестратору Argus внутри проекта, и это обычно лучше, чем гонять профили проекта самому: он уже держит бриф, он соблюдает уровень автономии и список запретов в коде и записывает узнанное обратно в заметки. Отвечает он тем, что он запустил, а не ждёт конца работы, — поэтому о том, как всё прошло, читайте в контексте проекта или в его заметках.

Соберите задачу воедино

Проекты — в лаунчере, в самом верху панели. Переносить в проект ничего не нужно: добавьте то, что уже есть, и заберите обратно когда захотите.