メインコンテンツまでスキップ

エージェントスキルで Genie Code を拡張する

Genie Codeには、ノートブックでのコードの作成、Unity Catalogでのデータの探索、ダッシュボードの構築、パイプラインの作成、MLflowの操作など、一般的なDatabricksワークフロー向けの組み込みスキルが用意されています。チームのドメイン固有のタスクに対応する専門的な機能でGenie Codeを拡張するカスタムスキルを作成します。

Genie Codeスキルとは何ですか?​

特殊な機能で Genie Code を拡張するスキルを作成します。スキルは、エージェント スキルのオープン スタンダードに準拠します。スキルは、特定のタスクを実行するために Genie Code が必要に応じてロードできるドメイン固有の知識とワークフローをパッケージ化します。スキルには、ガイダンス、ベスト プラクティス、再利用可能なコード、実行可能なスクリプトなどが含まれます。

スキルは、ドメイン固有のタスクに合わせて調整する必要があります。スキルを使用すると、指示を使用する場合よりも、タスクにより多くのコンテキスト(スクリプト、例、その他のリソースなど)を提供できます。グローバルに適用されるカスタム指示とは異なり、スキルは自動的に、関連するコンテキストでのみ読み込まれます。Genie Codeは、お客様のリクエストとスキルの説明に基づいて、関連する場合に自動的にスキルを読み込みます。スキルは、@それらについて言及することで、手動で呼び出すこともできます。これにより、効率的なコンテキストウィンドウが維持され、複数のチャットで同じコンテキストを提供する必要性が軽減されます。

スキルには2種類あります。

  • ワークスペーススキル : ワークスペース内の全員が利用できます。ワークスペース管理者は、ワークスペーススキルを作成し、他のユーザーにスキルフォルダーへのアクセス権を付与して、スキルを追加できるようにします。ワークスペーススキルを使用して、組織全体の標準を適用したり、ユーザー間で一貫した出力を提供したり (例: 機密性の高い列をマスクする PII 処理スキル)、さまざまなチームにサービスを提供したりできます (例: データエンジニア向けのパイプライン Template や、機械学習プラットフォームユーザー向けのモデルトレーニングプレイブック)。
  • ユーザースキル :あなただけが利用できます。ユーザーのスキルを活用して、好みのライブラリ、コーディングスタイル、役割や背景などの個人的な好みを設定してください。ユーザースキルは、スキルをワークスペースレベルに昇格させる前に、そのスキルのプロトタイプを作成する際にも役立ちます。

スキルを作成する​

Genie Codeを使用してスキルを作成したり、コンピュータからスキルフォルダーをuploadしたり、手動でスキルファイルを作成したりできます。

Genie Codeで カスタマイズ をクリックし、 スキル を選択してスキルリストを開きます。 新規 をクリックして、利用可能なオプションを表示します。

ワークスペース管理者の場合、 新規 メニューには2つのセクションがあります:

  • このワークスペース内の全員 :ワークスペース内の全員が利用できるワークスペーススキルを作成またはuploadします。
  • 自分用 : 個人のスキルを作成またはuploadするか、既存のワークスペースフォルダーからスキルを追加します。

他のユーザーには、セクション見出しなしで個人用スキルのオプションが表示されます。

Genieで作成​

チャットでスキルを作成するには:

  1. スキルリストで [新規] をクリックし、 [Genie で作成] を選択します。ワークスペース管理者の場合は、目的の対象読者の見出しの下にあるオプションを選択します。
  2. 新しいチャットで、Genie Codeに作成させるスキルを説明します。

新しいスキルがスキルリストに表示されます。パーソナルスキルは、ワークスペースのホームフォルダー /Users/{username}/.assistant/skills/ に保存されます。ワークスペーススキルは /Workspace/.assistant/skills/ に保存され、ワークスペース内の全員に対して有効になります。

コンピュータからスキルをuploadする​

