Agents Cloudflare : construire des intelligences interactives en temps réel sur les réseaux périphériques

Introduction générale

Cloudflare Agents est un cadre de développement open source de Cloudflare conçu pour aider les développeurs à créer des agents d'intelligence artificielle intelligents sur les réseaux périphériques mondiaux. Il permet aux agents de conserver leur état, de communiquer en temps réel et de fonctionner de manière autonome. Les fonctionnalités de base comprennent la gestion de l'état et l'interaction en temps réel WebSocket, qui peuvent déjà être utilisées pour créer des chatbots ou des outils de tâches automatisées.Cloudflare Agents vise à construire un système d'agents intelligents distribués où les agents peuvent fonctionner globalement avec un support pour les mécanismes de sommeil et de réveil. Les développeurs peuvent rejoindre ce projet open source avec une simple étape d'installation et travailler ensemble pour faire progresser la technologie de l'IA.

Liste des fonctions

• Cadre de travail de l'agent centralLe système de gestion de l'état : il fournit une fonctionnalité de gestion de l'état dans laquelle les agents peuvent se souvenir des données d'interaction historiques.
• communication en temps réelLe système d'information sur la vie privée : Il permet un dialogue instantané entre l'agent et le client par l'intermédiaire de WebSocket.
• Routage HTTPIl s'agit de traiter les demandes web et de faciliter l'interface avec les services externes.
• Intégration de ReactLes développeurs frontaux peuvent utiliser des crochets React intégrés.
• Chat de base sur l'IALe projet a pour but d'aider à l'élaboration de systèmes de dialogue simples et intelligents.
• Fonctions en cours de développementLa technologie de l'information : elle comprend un système de mémoire avancé, la prise en charge de l'audio et de la vidéo par WebRTC et des fonctionnalités de messagerie électronique.

Utiliser l'aide

Cloudflare Agents est un outil orienté vers le développement qui nécessite des connaissances de base en programmation avant d'être utilisé. Vous trouverez ci-dessous un guide d'installation et d'utilisation détaillé qui vous aidera à démarrer rapidement et à tirer le meilleur parti de ses fonctionnalités.

Processus d'installation

Les agents Cloudflare sont installés via npm et prennent en charge les nouveaux projets ou l'ajout à des projets existants. Voici les étapes à suivre.

Nouveaux projets de construction

1. Vérification de l'environnement
   Assurez-vous que Node.js (version 16 ou supérieure recommandée) et npm sont installés sur votre ordinateur. Ouvrez un terminal et tapez node -v répondre en chantant npm -v Consulter le numéro de version.
2. Créer un projet
   Exécutez la commande suivante dans le terminal :

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

Vous serez invité à saisir un nom de projet et à sélectionner un répertoire, et un projet de base sera généré à l'issue de la procédure.
3. Aller dans le répertoire du projet
importation cd 你的项目名称 Allez dans le dossier du projet nouvellement créé.
4. Lancer le développement local
La course à pied :

npm run dev

Cela démarre le serveur local et vous pouvez accéder à l'adresse locale par l'intermédiaire de votre navigateur (en général, l'adresse http://localhost:8787) pour en voir l'effet.

Ajouter à un projet existant

1. Aller dans le répertoire du projet
   utilisation finale cd pour passer au dossier de votre projet existant.
2. Installation du SDK
   Entrée :

npm install agents-sdk

Cela ajoutera la bibliothèque de base des agents Cloudflare au projet.
3. Code de configuration
Introduit dans le code agents-sdkPour l'utilisation spécifique, se référer à la documentation officielle.

Principales fonctions

Création d'un agent conversationnel simple

1. Écrire un code proxy
   Créer un fichier dans le projet (par ex. worker.ts), entrez le code suivant :

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

Cet agent répondra simplement à ce que l'utilisateur saisit.
2. Déploiement sur Cloudflare
S'exécute dans le terminal :

npx wrangler@latest deploy

Suivez les instructions pour vous connecter à votre compte Cloudflare, et une URL en ligne vous sera renvoyée une fois le déploiement terminé.
3. fonction de test
Visitez l'URL déployée avec un navigateur ou envoyez un message avec un outil tel que Postman pour vérifier que la réponse fonctionne.

Communication en temps réel avec WebSocket

1. Configuration de la prise en charge de WebSocket
   Modifier le code de l'agent pour inclure la communication en temps réel :

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

2. courtier de connexion frontal
   Ajoutez-le dans le code du front-end :

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

   Cela crée un canal de communication en temps réel, où les messages sont envoyés et les réponses reçues immédiatement.

3. test opérationnel
   Après le déploiement, exécutez le code frontal à l'aide de la console de l'outil de développement du navigateur pour voir comment fonctionne l'interaction avec le message.

Statut de l'agent de gestion

1. Sauvegarder et mettre à jour le statut
   Ajouter la gestion des états à l'agent :

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

2. Persistance de l'état de validation
   Visitez l'URL du proxy plusieurs fois après le déploiement et observez si le nombre continue d'augmenter, ce qui prouve que l'état est préservé.
3. scénario d'application
   La gestion de l'état est adaptée aux scénarios dans lesquels l'historique doit être enregistré, comme le nombre d'interactions avec l'utilisateur ou l'avancement d'une tâche.

Détails du processus d'opération

• débogage local: Run npm run dev Activez le mode développement et mettez automatiquement à jour le code après modification pour faciliter les tests.
• Le déploiement est opérationnelUtilisation de la npx wrangler@latest deploy Publier des agents sur le réseau mondial Cloudflare.
• Accès aux documents: Accès document officiel Obtenez plus d'exemples de code et de détails sur l'API.
• Participation de la communautéSi vous avez des suggestions d'amélioration, vous pouvez soumettre des problèmes ou du code sur GitHub et participer au développement du projet.

mise en garde

• variable d'environnementSi vous avez besoin d'appeler un modèle d'IA externe (par exemple, OpenAI), faites-le dans la section wrangler.toml pour configurer la clé API.
• exigences en matière de réseauDéploiement : Le déploiement nécessite une connexion réseau stable afin de s'assurer qu'il n'y a pas d'interruptions lors de la connexion à Cloudflare.
• Ressources pédagogiques: Fourni officiellement Terrain de jeux Exemple (situé dans le dépôt GitHub de l'application examples/playground), vous pouvez exécuter la référence directement.

L'avantage des agents Cloudflare est leur déploiement distribué à l'échelle mondiale et leurs fonctions de persistance de l'état, qui conviennent aux scénarios d'application nécessitant une faible latence et une haute disponibilité.