Agentforce DX実装ガイド｜Salesforceエージェントのコード管理とCLI活用術

どんな取り組みか
使われた技術スタック
実装のポイント
得られた成果や学び
まとめ

どんな取り組みか

Agentforceは、ブラウザ上のUI（Agentforce Builder）で設定を行うイメージが強いかもしれませんが、チーム開発や本番・サンドボックス環境間での設定移行を考えると、バージョン管理の必要性が生じます。この課題を解決するのが「Agentforce DX」です。

Agentforce DXは、Salesforce CLIとVisual Studio Code（VS Code）を用いて、Agentforceのエージェントをコードとして開発・管理するためのツールセットです。これにより、エージェントの設定をSalesforceのメタデータとして扱い、Gitなどのバージョン管理システムで管理したり、CI/CDパイプラインに組み込んだりすることが可能になります。つまり、エージェント開発を他のSalesforceカスタマイズと同様に、コードベースで体系的に管理する取り組みです。

使われた技術スタック

Agentforce DXを始めるために必要なツールは主に以下の3つです。

Visual Studio Code (VS Code): コードを編集するためのエディタ。公式サイトからインストールします。
Salesforce Extension Pack: VS Code用のSalesforce開発に特化した拡張機能セットです。VS CodeのMarketplaceからインストールすることで、Agentforce DXに必要な以下の拡張機能がまとめて導入されます。
- Agentforce DX: エージェントのメタデータを操作するための基本ツール。
- Agent Script Language Server: エージェントスクリプトの入力補完や構文検証をサポートします。
- Agentforce Vibes: AIアシスト機能により、コードの生成や補完を支援します（旧称: Agentforce for Developers）。
Salesforce CLI: コマンドラインからSalesforce組織を操作するためのツール。公式ガイドに従ってインストールします。

Salesforce Extension Packを導入すれば、必要な開発環境が一度に整うため、セットアップは比較的シンプルです。

実装のポイント

Agentforce DXを効果的に活用するための主要なポイントを解説します。

エージェントのメタデータ構造

Salesforce DXプロジェクトにおいて、エージェントはAiAuthoringBundleというメタデータ型で管理されます。このバンドルは、主に2つのファイルで構成されています。

aiAuthoringBundles/
└── My_Bundle/
    ├── My_Bundle.bundle-meta.xml
    └── My_Bundle.agent

.agentファイルが「エージェントスクリプト」と呼ばれる、エージェントの動作を定義する中心的なファイルです。これはApexクラスにおける.clsファイルに相当します。エージェントスクリプトは、LLMに判断を委ねる自然言語の指示と、確定的なロジックを記述するプログラム的な条件式を組み合わせて記述できます。VS Codeでは、このスクリプトファイルに対してシンタックスハイライトやオートコンプリートが機能するため、効率的なコーディングが可能です。

sf agentコマンドの基本

Salesforce CLIには、エージェントを操作するためのsf agentコマンドグループが用意されています。以下に主要なコマンドを紹介します。

エージェントユーザーの作成: Agentforceが動作するためには専用の「エージェントユーザー」が必要です。以下のコマンドで、必要なプロファイルと権限セットが割り当てられたユーザーを自動で作成できます。
```
sf org create agent-user --target-org <org-alias>
```
エージェントのプレビュー: CLIから対話形式でエージェントの動作をテストできる機能です。この機能はSummer ’26リリースで一般提供（GA）となりました。CI/CDでの自動テストにも活用できます。
```
sf agent preview start
sf agent preview send
sf agent preview end
```

Gitによるバージョン管理

Agentforce DXの最大の利点は、エージェントをGitで管理できることです。基本的な開発フローは以下のようになります。

ローカルのDXプロジェクトでエージェントスクリプトを編集する。
sf project deploy startコマンドでサンドボックスにデプロイし、動作を確認する。
Agentforce BuilderのUIで微調整した内容をsf project retrieve startコマンドでローカルに反映させる。
変更内容をGitにコミットし、GitHubなどのリモートリポジトリにプッシュする。

このように、ローカルでのコード編集とブラウザUIでの操作を柔軟に使い分けながら開発を進めることができます。

開発時の注意点

開発をスムーズに進めるために、以下の点に注意が必要です。

サンドボックスとスクラッチ組織の選択: 開発環境としてサンドボックスとスクラッチ組織のどちらを使うかは、「Data 360（Agentforce Data Libraries）」を利用するかどうかで判断します。Data 360が必要な場合はサンドボックスが必須であり、Salesforceもエージェント開発にはサンドボックスを推奨しています。不要な場合は、手軽に作成・破棄できるスクラッチ組織が利用できます。
「サブエージェント」と「トピック」の混同: 過去のドキュメントでは「Topic（トピック）」と呼ばれていた機能が、現在では「サブエージェント（Subagent）」という正式名称に変更されています。機能は同じですが、古い資料を参照する際は注意が必要です。
権限設定: Agentforce DXの操作には特定のシステム権限が必要です。例えば、オーサリングバンドルの公開には「すべてのデータの変更」と「AI エージェントの管理」、プレビュー機能の利用には「Agent Platform Builder」権限が求められます。コマンド実行時にエラーが発生した場合は、まず権限設定を確認することが推奨されます。

得られた成果や学び

Agentforce DXを導入することで、エージェント開発を属人的なUI操作から、体系的なコード管理へと移行できます。これにより、Gitを用いたバージョン管理が可能となり、変更履歴の追跡やチームでの共同作業が格段に容易になります。また、サンドボックスと本番環境間のデプロイも、他のメタデータと同様にCLIコマンドで実行できるため、開発プロセス全体の効率化と品質向上に繋がります。最初は新しい概念に戸惑うかもしれませんが、一度慣れれば、従来のSalesforce開発と同じ感覚でエージェントを扱えるようになります。