Интеграции¶

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

Google Workspace¶

Подключите Google, чтобы агент мог работать с Календарём, Таблицами, Документами и Диском. Для каждого сервиса вы выбираете уровень доступа:

Выкл — агент не может им пользоваться.
Чтение — доступ только на чтение.
Чтение и запись — полный доступ.

Также вы выбираете режим подключения:

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

Вы включаете интеграцию, выбираете сервисы и уровни доступа и либо сохраняете (тогда конечные пользователи подключаются в окне настройки агента или в чате), либо нажимаете Сохранить и подключить Google в режиме общего аккаунта. В режиме «для каждого пользователя» вы также можете подключить свой аккаунт прямо с этой панели — удобно, чтобы проверить интеграцию как конечный пользователь собственного агента; чтобы убрать его, используйте Управлять в подключениях. Вы видите, сколько пользователей подключилось, можете изменить выбор сервисов или отключить интеграцию. Подключение и отключение проходят через собственный экран входа Google.

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

Почта¶

Дайте агенту почтовый ящик по IMAP/SMTP, чтобы он мог читать, искать, отвечать на письма и отправлять их. Вы выбираете, чей ящик он использует:

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

В воркфлоу. Шаг «Агент» может пользоваться этим же ящиком: просматривать и читать письма, искать по ним, помечать письмо прочитанным, отвечать, отправлять новое письмо и пересылать. Ответ или новое письмо может содержать файлы, которые уже есть у запуска, а при чтении письма можно получить вложение. При пересылке отправляется текст исходного письма. В режиме Каждый пользователь — своё запуск использует ящик человека, от имени которого он идёт; в режиме Общее — моё подключение для всех каждый запуск использует ваш. На схеме воркфлоу у шага видны тип аккаунта и адрес, например Почта — Gmail. Шаг, которому нужно отправить только одно заранее подготовленное письмо — утренний отчёт, оповещение, — это шаг «Уведомление». Такое письмо уходит из почтового ящика платформы или с почтового сервера, указанного в шаге, а не с этого аккаунта.

Чтобы добавить ящик, пройдите мастер из двух шагов: выберите почтового провайдера (для популярных провайдеров адреса серверов заполнены заранее, и мастер подскажет, где получить пароль приложения), введите адрес и пароль приложения, при желании задайте отображаемое имя и раскройте Дополнительные настройки сервера, чтобы указать хосты и порты IMAP/SMTP. Перед сохранением ящик проверяется на сервере, после чего попадает в вашу библиотеку подключений, и другие агенты могут использовать его повторно. На панели агента Интеграции можно сменить режим, выбрать, какой из ваших ящиков использует агент, Проверить его или убрать ящик из агента (подключение останется в вашей библиотеке).

Telegram¶

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

Доступность в зависимости от установки

Интеграции с Google и Telegram можно по отдельности отключить на уровне установки — тогда они не появятся у агентов этой установки. Это настройка всей установки, а не отдельного агента.

GitHub и GitLab¶

Подключите аккаунт GitHub (github.com) или GitLab (gitlab.com), чтобы агенты могли работать с вашими репозиториями. Откройте Профиль → Подключения и выберите способ подключения: Подключить GitHub App или Подключить GitLab, чтобы войти на странице провайдера, или Подключить по токену, чтобы вставить персональный токен доступа. Платформа никогда не видит и не хранит ваш пароль. Когда подключение готово, на карточке провайдера вместо кнопок подключения появляется аккаунт — Подключено как <ваш логин> — с теми же действиями, что и у любого подключения в вашей библиотеке подключений. Для GitHub App кнопка Показать доступ к репозиториям на этой карточке перечисляет аккаунты и организации, где установлено приложение, а Изменить доступ к репозиториям открывает страницу GitHub, где можно установить его в другой аккаунт или организацию или изменить, к каким репозиториям у него есть доступ.

Подключить любой из них можно и из приложений для Android, iPhone, iPad и Mac (Подключения), а также изнутри Веб-разработчика, когда ему нужен репозиторий, — не заходя сначала в профиль.

Подключается один аккаунт GitHub и один аккаунт GitLab. Вход под другим аккаунтом, чем подключённый, отклоняется; чтобы сменить аккаунт, удалите подключение, войдите в другой аккаунт на сайте провайдера и подключитесь снова.

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

