VoltAgent: фреймворк с открытым исходным кодом на TypeScript для быстрого создания искусственного интеллекта

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

VoltAgent - это фреймворк TypeScript с открытым исходным кодом, предназначенный для разработчиков, чтобы помочь быстро создать и оркестровать интеллектуальные системы искусственного интеллекта. Он предоставляет модульные инструменты и стандартизированную модель разработки, которая упрощает взаимодействие с большими языковыми моделями (LLM), управление состоянием и интеграцию внешних инструментов. Разработчики могут использовать его для создания чат-ботов, виртуальных помощников или сложных мультиинтеллектуальных систем. VoltAgent позволяет избежать утомительной разработки с нуля и преодолеть ограничения бескодовых платформ. Он поддерживает различные модели LLM, такие как OpenAI, Google и Anthropic, и предоставляет локальную отладочную консоль, с помощью которой разработчики могут легко отслеживать состояние своих интеллектов. Проект имеет открытый исходный код и поддерживается сообществом на GitHub. Он подходит для разработчиков, которые хотят быстро создавать масштабируемые приложения ИИ.

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

• Основной двигатель (@voltagent/core): Предоставляет возможности определения разведданных, управления инструментами и маршрутизации сообщений.
• Мультиинтеллектуальная система тела: поддерживает координацию нескольких субинтеллектов через интеллектуальное тело руководителя для выполнения сложных рабочих процессов.
• Интеграция инструментов: поддержка подключения к внешним API, базам данных и сервисам, с помощью которых интеллекты могут выполнять реалистичные задачи.
• Гибкая поддержка LLM: совместимость с OpenAI, Anthropic, Google и другими моделями, простота переключения.
• Управление памятью: интеллекты могут сохранять контексты взаимодействия для естественного диалога.
• Локальная отладочная консоль: мониторинг состояния интеллектуального тела, журналов и вызовов инструментов в режиме реального времени.
• Поиск данных и RAG: поддержка создания улучшений поиска для эффективного получения и обработки информации.
• Голосовое взаимодействие: через @voltagent/voice Пакет поддерживает распознавание и синтез речи.
• Инструменты CLI: через create-voltagent-app Быстро создавайте проекты.

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

Процесс установки

VoltAgent основан на среде Node.js, поэтому сначала необходимо убедиться, что Node.js установлен (рекомендуется версия LTS). Ниже приведены подробные шаги по установке:

1. Проект инициализации
   Для быстрого создания проекта используйте инструмент CLI, предоставляемый VoltAgent. Откройте терминал и выполните следующую команду:

   npm create voltagent-app@latest my-voltagent-app
   

Вам будет предложено выбрать менеджер пакетов (npm, yarn или pnpm) и ввести имя проекта. После завершения введите каталог проекта:

cd my-voltagent-app

2. Конфигурационная среда
   После создания проекта необходимо настроить API-ключ для провайдера LLM. Например, чтобы использовать модель OpenAI, создайте ключ .env Файл, добавить:

   OPENAI_API_KEY=sk-proj-你的密钥
   

   взаимозаменяемость sk-proj-你的密钥 для фактического ключа API OpenAI. Другие модели (например, Anthropic, Google) имеют аналогичные конфигурации, подробности см. в официальной документации voltagent.dev/docs.

