본문으로 건너뛰기
모든 기능

제공

Webhook과 이벤트

백엔드에서 수명 주기 변경과 운영 이벤트에 대응합니다.

자체 백엔드
Server SDK · BeeOSClient
BeeOS Cloud
에이전트 런타임
harness-sdk.ts
import {
  RuntimeRegistrationCoordinator,
  type RuntimeRegistrationConfig,
  type RuntimeRegistrationTransport,
} from "@beeos-ai/cloud-harness-sdk";

async function startRuntime(
  transport: RuntimeRegistrationTransport,
  config: RuntimeRegistrationConfig,
  onLeaseLost: (reason: "fenced" | "expired" | "heartbeat_failed", cause?: unknown) => void,
) {
  const runtime = new RuntimeRegistrationCoordinator(transport, config, onLeaseLost);
  await runtime.start();
  return runtime;
}
백엔드에서 인가App 범위 서버 자격 증명을 발급하고 요청 전에 자체 사용자 권한을 검증합니다.
런타임 연결런타임을 등록하고 지원 메서드를 선언한 뒤 응답을 제품으로 전달합니다.
이벤트 수신수명 주기와 운영 Webhook을 구독하고 자체 저장소의 상태를 갱신합니다.

최종 사용자 신원과 ACL은 백엔드가 관리합니다. 프런트엔드는 백엔드를 통해 인가된 데이터를 받아 렌더링하며, 별도의 App 클라이언트 SDK는 없습니다.

문서
  1. 01

    백엔드 엔드포인트 등록

  2. 02

    관련 수명 주기 이벤트 구독

  3. 03

    제품에서 이벤트 처리

활용 사례

에이전트 작업이나 인스턴스 상태 변경 이벤트를 받고 제품을 갱신합니다.

  • 수명 주기 이벤트 전달
  • 백엔드 기반 반응
  • 이벤트 연계 운영 워크플로

통합 시작

통합 시작

통합 가이드를 읽고 런타임과 백엔드를 연결하세요.

문서