Публикация агента¶

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

Агент Атом остаётся приватным

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

Задайте адрес¶

При публикации вы задаёте агенту публичный адрес — короткое понятное имя на ваш выбор. Страница агента после этого доступна по аккуратному адресу вида yourdomain/chat/support-bot. Адрес и есть ссылка: никаких длинных случайных токенов для общего доступа, которыми нужно управлять. На телефоне адрес сайта стоит над полем с именем, чтобы имя помещалось.

Кто может открыть агента¶

Выберите режим доступа в зависимости от того, насколько широко должен использоваться агент:

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

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

В Запросах на экране «Поделиться» видны люди, которые открыли закрытую страницу и нажали Попросить доступ. Разрешить открывает человеку использование агента. Отклонить сообщает человеку, что запрос отклонён, и следующий запрос можно отправить через 15 минут. Уведомление владельца открывает «Поделиться».

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

Удаление любой настройки доступа спрашивает подтверждение в той же строке. Если у строки одно действие, оно стоит на ней иконкой. У фразы с людьми одного уровня это корзина: она убирает всю фразу. Ссылка и пароль держат в меню ⋯ копирование адреса и удаление. Если адреса страницы нет, копирование ссылки остаётся в этом меню и выключено. Удаление по-прежнему спрашивает подтверждение. Оплата за человека, повторная отправка приглашения и удаление одного адреса — в списке имён. У уровня «Может копировать» оплаты нет: за этого человека владелец не платит. Статус приглашения показан бейджем Приглашён.

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

Что может каждый человек¶

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

Уровень	Что может человек
Может пользоваться	Общаться с агентом и пользоваться его опубликованной страницей.
Может копировать	Всё, что в «Может пользоваться», плюс Сделать копию — собственную копию агента, владельцем которой он становится.
Может редактировать	Всё, что в «Может копировать», плюс совместная работа над агентом с вами в билдере.

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

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

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

Что входит в копию¶

В копию входят:

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

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

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

Редактор может изменить поведение вашего агента. Давайте уровень Может редактировать только тем, кому вы доверили бы самостоятельно работать над агентом.

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

Кто платит¶

Каждый человек платит за своё использование сам, пока вы не задали оплату именно для него. Рядом с заголовком Поделиться написано «Каждый платит сам». Когда вы платите за некоторых из них, там написано, за кого, например «Вы платите за 1 редактора и 2 пользователей». Редактор видит там «Владелец платит за 1 редактора и 2 пользователей». Приглашение, за которое вы платите, входит в эту строку ещё до принятия. Агента, опубликованного для вашей организации, оплачивает организация. Ваше собственное использование оплачиваете вы.

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

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

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

Откройте имя человека, откройте меню этого человека и выберите Платить за использование. Карточка задаёт оплату в первый раз. Уже начатую оплату она не меняет. На карточке поле Лимит, рядом с числом написано «кредитов в месяц». На карточке написано: после лимита или даты человек платит сам, а в чате видно, сколько осталось. Число — месячный запас кредитов. На агенте, опубликованном для вашей организации, это использование, которое оплачивает баланс организации. Если оставить поле пустым, лимита нет — никаких месячных ограничений. Ноль останавливает новое использование, за которое платите вы. Использование, за которое человек платит сам, в лимит не засчитывается. Ваше собственное использование агента ничьим лимитом не ограничено. Лимит не распространяется на сборку агента и оценки. В строке человека первая строка говорит, за кого вы платите, и до какой даты, если дата задана. На следующей строке расход кредитов, затем полоска и сброс периода кошелька. Если строка не помещается, она переносится. Без месячного лимита нет ни полоски, ни сброса. До — необязательная дата, последний день, когда платите вы. Сам этот день ещё за ваш счёт. Со следующего дня дальнейшее использование этого агента оплачивает человек. Пустая дата оплату не заканчивает.

Кнопка Перестать платить заканчивает покрытие: лимит и дата сбрасываются, дальше человек платит сам. Выбор кошелька не меняется. Чтобы задать другой лимит или другую дату, остановите оплату и снова выберите Платить за использование в меню этого человека. В Android-приложении очистка поля лимита и сохранение по-прежнему возвращает неограниченное использование за ваш счёт.

