Билдер¶

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

Открыть агента¶

Нажмите агента в панели или найдите его через Поиск — и вы попадёте на самого агента:

Живой агент (справа). Его собственный рабочий интерфейс — ровно таким его увидят люди, с которыми вы им поделитесь. Строка над ним переключает между Приложение и Канвас (когда чат уже что-то сделал для канваса) и содержит Ширина телефона, Обновить поверхность и Открыть поверхность в новой вкладке.
Чат владельца (слева). Тот же чат и канвас, что у Агента Атом, в виде панели слева от живого интерфейса — приватный разговор с вашим агентом в роли его владельца. Удобно, чтобы попробовать его по-настоящему; перетащите разделитель, чтобы дать больше места одной из сторон. Кнопка панели в левом верхнем углу скрывает чат и возвращает его и в обоих случаях остаётся на том же месте.
Меню агента. Нажмите название агента вверху: Моя память, Мои файлы и ваши API-ключи для этого агента, а также Переименовать, Сделать копию, Пауза или Удалить, либо скопируйте его id. Для агента, которым с вами поделились, меню предлагает только то, что позволяет ваш уровень доступа.

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

Сделать копию¶

Сделать копию создаёт нового агента, который принадлежит вам, на основе этого. В копию переходят промпт и настройки, скиллы, воркфлоу, слоты подключений без учётных данных, имена ключей окружения без значений, код приложения и бэкенда, структура базы данных без данных и документы баз знаний, отмеченных Для всех (они переиндексируются для вас за ваш счёт, поэтому знания появляются постепенно). Секреты, данные, разговоры, память и приватные базы знаний не копируются никогда. Копировать можно своих агентов и агентов, которыми с вами поделились на уровне Может копировать или Может редактировать. См. Публикация агента.

Совместное редактирование¶

Владелец может дать человеку уровень Может редактировать (см. Публикация агента). Редактор открывает агента в билдере и может делать там всё то же, что и владелец, кроме:

удаления агента,
изменения настроек публикации и доступа,
управления API-ключами владельца,
превращения подключения в общее,
изменения того, кто может читать или записывать таблицу базы данных агента, или открытия таблицы, в которой уже есть записи, для всех авторизованных пользователей,
безвозвратного удаления данных агента.

В разделе Поделиться редактор видит настройки доступа. Каждый элемент на этом экране остаётся заблокированным. Экран называет, кто открыл доступ, и пишет, что редактировать можно. Там же сказано, что доступ меняет только этот человек, и что платит владелец, пока в билдере не включено «Платить из моего кошелька».

Редактор при этом может обновить публикацию, чтобы опубликованный агент получил его изменения.

Как это работает:

Редактирует один человек за раз. Пока билдер работает для кого-то, все остальные видят, кто это, и не могут отправлять сообщения или сохранять, пока он не закончит.
Чат билдера общий, поэтому все, кто редактирует, видят один и тот же разговор. В нём только работа над агентом: разговоры ваших пользователей с агентом в нём никогда не открываются.
Билдер работает с базой данных агента от имени того, кто собирает. Когда он проверяет или загружает записи, он видит то, что этот человек увидел бы, пользуясь агентом, — свои записи в таблицах с доступом только к своим записям, ничего в таблицах, закрытых для пользователей, — и это относится и к владельцу. Сборка агента — не способ просматривать записи людей, которые им пользуются. Миграция, которую применяет билдер, всё же выполняется с правами владельца базы данных, поэтому давайте Может редактировать только тем, кому доверяете данные агента.
Открыть билдер могут только владелец и редакторы. Никто не попадает туда по одной лишь роли, включая администратора платформы. Чтобы допустить его, поделитесь с ним агентом на уровне Может редактировать, как с любым другим.
Скиллы и субагенты, созданные редактором, принадлежат владельцу агента. Редактор также получает Может редактировать для каждого созданного им субагента, потому что билдер собирает его для него. Подключения, которые добавляет редактор, — его собственные и остаются за ним.
Кто платит за сборки редактора: по умолчанию владелец или сам редактор. Редактор может переключиться на свой кошелёк. Пока платит владелец, баланс редактора не имеет значения: его пустой кошелёк не блокирует билдер и не вызывает предложение перейти на другой тариф, а если закончатся средства аккаунта агента, билдер об этом скажет. Собственные сборки владельца всегда оплачивает аккаунт, которому принадлежит агент, даже если владелец открывает билдер из другого рабочего пространства. Этот выбор касается только сборок: запуски воркфлоу редактором оплачиваются так, как указано в публикации агента, — как и его чаты с агентом, см. Кто платит за запуск.
Воркфлоу. Редактор создаёт и изменяет воркфлоу агента так же, как владелец, и может удалить воркфлоу — вместе с ним удаляются расписания, вебхуки, значения настроек и запуски этого воркфлоу у всех людей. Собственные запуски, расписание и вебхук редактора принадлежат ему: он видит и останавливает только свои запуски, никогда чужие, а его расписание и вебхук — его собственные, а не владельца, включая расписание, которое билдер настроил во время хода редактора. Чтобы запускать воркфлоу и держать собственное расписание или вебхук, нужно, чтобы был включён параметр Разрешить пользователям с доступом запускать воркфлоу — как и для всех, с кем поделились агентом. Запуск или остановка воркфлоу — не редактирование, поэтому это работает, даже пока билдер занят кем-то другим.

