Как Leina подключает бизнес-приложения через OpenConnector

Карточка задачи проходит через шлюз к документам, календарю, электронной таблице и базе данных

Концептуальная иллюстрация: задача достигает авторизованных бизнес-приложений через шлюз доступа.

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

Leina подключает бизнес-приложения через OpenConnector — наш собственный шлюз безопасной авторизации. Шлюз обеспечивает авторизацию для вызовов приложений. Доступная область также зависит от поддержки коннектора, разрешений бизнес-аккаунта и настроек команды.

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

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

Что означают 1 500 провайдеров и 16 000 действий?

По данным о покрытии продукта на момент публикации, шлюз OpenConnector поддерживает более 1 500 провайдеров и свыше 16 000 действий. Эти цифры описывают покрытие сервисов и операций. Проверьте текущий каталог и коннектор для конкретных возможностей.

Понятие	Значение	Что проверить
Провайдер	Сервис, который можно подключить	Доступно ли бизнес-приложение команды?
Действие	Операция, предоставляемая его коннектором	Поддерживает ли он необходимый поиск, создание или обновление?
Разрешения аккаунта	Доступ аккаунта в этом сервисе	Может ли он достичь целевого рабочего пространства, папки или записей?

Поддерживаемый провайдер не предоставляет все функции своего сервиса. Поддерживаемое действие не даёт подключённому аккаунту доступ ко всем данным. Например, коннектор может поддерживать поиск документов, тогда как у аккаунта нет доступа к определённой папке проекта.

Покрытие сервисов даёт команде варианты; подходящее подключение и область авторизации определяют, сможет ли её задача быть выполнена.

Роль шлюза в доступе к приложениям

Доступ Leina к бизнес-приложениям проходит через OpenConnector. Команды авторизуют аккаунты через процесс подключения и определяют доступный объём через разрешения участников, групп и на стороне приложения.

From a Task to an Authorized Call

flowchart TB
  accTitle: From a Task to an Authorized Call
  accDescr: Leina uses OpenConnector to access app operations through authorized accounts. Both available actions and data scope need to be checked.
  T("Определённая задача"):::channel
  T --> L("Leina"):::agent
  L --> G("OpenConnector
Шлюз авторизации"):::gateway
  G --> A("Авторизованная учётная запись
Доступные данные"):::resource
  G --> O("Поддерживаемые
действия приложения"):::resource

App-call relationships: a task needs both a supported operation and appropriate account authorization.

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

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

Двигайтесь в обратном направлении от одной задачи

Для задачи, такой как суммирование заметок со встреч по проекту за эту неделю, определите четыре вещи перед подключением:

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

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

Проверьте подключение с помощью проверяемого запроса:

Найдите заметки со встреч по Проекту A за эту неделю в подключённом приложении для документов. Верните даты встреч, решения, ответственных и ссылки на источники. Читайте только материалы Проекта A и не изменяйте документы. Отметьте отсутствующую информацию как отсутствующую.

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

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

Чтение, создание, обновление и удаление — это разные требования. Создание точного резюме не устанавливает разрешение на изменение исходной системы.

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

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

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

Почему подключённое приложение всё ещё может возвращать отсутствующие данные?

Проверьте эти возможности по порядку:

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

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

Сделайте область подключения проверяемой

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

Для совместного использования перейдите к разрешениям участников и групп. Прочитайте один агент на всех платформах чата о взаимосвязи точек входа или обзор Leina для более широкого знакомства с продуктом.