3. Начало реализации проектов
   Выполните следующую команду, чтобы запустить сервер разработки:

   npm run dev
   

   Поддержка сервера разработки tsx watchПосле смены кода VoltAgent автоматически перезагружается. После запуска к консоли VoltAgent можно получить доступ через браузер (обычно это http://localhost:3000), взаимодействуя с интеллектом.

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

1. Создание и функционирование интеллекта

В основе VoltAgent лежит определение интеллекта. После инициализации проектаsrc/index.ts В комплект входит простой пример разумного тела. Ниже приведен код для создания базового разумного тела:

import { VoltAgent, Agent } from "@voltagent/core";
import { VercelAIProvider } from "@voltagent/vercel-ai";
import { openai } from "@ai-sdk/openai";
const agent = new Agent({
name: "my-voltagent-app",
description: "回答用户问题的助手",
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
});
const voltagent = new VoltAgent({ agents: { agent } });

Запустив проект, вы можете отправить сообщение через консоль, например "Объясните квантовые вычисления", и разумное тело сгенерирует ответ.

2. Мультиинтеллектуальные системы

VoltAgent поддерживает совместную работу нескольких интеллектов. Например, создайте аналитическую систему для репозитория GitHub, содержащую следующие интеллекты:

• StarsFetcher: Получите количество звезд склада.
• ВкладчикиФетчер: Получить список участников.
• RepoAnalyzerАнализировать данные и создавать отчеты.
• Супервайзер: Координируйте работу вышеперечисленных интеллектов.

Код примера:

const supervisorAgent = new Agent({
name: "Supervisor",
description: "协调 GitHub 仓库分析任务",
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
subAgents: [starsFetcherAgent, contributorsFetcherAgent, analyzerAgent],
});

Отправьте сообщение типа "analyse voltagent/voltagent", и управляющий интеллект вызовет подинтеллекты для получения результатов анализа.

3. Интеграция инструментов

Intelligentsia может взаимодействовать с внешними системами с помощью инструментов. Например, добавьте инструмент для получения звезд на GitHub:

const fetchRepoStarsTool = createTool({
name: "fetchRepoStars",
description: "获取 GitHub 仓库星标数",
execute: async ({ repo }) => {
// 调用 GitHub API
const response = await fetch(`https://api.github.com/repos/${repo}`);
const data = await response.json();
return { stars: data.stargazers_count };
},
});

Привяжите инструменты к интеллекту:

const starsFetcherAgent = new Agent({
name: "StarsFetcher",
tools: [fetchRepoStarsTool],
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
});

4. Ввод в эксплуатацию и мониторинг

VoltAgent предоставляет локальную отладочную консоль (console.voltagent.dev) для мониторинга работы smartbody без внешнего сервера. После запуска проекта зайдите в консоль и посмотрите:

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

5. голосовое взаимодействие

пройти (законопроект, проверку и т.д.) @voltagent/voice пакет, умное тело поддерживает голосовой ввод и вывод. Установочный пакет:

npm install @voltagent/voice

Включите функцию голосовой связи в конфигурации smartbody:

const voiceAgent = new Agent({
name: "VoiceAgent",
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
voice: true,
});

Пользователь может разговаривать с умным телом через микрофон, что подходит для сценариев виртуального помощника.

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

Поиск данных и RAG

VoltAgent поддерживает функцию Retrieval Augmented Generation (RAG), которая получает информацию из внешних источников данных с помощью специальных поисковых интеллектов. Пример конфигурации:

const retrieverAgent = new Agent({
name: "Retriever",
description: "从知识库检索信息",
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
tools: [vectorSearchTool],
});

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

управление памятью

Intelligentsia может сохранять контекст диалога. Память включена:

const agent = new Agent({
name: "MemoryAgent",
memory: { provider: "default", maxHistory: 10 },
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
});

Когда пользователи задают последовательные вопросы, интеллект генерирует более естественные ответы, основанные на истории.

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

1. Автоматизированное обслуживание клиентов
   VoltAgent создает интеллектуальные системы обслуживания клиентов для обработки запросов пользователей. Голосовые интеллекты поддерживают телефонное взаимодействие, управление памятью обеспечивает связный диалог, а инструменты интегрированы для запроса заказов или инвентаря.
2. Помощник по анализу данных
   Разработчики могут создавать интеллектуальные системы, которые анализируют репозитории GitHub, автоматически извлекают звезды, данные о вкладчиках и генерируют отчеты о тенденциях. Функциональность RAG поддерживает извлечение дополнительной информации из хранилищ документов.
3. Виртуальный помощник
   VoltAgent подходит для разработки персональных ассистентов для решения таких задач, как управление расписанием, ответы на электронные письма и многое другое. В инструмент интегрирован подключаемый API календаря, а голосовая функция поддерживает вербальные команды.
4. Образовательные инструменты
   Интеллектуальные тела могут использоваться в качестве помощников в обучении, чтобы отвечать на вопросы студентов и получать материалы по курсу. Управление памятью поддерживает долгосрочное обучение и фиксирует успехи учеников.

QA

1. Какие модели LLM поддерживает VoltAgent?
   Поддержка OpenAI, Anthropic, Google и других основных моделей, разработчики могут переключать модели через конфигурацию, не изменяя основной код.
2. Как отладить многоинтеллектуальную систему?
   Используйте консоль VoltAgent для просмотра взаимодействия с интеллектуальным телом, вызовов инструментов и журналов в режиме реального времени. Консоль поддерживает визуальные рабочие процессы для более интуитивного определения проблемы.
3. Какой уровень программирования требуется?
   Разработчики, знакомые с TypeScript и Node.js, могут быстро приступить к работе, а инструменты CLI и документация снижают барьер для новичков.
4. Является ли VoltAgent бесплатным?
   VoltAgent является фреймворком с открытым исходным кодом и бесплатен для использования. Однако для использования модели LLM необходимо оплатить API соответствующего провайдера.