Давайте доступ на редактирование только тем, кому доверяете.

Приостановка агента¶

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

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

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

Редактирование: оверлей сборки¶

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

Внутри оверлея:

Чат конструктора. Здесь вы разговариваете с билдером, а не со своим агентом. Вы описываете нужного агента — «Сделай ассистента поддержки, который отвечает по нашему FAQ и может писать клиентам на почту», — и билдер редактирует за вас конфигурацию агента: пишет его инструкции, включает нужные возможности, генерирует интерфейс. Продолжайте дорабатывать в том же разговоре («сделай дружелюбнее», «добавь дашборд», «подключи Slack»); он помнит, что уже настроено.
Настройки. Страница называется Настройки агента. Это список всех частей агента. Строка открывает эту часть, а Назад возвращает к списку — см. ниже.

К сообщению билдеру можно прикрепить файлы или изображения, если это помогает объяснить, что вы хотите. Баннер напоминает, что вы в режиме билдера, а не в собственном чате агента. На телефоне он говорит только про режим билдера.

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

В приложении Агент Атом для Mac выбор модели в билдере также показывает ваши подключённые подписки (группа Ваши модели). Выберите там подписку, чтобы собирать и дорабатывать агента на собственном тарифе провайдера. Билдер запоминает свой выбор; у чата использования агента отдельный выбор модели. Личные подписки требуют платного тарифа Атома и пока принимают текстовые сообщения; для сообщений с прикреплёнными файлами или изображениями используйте платформенную модель. См. Подключение собственной подписки.

Если соединение обрывается, пока билдер работает, сборка не останавливается: чат сам переподключается и продолжает с того места, где остановился, а сообщение, отправленное вами как раз в момент сбоя соединения, доставляется после его восстановления — ровно один раз.

У Агента Атом нет режима сборки

Ассистент Агент Атом — встроенный агент, привязанный к вам, поэтому режима сборки у него нет. У других встроенных агентов, входящих в Атом, тоже нет собственного режима билдера.

Язык¶

Разговаривайте с билдером на любом удобном вам языке. Всё, что будут читать ваши пользователи, — инструкции агента, его приветствие и подсказки, каждая надпись в сгенерированном интерфейсе — пишется на языке аудитории агента: по умолчанию на вашем, а на другом — как только вы скажете, для кого агент («этот — для наших испаноязычных клиентов»).

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

Чтобы посмотреть, как интерфейс выглядит на телефоне, нажмите Ширина телефона рядом с Обновить поверхность. Живой агент покажется в рамке размером с телефон; нажмите кнопку ещё раз, чтобы вернуться к полной ширине панели. Это предпросмотр только ширины: сенсорного ввода и экранной клавиатуры нет. Браузер запоминает выбор. В узком окне (ширины планшета или телефона) переключатель не показывается, потому что окно слишком узкое, чтобы показать чат и интерфейс рядом.

Панель настроек¶

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

Агент

Системный промпт — основные инструкции агента: его роль, тон, правила и то, что ему следует и не следует делать. Это самая важная настройка — характер агента и его должностная инструкция.
Модель — какая AI-модель работает в агенте (по умолчанию Авто).
Настройки чата — что люди видят в чате агента, прежде чем что-то напечатать, и могут ли они менять его модель. См. Чат агента ниже.
Голос — голосовые настройки. См. Голос.

Возможности

Инструменты — включаемые возможности: «Память», «Субагенты», «Веб-поиск», «Веб-браузер», «Управление браузером», «Отправка писем», «Генерация изображений», «Генерация видео», «Транскрипция аудио», «База данных», «Воркфлоу» и «Управление компьютером». Счётчик показывает, сколько из них включено. См. Возможности.
Скиллы — готовые пакеты знаний, которые можно добавить. См. Скиллы.

Подключения

MCP-серверы — подключение внешних инструментов и сервисов по стандарту MCP.
Интеграции — подключение сторонних сервисов. См. Интеграции.
Связанные агенты — позволяют этому агенту вызывать других созданных вами агентов. См. Команды агентов.

Данные

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

Автоматизация

