Как пользоваться агентом¶

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

Перед началом¶

Когда вы впервые открываете агента, которого собрал кто-то другой, Атом показывает, что автор агента может видеть о том, как вы им пользуетесь, — это определяется тем, как агент на самом деле настроен, — и вы выбираете Согласиться и продолжить или Уйти. Там же вы решаете, получит ли агент вашу почту и профиль. См. Что видит автор агента.

Как устроен экран¶

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

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

Общение в чате¶

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

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

Остановить ответ на середине,
Повторить ход, который не удался, или
Изменить и отправить заново своё последнее сообщение.

Можно продолжать писать, пока агент ещё отвечает. Ваше сообщение сразу до него доходит — он либо прерывается на полуслове, чтобы его учесть, либо заканчивает текущее действие и читает сообщение сразу после. Пока сообщение не прочитано, оно показано бледнее, и его можно отменить или изменить; Стоп возвращает текст в поле ввода, а не теряет его. Если настройка агента не позволяет принять сообщение посреди ответа, ваше подождёт и отправится само, как только ответ закончится.

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

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

Чат открыто показывает, что делает агент:

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

Ответы отображаются полноценным форматированным текстом — заголовки, списки, таблицы, ссылки, код с подсветкой синтаксиса, диаграммы и встроенные изображения. Отвечая по базе знаний, агент может приводить источники в разделе «Источники», сгруппированные по документам, с номерами страниц и раскрывающимися фрагментами. Ещё есть кнопка копирования, подсказки-чипы в пустом чате (нажатие заполняет поле ввода, чтобы вы могли поправить текст перед отправкой) и индикатор того, какую часть разговора агент держит в памяти (с подсказкой начать новый чат, когда она заполняется).

Когда агент вас о чём-то спрашивает¶

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

Загрузка файлов¶

Используйте кнопку прикрепления (＋) или перетащите файлы — до 10 файлов в одном сообщении, у каждого виден статус загрузки. Пока файл загружается, на его чипе крутится индикатор, а сообщение ждёт: Enter и кнопка отправки ничего не делают, пока не загрузятся все файлы. Поддерживаются любые типы файлов, и агент сразу может с ними работать. В приложении для Mac ⌘V в поле ввода прикрепляет файлы, скопированные в Finder, и скопированную картинку, например скриншот; скопированный текст вставляется как текст.

Изображения (PNG, JPEG, GIF, WebP) показываются как картинки, которые агент видит, — до 5 изображений в сообщении, каждое до 5 МБ, в виде миниатюр.
Документы и данные (текстовые документы, таблицы, презентации, простой текст, PDF — в том числе сканы) агент читает, чтобы анализировать их содержимое и работать с ним.
Другие форматы (архивы, видео, шрифты и прочие типы) доступны агенту как файлы, на которые он может ссылаться или которые может обрабатывать.

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

Разговоры и история¶

У каждого пользователя свои разговоры, и они сохраняются между сеансами. Новый разговор начинается автоматически с вашего первого сообщения и получает название автоматически по тому, что вы написали. Сворачиваемая панель истории группирует прошлые чаты (Сегодня, Вчера, На этой неделе…) и содержит кнопку Новый чат. Разговоры можно переименовывать и удалять, а также откатывать к более ранней точке — так и работает «изменить более раннее сообщение и продолжить с него». Если другие агенты поручали этому агенту работу, такие разговоры видны в отдельном списке «От агентов», который можно открыть только для чтения.

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

Вы также можете сами уйти от агента, которого собрал кто-то другой, и удалить свои данные в нём — см. Как уйти от агента и удалить свои данные.

Голос¶

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

Голосовой режим доступен и в вашем собственном рабочем пространстве. В веб-версии и в приложениях для iPhone и Mac можно надиктовывать текст в поле ввода. См. Голос вместо набора текста. Приложения для iPhone и Mac распознают диктовку на самом устройстве. Приложение для Android не поддерживает диктовку в поле ввода.

Что агент помнит о вас¶

Агент ведёт собственные заметки о вас и вашей работе с ним. Ваши заметки видите только вы; другие люди, которые пользуются тем же агентом, их не видят. Агенты вашего собственного рабочего пространства видят ваш краткий профиль. Агент, которого собрал кто-то другой, всегда знает ваше имя, а ваш профиль и почту получает, только если вы выбрали Делиться с агентом моей почтой и профилем — см. Ваша почта и профиль. Добавлять или менять факты в вашем профиле могут только агенты вашего рабочего пространства; агент, которым с вами поделился кто-то другой, его никогда не меняет. И заметки, и профиль можно просматривать, редактировать и удалять — см. Профиль и память.

