カスタムインストラクションは、アカウント管理者が組織全体に向けて設定するガイダンスです。Treasure AI Studioはこのテキストを組織内のすべてのエージェントのシステムプロンプトに追加します。そのため、優先データベース、出力フォーマット、要約の書式ルールといった大切な規約を、各ユーザーが会話ごとに繰り返し指示しなくても、エージェントが考慮するようになります。カスタムインストラクションは組織ごとに1つです。作業フォルダやチャット、ユーザーをまたいで適用したい共通ルールに使用してください。
カスタムインストラクションは、WebまたはDesktopのStudioの設定で行います。設定した内容は、Mobileを含むすべてのプラットフォームのチャットで、プロンプトに追加されます。
カスタムインストラクションを表示・編集できるのはアカウント管理者のみです。一般メンバーにはインストラクション設定タブは表示されませんが、インストラクションはそのチャットにも適用されます。
1つのカスタムインストラクションを記述して、組織内のすべてのエージェントに共通の動作ベースラインを与えます。あわせて、作業フォルダ単位のインストラクションとの関係と、変更がいつ反映されるかを理解します。
- Treasure AI Studioのアカウント管理者ロール
- WebまたはDesktopでサインイン済みであること（はじめに）— インストラクション設定タブはこれらで利用できます
カスタムインストラクションは、アカウント管理者が設定するテキストで、Treasure AI Studioが組織内のすべてのエージェントのシステムプロンプトに追加します。エージェントの動作は複数の層で形作られ、カスタムインストラクションはその組織全体の層にあたります。
| 層 | 適用範囲 | 設定者 |
|---|---|---|
| カスタムインストラクション | 組織内のすべてのチャット（すべての作業フォルダとユーザー） | アカウント管理者 |
| 作業フォルダのインストラクション | 1つの作業フォルダ内のチャット | その作業フォルダを編集できるユーザー（コアコンセプト） |
これらの層は同時に適用されます。カスタムインストラクションは組織全体のベースラインを定め、作業フォルダのインストラクションはその作業フォルダ内のチャットに固有のルールを上乗せします。組織全体の規約はカスタムインストラクションに、作業フォルダ固有の詳細は作業フォルダのインストラクションに記述し、同じ内容を各作業フォルダで重複させないようにします。
アカウントによっては、読み取り専用のマネージドインストラクションが表示されることもあります。これはアカウントに合わせてエージェントの動作を調整するためにTreasure AIが管理するもので、同じようにプロンプトに追加されます。詳しくは下記のマネージドインストラクションについてを参照してください。
インストラクションは、新しいチームメンバーに指示を出すのと同じ要領で、自分の言葉で書くプレーンテキストです。エージェントのシステムプロンプトに追加されるため、1回限りの依頼ではなく、恒常的なガイダンスとして記述してください（例：「デフォルトでmarketingデータベースを使用すること。要約は箇条書きで整形すること。」）。
- サイドバーのフッターにあるユーザーアバターから設定を開きます。
- Organizationセクションのインストラクションタブを選択します。このタブはアカウント管理者にのみ表示されます。
- カスタムインストラクションカードに、カウンターに表示される16,384文字の上限内で、組織全体のガイダンスを入力します。下書きが未変更の間、または上限を超えている間、保存は無効のままです。
- 保存を選択します。インストラクションが保存されると保存は再び無効の状態に戻り、変更が保存されたことを示します。
インストラクションを削除するには、テキストをすべて消して保存を選択します。カスタムインストラクションが空の場合、エージェントはデフォルトの動作に戻ります。
チャットは作成時にカスタムインストラクションを読み込みます。インストラクションを編集・削除しても、変更が反映されるのはその後に開始した新しいチャットだけです。すでに進行中のチャットは、開始時のインストラクションを保持します。更新を反映するには、新しいチャットを開始してください。
カスタムインストラクションは人ではなくエージェントが読むため、具体的かつ明確に記述します。
カスタムインストラクションはエージェントのシステムプロンプトの一部になるため、露出してしまう可能性は否定できません。シークレット、認証情報、APIキーや個人情報（PII）は含めないでください。
- タスクではなく恒常的なルールを記述する。 「プッシュ前に必ずYAMLを検証すること」はすべてのエージェントが従えるルールですが、「セグメントを作って」はチャットごとのタスクです。
- 具体的なデフォルトを明記する。 データベース、テーブルの命名規則、日付フォーマット、出力構造は、ここで一度固定しておく価値が最も高い項目です。
- 組織全体に関わる内容にとどめる。 1つの作業フォルダや1回の分析にのみ当てはまる内容は、ここではなくその作業フォルダのインストラクションに記述します。
- 簡潔にする。 焦点を絞ったインストラクションのほうが、細かな例外を長く並べるより、エージェントが一貫して従いやすくなります。また、組織内のすべてのチャットに適用されるため、短いほど各チャットのコストも抑えられます。
カスタムインストラクションと並んで、管理者には読み取り専用のマネージドインストラクションセクションが表示されることがあります。このインストラクションは、アカウントに合わせてエージェントの動作を調整するために、Treasure AIが記述・管理しています。編集はできませんが、エージェントが受け取るガイダンスの全体を確認できるよう、透明性のために表示されます。カスタムインストラクションと同様に、新しいチャットにのみ適用されます。
- アカウント管理者として設定 → インストラクションを開き、カスタムインストラクションを編集できることを確認する
- インストラクションを保存し（例：「すべての要約を箇条書きで整形すること」）、新しいチャットを開始して、内容が反映されることを確認する
| 問題 | 解決策 |
|---|---|
| インストラクションタブが表示されない | このタブはアカウント管理者にのみ表示されます。自分のロールを確認するか、管理者にインストラクションの設定を依頼してください |
| 更新したインストラクションが反映されない | 変更は新しいチャットにのみ適用されます。新しいチャットを開始してから動作を確認してください |
| 保存が無効になっている | 保存は、下書きが保存済みのテキストと異なり、かつ16,384文字の上限内である場合にのみ有効になります。上限を超えている下書きは短くしてください — カウンターが赤くなり、インラインでメッセージが表示されます |
| エージェントがインストラクションを十分に反映しない | 会話が長くなると、エージェントが長いインストラクションを重視しにくくなることがあり、矛盾するルールも一貫して反映しづらくなります。内容は簡潔にし、最も重要なルールに絞り込んでください。作業フォルダ固有の詳細は作業フォルダのインストラクションに移してください |
- コアコンセプト — 作業フォルダ、作業フォルダのインストラクション、モデル、クレジット
- エージェントオーケストレーター — Studioがエージェントの作業をどのように計画・実行するか
- セキュリティと権限 — ロール、アクセス制御、データ保持