# 結果を読む

> 実行ページのタブ、スコア、最良の結果をエクスポートまたは提供する方法。

実行ページには、実行の進捗と結果が表示されます。このガイドでは、実行ページのタブ、スコア、最良のバージョンをエクスポートまたは提供する方法を説明します。

## 実行ページのタブ

実行ページには、その実行に該当するタブだけが表示されます。一部のタブは、パス、ステータス、経験レベルによって表示が変わります。

| タブ                 | 表示される条件                                                               | 内容                                                                     |
| -------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **概要**             | 常に                                                                         | 進捗、スコア、スコアの履歴                                               |
| **使用状況**         | Skynet が提供できるプログラムで成功した実行                                  | 最適化されたプログラムを実行するフォームと、連携コード                   |
| **成果物**           | 結果のあるプロンプト、コード、テキストの実行                                 | アーティファクトのバージョンと、最良のバージョン                         |
| **データ**           | 完了した DSPy プログラムの実行                                               | 学習・検証・テストのセットへのデータの分割と、テストセットの評価         |
| **コード**           | 実行に表示するコードがあるとき                                               | 実行コードとメトリクス                                                   |
| **報酬**             | メトリクスが報酬の構成要素を宣言している、プロンプト、コード、テキストの実行 | 報酬の構成要素とその重み                                                 |
| **成果物**           | 最適化されたプロンプトまたはファイルがある実行                               | 最適化された出力と **結果をエクスポート**                                |
| **ログ**             | ほとんどの実行                                                               | 実行ログ                                                                 |
| **使用量とコスト**   | サインインしているとき                                                       | 実行が支出した金額                                                       |
| **スケジュール実行** | 成功したプロンプト、コード、テキストの実行                                   | 最適化を再度実行するスケジュール                                         |
| **設定**             | 常に                                                                         | 実行の設定                                                               |

> [!NOTE]
> **ガイド付き** レベルでは、実行ページで **データ**、**コード**、**ログ**、**設定** のタブが非表示になります。これらのタブへの直接リンクからは、引き続き開くことができます。レベルは **設定 → アカウント** で変更します。

## スコア

Skynet は検証ケースでバージョンを選びます。最終スコアはテストケースで報告します。エンジンがテストケースを見ることはありません。[データセットと分割](/docs/ja/concepts/datasets) をお読みください。

**概要** タブには次の項目が表示されます。

- **改善**: 開始バージョンから最良のバージョンへの変化。
- **スコアの推移**: 実行を通じたスコア。
- **スコアの内訳**: 各メトリクスと、**ベースライン**、**最適化後**、**変化** の列。

実行がアクティブな間は、概要に **経過時間**、**残り時間**、**レート** も表示されます。

プロンプト、コード、テキストの実行では、メトリクスが名前付きスコアを報告する場合、概要に **名前付きスコア** も表示されます。

DSPy プログラムの実行では、**データ** タブに **テストセット評価** があります。各テストケースについて、ベースラインと最適化後のスコアが表示されます。

### 最良のバージョンが開始バージョンである場合

どの候補も開始バージョンを上回らないことがあります。その場合、Skynet は開始バージョンを返します。**成果物** タブには、リグレッションガードが適用されたことが表示されます。

実行が予算に達して停止した場合、実行ページには Skynet がどのバージョンを保存したかが表示されます。[実行](/docs/ja/concepts/runs) をお読みください。

## 最良のバージョンをエクスポートする

### プロンプト、コード、テキストの実行

**成果物** タブには、アーティファクトの **バージョン** が一覧表示されます。各バージョンについて、次のことができます。

- バージョンをコピーする。
- バージョンをファイルとしてダウンロードする。
- リポジトリの実行の場合は、バージョンをリポジトリ全体の zip としてダウンロードする。

バージョンを別のバージョンと比較できます。このタブには、バージョンの **スコアラーのフィードバック** も表示されます。

### DSPy プログラムの実行

**成果物** タブには **結果をエクスポート** パネルがあります。**ダウンロード** メニューを開きます。実行が持つ形式が表示されます。

| オプション             | 形式                                             |
| ---------------------- | ------------------------------------------------ |
| DSPy プログラム        | `.zip`。そのまま実行できる自己完結型のエクスポート |
| 最適化後プログラム     | `.pkl`                                           |
| プロンプト             | `.json`                                          |
| 最適化されたコード     | `.py`                                            |
| ログ                   | `.csv`                                           |

## 最良のバージョンを提供する

最適化された DSPy プログラムを、自分のコードから呼び出せます。**使用状況** タブには 2 つの部分があります。

- フォーム。入力フィールドを入力し、**実行** を選択すると予測が得られます。
- cURL、Python、JavaScript、Go、DSPy の **連携コード**。

プログラムは常に、最適化されたときのモデル設定で実行されます。すべての入力フィールドを指定する必要があります。余分なフィールドは Skynet が無視します。

プログラムを呼び出すには、**設定 → API** で API トークンを作成します。次に、リクエストを送信します。

```bash tab="cURL"
export APP_API_TOKEN=skyd_...
curl -X POST "$API_URL/serve/<optimization_id>" \
  -H "Authorization: Bearer $APP_API_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"question": "What is DSPy?"}}'
```

```python tab="Python"
import os
import uuid
import requests

response = requests.post(
    f"{os.environ['API_URL']}/serve/<optimization_id>",
    headers={
        "Authorization": f"Bearer {os.environ['APP_API_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"inputs": {"question": "What is DSPy?"}},
)
print(response.json()["outputs"])
```

`question` は、プログラムの入力フィールドに置き換えてください。**使用状況** タブの **連携コード** には、実際の URL とフィールド名が入力されています。

レスポンスには、`outputs`、`input_fields`、`output_fields`、`model_used` が含まれます。

> [!TIP]
> リクエスト本文には `max_cost_cents` も指定できます。この 1 回の呼び出しにかけられる最大コストをセント単位で設定します。これが必須の実行もあります。

部分的な出力を届いた順に受け取るには、同じリクエストを `/serve/<optimization_id>/stream` に送信します。レスポンスは Server-Sent Events のストリームです。

認証とその他のエンドポイントについては、[API](/docs/ja/api) をお読みください。

## 結果を共有する

実行を他の人と共有したり、公開の探索ギャラリーに掲載したりできます。[共有と公開](/docs/ja/guides/sharing) をお読みください。

---

Source: https://staging.skynetml.com/docs/ja/guides/results