> ## 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 でオートメーションを使用する

> 特定のイベントが発生したときに、テンプレート化したプロンプトを ARIA に送信して新しい会話を開始する W&B オートメーションを作成します。

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>;
};

W\&B のオートメーションを使用すると、特定のイベントが発生したときに ARIA にプロンプトを送信できます。イベントが発生するたびに、オートメーションは新しい ARIA 会話を開始し、設定済みのプロンプトを送信します。

ARIA にプロンプトを送信するオートメーションは、主に次の 2 つの要素で構成されます。

* オートメーションをトリガーする[イベント](/ja/products/wandb/automations/automation-events)
* イベント発生時に ARIA が受け取るプロンプト

このワークフローを使用すると、実験結果の分析、run の要約やレポート作成、しきい値を超えたメトリクスの調査などを行えます。

ARIA へのプロンプト送信は、W\&B のオートメーションが実行できる action の 1 つです。他の送信先に通知を送るオートメーションを作成するには、[Create a Slack automation](/ja/products/wandb/automations/create-automations/slack) または [Create a webhook automation](/ja/products/wandb/automations/create-automations/webhook) を参照してください。

W\&B のオートメーションの作成や管理を ARIA に任せることもできます。詳しくは、[ARIA でオートメーションを作成・管理する](#create-and-manage-automations-with-aria)を参照してください。

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

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

<h2 id="requirements">
  要件
</h2>

ARIA にプロンプトを送信するオートメーションを作成する前に、以下を確認してください。

* 組織で ARIA が有効になっている必要があります。**Action type** リストに **Trigger ARIA** が表示されない場合、その組織、スコープ、またはデプロイメントでは ARIA を利用できません。この場合、オプションは説明なしでリストに表示されません。詳しくは [ガバナンスとセキュリティ](/ja/products/aria/governance) を参照してください。
* オートメーションのスコープとなる project、registry、またはコレクションへの書き込みアクセス権が必要です。
* W\&B オートメーションのスコープを registry に設定して ARIA にプロンプトを送信するには、同じ組織内のチームに所属している必要があります。各 ARIA 会話はチームに関連付けられるため、その組織内のどのチームにも所属していない場合は、registry をスコープとするオートメーションを作成できません。

ARIA オートメーションは実行されるたびに ARIA 会話を開始します。この会話は、ご自身で開始した会話と同様に、組織の使用量としてカウントされます。

<h2 id="create-an-automation">
  オートメーションを作成する
</h2>

オートメーションを適用するスコープに応じて、**Registry** または **Project** を選択します。続いて、以下の手順に従い、ARIA にプロンプトを送信するオートメーションを作成します。

<Note>
  オートメーションをより広い範囲に適用するには、グローバルな **Automations** ハブから作成し、**Team** または **Organization** スコープを選択します。手順は以下と同じです。これらのスコープでは、W\&B がサポートするのはアーティファクトイベントとコレクションイベントのみです。詳しくは [Automations ハブ](/ja/products/wandb/automations#automations-hub)を参照してください。
</Note>

<Tabs>
  <Tab title="Registry">
    Registry 管理者は、その Registry 内でオートメーションを作成できます。

    1. W\&B にログインします。
    2. Registry 名をクリックして、詳細を表示します。
    3. Registry をスコープとするオートメーションを作成するには、**Automations** タブをクリックし、**Create automation** をクリックします。Registry をスコープとするオートメーションは、その Registry 内のすべてのコレクション (今後作成されるものを含む) に自動的に適用されます。
    4. 監視する[イベント](/ja/products/wandb/automations/automation-events#registry-events)を選択します。

       選択したイベントに応じて追加のフィールドが表示されるので、入力します。たとえば、**An artifact alias is added** を選択した場合は、**Alias regex** を指定する必要があります。

       **Next step** をクリックします。
    5. ARIA 会話をホストするチームを選択します。Registry はチームではなく組織に属しますが、ARIA 会話はいずれかのチームに属している必要があります。詳しくは[オートメーションによって作成された会話を表示する](#view-conversations-created-by-automations)を参照してください。
    6. **Action type** を **Trigger ARIA** に設定します。
    7. **Prompt** フィールドに、ARIA に送信するプロンプトを記述します。詳しくは[プロンプトを記述する](#write-the-prompt)を参照してください。**Next step** をクリックします。
    8. オートメーションの名前を入力します。必要に応じて、説明も入力します。
    9. **Create automation** をクリックします。

    これでオートメーションが有効になり、選択したイベントが Registry 内で発生するたびに、新しい ARIA 会話が開始されます。
  </Tab>

  <Tab title="Project">
    W\&B 管理者は、project 内でオートメーションを作成できます。

    1. W\&B にログインします。
    2. project ページに移動して **Automations** タブをクリックし、**Create automation** をクリックします。
    3. 監視する[イベント](/ja/products/wandb/automations/automation-events#project)を選択します。

       1. 追加のフィールドが表示された場合は入力します。たとえば、**An artifact alias is added** を選択した場合は、**Alias regex** を指定する必要があります。

          1. run によってトリガーされるオートメーションでは、必要に応じて 1 つ以上の run フィルターを指定します。

             * **Filter to one user's runs**: 指定したユーザーが作成した run のみを対象にします。トグルをクリックしてフィルターを有効にし、ユーザー名を指定します。
             * **Filter on run name**: 名前が指定した正規表現に一致する run のみを対象にします。トグルをクリックしてフィルターを有効にし、正規表現を指定します。
       2. **Next step** をクリックします。
    4. project を所有するチームを選択します。
    5. **Action type** を **Trigger ARIA** に設定します。
    6. **Prompt** フィールドに、ARIA に送信するプロンプトを記述します。詳しくは[プロンプトを記述する](#write-the-prompt)を参照してください。**Next step** をクリックします。
    7. オートメーションの名前を入力します。必要に応じて、説明も入力します。
    8. **Create automation** をクリックします。

    これでオートメーションが有効になり、選択したイベントが project 内で発生するたびに、新しい ARIA 会話が開始されます。
  </Tab>
</Tabs>

<h2 id="create-and-manage-automations-with-aria">
  ARIA でオートメーションを作成・管理する
</h2>

ARIA は、必要に応じてオートメーションの作成、削除、有効化、無効化を行えます。

ARIA にオートメーションの作成を依頼します。

<AriaChatBubbles prompt="新しいオートメーションを作成してください: run が成功したら ARIA をトリガーし、run、メトリクス、結果をまとめたチーム向けの report を作成させてください。" response="**Summarize successful run** という名前で、project 全体を対象とする有効なオートメーションを作成できます。このオートメーションは、いずれかの run が `FINISHED` になるたびに起動し、run の設定、主要なメトリクス、結果、注目すべき観測値をまとめた report の作成を ARIA に依頼します。" />

既存のオートメーションについて ARIA に質問します。

<AriaChatBubbles prompt="この project にはどのようなオートメーションがありますか？" response="project レベルのオートメーションが 2 件あり、どちらも有効です...." />

ARIA にオートメーションのリネームを依頼します。

<AriaChatBubbles prompt="old-name を production-alert にリネームしてください。" response="リネームを実行しますか？" />

確認すると、ARIA がオートメーションをリネームします。

<h3 id="view-your-aria-automations-in-chat">
  チャットで ARIA のオートメーションを表示する
</h3>

ARIA を開き、チャットヘッダーの **Reveal chat history** をクリックします。次に、チャット履歴サイドバーの下部にある **Customize** セクションを開き、**My automations** を選択します。

**My automations** は、ARIA のメインパネルで会話ビューの横に開くのではなく、会話ビューと置き換わる形で表示されます。会話を選択するか新しいチャットを開始すると、会話に戻ります。このペインの状態はリロード時に保持されないため、ページを更新した場合も会話に戻ります。

このペインに一覧表示されるのは、自分が作成したオートメーションのうち、ARIA にプロンプトを送信するものだけです。他の action を使用するオートメーションや、チームメイトの ARIA オートメーションは表示されません。

このペインは読み取り専用です。オートメーションが有効か無効かは確認できますが、有効化、無効化、編集、削除を行うには、**View all automations** をクリックして、新しいタブで Automations ページを開きます。[オートメーションの表示と管理](#view-and-manage-automations)を参照してください。

名前で検索するか、**Previous** と **Next** で結果を 20 件ずつ切り替えて表示できます。一覧には、各オートメーションの名前、**Event type**、**Scope** が表示されます。

オートメーションをクリックすると詳細ビューが開き、**Description**、**Scope**、**Created by**、**Created**、**Status** (**Enabled** または **Disabled**) 、**Event type**、および送信される **Prompt ARIA** が表示されます。

**Automation history** セクションには、各実行の **Triggered** 時刻と **Status**、および **Conversation** 列が一覧表示されます。**Open thread** をクリックすると、その実行で作成された会話が開きます。値が **No thread** の場合、その実行では会話が作成されなかったことを示します。実行は最大 6 か月間表示されます。

一覧または詳細ビューから戻るには、**Back to chat** または **Back to My automations** を使用します。

オートメーションを作成するには、**Create automation** をクリックします。フォームは開かず、代わりに次のプロンプトがユーザーに代わって送信された状態で新しい ARIA チャットが開始されます。

<AriaChatBubbles prompt="ARIA にプロンプトを送信するオートメーションの作成手順を案内してください。何を自動化したいかを尋ね、スコープとトリガーの選択を手伝い、一緒にプロンプトの下書きを作成してください。" response="喜んでお手伝いします。どのイベントをトリガーにしますか？また、オートメーションは project と registry のどちらに配置しますか？それが決まったら、プロンプトの文言を一緒に考えましょう。" />

請求情報への読み取り専用アクセス権しかない場合、**Create automation** は無効になります。**My automations** は個人アカウントでは使用できません。オートメーションを表示するには組織を選択してください。このペインを使用するために個別の機能フラグは必要ありません。[要件](#requirements)で説明されているものと同じアクセスチェックを満たしていれば使用できます。

<h2 id="write-the-prompt">
  プロンプトを記述する
</h2>

ARIA action で設定する項目はプロンプトのみです。ARIA のチャットウィンドウでメッセージを書くのと同じ要領でプロンプトを記述し、[テンプレート変数](#template-variables) を使って ARIA が調べる run、アーティファクト、またはメトリクスを指定します。

次の制約に注意してください。

* プロンプトは必須で、最大 4,000 文字です。W\&B はテンプレート変数を置換した後にも長さを再チェックします。そのため、置換後の値が長いと、保存できたプロンプトでもオートメーションの実行時に失敗することがあります。このチェックに失敗したプロンプトは、オートメーションの [実行履歴](/ja/products/wandb/automations/view-automation-history) に失敗した実行として記録されます。
* イベントに該当しないテンプレート変数は、変数名のままではなく空文字列に解決されます。選択したイベントに対応する変数のみを使用してください。
* ARIA はオートメーションが実行されるたびに新しい会話を開始します。以前の会話を引き継ぐことはなく、同じオートメーションの過去の実行内容も記憶しません。

変数を挿入するには、**Prompt** フィールドの下にある一覧で、目的の変数の横にある **<Icon icon="plus" iconType="solid" />** をクリックします。変数はプロンプトの末尾に追加されます。一覧には、選択したイベントに該当する変数のみが表示されます。

たとえば、次のプロンプトは新しくリンクされたモデルバージョンをそれぞれ調査します。

```text theme={"system"}
${event_author} が ${artifact_collection_name} の新しいバージョンを ${project_name} にリンクしました。

${artifact_version_string} を現在の production エイリアスのバージョンと比較してください。評価メトリクスに回帰があればその内容を要約し、プロモートすべきかどうかを提案してください。
```

オートメーションを保存する前に、ARIA にプロンプトの文面を考えてもらうこともできます。

<AriaChatBubbles prompt="この project で run が失敗するたびに実行されるオートメーションを作成したいです。失敗の原因を診断するよう依頼するプロンプトの下書きを作成してください。" response="オートメーションに貼り付けるプロンプトの例は次のとおりです：「${project_name} の run ${run_name} が失敗しました。ログ、設定、システムメトリクスを確認し、直近で成功した数件の run と比較したうえで、最も可能性の高い原因と、試すべき具体的な修正案を 1 つ教えてください。」" />

<h2 id="template-variables">
  テンプレート変数
</h2>

テンプレート変数は `${variable_name}` という構文で記述します。プロンプトで使用できる変数は、オートメーションが監視するイベントによって異なります。

次の変数は、すべてのイベントで使用できます。

| 変数 | 説明 |
| - | - |
| `${automation_name}` | action をトリガーしたオートメーションの名前。 |
| `${event_type}` | action をトリガーしたイベントのタイプ。 |
| `${event_author}` | action をトリガーしたユーザー。 |
| `${entity_name}` | action をトリガーしたイベントを所有する entity の名前。 |
| `${project_name}` | action をトリガーしたイベントを所有する project の名前。 |

イベントによっては、上記の変数に加えて次の変数も使用できます。

| イベント | 追加の変数 |
| - | - |
| アーティファクトのバージョンが作成、リンク、またはリンク解除された | `${artifact_collection_name}`、`${artifact_version}`、`${artifact_version_string}`、`${artifact_version_index}`、`${artifact_metadata.KEY}` |
| アーティファクトのエイリアスが追加または更新された | 上記のアーティファクト変数と `${alias}` |
| アーティファクトのタグが追加または削除された | 上記のアーティファクト変数と `${tag}` |
| コレクションのタグが追加または削除された | `${artifact_collection_name}`、`${tag}` |
| run のメトリクスがしきい値を超えた、変化した、または z スコアで変化した | `${run_name}`、`${metric_name}`、`${metric_values}`、`${metric_filter}`、`${metric_filter_short}`、`${metric_current_status}` |
| run のステータスが変化した | `${run_name}`、`${run_status}` |
| Weave のメトリクスがしきい値を超えた | `${alert_name}`、`${metric_name}`、`${metric_value}`、`${threshold}`、`${comparison_op}`、`${message}` |

個々の変数に関する注意事項は次のとおりです。

* `${artifact_version}` は、`wandb-artifact://_id/QXJ0aWZhY3Q6NTE3ODg5ODg3` のようなアーティファクトのインスタンスに解決されます。バージョンを名前で参照するには、`${artifact_version_string}` を使用してください。
* `${artifact_metadata.KEY}` は、イベントをトリガーしたアーティファクトのバージョンからカスタムメタデータの値を読み取ります。`KEY` は目的のメタデータキーに置き換えてください。サポートされるのはトップレベルのメタデータキーのみです。

各スコープで使用できるイベントについては、[オートメーションのイベントとスコープ](/ja/products/wandb/automations/automation-events)を参照してください。

<h2 id="view-conversations-created-by-automations">
  オートメーションによって作成された会話を表示する
</h2>

オートメーションは、そのオートメーションを作成したユーザーのアカウントで ARIA 会話を作成します。この会話は、そのユーザーが自分で開始した会話と並んで、ARIA のチャット履歴サイドバーに表示されます。イベントを発生させたユーザーを特定するには、プロンプトに `${event_author}` を含めてください。

会話が作成される場所は、オートメーションのスコープによって異なります。

* **project スコープおよびチームスコープのオートメーション**: 会話は、イベントが発生した project に作成されます。
* **Registry スコープのオートメーション**: Registry はチームではなく組織に属しますが、ARIA 会話はいずれかのチームに属している必要があります。そのため会話は、オートメーションの作成時に選択したチーム内の `wandb_agent_default_project` という名前の project に作成されます。Registry ではなく、この project を確認してください。

  `wandb_agent_default_project` は、ユーザーが開いた project に紐付かない会話を保持するために、W\&B がチームごとに管理しているプレースホルダー project です。ユーザーが自分で作成する必要はなく、通常はこれらの会話以外には何も含まれていません。

オートメーションが実行されたかどうかを確認するには、その[実行履歴](/ja/products/wandb/automations/view-automation-history)を開きます。ARIA の実行が成功している場合は、W\&B が送信したプロンプトと、会話の `thread_id` を含む応答本文が表示されます。その会話を開くには、ARIA の [My automations](#view-your-aria-automations-in-chat) ペインにある **Open thread** リンクを使用します。このリンクは同じ `thread_id` をもとに生成されています。なお、オートメーションによって作成された会話は、チャット履歴上で他の会話と区別されずに表示されます。

<h2 id="view-and-manage-automations">
  オートメーションの表示と管理
</h2>

オートメーションは、project または registry の **Automations** タブ、あるいはグローバルな **Automations** ハブで表示と管理を行えます。オートメーションの一覧では、action は **ARIA** と表示されます。

ARIA にプロンプトを送信するオートメーションは、ARIA 会話が作成者のユーザーとして実行されるため、作成者本人しか編集できません。project または registry への書き込み権限を持つチームメンバーは、オートメーションを表示および削除できますが、**Edit** オプションは使用できません。

オートメーションの所有権は移譲できません。代わりに、オートメーションを削除し、新しい所有者に作成し直してもらってください。作成者がチームを離れたオートメーションを復旧する場合も、同じ手順で対応します。

<h2 id="limitations">
  制限事項
</h2>

ARIA オートメーションには次の制限があります。

* ARIA オートメーションは、[W\&B Multi-tenant Cloud](/ja/products/wandb/platform/hosting#wb-multi-tenant-cloud) のチーム project でのみ利用できます。また、組織管理者が **Smart features** を有効にしている必要があります。
* 各オートメーションが開始できる ARIA 会話は、1 分あたり最大 3 件です。この上限を超えた実行は、ステータス **Skipped** としてオートメーションの履歴に記録されます。これは、オートメーションがイベントに一致したものの、action は実行されなかったことを示します。
* オートメーションを作成したユーザーが project への書き込みアクセス権を失った場合や、そのユーザーのアカウントが無効化された場合は、以降の実行はすべて失敗します。失敗はオートメーションの実行履歴に表示されます。
* オートメーションを編集できるのは、その作成者のみです。
* `wandb` Python ライブラリは ARIA オートメーションに対応していません。[API でオートメーションを管理する](/ja/products/wandb/automations/api)を参照してください。
* チャット内の [My automations](#view-your-aria-automations-in-chat) ペインは読み取り専用です。オートメーションの有効化、無効化、編集、削除は、**Automations** タブまたはハブから行ってください。

<h2 id="next-steps">
  次のステップ
</h2>

詳しくは、次のリソースを参照してください。

* [オートメーションのイベントとスコープ](/ja/products/wandb/automations/automation-events)
* [オートメーションの履歴を表示する](/ja/products/wandb/automations/view-automation-history)
* [ARIA とチャットする](/ja/products/aria/chat)
* [ARIA の概要](/ja/products/aria)


## Related topics

- [ARIA とチャットする](/ja/products/aria/chat.md)