スキルフォルダーが既にコンピュータにある場合は、スキルリストからそれらをuploadします。各スキルフォルダーには、SKILL.md ファイルが含まれており、Agent Skillsの仕様に従う必要があります。

  1. [新規作成] をクリックし、 [コンピュータからupload] を選択します。ワークスペース管理者の場合は、 [このワークスペースの全員] または [自分のみ] の下にあるオプションを選択します。
  2. スキルフォルダーを upload ダイアログにドラッグするか、 フォルダーの参照 をクリックして選択します。
  3. uploadするスキルを確認し、個人用スキルなら Upload を、ワークスペーススキルなら ワークスペースにUpload をクリックします。

uploadされたスキルはスキルリストに表示されます。個人uploadは、/Users/{username}/.assistant/skills/のワークスペースホームフォルダーに保存されます。ワークスペース upload は/Workspace/.assistant/skills/に保存され、ワークスペース内の全員に対して有効になります。

既存のワークスペーススキルと同じ名前のワークスペーススキルをuploadすると、ワークスペース内の全員のスキルが置き換えられます。

スキル ファイルを手動で作成する​

defaultでは、スキルは .assistant/skills/ フォルダにあります。各スキルには、独自のフォルダと、そのフォルダ内の SKILL.md ファイルが必要です。場所はスキルタイプによって異なります。

  • ワークスペーススキル : Workspace/.assistant/skills/
  • ユーザースキル : /Users/{username}/.assistant/skills/

スキルを手動で作成するには:

  1. スキルフォルダが存在しない場合は、スキルタイプに適したパスに skills フォルダを作成します。

  2. スキルフォルダの中に、そのスキル専用のフォルダを作成してください。各スキルはそれぞれ専用のフォルダを持つ必要があります。例えば:

    Workspace/.assistant/skills/
    └── ml-workflows/
    └── SKILL.md

    /Users/{username}/.assistant/skills/
    └── personal-workflows/
    └── SKILL.md
  3. スキル フォルダー内にSKILL.mdファイルを作成します。このファイルは必須であり、スキルを定義します。スキルはエージェント スキルの仕様に従います。

  4. スキルに必要なフロントマターを追加します。

    YAML
    ---
    name: skill-name
    description: A description of what this skill does and when to use it.
    ---
  5. フロントマターの後に、スキルの説明を Markdown 形式で追加します。次のセクションを含めることをお勧めします。

    • ステップバイステップの説明: 明確な手順ガイド
    • 例: サンプル入力と期待される出力
    • エッジケース: 一般的なバリエーションと例外
  6. (オプション) より複雑なスキルの場合は、追加のリソースを提供して参照することができます。

    • エージェントが実行できる実行可能コードを含むスクリプト。
    • ベスト プラクティスやテンプレートなど、参照するための追加ドキュメントを含むファイル。

    他のファイルを参照する場合は、ルート スキルからの相対パスを使用します。

    例えば、ワークスペースの機械学習ワークフロースキルと個人のワークフロースキルは、次のような構造を持つ可能性があります。

    Workspace/.assistant/skills/
    ├── ml-workflows/
    ├── SKILL.md # Workflow overview and best practices
    ├── training-patterns.md # Standard ML training patterns
    └── scripts/
    └── model-deploy.py # Model deployment automation

    /Users/{username}/.assistant/skills/
    ├── personal-workflows/
    ├── SKILL.md # Workflow overview and best practices
    ├── etl-patterns.md # Personal ETL best practices
    ├── dashboard-templates.md # Reusable dashboard patterns
    └── scripts/
    └── pipeline-setup.sh # Environment setup scripts

Genie Codeは、次回使用時にスキルを自動的に認識します。Genie Codeがそれらを確実に使用するように、@ スキルに言及することもできます。

既存のスキルを編集した場合は、新しいチャットを起動して変更を適用してください。編集内容はアクティブなチャットには反映されません。スキルが古い動作や説明を表示するなど、依然として古い状態に見える場合は、ブラウザのtabをハード更新して、キャッシュされたスキルメタデータをクリアしてください。

別のフォルダーからスキルを追加する​

