OAK: проект с открытым исходным кодом для визуального построения интеллектуальных приложений для тела

Общее введение

OAK (Open Agent Kit) - это инструмент с открытым исходным кодом, который помогает разработчикам быстро создавать, настраивать и внедрять ИИ-интеллекты. Он может подключаться к любой большой языковой модели (LLM), например, от OpenAI, Google или Anthropic, а также поддерживает добавление функциональности с помощью плагинов. OAK разработан с четкой целью: сделать интеграцию ИИ простой. Он предлагает модульную структуру, интуитивно понятные API и простые в использовании компоненты интерфейса, которые позволяют разработчикам быстро перейти от идеи к производственной среде. Независимо от того, создаете ли вы интеллектуального помощника или разрабатываете клиентские сервисы на базе ИИ, OAK предлагает гибкость и масштабируемость. Сайт поддерживается сообществом разработчиков, код является публичным, и пользователи могут свободно его изменять, что делает его подходящим для проектов любого размера.

Список функций

• Поддержка произвольных LLM-соединений: совместимость с OpenAI, Google, Anthropic и другими моделями, а также поддержка самостоятельных моделей.
• Расширения плагинов: добавление функциональности с помощью плагинов, например, обработка данных или поиск в реальном времени.
• Модульная конструкция: включает в себя регулируемые компоненты для легкой настройки функций ИИ.
• Запуск в один клик: быстрый запуск родных приложений с помощью команд без сложной настройки.
• Компонент интерфейса: встроенный интерфейс чата, который может быть встроен в веб-сайт или приложение.
• Открытый исходный код и прозрачность: код находится в открытом доступе на GitHub и может быть изменен или дополнен пользователями.
• Поддержка баз данных: опционально устанавливается в PostgreSQL, хранить данные удобнее.
• Сообщество: получайте поддержку или делитесь опытом через Discord.

Использование помощи

OAK прост и понятен и подходит как для быстрого запуска, так и для глубокой поддержки разработки. Ниже приведены подробные инструкции по установке и использованию.

Основной процесс установки

Если вы хотите запустить OAK напрямую, без изменения кода или разработки плагинов, вы можете выполнить следующие действия:

1. запустить приложение
   Откройте терминал и введите команду:

npx @open-agent-kit/cli run docker

Это автоматически загрузит и запустит OAK.

2. модель конфигурации
   В командной строке будет предложено выбрать модель (например, OpenAI's GPT-4o) и ввести ключ API. Введите ключ в соответствии с запросом, напримерOPENAI_API_KEY=你的密钥, а затем введите.
3. Доступ к приложениям
   После успешного запуска откройте браузер и введите:

http://localhost:3000

Вы увидите экран чата OAK.

4. тестовый запуск
   Введите в интерфейсе "Какой сегодня день недели", если будет получен правильный ответ, установка прошла успешно.

Расширенный процесс установки

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

Создать проект

1. Создать проект
   Введите его в терминал:

npx @open-agent-kit/cli create project

Это создаст папку проекта с конфигурацией по умолчанию.

2. Доступ к каталогу
   импортcd 项目名Войдите в каталог проектов.

Настройка базы данных (необязательно)

1. Запуск PostgreSQL
   Запустите базу данных с помощью Docker и введите:

docker run --name oak-db 
-e POSTGRES_USER=你的用户名 
-e POSTGRES_PASSWORD=你的密码 
-e POSTGRES_DB=oak 
-p 5432:5432 -d pgvector/pgvector:pg17

взаимозаменяемость你的用户名ответить пением你的密码.

2. Настройка подключений
   Скопируйте файл проекта.env.exampleиз-за.envОтредактируйте файл и заполните информацию о базе данных, например:

DATABASE_URL=postgresql://你的用户名:你的密码@localhost:5432/oak?schema=public

Конфигурационная среда

1. Получить ключ API

• OpenAI: доступОфициальный сайт OpenAIСоздайте ключ.
• Google: ссылкаБлизнецы Документация.
• Антропологический: взглядАнтропологическая документация.
• XAI: См.Документ XAI.

2. Сгенерируйте ключ приложения
   интервьюhttps://api.open-agent-kit.com/generate-secret.htmlСоздатьAPP_SECRETНапример:

APP_SECRET=生成的32位密钥

3. Установка переменных окружения
   существовать.envЗаполните ключ и другие конфигурации, например:

APP_URL=http://localhost:5173
OPENAI_API_KEY=你的密钥
APP_SECRET=你的应用密钥

местное развитие

1. Установка зависимостей
   Вход:

npm install

2. оперативная миграция
   Если используется база данных, выполните:

npm run generate
npm run migrate:deploy

3. запустить приложение
   Вход:

npm run dev

интервьюhttp://localhost:5173Войдите в интерфейс администрирования.

Основные функции

Подключение LLM

• Нажмите на "Настройки" в интерфейсе и выберите модель (например, Google Gemini).
• Введите ключ API и сохраните.
• Проверьте, введя вопрос в поле чата, например, "Сколько раз 1+1 равно?".

Добавление плагинов

• В папке проектаpluginsВ каталог добавьте код плагина (см.(компьютерный) файл).
• быть в движенииnpm run buildУпаковка.
• Перезапустите приложение, и плагин вступит в силу автоматически.

Настройка интерфейса

• В административном интерфейсе настройте цвета и шрифты.
• сделать копию<iframe>Код для вставки на ваш сайт.

Функциональное управление

Модульная разработка

• Модульная конструкция OAK позволяет настраивать функции по отдельности, например, изменять логику чата.
• Найдите в кодеsrc/modulesПри необходимости в него вносятся изменения.

Развертывание облака

• Развертывание с помощью Vercel: В терминале введитеvercel deployСледуйте подсказкам.
• Доступ к возвращаемому URL после развертывания.

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

сценарий применения

1. интеллектуальный помощник
   С помощью OAK пользователи могут создавать персональных помощников, которые будут отвечать на вопросы или выполнять задачи при подключении к LLM.
2. обслуживание клиентов
   Предприятия внедряют OAK в свои веб-сайты, чтобы автоматизировать ответы на распространенные запросы и повысить эффективность работы.
3. Образовательная поддержка
   Преподаватели используют OAK для создания инструментов для ответов на вопросы, где ученики вводят вопросы, а система выдает ответы.
4. анализ данных
   Разработчик плюс плагин данных для анализа бизнес-данных и создания отчетов.

QA

1. Какие модели поддерживает OAK?
   Поддерживает основные LLM, такие как OpenAI, Google, Anthropic и т.д., а также поддерживает самостоятельно созданные модели.
2. Вам нужно знать программирование?
   Базовое использование не требуется, просто настройте интерфейс. Для разработки плагинов или изменения кода требуется база JavaScript.
3. Есть ли затраты на его локальное использование?
   Абсолютно бесплатно, только развертывание в облаке или вызов API могут быть платными.
4. Как обновить OAK?
   Просто возьмите последнюю версию кода с GitHub и заново выполните команду установки.