エージェントのスキルでアシスタントを拡張する
ドメイン固有のタスクに特化した機能を使用して、エージェント モードで Databricks Assistant を拡張するスキルを作成します。このページでは、スキルを作成して最適化する方法について説明します。
スキルとは何ですか?
特殊な機能でアシスタントを拡張するスキルを作成します。スキルは、エージェント スキルのオープン スタンダードに準拠します。スキルは、特定のタスクを実行するためにアシスタントが必要に応じて読み込むことができるドメイン固有の知識とワークフローをパッケージ化します。スキルには、ガイダンス、ベスト プラクティス、再利用可能なコード、実行可能なスクリプトなどが含まれます。
スキルはドメイン固有のタスクに合わせて調整する必要があります。スキルを使用すると、指示よりも多くのコンテキスト (スクリプト、例、その他のリソースなど) をタスクに提供できます。グローバルに適用されるカスタム命令とは異なり、スキルは関連するコンテキストでのみ自動的に読み込まれます。エージェント モードでは、アシスタントはユーザーのリクエストとスキルの説明に基づいて、関連するスキルを自動的に読み込みます。これにより、効率的なコンテキスト ウィンドウが維持され、複数のチャットにわたって同じコンテキストを提供する必要性が軽減されます。
スキルは、Databricks Assistantエージェント モードでのみサポートされます。
スキルを作成する
新しいスキルを作成するには:
-
ユーザーワークスペースフォルダーに、新しいスキルフォルダーを作成します。フォルダー パスは次のようになります:
/Users/{username}/.assistant/skills/。作成後、アシスタント パネルでこのフォルダーにすぐにアクセスできます。クリック
設定 をクリックし、 
スキルフォルダを開きます 。 -
スキル用の
SKILL.mdファイルを作成します。スキルはエージェント スキルの仕様に従います。 -
スキルに必要なフロントマターを追加します。
---
name: skill-name
description: A description of what this skill does and when to use it.
--- -
フロントマターの後に、スキルの説明を Markdown 形式で追加します。次のセクションを含めることをお勧めします。
- ステップバイステップの説明: 明確な手順ガイド
- 例: サンプル入力と期待される出力
- エッジケース: 一般的なバリエーションと例外
-
(オプション) より複雑なスキルの場合は、追加のリソースを提供して参照することができます。
- エージェントが実行できる実行可能コードを含むスクリプト。
- ベスト プラクティスやテンプレートなど、参照するための追加ドキュメントを含むファイル。
他のファイルを参照する場合は、ルート スキルからの相対パスを使用します。
たとえば、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 は、次回エージェント モードで使用するときに、自動的にスキルを取得します。
ベストプラクティス
効果的なスキルを書くには、次のガイドラインに従ってください。
- スキルを集中させましょう。スキルは、単一のタスクまたはワークフローに焦点を当てた場合に最も効果を発揮します。スコープを狭くすると、スキルが適用されるタイミングをアシスタントが認識しやすくなります。
- 明確な名前と説明を使用してください。簡潔でわかりやすい名前と概要は、アシスタントが適切なスキルを適切なリクエストに一致させるのに役立ちます。
- 明確に、例を挙げて説明してください。ワークフローをステップごとに説明し、アシスタントが再利用できる具体的な例やパターンを含めます。
- 不必要なコンテキストを避けてください。タスクに必要な情報のみを含めます。詳細を追加すると、スキルを確実に適用することが難しくなる可能性があります。
- 時間をかけて繰り返します。スキルを生きたワークフローとして扱います。実際の使用状況に基づいた小さな更新により、結果が大幅に改善される可能性があります。
- ガイダンスと自動化を分離します。マークダウンを使用して、意図とベストプラクティス、および繰り返し可能なアクションのスクリプトを説明します。これらの懸念事項を明確にしておくと、スキルの維持と再利用が容易になります。