> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ARIA

> W&B の AI リサーチエージェントを使って、実験の分析と実行、結果の解説、report の作成を行えます。

export const AriaChatBubbles = ({prompt, response}) => {
  const [isDark, setIsDark] = useState(false);
  const [promptCopied, setPromptCopied] = useState(false);
  useEffect(() => {
    const root = document.documentElement;
    const sync = () => setIsDark(root.classList.contains('dark'));
    sync();
    const obs = new MutationObserver(sync);
    obs.observe(root, {
      attributes: true,
      attributeFilter: ['class']
    });
    return () => obs.disconnect();
  }, []);
  useEffect(() => {
    if (!promptCopied) {
      return undefined;
    }
    const timeout = setTimeout(() => setPromptCopied(false), 2000);
    return () => clearTimeout(timeout);
  }, [promptCopied]);
  const copyText = text => {
    navigator.clipboard.writeText(text).then(() => setPromptCopied(true)).catch(console.error);
  };
  const userBg = isDark ? '#363C44' : '#F8F8F8';
  const userBorder = isDark ? '#4B535C' : '#DFE0E2';
  const textColor = isDark ? '#E8E8E9' : '#2B3038';
  const iconColor = isDark ? '#8F949E' : '#79808A';
  const iconHoverBg = isDark ? 'rgba(255,255,255,0.10)' : 'rgba(0,0,0,0.05)';
  const bubbleText = {
    fontSize: '15px',
    color: textColor,
    overflowWrap: 'anywhere'
  };
  const bubbleBase = {
    maxWidth: '85%'
  };
  const copyIcon = promptCopied ? <svg aria-hidden="true" focusable="false" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{
    color: '#FCBC32'
  }}>
      <path d="M20 6 9 17l-5-5" />
    </svg> : <svg aria-hidden="true" focusable="false" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
      <rect width="14" height="14" x="8" y="8" rx="2" ry="2" />
      <path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" />
    </svg>;
  return <div aria-label="ARIA chat example" className="not-prose flex flex-col gap-3" role="group">
      {}
      <div className="flex w-full justify-end">
        <div className="flex w-fit items-start gap-1 rounded-2xl py-2 pl-3 pr-1.5" style={{
    ...bubbleBase,
    backgroundColor: userBg,
    border: `1px solid ${userBorder}`
  }}>
          <div className="min-w-0 flex-1 hyphens-auto whitespace-pre-wrap" style={bubbleText}>
            {prompt}
          </div>
          <button type="button" className="mt-0.5 shrink-0 rounded-lg p-1.5 cursor-pointer" style={{
    color: iconColor,
    background: 'transparent'
  }} onMouseEnter={e => {
    e.currentTarget.style.backgroundColor = iconHoverBg;
  }} onMouseLeave={e => {
    e.currentTarget.style.backgroundColor = 'transparent';
  }} onClick={() => copyText(prompt)} aria-label="Copy user prompt">
            {copyIcon}
          </button>
        </div>
      </div>
      {}
      <div className="flex w-full justify-start">
        <div className="w-fit rounded-2xl py-2 px-3" style={{
    ...bubbleBase,
    border: '1px solid #CDF4F7'
  }}>
          <div className="hyphens-auto whitespace-pre-wrap" style={bubbleText}>
            {response}
          </div>
        </div>
      </div>
    </div>;
};

ARIA (W\&B の AI Research and Iteration Agent) は、W\&B で実験の分析と実行、結果の説明、run 間のパターンの特定、次のステップの提案、可視化や report の作成などを支援する、あなた専用のリサーチアシスタントです。