Воркфлоу — многошаговые процедуры по расписанию или автоматические. См. Воркфлоу. Когда билдер настраивает шаг воркфлоу, он может использовать ваши MCP-серверы, встроенный веб-поиск и интеграции, которые Атом предлагает вашим агентам, например Google Workspace, — в том числе ту, которую вы ещё не подключили. Это задуманный порядок, а не пробел: билдер собирает шаг, говорит вам, что подключить, и воркфлоу запрашивает это при первом запуске, если оно всё ещё не подключено.

Для программ

API — ключи и эндпоинты для программного вызова агента. См. Доступ по API.
Окружение — значения конфигурации, например ключи, которые нужны инструментам агента.

Качество и история

Оценка — тестирование агента и контроль его качества. См. Оценка.
Версии — снимки агента во времени. См. Версии.

Доступ

Опубликовать и Поделиться идут следом за Настройки на том же переключателе. Опубликовать задаёт адрес. Поделиться — кто может открыть агента. См. Публикация агента.

Сборка в приложениях для iPhone, iPad и Mac¶

Билдер есть и в приложении Атома для iPhone, iPad и Mac — создавать и редактировать агента можно, не открывая сайт.

Вкладка Агенты перечисляет агентов, которыми вы владеете, начиная с недавно изменённых, и обновляется потягиванием вниз; Новый агент создаёт агента и сразу открывает на нём билдер.

Сборка в строке агента или в заголовке его собственного чата открывает билдер в приложении: чат билдера слева, живое превью поверхности агента справа. На телефоне между ними переключатель «Чат / Превью»; на iPad и Mac они стоят рядом с перетаскиваемым разделителем.

Превью — это настоящий dev-сервер, поэтому в первый раз он загружается не сразу и показывает, что делает (запускается, загружается, собирается, перезагружается). Перезагрузка и Открыть в браузере — в его панели инструментов; на Mac ⌘R перезагружает, а ⌘⇧R перезапускает dev-сервер. Ссылки на другие сайты открываются в браузере, а файл, который превью предлагает скачать, сохраняется — см. Интерфейс агента в приложениях.

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

Чаты сборки отделены от обычных чатов: они живут в собственной истории билдера и никогда не появляются в истории ваших чатов. Переименовать агента можно из заголовка билдера.

Настройки, которые в вебе доступны в панели, есть в виде нативных панелей в меню билдера: Инструменты, Системный промпт, Модель, Чат, Интеграции (почтовый ящик, Telegram и Google) и Опыт агента. Они редактируют ту же конфигурацию, что и веб, — пока идёт ход билдера, они доступны только для чтения, чтобы правка не конфликтовала с тем, что пишет билдер.

На iPhone, чтобы вернуться на предыдущий экран, используйте единственную кнопку Назад рядом с заголовком экрана.

Несохранённый системный промпт хранится как черновик под тем же ключом, что и в вебе, поэтому промпт, начатый на телефоне, будет на месте и в браузере.

В приложении для Android в меню билдера также есть MCP-серверы и База знаний — см. Инструменты и MCP и Документы и RAG. В Интеграциях слоты почтового ящика и Telegram позволяют выбрать, какой из ваших аккаунтов использует агент, или добавить новый, не выходя из приложения; Управлять в подключениях открывает вашу библиотеку подключений.

Чего нет на iPhone и iPad: скиллов, связанных агентов, базы данных, оценки, версий, API-ключей, публикации и редактора окружения — эти ссылки открывают сайт. В приложении для Mac всё это есть нативно, см. Сборка на Mac. В приложении для Android есть панель публикации с доступом, приглашениями и опубликованной ссылкой; оценка, версии и редактор окружения там по-прежнему открывают сайт.

Сборка на Mac¶

В приложении для Mac есть весь билдер, а не урезанная версия. Всё, что можно сделать в веб-билдере, можно сделать и там.

Одна страница на агента. Чат билдера слева, а выбранный раздел занимает панель справа. Боковая панель перечисляет агента и его разделы по группам:

Сборка — Чат (чат билдера отдельно, на всю ширину), Превью и Системный промпт.
Агент — Модель, Инструменты, Скиллы, MCP-серверы, Связанные агенты и Интеграции.
Данные — База знаний, База данных, Файлы и Опыт агента.
Поведение — Воркфлоу, Оценка, API, Чат, Голос и Окружение.
Версии, Опубликовать и ссылка, которая открывает агента в браузере.

Разделы с элементами показывают рядом с названием их количество. Боковая панель следует навигации назад и вперёд, так что подсвечен тот раздел, где вы были.

Превью. Панель показывает агента таким, какой он сейчас. Переключайтесь между шириной телефона и десктопа, перезагружайте ⌘R или перезапускайте dev-сервер ⌘⇧R. Пока билдер работает, превью показывает Сборка… и обновляется в конце хода.

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

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

