エージェントモニタリングアプリケーションの作成¶

エージェントモニタリング > サマリー に移動します。
エージェント タブを選択します。
エージェントを接続 をクリックし、接続設定ページを開きます。

統合タイプ¶

エージェントモニタリングは、以下の統合タイプをサポートしています。

接続方法	統合タイプ
インストーラ接続	Codex、Claude Code、OpenClaw、Hermes、Qoder、WorkBuddy、OpenCode、CodeBuddy、Cursor、DeepSeek Harness
手動接続	AgentScope、Spring AI Alibaba

インストーラを使用した接続¶

Codex、Claude Code、OpenClaw、Hermes、Qoder、WorkBuddy、OpenCode、CodeBuddy、Cursor、DeepSeek Harness は obs-agent-connector インストーラを使用して接続します。コネクタのインストールは一度だけ必要です。

ステップ 1：統合タイプの選択¶

接続設定ページで、接続するエージェントタイプを選択します。

ステップ 2：ユーザーアイデンティティの設定¶

接続設定では、現在のワークスペースメンバーの個人情報を関連付けるかどうかを選択できます。

「ワークスペースの個人情報を関連付ける」がデフォルトでチェックされています。システムはメンバー名などの個人情報をアップロードし、メンバーの UUID を user_id、ユーザー名を user_name として使用します。
チェックを外すと、システムはランダムな ID を user_id として自動生成します。user_name は手動で入力する必要があります。
user_id はユーザーデータの集約、フィルタリング、ドリルダウンに使用されます。
user_name は表示と検索のみに使用され、ユーザーの一意の識別子としては使用されません。
同じコネクタで接続された複数のエージェントタイプは、同じ user_id を共有します。

匿名 user_id は、コネクタの再起動、アップグレード、またはプラグインの更新後も保持されます。アイデンティティ設定を完全にクリアするか、明示的にアイデンティティをリセットした場合にのみ、システムは新しい匿名 ID を生成します。

ステップ 3：コネクタのインストール¶

エージェントが動作しているホストのオペレーティングシステムに応じて、対応するコマンドを実行します。

macOS/LinuxWindows

curl -fsSL -O https://static.guance.com/obs-agent-connector/install.sh && \
sh install.sh \
  --download-base-url=https://static.guance.com/obs-agent-connector-test \
  --endpoint=<Endpoint> \
  --x-token=<X-Token>

PowerShell で以下を実行します。

$env:OBS_AGENT_CONNECTOR_OSS_ENDPOINT = "https://static.guance.com/obs-agent-connector"
Invoke-WebRequest -Uri "$env:OBS_AGENT_CONNECTOR_OSS_ENDPOINT/install.ps1" -OutFile "install.ps1"
powershell -ExecutionPolicy bypass -File .\install.ps1

インストール完了後、現在のターミナルで obs-agent-connector コマンドが認識されない場合は、ターミナルを開き直してから後続の操作を実行してください。

ステップ 4：プラグインのインストール¶

以下のコマンドを実行すると、現在の環境内のエージェントが自動的に検出され、接続が完了します。

obs-agent-connector discover

プラグインの更新または削除¶

プラグインの更新：

obs-agent-connector update <プラグイン識別子>

プラグインの削除：

obs-agent-connector remove <プラグイン識別子>

その他のコマンド

サポートされているエージェント、よく使うコマンド、インストールパラメータ、および使用例については、obs-agent-connector コマンドリファレンスを参照してください。

AgentScope の手動接続¶

AgentScope は obs-agent-connector を使用せず、OpenTelemetry による手動接続が必要です。言語によって接続方法が異なりますが、ここでは Java を例に説明します。

ステップ 1：AgentScope の選択¶

接続設定ページで AgentScope を選択し、インスタンス名を入力します。インスタンス名は、中国語、英語、数字、アンダースコア、ハイフンを使用でき、同一エージェントタイプ内で一意である必要があります。

ステップ 2：OpenTelemetry の有効化¶

AgentScope 公式ドキュメントを参照し、AgentScope のコード内で TelemetryTracer を登録します。

import io.agentscope.core.tracing.TraceRegistry;
import io.agentscope.core.tracing.telemetry.TelemetryTracer;

TraceRegistry.register(
    TelemetryTracer.builder()
        .build()
);

ReActAgent agent = ReActAgent.builder()
    .name("Assistant")
    .model(model)
    .build();

ステップ 3：環境変数の設定¶

接続設定ページは、現在のインスタンスに基づいて Endpoint、X-Token、Agent ID、Agent Name を生成します。ページで生成された実際の値をコピーし、以下の環境変数を設定します。

export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_TRACES_EXPORTER=otlp
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="<Endpoint>/v1/write/otel-llm"
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="<Endpoint>/v1/write/otel-metrics"
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="<Endpoint>/v1/write/otel-logs"
export OTEL_RESOURCE_ATTRIBUTES="service.version=1.0.0,deployment.environment=production,agent_id=<Agent ID>,agent_name=<Agent Name>,agent_runtime=agentscope"
export OTEL_EXPORTER_OTLP_HEADERS="X-token=<X-Token>,to-headless=true"

ステップ 4：接続の確認¶

AgentScope アプリケーションを再起動し、テストリクエストを 1 回送信します。その後、エージェントモニタリングで Trace と Metrics データが生成されていることを確認します。データが表示されない場合は、Endpoint、X-Token、Agent ID、および OpenTelemetry の環境変数が正しく有効になっているかどうかを重点的に確認してください。