次の方法で共有

エージェント スキルを使用してアシスタントを拡張する

ドメイン固有のタスクに特化した機能を使用して、エージェント モードで Databricks Assistant を拡張するスキルを作成します。 このページでは、スキルを作成して最適化する方法について説明します。

スキルとは

特殊な機能を使用してアシスタントを拡張するスキルを作成します。 スキルは 、エージェント スキルのオープン 標準に従います。 スキル は、特定のタスクを実行するために関連する場合にアシスタントが読み込むことができるドメイン固有の知識とワークフローをパッケージ化します。 スキルには、ガイダンス、ベスト プラクティス、再利用可能なコード、実行可能スクリプトを含めることができます。

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

注

スキルは、Databricks Assistant エージェント モードでのみサポートされます。

スキルの作成

スキルは、 /Users/{username}/.assistant/skills/ ディレクトリに格納されます。 各スキルには、独自のフォルダーと、そのフォルダー内の SKILL.md ファイルが必要です。

新しいスキルを作成するには:

  1. ユーザー ワークスペース フォルダーに、新しいスキル フォルダーを作成します。 フォルダー パスは次のようになります: /Users/{username}/.assistant/skills/。

    作成後、アシスタント パネルでこのフォルダーにすばやくアクセスできます。 歯車 アイコン をクリックして、[設定] を選択し、矢印 アイコンをクリックして、スキルフォルダーを開きます。

  2. スキル フォルダー内にスキル専用のフォルダーを作成します。 各スキルには、独自のフォルダーが必要です。 たとえば、個人用ワークフローのスキルを作成する場合、フォルダー構造は次のようになります。

    /Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. スキル フォルダー内に、 SKILL.md ファイルを作成します。 このファイルは必須であり、スキルを定義します。 スキルは エージェント スキルの仕様に従います。

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

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. フロントマッターの後に Markdown 形式のスキル命令を追加します。 次のセクションを含めるのが推奨されます。

    • ステップ バイ ステップの手順: 手順のガイダンスを明確にする
    • 例: サンプル入力と予想される出力
    • エッジ ケース: 一般的なバリエーションと例外

  6. (省略可能)より複雑なスキルを持つ場合は、追加のリソースを提供して参照できます。

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

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

    たとえば、ETL のベスト プラクティス、ダッシュボード テンプレート、パイプラインのセットアップとデプロイ用のスクリプトを参照する個人用ワークフロー スキルがあるとします。 スキルのフォルダーには、次のファイルを含めることができます。

    /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
         └── model-deploy.py     # Model deployment automation

Databricks Assistant は、次回エージェント モードでスキルを使用するときに自動的にスキルを取得します。

ベスト プラクティス

効果的なスキルを記述するには、次のガイドラインに従います。

  • スキルに集中する。 スキルは、1 つのタスクまたはワークフローに集中する場合に最適です。 スコープを狭くすると、アシスタントはスキルが適用されるタイミングを簡単に認識できます。
  • 明確な名前と説明を使用します。 簡潔でわかりやすい名前と概要は、アシスタントが適切なスキルを適切な要求に一致させるのに役立ちます。
  • 明示的で、例を用いる。 ワークフローを段階的に説明し、アシスタントが再利用できる具体的な例やパターンを含めます。
  • 不要なコンテキストを避けます。 タスクに必要な情報のみを含めます。 余分な詳細は、スキルを確実に適用するのが難しくなる可能性があります。
  • 時間をかけて反復処理する。 スキルを生きたワークフローとして扱います。 実際の使用状況に基づく小さな更新によって、結果が大幅に向上する可能性があります。
  • ガイダンスと自動化を分離します。 Markdown を使用して、意図とベスト プラクティス、および反復可能なアクションのスクリプトについて説明します。 これらの懸念事項を明確に保つことで、スキルの維持と再利用が容易になります。

こちらも参照ください

  • Last updated on