By default, Genie Code loads skills from the .assistant/skills/ folders.You can also 登録する additional skill folders, so that skills stored elsewhere in your ワークスペース are available without moving them into .assistant/skills/.This is useful when you keep skills in a Databricks Git folder next to the project code they relate to.

登録するフォルダは、.assistant/skills/ と同じ構造を持つ、スキルのサブフォルダを含む親フォルダである必要があります。各スキルには、引き続き SKILL.md ファイルを含む独自のサブフォルダが必要です。SKILL.md ファイルを含むフォルダを直接登録しないでください。

たとえば、/Users/{username}/my-skills/ が次の構造を持つ場合に登録します:

/Users/{username}/my-skills/
├── etl-checks/
│ └── SKILL.md
└── release-notes/
└── SKILL.md

追加のスキルフォルダを登録するには:

  1. Genie Codeで [カスタマイズ] をクリックし、 [スキル] を選択します。
  2. New をクリックし、 Add from ワークスペース folder を選択します。ワークスペース管理者の場合、このオプションは Just for me にあります。
  3. ワークスペースブラウザで、スキルサブフォルダを含む親フォルダを選択します。フォルダへの読み取りアクセス権が必要です。

登録済みフォルダーのスキルは、defaultスキルとともにスキルリストに表示されます。フォルダーを登録すると、そのスキルはワークスペース内の全員ではなく、登録したユーザーのスキルに追加されます。default .assistant/skills/ フォルダーは引き続き利用できます。

フォルダーを登録したら、スキルリストの フォルダー をクリックして、登録済みのフォルダーを表示します。 スキルフォルダー ダイアログで、 フォルダーの追加 をクリックして別のフォルダーを登録するか、リストからフォルダーを削除してスキルの読み込みを停止します。このリストからフォルダーを削除しても、フォルダーやそのファイルは削除されません。

スキル作成のベストプラクティス​

効果的なスキルを書くには、次のガイドラインに従ってください。

  • 適切なスキルタイプを選択してください。ワークスペースのスキルを活用して、共有標準(個人情報の取り扱い、命名規則、チーム固有のテンプレートなど)を体系化し、すべてのユーザーが一貫した出力を得られるようにする。ユーザー スキルを個人の好みに合わせて使用し、ワークスペースにプロモートする前にスキルのプロトタイプを作成します。
  • スキルを集中させましょう。スキルは、単一のタスクまたはワークフローに焦点を当てた場合に最も効果を発揮します。スコープを狭くすると、スキルが適用されるタイミングを Genie Code が認識しやすくなります。
  • 明確な名前と説明を使用してください。簡潔で説明的な名前と概要は、Genie Code が適切なスキルを適切なリクエストに一致させるのに役立ちます。
  • 明確に、例を挙げて説明してください。ワークフローをステップごとに説明し、 Genie Code で再利用できる具体的な例やパターンを含めます。
  • 不必要なコンテキストを避けてください。タスクに必要な情報のみを含めます。詳細を追加すると、スキルを確実に適用することが難しくなる可能性があります。
  • 時間をかけて繰り返します。スキルを生きたワークフローとして扱います。実際の使用状況に基づいた小さな更新により、結果が大幅に改善される可能性があります。
  • Genie Codeを使った執筆スキル。Genie Codeを使ってスキルを設計・改良しましょう。エージェントが苦戦する箇所を特定するために、新しいスキルや更新されたスキルを代表的なタスクでテストし、そのギャップを埋めるように指示を更新します。
  • ガイダンスと自動化を分離します。マークダウンを使用して、意図とベストプラクティス、および繰り返し可能なアクションのスクリプトを説明します。これらの懸念事項を明確にしておくと、スキルの維持と再利用が容易になります。
  • スキルをバージョン管理します。スキルフォルダを Databricks Git フォルダでバックアップすると、変更の追跡、チームメイトとの共同作業、必要に応じたロールバックが可能になります。そのフォルダをワークスペース内の任意の場所に保持し、追加のスキルフォルダとして登録できるため、.assistant/skills/ にクローンを作成する必要はありません。

その他のリソース​