---
title: 初回観測を実行して結果を読む
description: サイトから設定候補を生成し、確定した初回観測の結果とセットアップ状態を確認する。
canonical_url: https://orchestor.io/docs/cli/workflows/onboarding
markdown_url: https://orchestor.io/docs/cli/workflows/onboarding.md
contentType: how-to
---

# 初回観測を実行して結果を読む

[サインイン](https://orchestor.io/docs/cli/quickstart.md)し、使用するワークスペースを選んでから進めます。別の対象なら[新しいワークスペースを作成](https://orchestor.io/docs/cli/workflows/new-workspace.md)します。以下の`WORKSPACE_ID`とサイトURLを実際の対象に置き換えます。JSONの編集には`jq`を使います。

ベータユーザーはブラウザーで認証したCLIの資格情報を使えます。APIキーで実行する場合は、対象ワークスペースの観測利用枠と`read_write`権限が必要です。

## 1. サイトから設定候補を生成する

```bash
orc observations create --workspace WORKSPACE_ID \
  --website https://example.com --region JP --language ja \
  --wait --timeout 10m --json
orc observations configurations get --workspace WORKSPACE_ID --json > configuration.json
```

設定生成が成功したら、ブランド、競合、トピック、プロンプト、観測地域・言語・モデルを確認します。この時点では候補を生成した状態です。初回観測は次の確定で始まります。

## 2. 確定する内容を用意する

取得結果には表示用の情報も含まれます。次の変換で確定APIが受け取る項目を取り出し、`confirmation.json`を編集します。以下は候補を維持し、未指定の選択状態を有効にする例です。

```bash
jq '.data | {
  monitoring_scope_id,
  brand: (.brand | {id, name, domain, description, industry, identity, products,
    audience: [.audience[] | {label, description, percentage, enabled: true}]}),
  competitors: [.competitors[] | {id, name, domain, selected: (if .selected == null then true else .selected end)}],
  topics: [.topics[] | {id, name, selected: (if .selected == null then true else .selected end)}],
  prompts: [.prompts[] | {id, topic_id, text, selected: (if .selected == null then true else .selected end)}],
  dimensions: (.dimensions | {engine, model_channel, region, language})
} + (if has("platform_selection") then {platform_selection} else {} end)' \
  configuration.json > confirmation.json
```

観測するプロンプトとモデルを確認してから確定します。確定は観測を開始する書き込み操作です。

```bash
orc observations configurations confirm --workspace WORKSPACE_ID \
  --stdin --json < confirmation.json > confirmation-result.json
INITIAL_BATCH_ID=$(jq -er '.data.initial_batch_id' confirmation-result.json)
```

`initial_batch_id`が返ったことを確認します。返らない場合は、確定結果と[セットアップ状態](https://orchestor.io/docs/cli/workspaces.md#orc-workspaces-setup-get)を確認し、観測が始まったとは扱いません。

## 3. 初回観測を待ち、結果を読む

```bash
orc runs batches get "$INITIAL_BATCH_ID" --workspace WORKSPACE_ID --wait --timeout 10m --json
orc runs batches get "$INITIAL_BATCH_ID" --workspace WORKSPACE_ID --json
orc runs batches results get "$INITIAL_BATCH_ID" --workspace WORKSPACE_ID --json
orc workspaces setup get --workspace WORKSPACE_ID --json
```

同じバッチの状態が`completed`になり、実際の回答・結果が取得できたことを確認します。空の結果、設定生成の成功、確定の受付だけを「初回観測完了」として扱いません。

WebのWelcomeも同じ設定生成・確定APIを使います。ただし、Welcome画面の終了を示す`completed_at`と、初回観測バッチの完了は別の状態です。CLI 0.5.0にはWelcome終了のコマンドがないため、Webで終了が残っている場合は[Welcome](https://orchestor.io/welcome)で進めます。

## 中断・失敗から再開する

| 停止した段階 | 確認と再開 |
| --- | --- |
| 認証・対象 | `orc auth status --json`と対象IDを確認。登録し直さない。 |
| 設定生成 | `orc observations get --workspace WORKSPACE_ID --json`で状態とエラーを読む。原因を解消後、同じURL・ワークスペースで`observations create`を再実行する。 |
| 利用枠 | `measurement_quota_exhausted`は担当者に対象IDとエラーを伝える。招待入力や再試行だけで解決したとは扱わない。 |
| 候補の確認 | 保存した`configuration.json`を確認し、確定へ進む。ワークスペースを作り直さない。 |
| 観測待機のタイムアウト | サーバーの処理は継続する。同じ`INITIAL_BATCH_ID`で状態確認と待機を再開する。 |

## 設定生成から初回観測までをまとめて実行する

`init --website`は公開済みネイティブ版v0.6.30で利用できます。CLI 0.5.0には未収録です。`orc init --help`に`--website`がある版でのみ、以下を使います。0.5.0では上記の段階別コマンドを使ってください。

```bash
orc init --workspace WORKSPACE_ID --website https://example.com \
  --region JP --language ja --timeout 10m --json
```

生成候補をまとめて確定し、初回バッチを待ちます。編集してから確定する場合は`--no-confirm`を付け、生成後に手順2へ進みます。`init`は新規登録やワークスペース作成を行いません。

[新しいワークスペース](https://orchestor.io/docs/cli/workflows/new-workspace.md) · [initリファレンス](https://orchestor.io/docs/cli/init.md) · [セットアップの失敗箇所](https://orchestor.io/docs/cli/workflows/setup-troubleshooting.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)