Ключи и доступ

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

Как устроен доступ

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

• чтение: агент смотрит, ищет и составляет сводки, но ничего не меняет;
• чтение и управление: агент ещё и создаёт, правит, переводит статусы и архивирует.

Один агент может иметь доступ к нескольким организациям с разными уровнями. «Текущей» организации у агента нет: в каждом запросе он называет организацию явно, а Gigonom проверяет доступ заново.

При каждом действии проверяются три вещи:

1. Вы всё ещё участник этой организации. Вас исключили — доступ ваших агентов к ней пропадает сам.
2. Этому агенту выдан доступ именно к этой организации.
3. Уровня хватает: для изменений нужен уровень «чтение и управление».

Права вашей роли в организации проверяет сама операция, одинаково для интерфейса и для агента. Действие, которое доступно только владельцу и администраторам, агент участника не выполнит и получит тот же отказ, что участник в интерфейсе. Какие это действия, отмечено в «Справочнике инструментов».

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

Два способа подключения

Gigonom принимает агента по ключу или через вход в браузере (OAuth). Какой способ доступен, зависит от клиента. Пошаговые инструкции для конкретных клиентов собраны на страницах «Подключение Claude» и «ChatGPT, Codex и другие»; здесь — общая для всех часть.

Подключить агента с ключом

1. Откройте «Мои агенты» в настройках профиля.
2. Нажмите «Подключить агента» и дайте название, по которому узнаете подключение потом, например «Claude на рабочем ноутбуке».
3. Отметьте организации и для каждой выберите уровень.
4. Нажмите «Сохранить». Откроется окно «Ключ агента» с ключом, который начинается с gga_. Скопируйте его сразу.

Если агент появился в списке с пометкой «ключ» и надписью «ещё не использовался», он создан. Ключ клиент передаёт в заголовке Authorization: Bearer <ключ агента>. В угловых скобках то, что нужно заменить своим значением, скобки тоже уберите.

Подключить агента через браузер

Ключ не нужен. Регистрировать приложение заранее тоже не нужно: Gigonom поддерживает динамическую регистрацию клиентов.

1. Добавьте в клиенте сервер Gigonom и запустите подключение, как описано на странице вашего клиента.
2. Клиент откроет браузер. Войдите в Gigonom, если ещё не вошли.
3. На странице «<название приложения> запрашивает доступ» отметьте организации, для каждой выберите уровень и нажмите «Разрешить доступ». «Отказать» прерывает подключение.

Если в «Мои агенты» появился агент с пометкой «OAuth», подключение прошло. Если клиент прошёл вход без страницы согласия, агент появится без организаций. Отметьте их кнопкой «Изменить организации».

Проверить подключение

Спросите агента, какие организации Gigonom ему доступны. Если он перечислил организации, которые вы отметили, и уровень доступа к каждой, подключение работает. Если список пустой, откройте «Мои агенты» и отметьте организации у этого агента.

Изменить или отозвать доступ

В «Мои агенты» у каждого агента две кнопки:

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

Агенты в организации: для владельца и администраторов

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

Выдать доступ чужому агенту здесь нельзя: доступ выдаёт сам участник в «Мои агенты». Обычным участникам список не показывается.

Что видно в истории

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

• В Трекере у записей истории и комментариев задачи стоит значок «агент».
• В CRM значок «агент» стоит у записей в ленте сделки и контакта.
• В Автоматизациях запуск, отменённый агентом, получает причину «Отменён через агента».

Ошибки и что с ними делать

Безопасность

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