Использовать агента и Опубликовать. Использовать агента в панели инструментов открывает собственный чат агента. Опубликовать открывает раздел публикации и, когда агент опубликован, называется Опубликован. Там вы выбираете, у кого есть доступ, приглашаете людей и копируете ссылки-приглашения, решаете, какими коллекциями знаний могут пользоваться все, кто работает с агентом, и видите список того, что посетителям показывают и просят принять перед началом. Варианты те же, что и в вебе, см. Публикация агента.

Воркфлоу. Раздел перечисляет воркфлоу агента с их состоянием, стоимостью и расписаниями, а воркфлоу открывается на собственной странице со схемой, запусками и триггерами — см. Воркфлоу в приложении для Mac. Исправить с помощью AI и Пересобрать отправляют сообщение в чат билдера рядом; пока билдер ещё отвечает, сообщение ждёт в чате, чтобы вы его отправили.

Оценка, API, Окружение и Версии. Оценка показывает, как далеко продвинулась последняя сборка, какие проверки задач опробованы на агенте и как он справляется в реальных разговорах. API управляет API-ключами агента. Окружение хранит ключи, которые читает код агента. Версии перечисляет сохранённые версии агента — см. Версии.

Новый агент¶

Новый агент на странице «Агенты» открывает окно с двумя способами начать:

Описать его. Напишите, что агент должен делать, для кого и с чем он работает, при необходимости прикрепите файлы и нажмите Собрать. Агент создаётся, и билдер открывается с уже отправленным брифом. Если какие-то файлы не загрузились, билдер всё равно получает бриф, а вам сообщают, что именно не попало. Начать с нуля вместо этого создаёт пустого агента.
Начать с шаблона. Просматривайте галерею по категориям — категорию каждого шаблона выбирает его автор, поэтому фильтры — это категории, которые есть у шаблонов, — откройте карточку, чтобы увидеть, что в него входит: скиллы, MCP-серверы, воркфлоу, коллекции знаний, ключи для заполнения, база данных, код бэкенда и есть ли у него приложение, — и нажмите Использовать шаблон. См. Шаблоны.

Действия с агентом¶

Меню агента в билдере (его заголовок и карточка агента в боковой панели) и меню в сведениях об агенте на странице «Агенты» содержат действия для одного агента:

Переименовать — с необязательным описанием.
Клонировать — копия, которая принадлежит вам, с тем содержимым, что описано в разделе Сделать копию.
Приостановить агента / Возобновить работу — см. Приостановка агента.
Опубликовать как шаблон… / Обновить шаблон… — поделиться агентом как шаблоном. Вы выбираете, что в него войдёт: основная настройка, скиллы и MCP-серверы, доработки приложения, код бэкенда, имена ключей окружения (никогда не их значения), структура базы данных и, по желанию, строки выбранных таблиц и коллекции знаний. Строки могут содержать персональные данные, поэтому выбирайте только справочные таблицы; включённые коллекции становятся общими и видимыми всем. Обновление перезаписывает действующий шаблон. Публиковать шаблоны могут только администраторы платформы и только своих агентов.
Удалить.

В приложении для Mac у страницы «Агенты» нет панели сведений: щёлкните строку агента правой кнопкой, чтобы переименовать или удалить его, а остальные действия — в билдере агента.

Чат агента¶

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

Заголовок приветствия и Текст приветствия — заголовок и короткая строка, с которых начинается пустой чат (например, Спланируйте поездку и Спрашивайте о маршрутах, ценах и датах). Оставьте их пустыми, чтобы сохранить стандартное приветствие.
Подсказки — до четырёх готовых первых сообщений под приветствием. Нажатие на подсказку вставляет её текст в поле сообщения, чтобы человек мог поправить его перед отправкой; само по себе ничего не отправляется.
Плейсхолдер — подсказка внутри пустого поля сообщения.
Разрешить выбор модели в чате — позволяет людям выбирать платформенную модель в чате агента. Это касается и вас: пока параметр выключен, платформенные ходы используют модель, заданную в панели Модель. Когда он включён, список под ним ограничивает, какие платформенные модели можно выбрать. Владелец, имеющий на это право и использующий приложение Атома для Mac, всё равно может выбрать подключённую личную подписку.

Для нового агента билдер заполняет приветствие и подсказки на языке агента; редактируйте их здесь или попросите чат билдера их изменить.

Что такое «конфиг» с вашей стороны¶

Вы не редактируете файл конфигурации. На практике ваш агент — это сумма его системного промпта, его модели, инструментов, которыми ему разрешено пользоваться, знаний и данных, на которые он может опираться, его скиллов и его интерфейса (поверхности, которая работает рядом с чатом). Чат билдера — просто более быстрый способ настроить всё это, чем делать вручную, — и всё, что делает чат, вы всё равно можете тонко подправить вручную в панели.