アーティファクトパネル（プレビュー）
Visual Studio Codeのアーティファクトパネルは、チャットの会話と並行して、スクリーンショット、計画書、ドキュメントなどの重要なリソースを表示します。アーティファクトは複数のソースから同時に取得でき、ソースごとにグループ化された折りたたみ可能なツリーコントロールに表示されます。
アーティファクトパネルは現在プレビュー版です。有効にするには、 chat.artifacts.enabled を true に設定してください。
アーティファクトのソース
アーティファクトは異なるソースからパネルに表示されることがあり、それらは統合され、発生元ごとにグループ化されます。
- ルールベースの抽出: VS Codeは、設定可能なMIMEタイプパターン、ファイルパスのグロブ（ワイルドカード）、またはメモリ上のファイルパスに基づいて、会話の内容から自動的にアーティファクトを抽出します。例えば、組み込みルールによってスクリーンショットや計画ドキュメントが表示されます。詳細は アーティファクト抽出ルールの設定 を参照してください。
- エージェント設定のアーティファクト: エージェントが
#artifactsツールを使用して明示的にアーティファクトを設定します。更新のたびに、それまでのエージェントのアーティファクトリストが置き換えられます。 - サブエージェントのアーティファクト: エージェントがサブエージェントに作業を委任する場合、各サブエージェントは独自のアーティファクトを設定でき、サブエージェント名でラベル付けされた個別のグループに表示されます。
アーティファクト抽出ルールの設定
ルールベースの抽出では3つの設定を使用し、それぞれがパターンをグループ構成にマッピングします。グループ構成には groupName（表示ラベル）と、オプションの onlyShowGroup フラグ（true の場合、個々のアイテムではなくグループヘッダーのみが表示されます）が含まれます。
| 設定 | 説明 | 既定値 |
|---|---|---|
| chat.artifacts.rules.byMimeType | "image/*" のようなMIMEタイプパターンでツール結果を照合します。 |
{ "image/*": { "groupName": "Screenshots", "onlyShowGroup": true } } |
| chat.artifacts.rules.byFilePath | "**/*plan*.md" のようなグロブパターンでワークスペースファイルを照合します。 |
{ "**/*plan*.md": { "groupName": "Plans" } } |
| chat.artifacts.rules.byMemoryFilePath | "**/*plan*.md" のようなグロブパターンでメモリツールへの書き込みを照合します。 |
{ "**/*plan*.md": { "groupName": "Plans" } } |
例えば、エージェントによって作成されたHTMLファイルをアーティファクトとして表示するルールを追加するには、設定に以下を追加します。
"chat.artifacts.rules.byFilePath": {
"**/*.html": { "groupName": "Web Pages" }
}
ルールベースの抽出を完全に無効にするには、これら3つのルール設定すべてを {} に設定します。
アーティファクトの使用
アーティファクトが利用可能な場合、会話と並んでアーティファクトパネルが表示されます。アーティファクトはそのソースに基づいてグループごとに整理されます。
- アーティファクトを選択すると、対応するリソースが開きます。例えば、画像アーティファクトを選択するとプレビューが表示され、ドキュメントアーティファクトを選択するとエディターでファイルが開かれます。
- エージェントによるアーティファクトは、エージェントが更新するたびに、前回のリストを置き換えます。
- 各サブエージェントのアーティファクトは個別のグループに表示されます。特定のサブエージェントのアーティファクトを個別にクリアすることもできます。
- ルールベースのアーティファクトは、会話の進行に合わせて自動的に更新されます。ルール設定を変更すると、アーティファクトパネルに変更が反映されます。
エージェントにアーティファクトの作成を依頼する
プロンプトで目的を説明することで、エージェントに何かをアーティファクトとして保存するように依頼できます。例:
- "アプリのスクリーンショットを撮って、アーティファクトとして設定して"
- "プロジェクト計画書を作成して、アーティファクトとして設定して"
- "これらのリンクをアーティファクトとして保存して"
エージェントは #artifacts ツールを使用して、そのリソースをアーティファクトパネルに追加します。ツールを直接指定する必要はありません。保存したい内容を説明するだけで、エージェントがいつアーティファクトとして表示するかを判断します。
エージェントは #artifactRules ツールを使用して、現在のセッションの抽出ルールを上書きすることもできます。これは、セッション期間中、設定に基づくルールを置き換えます。