メインコンテンツまでスキップ
に最終更新

カスタム指示を追加する

カスタム命令を追加することで、Databricks Assistant の応答方法をカスタマイズできます。アシスタントは、新しい応答を生成するときにこれらの指示を考慮します。

たとえば、指示には次のようなものが含まれます。

  • コードを書くときにどのライブラリを使用するかなどの好みに関する情報。
  • 名前や役割など、あなたが誰であるかに関するコンテキスト。
  • 従うべきコーディング規則。
  • 従うべきガイドライン。
  • カジュアルな口調を使用するなど、アシスタントがどのように応答すべきかについての指示。

クイック修正とオートコンプリートを除き、 Databricks Assistant 、インライン アシスタント、一般的なチャット、修正の提案、編集モード、エージェント モードなど、生成するすべての応答に指示を適用します。

Databricks Assistant は、ユーザー指示とワークスペース指示の 2 種類の指示をサポートしています。別途指示がない限り、アシスタントは通常、ユーザーの指示よりもワークスペースの指示を優先します。

ユーザー指示を追加する​

ユーザー指示を使用すると、アシスタントにシステムレベルの指示を提供できます。これらは、コンテキスト、設定、または推奨される作成方法を共有するための永続的な方法です。これらの手順はあなたに固有のものであり、アシスタントとのやり取りにのみ適用されます。

ユーザー指示を追加するには:

  1. クリックしてアシスタントパネルを開きますアバターアシスタントアイコン。ワークスペースの右上隅にあります。

  2. アシスタントパネルで、歯車アイコン。アシスタントの設定を開きます。

    アシスタントの指示を追加します。

  3. [ユーザー指示] の下で、 [指示ファイルの追加] をクリックします。これにより、デフォルトのユーザーワークスペースディレクトリ ( /Users/<your-username-or-email> ) に.assistant_instructions.mdファイルが作成され、新しいファイルタブで開きます。

    すでに指示ファイルを作成している場合は、 「指示ファイルを開く」 をクリックしてファイルを開きます。

  4. .assistant_instructions.mdファイルを編集してカスタム指示を追加します。Databricks では、各指示を新しい箇条書きまたは段落として区切って、わかりやすい英語のテキストで指示を追加することをお勧めします。アシスタントの指示に関するベストプラクティスを参照してください。

アシスタントは、次回操作するときに自動的に指示を取得します。

アシスタントを使用して指示を追加することもできます。アシスタント パネルから、アシスタントに何かを覚えてもらうように依頼します。

ワークスペースの指示を追加および表示する​

注記

ワークスペース管理者のみがワークスペースの指示を追加または編集できます。

ワークスペースの指示はワークスペースの管理者が構成するもので、アシスタントは詳細なコンテキストを与えられることで、ワークスペースでガイドラインに従ってより効率的に作業しやすくなります。

ワークスペースにまだワークスペースの指示がない場合、ワークスペース管理者は次のステップに従って指示ファイルを作成できます。

  1. ワークスペースのWorkspace/ディレクトリに、 .assistant_workspace_instructions.mdという名前のファイルを作成します。
  2. ファイルを編集して、ワークスペース全体に適用されるアシスタントの指示を追加します。Databricks では、各指示を箇条書きまたは段落として区切って、わかりやすい英語のテキストで指示を追加することをお勧めします。アシスタントの指示に関するベストプラクティスを参照してください。

ユーザーが次にアシスタントを操作するときに、アシスタントは新しいワークスペースの指示を自動的に取得します。

ワークスペースの指示を表示または編集するには:

  1. クリックしてアシスタントパネルを開きますアバターアシスタントアイコン。ワークスペースの右上隅にあります。

  2. アシスタントパネルで、歯車アイコン。アシスタントの設定を開きます。

  3. ワークスペースの指示 の下で、 ファイルの表示 をクリックします。これにより、 .assistant_workspace_instructions.mdファイルが新しいタブで開きます。

  4. ワークスペース管理者の場合は、ファイルを編集して、ワークスペース全体でのアシスタントの動作に適用される指示を追加できます。指示の追加に関する詳細については、 「アシスタント指示のベスト プラクティス」を参照してください。

    管理者でない場合でも、ファイルを表示して、ユーザーが提供した指示に加えて、アシスタントが従っている指示を把握することができます。

    ワークスペース アシスタントの手順を表示します。

アシスタントの指示に関するベストプラクティス​

指示を提供する際には、アシスタントの潜在的な制限を考慮することが重要です。ここでは、エクスペリエンスを最適化し、この機能を最大限に活用するための手順を記述するための一般的なガイドラインとヒントを紹介します。

  • 明確で具体的な指示を書く: 指示を書くときは、明確かつ曖昧にならないようにしてください。
  • 説明は 20,000 文字以内にしてください: 説明ファイルは 20,000 文字に制限されています。この制限を超える指示はアシスタントでは使用されません。簡潔にし、重要な指示を優先します。
  • 構造には見出しと区切り文字を使用します。 手順は Markdown ファイルにあります。構造を提供するために、手順では Markdown 形式を使用します。個別の指示を区切るために、箇条書きを区切りとして使用します。見出しを使用して一連の手順をグループ化します。たとえば、「Python コードの規則」という見出しに、アシスタントが Python コードを操作するときに従うべき Python 固有のガイドラインの箇条書きリストを含めることができます。
  • 範囲: アシスタントは、インライン アシスタント、一般チャット、修正の提案、編集モードなどを使用して対話するときに、生成するすべての応答に指示を適用します。ただし、アシスタントはクイックフィックスとオートコンプリートの指示を考慮しません。意図しない動作を避けるため、指示はさまざまなアシスタント機能に広く関連するものにしてください。
  • コンテキストと参照を提供する: アシスタントはノートブック コードやテーブル メタデータなどの周囲のコンテキストを使用しますが、指示に基づいて追加情報を積極的に取得することはまだありません。役立つ回答を確実に得るために、特定のテーブルや関数をいつ使用するかなどの重要な詳細を手順に直接含めてください。