OAK: proyecto de código abierto para construir visualmente aplicaciones corporales inteligentes

Introducción general

OAK (Open Agent Kit) es una herramienta de código abierto que ayuda a los desarrolladores a construir, personalizar y desplegar rápidamente inteligencias de IA. Puede conectarse a cualquier Large Language Model (LLM), como los de OpenAI, Google o Anthropic, y también permite añadir funcionalidad mediante plugins.OAK se ha diseñado con un objetivo claro: facilitar la integración de la IA. Ofrece una estructura modular, API intuitivas y componentes de interfaz fáciles de usar que permiten a los desarrolladores pasar rápidamente de la idea al entorno de producción. Tanto si está creando un asistente inteligente como desarrollando servicios de atención al cliente impulsados por IA, OAK ofrece flexibilidad y escalabilidad. Está impulsado por la comunidad de desarrolladores, el código es público y los usuarios pueden modificarlo libremente, lo que lo hace adecuado para proyectos de todos los tamaños.

Lista de funciones

• Admite conexiones LLM arbitrarias: compatible con OpenAI, Google, Anthropic y otros modelos, también admite modelos autoalojados.
• Extensiones de plugins: añade funcionalidades mediante plugins, como el tratamiento de datos o la búsqueda en tiempo real.
• Diseño modular: proporciona componentes ajustables para personalizar fácilmente las funciones de IA.
• Ejecución con un solo clic: inicie rápidamente aplicaciones nativas con comandos sin necesidad de configuraciones complejas.
• Componente de interfaz: Interfaz de chat integrada que puede incrustarse en un sitio web o una aplicación.
• Código abierto y transparente: el código está disponible públicamente en GitHub y los usuarios pueden modificarlo o contribuir a él.
• Soporte de base de datos: opcional en PostgreSQL, almacenar datos más conveniente.
• Impulsado por la comunidad: obtenga apoyo o comparta experiencias a través de Discord.

Utilizar la ayuda

OAK es sencillo y directo, y resulta adecuado tanto para una rápida puesta en marcha como para un desarrollo en profundidad. A continuación encontrará instrucciones detalladas de instalación y uso.

Proceso básico de instalación

Si desea ejecutar OAK directamente sin cambiar el código ni desarrollar plug-ins, puede seguir los pasos que se indican a continuación:

1. lanzar una aplicación
   Abra un terminal e introduzca el comando

npx @open-agent-kit/cli run docker

Esto descargará e iniciará automáticamente OAK.

2. modelo de configuración
   La línea de comandos le pedirá que seleccione un modelo (por ejemplo, GPT-4o de OpenAI) e introduzca la clave API. Rellene la clave como se le pida, por ejemploOPENAI_API_KEY=你的密钥y, a continuación, introduzca.
3. Acceso a las aplicaciones
   Una vez iniciada con éxito, abra su navegador y escriba:

http://localhost:3000

Verás la pantalla de chat de OAK.

4. prueba de funcionamiento
   Introduzca "Qué día de la semana es hoy" en la interfaz, si se devuelve la respuesta correcta, la instalación se ha realizado correctamente.

Proceso de instalación avanzado

Si quieres cambiar el modelo predeterminado, añadir plugins o desarrollar nuevas funciones, puedes seguir los pasos que se indican a continuación:

Crear un proyecto

1. Generar proyecto
   Introdúcelo en el terminal:

npx @open-agent-kit/cli create project

Esto creará una carpeta de proyecto con una configuración predeterminada.

2. Acceso al catálogo
   importacióncd 项目名Entre en el catálogo de proyectos.

Configuración de la base de datos (opcional)

1. Ejecutar PostgreSQL
   Inicie la base de datos con Docker y entre:

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

intercambiabilidad你的用户名responder cantando你的密码.

2. Configurar las conexiones
   Copie el proyecto.env.exampledebido a.envedita el archivo y rellena la información de la base de datos, por ejemplo:

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

Entorno de configuración

1. Obtener clave API

• OpenAI: AccesoSitio web oficial de OpenAIcrea la llave.
• Google: referenciaDocumentación Gemini.
• Antrópico: VerDocumentación antrópica.
• XAI: VerDocumento XAI.

2. Generar clave de aplicación
   entrevistashttps://api.open-agent-kit.com/generate-secret.htmlGenereAPP_SECRETPor ejemplo:

APP_SECRET=生成的32位密钥

3. Configuración de variables de entorno
   existe.envRellene la clave y otras configuraciones, por ejemplo:

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

desarrollo local

1. Instalación de dependencias
   Entrada:

npm install

2. migración operativa
   Si se utiliza una base de datos, ejecutar:

npm run generate
npm run migrate:deploy

3. lanzar una aplicación
   Entrada:

npm run dev

entrevistashttp://localhost:5173Accede a la interfaz de administración.

Funciones principales

Conexión LLM

• Haz clic en "Configuración" en la interfaz y selecciona un modelo (por ejemplo, Google Gemini).
• Introduzca la clave API y guarde.
• Haz la prueba escribiendo una pregunta en el cuadro de chat, por ejemplo: "¿Cuántas veces es igual a 1+1?".

Añadir plug-ins

• En la carpeta del proyectopluginsañada el código del plugin (consulteArchivo (informático)).
• estar en movimientonpm run buildEmbalaje.
• Reinicie la aplicación y el complemento surtirá efecto automáticamente.

Personalizar la interfaz

• En la interfaz de administración, ajusta los colores y los tipos de letra.
• haga una copia de<iframe>Código para incrustar en su sitio web.

Función destacada Operación

Desarrollo modular

• El diseño modular de OAK le permite ajustar características individualmente, como cambiar la lógica del chat.
• Buscar en el códigosrc/modulesmodificada en caso necesario.

Despliegue en la nube

• Despliegue con Vercel: En el terminal escribavercel deploySiga las instrucciones.
• Acceda a la URL devuelta tras la implantación.

Estos pasos hacen que OAK sea claro y operable desde su instalación hasta su uso. Para más informacióndocumento oficial.

escenario de aplicación

1. asistente inteligente
   Los usuarios pueden crear asistentes personales con OAK para responder preguntas o gestionar tareas cuando estén conectados a LLM.
2. servicio al cliente
   Las empresas integran OAK en sus sitios web para automatizar las respuestas a las consultas más habituales y mejorar la eficacia.
3. Apoyo educativo
   Los profesores utilizan OAK para crear herramientas de respuesta a preguntas en las que los alumnos introducen las preguntas y el sistema les devuelve las respuestas.
4. análisis de datos
   Desarrollador más plugin de datos para analizar datos empresariales y generar informes.

CONTROL DE CALIDAD

1. ¿Qué modelos admite OAK?
   Admite los principales LLM, como OpenAI, Google, Anthropic, etc., y también admite modelos de creación propia.
2. ¿Necesita saber programación?
   El uso básico no es necesario, basta con configurar la interfaz. Se requiere JavaScript base para desarrollar plugins o cambiar el código.
3. ¿Tiene algún coste gestionarlo localmente?
   Totalmente gratuito, sólo se pueden cobrar las implantaciones en la nube o las llamadas a la API.
4. ¿Cómo actualizar OAK?
   Basta con extraer el código más reciente de GitHub y volver a ejecutar el comando de instalación.