Лимит проверяется перед каждым запросом к модели, в том числе перед теми, что идут после вызовов инструментов. Ответ может остановиться на середине, как только уже учтённый расход за ваш счёт для этого человека достигнет лимита; то, что уже израсходовано, списывается. Несколько одновременных обращений могут пройти проверку до того, как их расходы будут учтены, поэтому итог может немного превысить лимит. Лимит обнуляется вместе с расчётным периодом кошелька, который за человека платит. Изменение числа не стирает расход, уже учтённый в этом периоде.

Когда лимит исчерпан, в чате человека говорится, что лимит владельца для этого агента исчерпан, показывается дата обнуления и предлагается Выбрать кошелёк. Сохранение кошелька не перезапускает сообщение или запуск — человек начинает его заново. Атом сам не переносит эту работу на его деньги.

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

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

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

В разделе Оплата он выбирает кошелёк своей организации. Его использование оплачивает его организация, и оно отображается на странице расхода этой организации.

Кто что видит:

Вы видите использование, которое засчитывается в ваш баланс, по каждому человеку, с именем и email. Использование, которое оплачивает организация этого человека, учитывается только в общих суммах, без имени.
Другая компания видит расход своего кошелька на странице расхода своей организации.

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

Разрешить пользователям с доступом запускать воркфлоу позволяет людям, с которыми вы поделились агентом, запускать его воркфлоу: на вкладке Воркфлоу страницы агента или попросив агента в чате, с собственным расписанием и вебхуком. Каждый их запуск выполняется от их имени — через их собственные подключения там, где агент просит каждого подключить своё, и через ваши для подключений, которыми вы делитесь (см. Чей это запуск). Они видят, для чего нужен каждый воркфлоу, но не то, что происходит внутри его шагов, а вы не видите их результатов: из их запусков вам видны только неудачные и ещё идущие, но никогда не их содержимое или результаты, а сводка публикации агента учитывает только ваши собственные запуски воркфлоу (см. Воркфлоу на агенте с общим доступом). Исправление, которое самовосстановление вносит в один из их запусков, остаётся в этом запуске и никогда не меняет ваш воркфлоу. Настройка включена, пока вы её не выключите; выключение останавливает их расписания и вебхуки.
Для всех — настройка каждой коллекции знаний, которая определяет, используется ли эта коллекция для ответов и в разговорах других людей с агентом, а не только в ваших. Для только что подключённой коллекции она выключена; включите её в настройках общего доступа агента («Опубликовать» → доступ), когда захотите, чтобы коллекция приносила пользу всем. Люди никогда не просматривают коллекцию напрямую — её читает только агент. Коллекция, не отмеченная как Для всех, используется для поиска, только когда агент работает для вас или для владельца или администратора вашей организации; для того, кому вы дали уровень Может редактировать, и для посетителей она не используется.
Подключения, которыми вы делитесь (Общее — моё подключение для всех, см. Общие и персональные подключения), означают, что каждый, кто общается с агентом, действует через ваш собственный аккаунт, включая изменения: инструменты MCP-сервера работают с вашими учётными данными, кто бы ни спрашивал. Если вы этого не хотите, установите для подключения Каждый пользователь — своё, и каждый будет использовать собственный аккаунт. С общим почтовым ящиком и общим аккаунтом Google всё строже: люди могут читать через них, но отправлять или менять что-либо можете только вы, владелец или администратор вашей организации и люди, которым вы дали уровень Может редактировать (см. Почтовый ящик и Google Workspace).
Разрешить пользователям создавать свои API-ключи позволяет любому, у кого есть доступ к агенту, создать собственный API-ключ на странице агента, вместо того чтобы токены для них создавали только вы. О том, что может ключ пользователя и чем он отличается от вашего, см. Доступ по API.

С чем соглашаются посетители¶

Прежде чем кто-либо начнёт пользоваться собранным вами агентом — в любом режиме доступа, в вебе и в приложениях, — Атом показывает ему, что вы как автор можете видеть о его использовании, и человек соглашается или уходит. Описание составляется по фактической настройке агента, а не пишется вами, и называет только то, что вы можете видеть, и места вне Атома, куда попадают данные людей: таблицы агента и то, кто их читает, подключённые вами AI-модели, почтовый ящик, аккаунт Google или Telegram-бот, которыми вы делитесь, HTTP MCP-серверы, куда воркфлоу доставляют результаты, собственные API-ключи людей, платите ли вы за их использование, и ваш список людей с тем, когда и как часто они пользуются агентом. О том, как это выглядит для посетителя, см. Что видит автор агента.

