OpenGeni: агентная служба для организации работы AI-агентов

Проект Opengeni — это готовый к использованию сервис, который позволяет запускать AI-агентов для выполнения реальной работы. Он обеспечивает поддержку длительных сессий, ведет подробный лог событий, останавливается для получения одобрений от человека и помещает каждую сессию либо в управляемую песочницу, либо на машину, которая принадлежит пользователю.

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

Как начать

Самый простой способ — использовать управляемый сервис. Зарегистрируйся на app.opengeni.ai, выбери имя для своей организации и подключи модель (например, ChatGPT или Codex) для начала первой сессии. В документации есть ускоренный старт.

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

Особенности

• Долговечные, воспроизводимые сессии. Каждое событие записывается в Postgres, что позволяет воспроизводить историю сессии в случае перезагрузки.
• Сессии, которые выполняют задачи. Агенты продолжают свою работу до тех пор, пока не достигнут успеха или не получат одобрение от человека.
• Человек в процессе. Одобрения инструментов необходимы для рискованных действий; агенты могут задавать уточняющие вопросы.
• Работа в любых условиях. Решение может работать как в песочнице (через Docker), так и на твоем оборудовании.
• Управление знаниями. Все файлы и источники можно искать и организовывать.
• Интеграция через один API. У тебя будет один ключ API, чтобы интегрировать все функции в своем приложении.

Как запустить локально

Для разработки или оценки Opengeni перед хостингом, нужно установить следующие зависимости: Bun, Git, curl, Docker, rustup и ключ OpenAI. После установки используй следующие команды:

git clone https://github.com/Cloudgeni-ai/opengeni.git
cd opengeni
cp .env.example .env   # добавь свои учетные данные модели
bun run dev

Затем открой http://127.0.0.1:3000 и опиши задачу для наблюдения за выполнением сессии.

Использование в коде

Для взаимодействия с Opengeni из своего кода можно использовать TypeScript SDK. Вот пример:

import { OpenGeni, createChatHandler } from "@opengeni/sdk/chat";

const og = new OpenGeni({
  apiKey: process.env.OPENGENI_API_KEY!,
  organizationId: process.env.OPENGENI_ORGANIZATION_ID!,
});

const chat = await og.chat({ tenant: "acme", user: "u_42", conversation: "c_9" });
const reply = await chat.send("Summarize open incidents from the last week.");
console.log(reply.text);

Начинай работу с документации по интеграции продукта и используй доступные компоненты для React.

Ограничения и безопасность

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

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