Cloudflare Agents: criando inteligências interativas em tempo real em redes de borda

Introdução geral

O Cloudflare Agents é uma estrutura de desenvolvimento de código aberto da Cloudflare projetada para ajudar os desenvolvedores a criar agentes de IA inteligentes em redes de borda global. Ele oferece aos agentes a capacidade de manter o estado, comunicar-se em tempo real e executar de forma autônoma, e o projeto está atualmente em desenvolvimento ativo. Os principais recursos incluem gerenciamento de estado e interação em tempo real via WebSocket, que já podem ser usados para criar chatbots ou ferramentas de tarefas automatizadas. O Cloudflare Agents tem como objetivo criar um sistema de agente inteligente distribuído em que os agentes possam ser executados globalmente com suporte para mecanismos de suspensão e despertar. Os desenvolvedores podem participar desse projeto de código aberto com uma simples etapa de instalação e trabalhar juntos para avançar a tecnologia de IA.

Lista de funções

• Estrutura do agente principalGerenciamento de estado: fornece funcionalidade de gerenciamento de estado em que os agentes podem se lembrar de dados históricos de interação.
• comunicação em tempo realSuporte ao diálogo instantâneo entre o agente e o cliente via WebSocket.
• Roteamento HTTPGerencia solicitações da Web e facilita a interface com serviços externos.
• Integração do ReactGanchos React incorporados para desenvolvedores de front-end.
• Bate-papo básico com IASuporte para a criação de sistemas de diálogo inteligentes simples.
• Funções em desenvolvimentoInclui um sistema de memória avançado, suporte a áudio e vídeo WebRTC e recursos de e-mail.

Usando a Ajuda

O Cloudflare Agents é uma ferramenta voltada para o desenvolvedor que requer conhecimentos básicos de programação antes de ser usada. Abaixo está um guia detalhado de instalação e operação para ajudá-lo a começar rapidamente e aproveitar ao máximo seus recursos.

Processo de instalação

O Cloudflare Agents é instalado via npm e oferece suporte a novos projetos ou à adição a projetos existentes. Aqui estão as etapas.

Novos projetos de construção

1. Verificação do ambiente
   Certifique-se de que seu computador tenha o Node.js (versão recomendada 16 ou superior) e o npm instalados. abra um terminal e digite node -v responder cantando npm -v Exibir o número da versão.
2. Criar um projeto
   Execute o seguinte comando no terminal:

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

Você será solicitado a digitar um nome de projeto e selecionar um diretório, e um projeto básico será gerado após a conclusão.
3. Vá para o diretório do projeto
importação cd 你的项目名称 Vá para a pasta do projeto recém-criado.
4. Início do desenvolvimento local
Em execução:

npm run dev

Isso iniciará o servidor local, e você poderá acessar o endereço local por meio do seu navegador (geralmente o http://localhost:8787) para ver o efeito.

Adicionar ao projeto existente

1. Vá para o diretório do projeto
   uso final cd para alternar para a pasta do projeto existente.
2. Instalação do SDK
   Entrada:

npm install agents-sdk

Isso adicionará a biblioteca principal do Cloudflare Agents ao projeto.
3. Código de configuração
Introduzido no código agents-sdkConsulte a documentação oficial para obter informações específicas sobre o uso.

Funções principais

Criação de um agente de bate-papo com IA simples

1. Escrevendo código proxy
   Crie um arquivo no projeto (por exemplo worker.ts), digite o seguinte código:

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

Esse agente simplesmente responderá ao que o usuário digitar.
2. Implementação na Cloudflare
É executado no terminal:

npx wrangler@latest deploy

Siga as instruções para fazer login na sua conta da Cloudflare, e um URL on-line será retornado quando a implantação for concluída.
3. função de teste
Visite o URL implantado com um navegador ou envie uma mensagem com uma ferramenta como o Postman para verificar se a resposta está funcionando.

Comunicação em tempo real usando WebSocket

1. Configuração do suporte a WebSocket
   Modifique o código do agente para incluir a comunicação em tempo real:

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

2. corretor de conexão front-end
   Adicione-o no código de front-end:

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

   Isso cria um canal de comunicação em tempo real, em que as mensagens são enviadas e as respostas são recebidas imediatamente.

3. teste operacional
   Após a implantação, execute o código de front-end usando o console da ferramenta de desenvolvimento do navegador para ver como funciona a interação da mensagem.

Status do agente de gerenciamento

1. Salvar e atualizar o status
   Adicionar gerenciamento de estado ao agente:

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

2. Persistência do estado de validação
   Visite o URL do proxy várias vezes após a implantação e observe se a contagem continua a aumentar, provando que o estado foi preservado.
3. cenário do aplicativo
   O gerenciamento de status é adequado para cenários em que o histórico precisa ser registrado, como o número de interações do usuário ou o progresso da tarefa.

Detalhes do processo de operação

• depuração local: Executar npm run dev Ative o modo de desenvolvimento e atualize automaticamente o código após a modificação para facilitar os testes.
• A implantação entra em operaçãoUso de npx wrangler@latest deploy Publicar agentes na rede global da Cloudflare.
• Acesso a documentos: Acesso documento oficial Obtenha mais exemplos de código e detalhes da API.
• Envolvimento da comunidadeSe você tiver sugestões de melhorias, poderá enviar problemas ou códigos no GitHub e participar do desenvolvimento do projeto.

advertência

• variável de ambienteSe você precisar chamar um modelo de IA externo (por exemplo, OpenAI), faça isso na seção wrangler.toml para configurar a chave da API.
• requisito de redeA implantação requer uma conexão de rede estável para garantir que não haja interrupções ao fazer login na Cloudflare.
• Recursos de aprendizadoFornecido oficialmente Playground Exemplo (localizado no repositório GitHub do examples/playground), você pode executar a referência diretamente.

Com as etapas acima, você pode criar facilmente um agente de IA. A vantagem dos agentes da Cloudflare é sua implantação globalmente distribuída e seus recursos de persistência de estado, que são adequados para cenários de aplicativos que exigem baixa latência e alta disponibilidade.