Посмотрите сами. Откройте Что увидят посетители в настройках публикации, чтобы прочитать, что именно показывается людям, с которыми вы делитесь агентом, и участникам вашей организации.
Кого не спрашивают. Вас, владельцев и администраторов вашей организации и людей, которым вы дали уровень Может редактировать.
Когда спрашивают снова. Изменение, которое позволяет вам видеть больше, — новый HTTP MCP-сервер, таблица, которую сделали доступной вам для чтения, новый адрес доставки результатов, — заново запрашивает согласие у всех перед их следующим сообщением. Изменение, после которого вы видите меньше, — нет. Пока человек не согласится снова, его расписания пропускаются (но не выключаются), доставки на его вебхуки и вызовы с его API-ключами отклоняются, и он получает одно письмо.
Email и профиль. Каждый человек сам решает, получит ли агент его email и профиль; имя агент знает всегда (см. Ваш email и профиль).
Чтение записей всех людей. Чтобы просматривать записи каждого человека в таблице, сделайте её доступной вам для чтения, пока она ещё пуста.
Уход. Любой может уйти от агента и удалить свои данные в нём (см. Как уйти от агента и удалить свои данные). Если вы сами удалите человека из списка людей, ничего не удаляется.

Что получают люди¶

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

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

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

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

Собственный интерфейс агента не печатает внутри приложений для Android, iPhone, iPad и Mac. Поэтому билдер не добавляет кнопку печати: интерфейс предлагает документ как файл для сохранения (см. Интерфейс агента в приложениях). Если в вашем интерфейсе есть только кнопка печати, попросите билдер добавить скачивание.

Опубликуйте снова, чтобы обновить опубликованную страницу

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

Агенты, опубликованные раньше

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

Когда что-то идёт не так¶

Посетители видят уведомление об ошибке только при сбоях, с которыми они действительно могут что-то сделать:

Сбой чата — сообщение не отправилось: «Не удалось отправить сообщение. Попробуйте ещё раз.»
Сбой платформы — запрос не выполнился на стороне Атома: «Что-то не загрузилось. Попробуйте ещё раз.»
Потеря соединения — одно уведомление «Соединение потеряно.», которое исчезает само, когда соединение восстанавливается.

Ошибки внутри сгенерированного кода самого агента посетителям не показываются — они ничего не могут с ними сделать. Вы видите эти ошибки в предпросмотре билдера, где у каждой есть действие Исправить с помощью AI, которое передаёт её прямо в чат билдера. Чтобы разобраться с тем, о чём сообщил посетитель, откройте агента в предпросмотре и повторите его шаги.

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

Опубликуйте заново, чтобы перенести настройку на страницу агента

Если агент использует персональные подключения или параметры (см. Общие и персональные подключения), каждый человек подключает свои аккаунты — или выбирает их из своей библиотеки подключений — и заполняет параметры с пометкой «Заполняет каждый пользователь» в разделе Мои настройки на странице агента. Интерфейс, опубликованный до того, как настройка переехала на страницу, показывает собственное окно настройки, которое больше не может ничего сохранить: опубликуйте агента заново, чтобы настройка происходила на странице. Агенты v1 не поддерживают персональные подключения, поэтому для них окно настройки не появляется.

Установка как приложения¶

Любого опубликованного агента можно установить как отдельное приложение на телефон или компьютер — через «На экран „Домой“» на iOS и через предложение установки на Android/в Chrome. Оно открывается сразу в вашем агенте, под его собственным именем и значком.

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

Десктоп-приложение¶

Есть и приложение «Агент Атом» для Windows — десктоп-оболочка платформы с автообновлением и запуском вместе с Windows. Оно превращает ваш компьютер в устройство, на котором агенты выполняют задачи локально (см. Устройства). Скачайте его на странице «Устройства» или по прямой ссылке для Windows; для развёртывания в компании есть офлайн-установщик. Обновления предлагаются внутри самого приложения. В Microsoft Store приложения нет.

Брендирование¶

Индивидуальный внешний вид агента достигается сборкой агента с собственным интерфейсом — собственный фронтенд агента и есть его брендирование.

Способы распространения на сегодня

Поддерживаемые способы распространения агента — ссылка для общего доступа, установка как PWA, десктоп-приложение и API. Виджета или iframe для встраивания на сайт и панели настройки цвета и логотипа для отдельного агента в продукте сейчас нет.