<Note>
  [W\&B Multi-tenant Cloud](/ja/products/wandb/platform/hosting#wb-multi-tenant-cloud) でのみ利用できます。

  ARIA はチームの project で動作し、個人の entity では使用できません。また、組織管理者が **Smart features** を有効にしておく必要があります。詳しくは [ガバナンスとセキュリティ](/ja/products/aria/governance) を参照してください。
</Note>

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/agent_empty_chat_window.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=42cbbdfb80efff27b38700c29a1a9260" alt="空の ARIA チャットウィンドウ" width="1152" height="968" data-path="products/aria/_media/agent_empty_chat_window.png" />
</Frame>

ARIA を使うと、次のことができます。

* 実験を分析して、パターンやインサイトを見つける。
* [実験や sweep を実行して、新しいアイデアを検証する](/ja/products/aria/autoresearch)。
* 試すべきハイパーパラメーターの推奨など、次のステップを提案する。
* プロットやパネルを作成して、データを可視化する。
* 保存済みビューや report を作成して、インサイトをチームと共有する。
* 失敗した run の診断や新しいモデルバージョンのレビューなど、[W\&B のイベントに自動で対応する](/ja/products/wandb/automations/create-automations/aria)。

<h2 id="quick-start">
  クイックスタート
</h2>

[ARIA とチャット](/ja/products/aria/chat)するには、次の手順を実行します。

1. 任意の project で、ページ右上の **Ask ARIA** をクリックします。
2. チャットウィンドウに質問やリクエストを入力します。何を尋ねればよいかわからない場合は、候補として表示されるプロンプトを選択します。
3. チャットウィンドウ右下にある上向き矢印の **Send** ボタンをクリックします。

<h2 id="start-aria-from-where-you-work">
  作業中の画面から ARIA を開始する
</h2>

ページ上部の **Ask ARIA** のほかに、W\&B の各所にあるボタンからも ARIA を開始できます。これらのボタンの多くは、メッセージボックスにヒントが表示された状態で新しいチャットを開きます。目的を入力してからメッセージを送信してください。

| 場所 | ボタン | ARIA が支援する内容 |
| - | - | - |
| クラッシュまたは失敗した run のページ | **Debug with ARIA** | run がクラッシュまたは失敗した理由を説明します。このボタンを押すと新しいチャットが開始され、すぐに ARIA に質問が送信されます。 |
| Workspace の **Runs** 表のツールバー | **Show most useful columns with ARIA** | **Runs** 表の列の表示、非表示、固定、並べ替え、サイズ変更を行います。 |
| **Runs** 表の **Manage columns** ダイアログ | **Manage columns with ARIA** | **Runs** 表の列の表示、非表示、固定、並べ替え、サイズ変更を行います。 |
| **Runs** 表の **Filter** メニュー | **Describe the filters you want ARIA to create** テキストフィールド | **Runs** 表をフィルターします。目的の run の説明を入力して **Enter** を押すと、ARIA が **Run Filter** を提案します。チャット内でそれをクリックすると、Workspace に適用されます。 |
| 保存済みビューのメニュー | **Ask ARIA** | Workspace の保存済みビューを作成します。 |
| project の **Reports** タブ | **Draft report with ARIA** | 新しい report を作成します。 |
| 自分が所有する report | **Edit with ARIA** | report を修正します。ARIA は変更内容を既存の report に保存します。 |

特定の run、Workspace パネル、または W\&B Weave のトレースや評価に関するコンテキストを ARIA に提供する方法については、[会話にコンテキストを追加する](/ja/products/aria/chat#add-context-to-a-conversation)を参照してください。

<h2 id="follow-arias-progress">
  ARIA の進行状況を確認する
</h2>

ARIA は作業中に応答をストリーミングするため、回答が完成するのを待たずに、進行状況をステップごとに確認できます。質問の複雑さによっては、ARIA の処理が完了するまでにしばらく時間がかかる場合があります。ARIA の作業中にチャットウィンドウを閉じて後から応答を確認することも、完了を待たずに[次のメッセージをキューに追加する](/ja/products/aria/chat#queue-messages)こともできます。追加の情報が必要な場合は、ARIA から確認の質問が送られます。

作業の流れを見失わないように、ARIA は折れ線グラフや棒グラフをチャット内で直接レンダリングします。これらのグラフは全画面表示にも対応しています。Workspace の **Runs** タブで run にカーソルを合わせると、ARIA 内の該当する run のプロットがハイライトされます。逆に、ARIA 内のパネルにカーソルを合わせると、**Runs** タブ内の該当する run がハイライトされます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/aria-line-plot-interactions.gif?s=3b08dcff63f7d8f01db62b5ed67aab9f" alt="ARIA の折れ線グラフの操作を示すアニメーション" width="1728" height="906" data-path="products/aria/_media/aria-line-plot-interactions.gif" />
</Frame>

ARIA の作業中には、**Thinking** ステップと **shell** ステップが表示されることがあります。

* **Thinking** ステップには、ARIA が質問にどのように取り組んでいるかの概要が表示されます。
* **shell** ステップには、パネルの作成、run のフィルタリング、Python スクリプトの作成と実行など、ARIA が action を実行したことが表示されます。

**Thinking** または **shell** ステップをクリックすると、ARIA の推論や実行した action の詳細を展開して確認できます。

実際の使用例については、[チャット例](/ja/products/aria#example-chats)を参照してください。チャットの管理について詳しくは、[Chat with ARIA](/ja/products/aria/chat) を参照してください。

<h2 id="view-and-manage-project-memories">
  project のメモリの表示と管理
</h2>

ARIA は学習した内容を記憶します。作業を進めるうちに、ARIA は project 単位の *メモリ* を書き込みます。そのため、新しいセッションのたびにセットアップ、結論、好みをゼロから把握し直す必要がありません。たとえば、チームが対数スケールのチャートを好むことを一度伝えれば、ARIA はそれを覚えています。

各メモリには、ARIA がいつ呼び出すべきかを判断するための名前と説明、そしてメモリのテキスト本体が含まれます。

project を所有するチームのメンバーであれば誰でも、メモリを表示、編集、削除できます。

1. ARIA のチャットウィンドウで **<Icon icon="sidebar-reveal" iconType="solid" />** (**Reveal chat history**) をクリックして、チャット履歴のサイドバーを開きます。
2. **Customize** セクションで **Project memory** をクリックします。ARIA がその project について保持しているメモリが一覧表示されます。
3. メモリを編集するには、**<Icon icon="pencil" iconType="solid" />** をクリックします。メモリの **Name**、**Description**、または **Memory** を更新し、**Save** をクリックします。
4. メモリを削除するには、**<Icon icon="trash" iconType="solid" />** をクリックします。

ARIA が新しいメモリを学習するのを待たずに、project のメモリをインタラクティブに作成することもできます。例:

<AriaChatBubbles prompt="チャートにはセマンティックな色分けを使うようにしていることを覚えておいてください。" response="この設定が重複せず適切なトピックに記録されるよう、まず既存の project のメモリを確認します ... 新しい project のメモリを保存しました: chart-coloring。チャートの色は、パレットの任意の順序ではなく、時系列やカテゴリの意味、またはステータスに基づいて、一貫性のあるセマンティックな色を使用するという内容を記録しました。 " />

<h2 id="example-chats">
  チャット例
</h2>

以下は、ARIA との実際のチャット例です。ARIA とどのようにやり取りできるか、またどのような応答が返ってくるかを示しています。

<Accordion title="ARIA の推奨に基づいて実験を実行する">
  一連の実験を終えたばかりの ML エンジニアを想定します。モデルのパフォーマンスを向上させるために、次に何をすべきかを知りたいと考えています。

  そこで、run をログした project にアクセスし、ARIA を開いて次のように質問します。

  ```text title="ユーザー プロンプト" theme={"system"}
  /recommend-next-experiment
  ```

  以下は、この質問に対する ARIA の応答例です。ARIA はまず推論ステップを実行し、質問にどうアプローチするかを判断します。簡潔にするため、以下では ARIA の推論の一部のみを示します。

  ```text title="ARIA の推論ステップ" theme={"system"}
  Recommendation: run one “longer-training + held-out-eval” experiment
  before changing model architecture or sweeping LR.

  Use the current best setup, but train longer:

  hyperparameter_config = {
      "learning_rate": 0.1,          # 固定のまま
      "epochs": 2000,                # 以前は 1000
      "model_type": "Multivariate_neural_network_classifier",
      "torch_seed": 0,               # 再現性のために追加
  }
  Also add logging for the existing held-out split every epoch or
  every 10–50 epochs:

  train/train_loss
  train/train_acc
  test/test_loss
  test/test_acc

  and save the best checkpoint by test/test_loss, not only
  by training loss.

  Why this is the most promising next experiment
  The project has 16 finished runs, but only 4 are actual training runs;
  all four used the same training config:

  learning_rate = 0.1
  epochs = 1000
  same model: Multivariate_neural_network_classifier

  So there is no real hyperparameter comparison yet. The
  strongest signal is from the learning curves: all four
  training losses are still improving at the final epoch, and
  the minimum training loss occurs at epoch 1000 in every run.

  I’d run:

  learning_rate: 0.1
  epochs: 2000
  model_type: unchanged
  random_state: keep existing dataset split, 42
  add torch.manual_seed(0) and log it as torch_seed
  evaluate on X_test, y_test each epoch or every 10 epochs
  checkpoint on lowest test/test_loss
  ```

  ARIA の推奨に納得したので、ARIA に実験の実行を依頼します。

  ```text title="ユーザー プロンプト" theme={"system"}
  Run that experiment for me.
  ```

  ARIA は W\&B Launch を使用して、サンドボックス環境で実験を実行します。次の画像は、実験の実行が完了した後の ARIA の応答を示しています。

  <Frame>
    <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/aria_experiment.gif?s=efb0641e6d5f23b3816b3114e50a4658" alt="実験を実行している ARIA" width="2772" height="1770" data-path="products/aria/_media/aria_experiment.gif" />
  </Frame>

  ARIA は W\&B Launch を使用して、サンドボックス環境で実験を実行します。詳細については、[ARIA による実験の実行を有効にする](/ja/products/aria/autoresearch)を参照してください。
</Accordion>

<Accordion title="実験に関するインサイトを得る">
  新しいモデルの一連の run を完了したばかりの ML エンジニアを想定します。モデルのパフォーマンスを把握し、潜在的な問題を特定したうえで、次のステップを決めたいと考えています。

  そこで、run をログした project にアクセスします。ARIA を開き、次のように質問します。

  ```text title="ユーザー プロンプト" theme={"system"}
  What patterns do you see across my runs?
  ```

  以下は、この質問に対する ARIA の応答例です。まず、ARIA は推論ステップを実行して、質問にどうアプローチするかを判断します。

  ```text title="ARIA の推論ステップ" theme={"system"}
  I’m considering running a state breakdown scan with counts by state using
  specific server filters. I’ll look at the array of states: ['finished',
  'running', 'crashed', 'failed', 'killed', 'pending', 'preempting'] and
  determine the length of each. Summing these metrics could provide
  useful insights. I should also focus on identifying objective metrics
  from sample keys while excluding those that start with "_" or "system/".
  It’s important to compute the best min/max for numeric summary metrics too.
  ```

  ARIA は、質問に答えるには複数の run にわたるデータを分析する必要があると判断します。そこで、サンドボックス環境でスクリプトを実行し、W\&B Python SDK を使用して過去にログされた run をクエリし、データ内のパターンを特定します。各ステップは実行されるたびにチャットに表示され、ステップを展開すると詳細を確認できます。

  <Frame>
    <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/agent_analyze_project.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=b17fcef3080c1721c9ff778f9c9d7107" alt="ARIA の思考プロセス" width="1152" height="968" data-path="products/aria/_media/agent_analyze_project.png" />
  </Frame>

  次に、ARIA はその出力をもとに、run 全体で見つかったパターンの概要を生成し、チャットで共有します。

  <Frame>
    <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/agent_analyze_summary_results.gif?s=ba700bea295669047612fe1e779af794" alt="run 全体のパターンに関する ARIA の概要" width="2774" height="1986" data-path="products/aria/_media/agent_analyze_summary_results.gif" />
  </Frame>

  この例では、ARIA は現在の実験で `validation/test` メトリクスがログされていないことを特定し、モデルのパフォーマンスをより深く把握するために、今後の run ではこれらのメトリクスをログするよう推奨しました。

  次のステップとして、検証メトリクスをログする実験の設定を ARIA に手伝ってもらうことができます。たとえば、次のように質問します。

  ```text title="ユーザー プロンプト" theme={"system"}
  Can you help me update my Python script to also log validation metrics?
  ```

  すると ARIA は、トレーニングスクリプトで検証メトリクスをログするためのコードを生成します。生成されたコードは、そのままコードベースにコピー＆ペーストできます。
</Accordion>

<Accordion title="ハイパーパラメーター調整の推奨事項を得る">
  新しいモデルの一連の run を完了したばかりの ML エンジニアを想定します。モデルのパフォーマンスを把握し、今後の run でパフォーマンスを改善する方法について推奨事項を得たいと考えています。そこで、ハイパーパラメーター調整について ARIA に相談することにします。

  たとえば、次のように ARIA に質問します。

  ```text title="ユーザー プロンプト" theme={"system"}
  I want to conduct a sweep to improve lower my training model's loss. Do you have suggestions on what hyperparameters I should try?
  ```

  ARIA は、たとえば次のような推論ステップで応答します。

  ```text title="ARIA の推論ステップ" theme={"system"}
   The user is looking for insights to improve training loss, so I
   should suggest ranges for learning rate, optimizer, batch size,
   weight decay, and other relevant parameters.

  Since the user wants to conduct a sweep, I need to show the code or
  instrumentation with a clear yet concise YAML or Python configuration.
  I might also suggest using random or Bayesian techniques for more
  effective hyperparameter selection.
  ```

  ARIA は、ハイパーパラメーター調整の推奨事項を示すには、過去の run で使用されたハイパーパラメーターとトレーニング損失の関係を分析する必要があると判断します。

  分析の結果、ARIA はこの project のすべての run で学習率 `0.01` が使用されていることを特定します。これを踏まえ、パフォーマンスが改善するかを確認するため、今後の run では `0.001` などのより低い学習率を試すよう推奨します。

  また、すべての run で SGD オプティマイザーが使用されていることも特定します。これを踏まえ、パフォーマンスが改善するかを確認するため、今後の run では Adam (Adaptive Moment Estimation) などの別のオプティマイザーを試すよう推奨します。

  次の画像は、ハイパーパラメーター調整の推奨事項を含む ARIA の応答の一部です。

  <Frame>
    <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/agent_recommend_hyperparameter.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=5c9bfe1262326e91484e95bacba5159a" alt="ハイパーパラメーター調整に関する ARIA の推奨事項" width="2636" height="1844" data-path="products/aria/_media/agent_recommend_hyperparameter.png" />
  </Frame>
</Accordion>

<Accordion title="チームと共有する report を作成する">
  あなたはデータサイエンティストで、project の run を分析した結果、データに興味深いパターンを見つけたとします。この知見を、わかりやすい形式でチームと共有したいと考えています。そこで、ARIA に [W\&B Report](/ja/products/wandb/reports) の作成を手伝ってもらうことにしました。

  ARIA を開き、次のように依頼します。

  ```text title="ユーザー プロンプト" theme={"system"}
  Create a report to share my findings with my team.
  ```

  ARIA は、たとえば次のような推論ステップを示します。

  ```text title="ARIA の推論ステップ" theme={"system"}
  I’m looking to query the recent 50 runs, summarizing key frequencies 
  and counts by using api.runs to slice them down. I'll be counting
  lengths with lazy evaluation and weaving together the stats
  for a proper report.  I need to include a description that might
  require importing different report libraries.
  ```

  ARIA は、データから得られた知見をまとめた W\&B Report を作成する必要があると判断します。推論プロセスの一環として、W\&B SDK を使用して関連データと知見を盛り込んだ report を作成する Python スクリプトを生成します。ARIA がこのスクリプトをサンドボックス環境で実行すると、project 内に W\&B Report が作成されます。

  次の画像は、ARIA がサンドボックス環境で W\&B Report を作成し、チャットで report へのリンクを返す様子を示しています。

  <Frame>
    <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/aria/_media/agent_create_report.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=41f2b7ec4c157d0782660106cdbdf25d" alt="ARIA が report を作成する" width="2636" height="1626" data-path="products/aria/_media/agent_create_report.png" />
  </Frame>

  <Info>
    内部的には、ARIA は Workspaces and Reports API を使用して W\&B Report を作成しています。
  </Info>
</Accordion>


## Related topics

- [ARIA](/ja/redirects/forge/aria.md)
