はじめに
Agentforceのエージェント開発を試したいけれど、最初の環境構築でつまずいた経験はありませんか。
オブジェクト定義、Apexクラス、Flow、Agent Script……用意するメタデータの種類が多く、手順を追うだけで疲れてしまいます。
sf CLIのsf template generate project -t agentを使うと、Apex・Prompt Template・Flowの3パターンを実装済みのサンプルエージェント一式が、コマンド一発でローカルに展開されます。
本記事では、このコマンドを起点にサンプルAgentを作る方法を解説します。
Agent project scaffoldingとは何か
Agent project scaffoldingは、Salesforce CLIのプロジェクトテンプレートの一つです。空のプロジェクトを一から組み立てるのではなく、動くサンプルエージェントが最初から入った状態でプロジェクトを作成できます。
Salesforce Developers Blogの Summer '26 開発者向けリリースまとめでは、次のように説明されています。
Agent project scaffolding: Spin up a runnable Agentforce sample instead of starting from scratch. The agent template generates a Local Info Agent demonstrating Apex, Prompt Template, and Flow subagents.
(エージェントプロジェクトのスキャフォールディング:ゼロから始めるのではなく、実行可能なAgentforceサンプルを起動します。エージェントテンプレートは、Apex、プロンプトテンプレート、およびフローサブエージェントを示すローカル情報エージェントを生成します。)
agentテンプレートを指定すると、「Local Info Agent」という名前のサンプルエージェントが生成されます。地域の天気やイベント情報、施設の営業時間を案内するという想定で作られたエージェントで、Apex・Prompt Template・Flowという3種類の異なるバックエンドを持つサブエージェントがそれぞれ組み込まれています。要するに、家具も家電もそろったモデルルームを渡されるようなものです。間取り(構造)を見ながら、自分の用途に合わせて棚を入れ替えたり壁紙を変えたりする感覚で開発を始められます。
Apex・Prompt Template・Flowという3つの実装パターンが最初から並んでいる点が実用的です。実際の業務では「この処理はFlowで十分か、Apexが要るか」を毎回判断する必要がありますが、3種類とも動く状態でサンプルに入っているので、それぞれの書き方や使い分けをコードを読みながら学べます。
実際に使う手順
プロジェクトの生成には、sf template generate projectコマンドにテンプレート指定のオプションを付けて実行します。
sf template generate project -n my-agent-project -t agent
このコマンドを実行すると、Local Info Agentのメタデータ一式(サブエージェント定義・Apexクラス・Flow・Prompt Templateなど)が入った新しいDXプロジェクトフォルダが作成されます。
CLIは週次でアップデートされているため、細かいオプション名は変わることがあります。手元で実行する前にsf template generate project --helpで最新のオプションを確認してください。
プロジェクトができたら、あとは通常のAgentforce開発の流れに乗せていきます。
validateでAgent Scriptの構文チェックをして、
preview startでライブのアクションを使った動作確認をします。
ここで意図通りに動くことを確認できたら、publishでバージョンを確定し、
activateで公開する、という流れです。
開発の流れ全体像
Agent project scaffoldingは単体でも便利ですが、真価を発揮するのはClaude CodeやCodex、Agentforce VibesといったコーディングエージェントとSalesforce Agent Skillsを組み合わせたときです。
Salesforce Developers Blogの「Master the Agentic Development Lifecycle for Agentforce」という記事では、developing-agentforce・testing-agentforce・observing-agentforceという3つのAgent Skillsが紹介されています。
これらはオープンソースのforcedotcom/sf-skillsリポジトリで公開されていて、コーディングエージェントに「Salesforceの作法」を教え込む役割を持ちます。スキルを入れておけば、プロジェクトのスキャフォールディングから、認証情報を守るスクラッチ組織の作り方、デプロイの失敗を自動で読み取って直す「fix-and-retry」ループまで、コーディングエージェントが一連の流れを把握した状態で動いてくれます。
skillの入れ方は以下で詳しく説明しています。
正直、「AIに設計から丸投げしていいのか」と少し身構えたのですが、公式ブログが推奨しているのは丸投げではなく設計主導の進め方でした。ビルドの前に一度立ち止まり、コーディングエージェントに「データモデル・アクション・権限・エージェント構造について、一問ずつ聞いてから提案してほしい」と指示して設計を固めてから実装に入る、という手順です。Claude CodeであればShift+Tabでプランモードに切り替えられます。ここで手を抜くと、あとで作り直す羽目になりかねません。
つまり、サンプルから始めて全体構造を把握し、設計を固めてから作り込むという順番を守れば、スクラッチから作るより早く、かつ壊れにくいエージェントに辿り着けます。
ここは注意!つまずきポイント
Agent Scriptでの開発には、Agentforceライセンスに加えてAPI v66.0以降、そしてEinstein Agent Userの設定が必要です。この設定が抜けていると、プレビュー実行時に権限エラーで止まることがあるので注意してください。
開発中は必ずスクラッチ組織かSandboxを使い、本番組織にはコーディングエージェントを近づけない運用にしましょう。パスワードなどの秘匿情報をプロンプトに直接貼り付けるのも避けたいところです。公式ブログでも、秘匿情報を扱うコマンドはコーディングエージェントを介さない別ターミナルで実行することが推奨されています。
Local Info Agentはあくまでサンプルです。そのまま公開せず、実際の業務要件に合わせてサブエージェントやアクションを組み替えてから使ってください。Agentforce自体の利用にはAgentforceライセンスや推論エンジンの利用枠(Flex Credits)が関わってくるため、対象エディションや追加費用の詳細は公式の価格ページで最新情報を確認することをおすすめします。
まとめ
- Agent project scaffoldingは、
agentテンプレートで動くサンプルエージェント(Local Info Agent)ごとプロジェクトを生成できるSummer '26のCLI機能です - Local Info AgentはApex・Prompt Template・Flowの3種類のサブエージェントを含み、実装パターンを見比べながら学べます
-
sf template generate project -t agentでプロジェクトを作り、validate・preview・publish・activateという通常の流れでデプロイします - Salesforce Agent Skills(developing-agentforce等)をコーディングエージェントに入れておくと、設計からデバッグまでを一貫してサポートしてもらえます
- Agentforceライセンスや権限設定、本番環境の取り扱いには注意が必要です
まずはサンプルを動かして構造をつかむところから、少しずつ慣れていきましょう!
現場での気づきをnoteで発信しています。
→ note