VoltAgent: un marco de código abierto TypeScript para construir rápidamente inteligencias de IA

Introducción general

VoltAgent es un marco TypeScript de código abierto diseñado para que los desarrolladores construyan y orquesten rápidamente inteligencias de IA. Proporciona herramientas modulares y un modelo de desarrollo estandarizado que simplifica la complejidad de interactuar con grandes modelos de lenguaje (LLM), la gestión de estados y la integración de herramientas externas. Los desarrolladores pueden utilizarlo para crear chatbots, asistentes virtuales o complejos sistemas multiinteligencia.VoltAgent evita el tedio de desarrollar desde cero y rompe con las limitaciones de las plataformas sin código. Es compatible con diversos modelos LLM, como OpenAI, Google y Anthropic, y ofrece una consola de depuración local para que los desarrolladores puedan supervisar fácilmente el estado de sus inteligencias. El proyecto es de código abierto y está impulsado por la comunidad a través de GitHub, y es adecuado para desarrolladores que quieran desarrollar rápidamente aplicaciones de IA escalables.

Lista de funciones

• El motor central (@voltagent/core): Proporciona capacidades de definición de inteligencia, gestión de herramientas y enrutamiento de mensajes.
• Sistema de cuerpo multiinteligente: admite la coordinación de múltiples subinteligencias a través de un cuerpo inteligente supervisor para gestionar flujos de trabajo complejos.
• Integración de herramientas: Soporte para conectarse a APIs externas, bases de datos y servicios donde las inteligencias pueden realizar tareas realistas.
• Soporte LLM flexible: compatible con OpenAI, Anthropic, Google y otros modelos, fácil de cambiar.
• Gestión de la memoria: las inteligencias pueden guardar contextos de interacción para un diálogo natural.
• Consola de depuración local: supervisión en tiempo real del estado del cuerpo inteligente, registros y llamadas a herramientas.
• Recuperación de datos y RAG: admite la generación de mejoras de recuperación para una adquisición y un tratamiento eficaces de la información.
• Interacción por voz: mediante @voltagent/voice El paquete es compatible con el reconocimiento y la síntesis de voz.
• Herramientas CLI: mediante create-voltagent-app Construya proyectos rápidamente.

Utilizar la ayuda

Proceso de instalación

VoltAgent está basado en un entorno Node.js y necesitas asegurarte de que Node.js está instalado primero (se recomienda la versión LTS). Aquí están los pasos detallados de instalación:

1. Proyecto de inicialización
   Utilice la herramienta CLI proporcionada por VoltAgent para crear rápidamente un proyecto. Abra un terminal y ejecute el siguiente comando:

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

Se te pedirá que selecciones un gestor de paquetes (npm, yarn o pnpm) y que introduzcas el nombre del proyecto. Cuando termine, introduzca el directorio del proyecto:

cd my-voltagent-app

2. Entorno de configuración
   Una vez creado el proyecto, es necesario configurar la clave API para el proveedor LLM. Por ejemplo, para utilizar el modelo OpenAI, cree la clave .env Archivo, añadir:

   OPENAI_API_KEY=sk-proj-你的密钥
   

   intercambiabilidad sk-proj-你的密钥 para la clave real de la API de OpenAI. Otros modelos (por ejemplo, Anthropic, Google) tienen configuraciones similares, consulte la documentación oficial para más detalles voltagent.dev/docs.

3. Inicio de proyectos
   Ejecute el siguiente comando para iniciar el servidor de desarrollo:

   npm run dev
   

   Asistencia al servidor de desarrollo tsx watchEl VoltAgent se reinicia automáticamente tras un cambio de código. Una vez iniciada, se puede acceder a la consola del VoltAgent a través de un navegador (normalmente el navegador http://localhost:3000) interactuando con las inteligencias.

Funciones principales

1. Creación y funcionamiento de las inteligencias

En el corazón de VoltAgent está la definición de las inteligencias. Tras la inicialización del proyecto, elsrc/index.ts Se incluye un ejemplo sencillo de cuerpo inteligente. A continuación se muestra el código para crear un cuerpo inteligente básico:

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 } });

Tras ejecutar el proyecto, puedes enviar un mensaje a través de la consola, como "Explica la computación cuántica", y el organismo inteligente generará una respuesta.

2. Sistemas multiinteligencia

VoltAgent soporta la colaboración multi-inteligencia. Por ejemplo, cree un sistema de análisis de repositorios de GitHub que contenga las siguientes inteligencias:

