本文へ移動
すべての機能

提供

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

    製品でイベントを処理

活用例

タスクやインスタンスの状態変更を受け取り、製品を更新します。

  • ライフサイクルイベントの配信
  • バックエンド主導の処理
  • イベントに連動する運用

連携を始める

連携を始める

連携ガイドを読み、ランタイムとバックエンドを接続してください。

ドキュメント