Cloudflare 에이전트: 엣지 네트워크에서 실시간 대화형 인텔리전스 구축

일반 소개

Cloudflare 에이전트는 개발자가 글로벌 에지 네트워크에서 지능형 AI 에이전트를 구축할 수 있도록 설계된 Cloudflare의 오픈 소스 개발 프레임워크입니다. 에이전트가 상태를 유지하고, 실시간으로 통신하며, 자율적으로 실행할 수 있는 기능을 제공하며, 현재 활발하게 개발 중인 프로젝트입니다. 핵심 기능으로는 상태 관리와 WebSocket 실시간 상호 작용이 있으며, 이미 챗봇이나 자동화된 작업 도구를 만드는 데 사용할 수 있습니다.Cloudflare 에이전트는 에이전트가 절전 및 깨우기 메커니즘을 지원하여 전 세계적으로 실행될 수 있는 분산형 지능형 에이전트 시스템을 구축하는 것을 목표로 합니다. 개발자는 간단한 설치 단계를 통해 이 오픈 소스 프로젝트에 참여하여 AI 기술 발전을 위해 함께 작업할 수 있습니다.

기능 목록

• 핵심 에이전트 프레임워크상담원이 과거 상호작용 데이터를 기억할 수 있는 상태 관리 기능을 제공합니다.
• 실시간 커뮤니케이션웹소켓을 통해 상담원과 클라이언트 간의 즉각적인 대화를 지원합니다.
• HTTP 라우팅웹 요청을 처리하고 외부 서비스와의 연동을 용이하게 합니다.
• React 통합프론트엔드 개발자를 위한 내장형 React 후크.
• 기본 AI 채팅간단한 지능형 대화 시스템 구축 지원.
• 개발 중인 기능고급 메모리 시스템, WebRTC 오디오 및 비디오 지원, 이메일 기능이 포함되어 있습니다.

도움말 사용

Cloudflare 에이전트는 개발자 중심 도구로, 사용하기 전에 기본적인 프로그래밍 지식이 필요합니다. 다음은 빠르게 시작하고 기능을 최대한 활용하는 데 도움이 되는 자세한 설치 및 운영 가이드입니다.

설치 프로세스

Cloudflare 에이전트는 npm을 통해 설치되며 새 프로젝트를 지원하거나 기존 프로젝트에 추가할 수 있습니다. 단계는 다음과 같습니다.

신규 건설 프로젝트

1. 환경 확인
   컴퓨터에 Node.js(권장 버전 16 이상)와 npm이 설치되어 있는지 확인합니다. 터미널을 열고 다음을 입력합니다. node -v 노래로 응답 npm -v 버전 번호를 확인합니다.
2. 프로젝트 만들기
   터미널에서 다음 명령을 실행합니다:

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

프로젝트 이름을 입력하고 디렉터리를 선택하라는 메시지가 표시되며, 완료되면 기본 프로젝트가 생성됩니다.
3. 프로젝트 디렉토리로 이동
가져오기 cd 你的项目名称 새로 만든 프로젝트 폴더로 이동합니다.
4. 지역 개발 시작
실행 중입니다:

npm run dev

그러면 로컬 서버가 시작되고 브라우저를 통해 로컬 주소에 액세스할 수 있습니다(일반적으로 http://localhost:8787)를 클릭하여 효과를 확인합니다.

기존 프로젝트에 추가

1. 프로젝트 디렉토리로 이동
   최종 용도 cd 명령을 사용하여 기존 프로젝트 폴더로 전환합니다.
2. SDK 설치하기
   입력:

npm install agents-sdk

이렇게 하면 Cloudflare 에이전트 코어 라이브러리가 프로젝트에 추가됩니다.
3. 구성 코드
코드에 도입 agents-sdk를 클릭하고 구체적인 사용법은 공식 문서를 참조하세요.

주요 기능

간단한 AI 채팅 상담원 만들기

1. 프록시 코드 작성
   프로젝트에 파일을 만듭니다(예 worker.ts)를 클릭한 후 다음 코드를 입력합니다:

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

이 에이전트는 사용자가 입력한 내용에 간단히 응답합니다.
2. Cloudflare에 배포
터미널에서 실행됩니다:

npx wrangler@latest deploy

메시지에 따라 Cloudflare 계정에 로그인하면 배포가 완료되면 온라인 URL이 반환됩니다.
3. 테스트 기능
브라우저로 배포된 URL을 방문하거나 Postman과 같은 도구를 사용하여 메시지를 보내 응답이 작동하는지 확인합니다.

WebSocket을 사용한 실시간 커뮤니케이션

1. 웹소켓 지원 구성
   실시간 커뮤니케이션을 포함하도록 상담원 코드를 수정합니다:

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

2. 프런트엔드 연결 브로커
   프런트엔드 코드에 추가하세요:

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

   이렇게 하면 메시지를 보내고 즉시 답장을 받을 수 있는 실시간 커뮤니케이션 채널이 만들어집니다.

3. 운영 테스트
   배포 후 브라우저 개발자 도구의 콘솔을 사용하여 프런트엔드 코드를 실행하여 메시지 상호 작용이 어떻게 작동하는지 확인합니다.

상담원 상태 관리

1. 상태 저장 및 업데이트
   상담원에게 상태 관리 기능을 추가합니다:

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

2. 유효성 검사 상태 지속성
   배포 후 프록시 URL을 여러 번 방문하여 카운트가 계속 증가하여 상태가 유지되는지 관찰합니다.
3. 애플리케이션 시나리오
   상태 관리는 사용자 상호작용 횟수나 작업 진행 상황 등 기록을 기록해야 하는 시나리오에 적합합니다.

운영 프로세스 세부 정보

• 로컬 디버깅: 실행 npm run dev 개발 모드를 활성화하고 수정 후 코드를 자동으로 업데이트하여 쉽게 테스트할 수 있습니다.
• 배포 시작사용 npx wrangler@latest deploy Cloudflare 글로벌 네트워크에 에이전트를 게시합니다.
• 문서에 액세스액세스 공식 문서 더 많은 코드 샘플과 API 세부 정보를 확인하세요.
• 커뮤니티 참여개선에 대한 제안이 있는 경우 GitHub에 이슈나 코드를 제출하고 프로젝트 개발에 참여할 수 있습니다.

주의

• 환경 변수외부 AI 모델(예: OpenAI)을 호출해야 하는 경우에는 wrangler.toml 파일을 사용하여 API 키를 구성합니다.
• 네트워크 요구 사항배포하려면 Cloudflare에 로그인할 때 중단이 발생하지 않도록 안정적인 네트워크 연결이 필요합니다.
• 학습 리소스공식 제공 놀이터 예제(GitHub 리포지토리에 있는 examples/playground), 참조를 직접 실행할 수 있습니다.

위의 단계를 통해 AI 에이전트를 쉽게 구축할 수 있습니다. Cloudflare 에이전트의 장점은 전 세계적으로 분산된 배포 및 상태 지속성 기능으로, 짧은 지연 시간과 고가용성이 필요한 애플리케이션 시나리오에 적합합니다.