• StarsFetcher: Obtiene el número de estrellas de almacén.
• ColaboradoresFetcherObtenga una lista de colaboradores.
• RepoAnalyzer: Analizar datos y generar informes.
• Supervisor: Coordinar las inteligencias anteriores.

Código de ejemplo:

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

Envíe un mensaje como "analizar voltagent/voltagent" y la inteligencia supervisora llamará a las subinteligencias para generar los resultados del análisis.

3. Integración de herramientas

Intelligentsia puede interactuar con sistemas externos a través de herramientas. Por ejemplo, añade una herramienta para obtener GitHub starred:

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 };
},
});

Vincula las herramientas a las inteligencias:

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

4. Puesta en servicio y control

VoltAgent proporciona una consola de depuración local (console.voltagent.dev) para supervisar el funcionamiento de smartbody sin un servidor externo. Después de iniciar el proyecto, acceder a la consola y ver:

• Flujo de mensajes del cuerpo inteligente e invocación de herramientas.
• Registro y estado en tiempo real.
• Métricas de rendimiento como el tiempo de respuesta.
  La consola admite flujos de trabajo visuales, similares a los de n8n, para depurar sistemas complejos de inteligencia múltiple.

5. Interacción vocal

aprobar (una factura o inspección, etc.) @voltagent/voice paquete, el cuerpo inteligente soporta entrada y salida de voz. Paquete de instalación:

npm install @voltagent/voice

Active la función de voz en la configuración de smartbody:

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

El usuario puede hablar con el cuerpo inteligente a través del micrófono, lo que resulta idóneo para escenarios de asistente virtual.

Función destacada Operación

Recuperación de datos y GAR

VoltAgent soporta la Generación Aumentada de Recuperación (RAG), que obtiene información de fuentes de datos externas a través de inteligencias de recuperación dedicadas. Ejemplo de configuración:

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

Combinadas con herramientas de búsqueda vectorial, las inteligencias pueden extraer información relevante de bases de datos o documentos para mejorar la precisión de las respuestas.

gestión de la memoria

Intelligentsia puede guardar el contexto del diálogo. La memoria está activada:

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

Cuando los usuarios formulan preguntas consecutivas, la inteligencia genera respuestas más naturales basadas en el historial.

escenario de aplicación

1. Servicio automatizado de atención al cliente
   VoltAgent crea sistemas inteligentes de atención al cliente para gestionar las consultas de los usuarios. Las inteligencias de voz apoyan las interacciones telefónicas, la gestión de la memoria garantiza un diálogo coherente y se integran herramientas para consultar pedidos o inventarios.
2. Asistente de análisis de datos
   Los desarrolladores pueden crear inteligencias que analicen los repositorios de GitHub, extrayendo automáticamente las estrellas, los datos de los colaboradores y generando informes de tendencias.La funcionalidad RAG admite la extracción de información adicional de los repositorios de documentos.
3. Asistente virtual
   VoltAgent es adecuado para el desarrollo de asistentes personales que se ocupen de tareas como la gestión de la agenda, las respuestas al correo electrónico, etc. La herramienta integra una API de calendario conectable y la función de voz admite comandos verbales.
4. Herramientas educativas
   Los cuerpos inteligentes pueden utilizarse como asistentes de aprendizaje para responder a las preguntas de los alumnos y recuperar los materiales del curso. La gestión de la memoria facilita la tutoría a largo plazo y registra el progreso de los alumnos.

CONTROL DE CALIDAD

1. ¿Qué modelos de LLM admite VoltAgent?
   Soporta OpenAI, Anthropic, Google y otros modelos principales, los desarrolladores pueden cambiar de modelo a través de la configuración, sin modificar el código del núcleo.
2. ¿Cómo depurar un sistema multiinteligencia?
   Utilice la consola VoltAgent para ver las interacciones del cuerpo inteligente, las llamadas a herramientas y los registros en tiempo real. La consola admite flujos de trabajo visuales para una localización de problemas más intuitiva.
3. ¿Qué nivel de programación se requiere?
   Los desarrolladores familiarizados con TypeScript y Node.js pueden empezar rápidamente, y las herramientas CLI y la documentación reducen la barrera para los principiantes.
4. ¿Es VoltAgent gratuito?
   VoltAgent es un framework de código abierto y de uso gratuito. Sin embargo, es necesario pagar la tarifa API del proveedor correspondiente para utilizar el modelo LLM.