GitHub использует GitHub App платформы. Вы входите на GitHub и выбираете, куда установить приложение: в свой аккаунт или в организацию, в которой состоите, — и на все её репозитории или только на выбранные. Агентам доступны только эти репозитории. Если вы не владелец организации, GitHub отправит ваш запрос её владельцу, и репозитории организации станут доступны после его одобрения. Приложение запрашивает доступ на чтение и запись к содержимому репозиториев, пул-реквестам и файлам воркфлоу, а также доступ на чтение к проверкам и информации о репозитории.
GitLab открывает собственный экран входа и согласия GitLab. Вы даёте доступ к API GitLab от вашего имени (репозитории, ветки и merge request'ы), разрешение на push в репозитории и чтение вашего основного профиля.

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

Персональный токен доступа¶

Используйте токен, если ваша организация не разрешает GitHub App, если вы хотите сами ограничить доступ конкретными репозиториями и сроком действия или если вам нужно, чтобы Веб-разработчик работал с GitHub или GitLab из консоли своих окружений (gh, glab и git). На карточке GitHub или GitLab в разделе Профиль → Подключения выберите Подключить по токену. Кнопка откроет страницу токенов провайдера, где уже заполнены название токена и нужные платформе права. Создайте там токен, скопируйте его и вставьте в платформу. Платформа проверяет токен у провайдера перед сохранением, хранит его в зашифрованном виде и больше никогда не показывает.

Какой токен создать:

GitHub, ваши собственные репозитории — fine-grained токен, ограниченный выбранными вами репозиториями.
GitHub, репозитории организации — fine-grained токен, владельцем которого указана организация, ограниченный нужными вам репозиториями. Некоторые организации требуют, чтобы fine-grained токены одобрял владелец, а некоторые их не разрешают; в этом случае создайте классический токен, а если организация использует единый вход (SSO), авторизуйте токен для неё на GitHub.
GitLab — персональный токен доступа. Он даёт доступ ко всем проектам, в которых состоит ваш аккаунт, включая проекты в группах.

Токен доступен агенту в окружениях разработки

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

Изменение, замена и отключение¶

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

Изменение доступа к репозиториям. С GitHub App вы сами решаете на GitHub, к каким репозиториям у него есть доступ: выберите Изменить доступ к репозиториям в строке подключения — откроется страница приложения на GitHub — или перейдите в Installed GitHub Apps в настройках вашего аккаунта или организации. Добавлять и удалять репозитории или устанавливать приложение в другую организацию можно в любой момент. С токеном доступ такой, с каким токен был создан; чтобы изменить его, создайте новый токен и замените им старый.

Замена токена. Выберите Заменить токен в строке подключения и вставьте новый токен; он заменит прежний в том же подключении. Подключение можно также переключить с одного способа на другой: Подключить по токену превращает подключение через GitHub App или вход через GitLab в подключение по токену, а кнопка входа возвращает его обратно.

Если доступ перестал работать. Если вы отозвали доступ платформы на GitHub или GitLab, если срок действия токена истёк или токен удалён, или если провайдер отклоняет сохранённую авторизацию, у подключения появляется статус Нужно переподключить (у токена — Срок истёк — замените токен). Для подключения через GitHub App или вход через GitLab выберите Переподключить в этой строке и снова подтвердите доступ в окне провайдера; для токена выберите Заменить токен и вставьте новый.

Где это используется. Встроенный агент Веб-разработчик использует эти подключения, чтобы импортировать репозиторий и открывать pull request'ы или merge request'ы из своих задач. С подключением по токену он также работает с GitHub или GitLab из консоли своего окружения. Подключите аккаунт в разделе Профиль → Подключения; экраны Веб-разработчика ведут туда.

Отключение. Если удалить подключение GitHub или GitLab из библиотеки, оно удаляется с платформы, и окружения перестают получать токен.

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

Библиотека подключений¶

На iPhone откройте Настройки → Подключения → + → Аккаунт Google, чтобы добавить аккаунт Google в свою библиотеку. Меню добавления закрывается до того, как откроется экран входа Google. После того как вы подтвердите доступ, аккаунт появится в списке подключений.

В вашем аккаунте есть библиотека подключений — все подключённые вами MCP-серверы, аккаунты Google, почтовые ящики, чаты Telegram и аккаунты GitHub или GitLab, каждый указан один раз вместе с агентами, которые его используют. У каждой записи видно, куда она ведёт (аккаунт Google, адрес ящика, бот и чат или хост либо пакет сервера), есть кнопка Проверить или Подключить и меню, в котором запись можно переименовать, обновить её секреты (новый пароль приложения или токен бота для ящика или чата Telegram), отвязать от одного агента или удалить. Добавить ящик или чат Telegram в библиотеку можно кнопками Добавить почту / Добавить Telegram вверху страницы. При отвязке подключение остаётся в библиотеке: агент, который просит каждого пользователя подключить своё, попросит вас снова выбрать подключение, а у вашего собственного агента инструмент останется без учётных данных, пока вы не выберете другое подключение в настройках агента. Это то же место, куда вы попадаете, когда агент просит подключиться или выбрать одно из существующих подключений, так что просматривать их и управлять ими можно и вне чата какого-либо агента.

В приложениях для iOS, macOS и Android кнопка Проверить работает и для аккаунта GitHub или GitLab: она проверяет, что аккаунт по-прежнему принимает вход. Если доступ был отозван на GitHub или GitLab, подключение помечается как требующее переподключения.

Чтобы добавить MCP-сервер в библиотеку, используйте Добавить → Установить пакет или Добавить → Ручная настройка — те же два способа, что описаны в разделе Подключение внешних инструментов через MCP, — или Добавить → С помощью ассистента: откроется ассистент аккаунта, который найдёт и подключит сервер за вас, в том числе выполнит вход через OAuth, если серверу это нужно.

У каждого MCP-сервера, почтового ящика и аккаунта Google есть переключатель Доступно в чатах Агента Атом, по умолчанию выключенный. Если его включить, Агент Атом сможет пользоваться этим подключением в ваших повседневных чатах, а не только агенты, к которым оно привязано: вызывать инструменты сервера, читать и отправлять письма из вашего ящика или работать с Календарём, Таблицами, Документами и Диском Google в пределах того, что вы разрешили при подключении аккаунта. Если включено несколько ящиков или аккаунтов Google, Агент Атом использует тот, что вы подключили первым. У чатов Telegram такого переключателя нет — они служат только для уведомлений воркфлоу. Общее подключение агента, к которому открыт доступ или который опубликован, отмечено предупреждением — Все, кто использует <агент>, используют ваши учётные данные, — ведь каждый, кто общается с этим агентом, действует через ваше подключение, в чате и в своих запусках воркфлоу; если вы этого не хотите, переключите интеграцию агента в режим Каждый пользователь — своё, чтобы каждый конечный пользователь подключал своё.

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

Личные подключения и переменные окружения для каждого пользователя требуют агента v2 — агенты v1 их не поддерживают, и для таких агентов конечные пользователи видят только режим общего подключения.