Агенты, которыми с вами поделились, в веб-версии¶

В разделе Агенты панели есть Мои — агенты, которых собрали вы, и Общие — всё, чем с вами поделились другие; агент из любого из них открывается чатом с ним. В рабочем пространстве организации раздел Общие содержит и агентов, опубликованных для организации, и тех, которыми поделились лично с вами. Список ваших чатов с агентом одинаков во всех рабочих пространствах, но каждый чат продолжает работать в том рабочем пространстве, где он был начат; в веб-версии у чата из другого рабочего пространства указано его название. Когда за использование агента платит пользователь, платит кошелёк того рабочего пространства, в котором вы находитесь, если только вы не выбрали другой кошелёк в разделе Оплата (см. Настройка агента, которым с вами поделились). В разделе Мои показаны пять недавно обновлённых агентов; Ещё N открывает остальных. В разделе Общие у каждого агента указано имя владельца, и маленький бейдж с вашим доступом: Доступ, Копия или Правка. Агент из раздела Общие открывается внутри рабочего пространства, в том же виде, что и любой агент. Там же открывается и ссылка на агента, которую вам прислали, — как только у вас появится доступ (после входа или ввода пароля агента) и вы согласитесь с описанием агента. На весь экран вверху страницы агента открывает его на отдельной странице, без панели рабочего пространства, а Вернуться в рабочее пространство возвращает назад. С этой страницы агента можно также сохранить как приложение: нажмите Установить в Chrome или Edge; на iPhone или iPad нажмите Поделиться, затем На экран «Домой». Установленный агент всегда открывается на весь экран. Агент, которым с вами поделились для редактирования, тоже открывается из раздела Общие на использование; чтобы изменить его, откройте его и нажмите Редактировать (см. совместное редактирование). Принятое приглашение на редактирование открывает агента сразу, и в шапке есть Редактировать. На общей странице эта кнопка стоит рядом с Сделать копию. Если владелец дал вам права Может копировать или Может редактировать, агент также предлагает Сделать копию — вашу собственную копию; см. что входит в копию. Ваш уровень доступа задаёт владелец.

В разделе Общие в меню строки агента, которым поделились лично с вами, есть переключатель Агент Атом может поручать. По умолчанию он выключен. Пока он выключен, Агент Атом спрашивает вас в чате, прежде чем впервые передать этому агенту задачу, — Передать эту задачу …? с кнопками Да и Нет, — и ваш ответ действует до конца этого чата. Закрепление агента или упоминание его через @ считается ответом «да» для этого чата. Когда переключатель включён, ассистент передаёт этому агенту задачи без вопросов, в любом чате. Чтобы включить переключатель, сначала нужно согласиться с тем, как агент использует ваши данные. Агентов, опубликованных для вашей организации, это не касается.

Настройка агента, которым с вами поделились¶

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

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

Те же подключения используются воркфлоу агента, когда они запускаются для вас, — см. Ваши воркфлоу.

Кто платит за ваше использование¶

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

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

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

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

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

Чтобы убрать сохранённый выбор кошелька, выберите Как задано у агента и нажмите Сохранить кошелёк. Это работает и в приложении для Android. Дальше вы платите за своё использование сами, если владелец не задал оплату для вас и не опубликовал агента для организации.

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

Ваши воркфлоу¶

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

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

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

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

В приложении для Mac на странице агента есть панель Воркфлоу с теми же карточками, запусками и триггерами. В приложениях для Android, iPhone и iPad вкладки Воркфлоу нет: откройте страницу агента в веб-версии или попросите агента в чате. Как это выглядит со стороны владельца, см. в разделе Воркфлоу у агента, которым поделились.

Ваши собственные знания¶

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

Ваши API-ключи¶

Если владелец включил Разрешить пользователям создавать свои API-ключи, в панели Мои настройки на странице агента появляется вкладка API-ключи. Если вы ещё не согласились с описанием агента, вкладка сначала предлагает Посмотреть и согласиться. Там можно:

создать до 10 ключей,
увидеть секрет каждого ключа один раз — при создании,
удалить ключ, который больше не нужен.

