Введение в OOMOL

OOMOL предоставляет AI Agents и backend продуктов общий способ работы с подключёнными Apps. Пользователь один раз авторизует аккаунт, после чего Agent, Skill или backend может вызывать разрешённые инструменты, не получая пароль аккаунта или необработанный токен провайдера.

Используйте OOMOL, когда нужно:

Предоставить Agent доступ к инструментам Apps, например Gmail, GitHub, Notion или Slack.
Повторно использовать одни подключённые Apps в поддерживаемых Agents.
Упаковать повторяемые инструкции Agent в Skills.
Добавить в backend продукта интеграции Apps, авторизованные пользователем.
Запустить open-source runtime Connector в собственном окружении.

Начните со своей задачи

Задача	Начните здесь
Использовать подключённые Apps из Agent	Использование OOMOL с AI Agent
Вызывать собственные подключённые Apps из backend-кода	Обзор Connector
Позволить каждому пользователю SaaS подключать собственные аккаунты	Обзор интеграции SaaS
Хранить runtime, credentials и журналы в своём окружении	Обзор OpenConnector

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

Как работает вызов инструмента

Пользователь подключает App и подтверждает разрешения провайдера.
OOMOL хранит полученный credential внутри выбранного hosted или self-hosted runtime.
Agent, Skill или backend находит action и его input schema.
Вызывающая сторона выбирает подключённый аккаунт и отправляет input action.
Runtime Connector вызывает провайдера и возвращает результат.

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

Компоненты продукта

Apps

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

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

Agents и oo CLI

oo — это command-line entry point для Agents с доступом к терминалу. На страницах установки приведены инструкции по настройке Codex, ChatGPT, Claude Code, других Agents и MCP-клиентов.

Начните с раздела Использование OOMOL с AI Agent.

Skills

Skill — это повторно используемый пакет инструкций, который объясняет Agent, как выполнить задачу. Skill может сочетать инструменты OOMOL App, локальные scripts и reasoning самого Agent.

Откройте OOMOL Skills, чтобы объединить выбор инструментов и инструкции задачи в повторно используемый workflow.

Connector

Connector — это слой подключения и выполнения. Он авторизует аккаунты, хранит credentials, предоставляет схемы actions и выполняет вызовы провайдеров. Начните с hosted Connector, интеграции SaaS или OpenConnector.

Credentials остаются за границей

Граница зависит от выбранного пути:

Hosting OOMOL хранит и обновляет credentials для hosted-вызовов Agent и SDK.
Проект Connector SaaS разделяет credentials проекта и подключения конечных пользователей.
Самостоятельно размещённый OpenConnector хранит credentials и записи выполнения в инфраструктуре, которой вы управляете.

Проверяйте scopes перед подключением аккаунта, предоставляйте только необходимые для задачи actions и не помещайте API keys в browser code, prompts и репозитории.

Следующий шаг

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