일반 Worker는 요청에 응답할 수 있지만 많은 애플리케이션에는 상태를 기억하고 연결된 클라이언트를 조정하며 요청이 끝난 뒤에도 작업을 계속하는 고정된 신원이 필요합니다. Cloudflare Agents SDK는 Workers와 SQLite 기반 Durable Objects 위에 이 애플리케이션 모델을 제공합니다.
작은 합성 지원 시스템을 경계 하나씩 구축합니다. 이름이 있는 신원, 영구 상태, 동기화된 클라이언트를 명확히 볼 수 있도록 AI 모델 없이 시작합니다. 이후 실습에서 지속적인 대화, 예약 작업, 모델이 선택한 도구, 명시적인 승인, 읽기 전용 MCP 인터페이스, 실용적인 라우팅 진단을 추가합니다. 각 개념을 필요한 애플리케이션 요구와 함께 설명하므로 Agents SDK 경험은 필요하지 않습니다. 안내형 실습 8개와 독립 승인 복구 도전 과제 1개로 구성되며 각 역량을 안내형 실습에서 먼저 익힙니다.
배울 내용
- 이름이 있는 지원 Agent 만들기: 고정된 이름을 라우팅하고 지원 상태를 저장하며 Agent 인스턴스 간 격리를 확인합니다.
- 지원 대시보드 동기화하기: 브라우저 클라이언트 두 개를 연결하고 서버가 권한을 갖는 상태 갱신을 실시간으로 관찰합니다.
- 지속적인 대화 스트리밍하기: 범위가 제한된 답변을 스트리밍하고 재연결 후 영구 대화 기록을 복원합니다.
- 지원 후속 작업 예약하기: 영구 Agent 작업을 등록, 확인, 완료, 취소합니다.
- 검증된 지원 도구 추가하기: 스키마와 서버 측 범위 검사로 모델이 선택한 도구를 합성 레코드에 연결합니다.
- 레코드 변경에 승인 요구하기: 사람의 결정을 기다리며 부수 효과를 중단하고 반복 전달을 안전하게 처리합니다.
- 읽기 전용 MCP 도구 게시하기: 원격 MCP 전송을 통해 엄격히 검증된 합성 조회를 제공합니다.
- 잘못 라우팅된 Agent 세션 진단하기: 기록을 잃거나 격리를 약화하지 않고 선택한 Agent 이름을 복구합니다.
- 승인되지 않은 지원 갱신: 제공된 Agent에서 효과 실행 전 승인과 정확히 한 번의 동작을 독립적으로 복구합니다.
이 과정의 대상
Workers와 Durable Objects에 익숙하며 상태가 있는 도우미와 조정된 클라이언트를 구축하려는 개발자를 위한 과정입니다.
사전 요구 사항: Cloudflare Durable Objects for Beginners와 Connect LabEx to Your Cloudflare Account를 완료하세요. 작은 TypeScript Worker와 고정된 이름마다 Durable Object 하나를 사용하는 개념을 알아야 합니다. Agents SDK 자체는 처음부터 소개합니다.
학습 환경: 자신의 전용 Cloudflare 학습 계정을 사용하세요. 각 단원은 새 VM에서 시작하고 Wrangler를 별도로 승인하며 고유한 이름의 일회용 리소스를 생성한 뒤 삭제와 로그아웃으로 끝납니다. 실습은 범위가 제한된 Workers Free 리소스를 사용하며 모델을 사용하는 실습은 소수의 Cloudflare 호스팅 추론 호출만 수행합니다.
자주 묻는 질문
Agents SDK나 AI 경험이 필요한가요?
Agents SDK 사전 경험은 필요하지 않습니다. 첫 두 실습은 AI 모델 없이 이름이 있는 신원, 영구 상태, 동기화된 클라이언트를 먼저 이해하도록 합니다. 모델을 사용하는 실습에는 Workers AI 기초가 필요합니다.
모델이 레코드를 직접 변경할 수 있나요?
제안된 도구 호출은 스키마와 서버 측 범위 검사를 통과해야 합니다. 승인 실습은 사람의 결정을 기다리며 부수 효과를 중단하고 반복 전달을 안전하게 처리합니다. 도전 과제는 효과 실행 전에 승인을 확인합니다.
클라이언트가 재연결하면 어떻게 되나요?
선택한 Agent 신원, 영구 대화, 서버가 권한을 갖는 상태를 하나의 브라우저 연결과 구분합니다. 유효한 기록을 버리지 않고 잘못 라우팅된 세션도 복구합니다.
리소스는 어떻게 정리하나요?
승인된 상태에서 실습의 일회용 Workers와 객체 네임스페이스만 삭제하고 제거를 확인한 뒤 로그아웃하세요. 각 VM은 자신의 계정을 독립적으로 승인합니다.
