Agentes Cloudflare: creación de inteligencias interactivas en tiempo real en redes periféricas

Introducción general

Cloudflare Agents es un marco de desarrollo de código abierto de Cloudflare diseñado para ayudar a los desarrolladores a crear agentes de IA inteligentes en redes de borde global. Proporciona a los agentes la capacidad de persistir en el estado, comunicarse en tiempo real y funcionar de forma autónoma, y el proyecto se encuentra actualmente en desarrollo activo. Entre sus características principales se incluyen la gestión de estados y la interacción en tiempo real mediante WebSocket, que ya pueden utilizarse para crear chatbots o herramientas de tareas automatizadas.Cloudflare Agents tiene como objetivo construir un sistema de agentes inteligentes distribuidos en el que los agentes puedan ejecutarse globalmente con soporte para mecanismos de suspensión y activación. Los desarrolladores pueden unirse a este proyecto de código abierto con un sencillo paso de instalación y trabajar juntos para hacer avanzar la tecnología de IA.

Lista de funciones

• Marco de agentes principalesGestión de estados: Proporciona una funcionalidad de gestión de estados en la que los agentes pueden recordar datos históricos de interacción.
• comunicación en tiempo realPermite el diálogo instantáneo entre el agente y el cliente a través de WebSocket.
• Enrutamiento HTTP: Gestiona las solicitudes web y facilita la interconexión con servicios externos.
• Integración de ReactGanchos React incorporados para desarrolladores front-end.
• Chat AI básicoSoporte para la construcción de sistemas de diálogo inteligente sencillos.
• Funciones en desarrollo: Incluye un sistema de memoria avanzado, soporte de audio y vídeo WebRTC y funciones de correo electrónico.

Utilizar la ayuda

Cloudflare Agents es una herramienta orientada a desarrolladores que requiere conocimientos básicos de programación antes de su uso. A continuación encontrará una guía detallada de instalación y funcionamiento que le ayudará a empezar a utilizarla rápidamente y a sacar el máximo partido de sus funciones.

Proceso de instalación

Cloudflare Agents se instala a través de npm y admite nuevos proyectos o la adición a proyectos existentes. Estos son los pasos.

Proyectos de nueva construcción

1. Comprobación del entorno
   Asegúrese de que su ordenador tiene instalado Node.js (se recomienda la versión 16 o superior) y npm. abra un terminal y escriba node -v responder cantando npm -v Ver el número de versión.
2. Crear un proyecto
   Ejecute el siguiente comando en el terminal:

npm create cloudflare@latest -- --template cloudflare/agents-starter

Se le pedirá que introduzca un nombre de proyecto y seleccione un directorio, y al terminar se generará un proyecto base.
3. Vaya al directorio del proyecto
importación cd 你的项目名称 Vaya a la carpeta del proyecto recién creado.
4. Iniciar el desarrollo local
Corriendo:

npm run dev

Esto iniciará el servidor local, y podrá acceder a la dirección local a través de su navegador (normalmente la dirección http://localhost:8787) para ver el efecto.

Añadir a proyecto existente

1. Vaya al directorio del proyecto
   uso final cd para cambiar a la carpeta del proyecto existente.
2. Instalación del SDK
   Entrada:

npm install agents-sdk

Esto añadirá la biblioteca principal de agentes de Cloudflare al proyecto.
3. Código de configuración
Introducido en el código agents-sdkConsulte la documentación oficial para usos específicos.

Funciones principales

Creación de un agente de chat de IA sencillo

1. Escribir código proxy
   Cree un archivo en el proyecto (por ejemplo worker.ts), introduzca el siguiente código:

import { Agent } from "agents-sdk";
export class ChatAgent extends Agent {
async onRequest(request) {
const message = await request.text();
return new Response(`你说：${message}`);
}
}

Este agente se limitará a responder a lo que introduzca el usuario.
2. Implementación en Cloudflare
Se ejecuta en el terminal:

npx wrangler@latest deploy

Siga las indicaciones para iniciar sesión en su cuenta de Cloudflare, y se le devolverá una URL en línea cuando se haya completado la implementación.
3. función de prueba
Visite la URL desplegada con un navegador o envíe un mensaje con una herramienta como Postman para comprobar que la respuesta funciona.

Comunicación en tiempo real mediante WebSocket

1. Configuración de la compatibilidad con WebSocket
   Modificar el código del agente para incluir la comunicación en tiempo real:

   import { Agent } from "agents-sdk";
   export class RealTimeAgent extends Agent {
   async onConnect(connection) {
   connection.send("已连接！");
   }
   async onMessage(connection, message) {
   connection.send(`收到消息：${message}`);
   }
   }
   

2. broker de conexión front-end
   Añádelo en el código del front-end:

   const ws = new WebSocket("wss://你的代理URL");
   ws.onmessage = (event) => console.log(event.data);
   ws.send("你好");
   

   Se crea así un canal de comunicación en tiempo real, en el que los mensajes se envían y las respuestas se reciben inmediatamente.

3. prueba de funcionamiento
   Después del despliegue, ejecute el código del front-end utilizando la consola de la herramienta de desarrollo del navegador para ver cómo funciona la interacción con los mensajes.

Estado del agente gestor

1. Guardar y actualizar el estado
   Añade la gestión de estados al agente:

   export class StateAgent extends Agent {
   async onRequest(request) {
   this.state.count = (this.state.count || 0) + 1;
   return new Response(`访问次数：${this.state.count}`);
   }
   }
   

2. Persistencia del estado de validación
   Visite la URL del proxy varias veces después del despliegue y observe si el recuento sigue aumentando, lo que demuestra que el estado se conserva.
3. escenario de aplicación
   La gestión del estado es adecuada para escenarios en los que es necesario registrar el historial, como el número de interacciones del usuario o el progreso de las tareas.

Detalles del proceso operativo

• depuración local: Ejecutar npm run dev Active el modo de desarrollo y actualice automáticamente el código después de modificarlo para facilitar las pruebas.
• Despliegue en directo: Uso de npx wrangler@latest deploy Publique agentes en la red global de Cloudflare.
• Acceso a los documentos: Acceso documento oficial Obtenga más ejemplos de código y detalles de la API.
• Participación comunitariaSi tiene sugerencias de mejora, puede enviar problemas o código a GitHub y participar en el desarrollo del proyecto.

advertencia

• variable de entornoSi necesita llamar a un modelo de IA externo (por ejemplo, OpenAI), hágalo en el campo wrangler.toml para configurar la clave API.
• requisitos de la redLa implementación requiere una conexión de red estable para garantizar que no haya interrupciones al iniciar sesión en Cloudflare.
• Recursos de aprendizaje: Proporcionado oficialmente Parque infantil Ejemplo (ubicado en el repositorio GitHub del proyecto examples/playground), puede ejecutar la referencia directamente.

Con los pasos anteriores, puede crear fácilmente un agente de IA. La ventaja de los agentes de Cloudflare es su implementación distribuida globalmente y las funciones de persistencia de estado, que son adecuadas para escenarios de aplicaciones que requieren baja latencia y alta disponibilidad.