Ключ действует от вашего имени: при вызове агента он использует вашу собственную память, файлы, профиль и личные подключения и получает тот же пользовательский доступ к базе данных агента, что и вы. Если владелец выключит эту настройку или вы потеряете доступ к агенту, ваши ключи перестанут работать. Вызов, сделанный ключом до того, как вы закончили настройку агента, отклоняется с ошибкой agent_setup_required — закончите настройку на странице агента и повторите. Вызов, сделанный до того, как вы согласились с описанием агента, или после того, как описание изменилось и стало показывать автору больше, отклоняется с ошибкой consent_required (HTTP 409); в её сообщении есть ссылка на страницу агента — согласитесь там и повторите. Когда это происходит впервые, вы получаете одно письмо. См. Когда агент меняется.

В приложении для Android ключами можно управлять из меню агента в заголовке чата — см. Мои API-ключи ниже. В приложении для Mac то же самое делает пункт API-ключи в меню агента или панель API-ключи на странице агента. Приложения для iPhone и iPad не управляют ключами: используйте страницу агента в веб-версии.

Интерфейс агента в приложениях¶

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

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

Приложение	Куда сохраняется файл	Что вы видите
Android	«Загрузки»	Сохранено в «Загрузки» или Не удалось сохранить файл. Для большого файла сначала показывается Сохранение «имя»…
iPhone и iPad	Приложение спрашивает, куда сохранить	После этого — Файл сохранён или Не удалось сохранить файл. При отмене ничего не показывается.
Mac	Приложение спрашивает, куда сохранить, и предлагает исходное имя файла	После этого — Файл сохранён или Не удалось сохранить файл. При отмене ничего не показывается.

Файл, на который ссылается интерфейс, может весить до 2 ГБ, а файл, который интерфейс готовит сам, — до 50 МБ. В приложении для Android, если файл упакован прямо в ссылку, лимит — несколько мегабайт. Для файла больше лимита показывается Файл слишком большой, чтобы сохранить его со страницы., и он не сохраняется.

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

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

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

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

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

Перед тем как пользоваться чужим агентом в приложениях¶

В приложениях для Android, iPhone, iPad и Mac, когда вы впервые открываете чужого агента — его чат, его приложение, ссылку или приглашение к нему, или когда закрепляете его в чате с Агентом Атом, — приложение по пунктам показывает, что автор агента может видеть о том, как вы им пользуетесь, и просит согласиться. Если какие-то из этих пунктов изменились с тех пор, как вы соглашались в прошлый раз, они помечены как Новое, и приложение спрашивает снова.

Делиться с агентом моей почтой и профилем выключено, пока вы его не включите; имя агент получает всегда. Согласиться и продолжить открывает агента и, если вы уже отправили сообщение, отправляет его снова. Уйти закрывает агента, не открывая его.

Ваши собственные агенты, агенты, которые вы можете редактировать, и встроенные агенты никогда об этом не спрашивают.

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

Уйти от агента и удалить свои данные в нём можно в веб-версии — см. В приложениях.

В приложении для Android¶

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

Откройте агента — меню в заголовке его чата предлагает для любого агента, которым вы можете пользоваться:

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

Мои настройки¶

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

Если у вас уже есть подходящие подключения, выберите одно из списка кнопкой Выберите подключение (или Сменить, чтобы заменить его). Они берутся из вашей библиотеки подключений. Агент никогда не выбирает подключение за вас, даже если подходит ровно одно, а если владелец меняет то, как запускается один из его серверов, вас попросят выбрать снова.
Иначе подключите новое прямо здесь: войдите в сервис, введите ключи, которые он просит, или добавьте почтовый ящик или чат в Telegram. Где подключение можно проверить, кнопка Проверить скажет, работает ли оно.

В разделе Ваши данные — значения, которые агент просит у каждого пользователя. Значение, которое вы уже сохранили, показано как Сохранено и больше никогда не отображается. Кнопка Продолжить становится активной, когда ничего не осталось.

Когда вы пишете агенту, которому сначала нужна эта настройка, приложение сообщает об этом и открывает «Мои настройки»; Продолжить возвращает вас в чат.

Мои API-ключи¶

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

Вход¶

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

На закрытой странице, где написано, что доступа нет, Попросить доступ отправляет владельцу запрос. Когда он разрешит, страница открывает агента, и приходит уведомление. Если он отклонит, приходит уведомление, а на странице 15 минут идёт таймер, и кнопка Попросить доступ возвращается, когда время выйдет.