setupaiagents.com
Глоссарий

Connector (Workspace Agents), определение

Краткое определение

Коннектор, нативная OAuth-интеграция между Workspace Agent и внешней бизнес-системой, дающая агенту право читать данные из этой системы и (опционально) записывать в неё.

Развёрнутое определение

Коннекторы, основной способ, которым Workspace Agents взаимодействуют с внешним миром. OpenAI разработал нативные коннекторы для Google Workspace, Microsoft 365, Slack, HubSpot, Salesforce, GitHub, Linear, Notion, BigQuery, Snowflake и других систем. Каждый коннектор авторизуется через OAuth на уровне администратора и ограничивается по группам пользователей. Коннекторы отличаются от Actions, настраиваемых интеграций на основе OpenAPI, тем, что их поддерживает OpenAI и для их подключения не нужно никакой инженерной работы.

На практике

При проектировании Workspace Agent коннекторы, это первый архитектурный вопрос: из каких систем агент должен читать, в какие может писать и каков минимально необходимый OAuth-скоуп для каждой? Избыточные права доступа, главная ошибка в управлении агентами.

Типичные ошибки

  • Давать доступ «ко всему Drive» или «ко всему HubSpot» вместо ограничения конкретными папками или воронками
  • Считать, что коннектор существует, хотя нужен Action, проверяйте перед проектированием
  • Забывать, что права коннектора наследуются от пользователя, запускающего агента, а не от сервисного аккаунта по умолчанию

Смотрите также

Подробный гайд по этой теме →

Хотите запустить это для своей команды?

20 минут на звонке. Мы скажем, подходит ли это вам и что для этого нужно.