Skip to main content

Agentforce DX の使用開始

学習の目的

このプロジェクトでは、次のことを行います。

  • Agentforce DX がエージェントの構築にどのように役立つか説明する。
  • Agentforce DX 開発環境を設定する。
  • サンプルエージェントを含むリポジトリを DX プロジェクトにコピーする。
メモ

メモ

日本語で受講されている方へ
Challenge は日本語の Trailhead Playground で開始し、かっこ内の翻訳を参照しながら進めていってください。Challenge での評価は英語データを対象に行われるため、英語の値のみをコピーして貼り付けるようにしてください。日本語の組織で Challenge が不合格だった場合は、(1) この手順に従って [Locale (地域)] を [United States (米国)] に切り替え、(2) [Language (言語)] を [English (英語)] に切り替えてから、(3) [Check Challenge (Challenge を確認)] ボタンをクリックしてみることをお勧めします。

翻訳版 Trailhead を活用する方法の詳細は、自分の言語の Trailhead バッジを参照してください。

Coral Cloud Resorts + Agentforce DX

おめでとうございます! Coral Cloud Resorts の開発チームに採用されたあなたは、早速コーディングを始めようと意気込んでいます。新しいマネージャーから、チームは現在エージェントの開発に精力的に取り組んでいるという説明を受けました。お客様に現地の天気予報やイベント情報を伝える「ローカル情報エージェント」の開発が始まっており、あなたはそのプロジェクトを引き継ぐことになります。けれども、Salesforce でエージェントを開発したことがないため、基本事項を学ぶトレーニングが必要です。ということで、次のように定義します。

現代の開発者であるあなたは、GitHub のようなバージョン管理システムにエージェントのソースコードを保存することや、エージェントの開発やテストを継続的インテグレーション (CI) ジョブに組み込むことなど、最新の開発ツールには慣れています。ですから、Agentforce DX があなたの役に立ちそうです。

嬉しそうに飛び跳ねている Codey

Agentforce DX とは?

これまでは、エージェントの構築に Agentforce Builder UI を使っていたかもしれません。これは、コードではなく、クリック操作でエージェントを作成するローコードの手段です。ただし、AI を最新の DevOps パイプラインに組み込むためには、ブラウザーの域を出て、Agentforce Developer Experience (DX) というプロコードの世界に足を踏み入れる必要があります。DX に移行すると、エージェントのロジックをソースコードとして処理し、リポジトリでバージョンを管理して、各自の Apex や Lightning コンポーネントと共にエージェントを実装できます。

Salesforce 開発者であれば、Salesforce DX をすでにご存じかと思います。Salesforce Platform でアプリケーションを構築してテストし、配信するプロコードのツールセットです。このツールは Agentforce バイブス、Visual Studio Code (VS Code) 拡張機能、Salesforce CLI などで構成されます。Agentforce DX は、こうしたツールをエージェントと連動するように拡張します。

エージェントは、Salesforce のほかのカスタマイズと同じようにメタデータで構成されます。Agentforce DX には、Agentforce Builder UI を使用せずにエージェントを作成、変更、プレビュー、テストできるプロコードツールが用意されています。また、エージェントのメタデータを DX プロジェクトと、使用するスクラッチ組織、Sandbox、本番組織間で移動できます。こうした機能を使用して、エージェントを最新のソフトウェア開発プロセスに組み込むことができます。

Agentforce 用の Developer Edition 組織にサインアップする

このプロジェクトを実行するには、Agentforce とサンプルデータが搭載された特別な Developer Edition 組織が必要です。無料の Developer Edition を入手して Trailhead に接続し、このプロジェクトの Challenge を実行できるようにします。この Developer Edition は、このバッジの Challenge 向けに設計されているため、ほかのバッジでは機能しないことがあります。使用している Trailhead Playground や特別な Developer Edition 組織が推奨されているものであることを必ず確認してください。

  1. Agentforce を搭載した無料の Developer Edition 組織にサインアップします。
  2. フォームに記入します。
    • [Email (メール)] に、有効なメールアドレスを入力します。
    • [Username (ユーザー名)] に、一意のメールアドレス (例: yourname@test.com) を入力します。実際のアカウントである必要はありません。
  3. フォームに入力したら [Sign me up (サインアップ)] をクリックします。確認メッセージが表示されます。
  4. アクティベーションメールを受信したら (数分かかる場合があります)、そのメールを開いて [Verify Account (アカウントを確認)] をクリックします。
  5. パスワードと確認用の質問を設定して、登録を完了します。
    • アクセスしやすいように、ユーザー名、パスワード、ログイン URL を安全な場所 (パスワードマネージャーなど) に保存しておくことをお勧めします。この情報は、後ほど Developer Edition 組織を使用できるように Salesforce CLI を認証するときに必要になります。
  6. Developer Edition にログインした状態になります。

新しい Developer Edition 組織を Trailhead に接続します。

  1. Trailhead アカウントにログインしていることを確認します。
  2. このページの最下部にある「Verify Step (ステップを確認)」セクションで、表示されているハンズオン組織をクリックし、[Connect Org (組織を接続)] をクリックします。
  3. ログイン画面で、設定したばかりの Developer Edition のユーザー名とパスワードを入力します。
  4. [Allow Access? (アクセスを許可しますか?)] 画面で [Allow (許可)] をクリックします。
  5. [この組織をハンズオン Challenge 用に接続しますか?] 画面で [はい! 保存します。] をクリックします。Challenge ページにリダイレクトされたら、このバッジの獲得を目指して新しい Developer Edition を使用できます。

Developer Edition 組織で Agentforce を有効にする

Agentforce DX を使用してエージェントを開発するには、Developer Edition 組織で Agentforce を 有効にします。

  1. Developer Edition 組織にログインし、右上の設定ギアアイコンをクリックします。
  2. ドロップダウンメニューの [Setup (設定)] をクリックします。
  3. [Quick Find (クイック検索)] ボックスに Einstein Setup (Einstein 設定) と入力し、[Einstein Setup (Einstein 設定)] をクリックします。
  4. [Turn on Einstein (Einstein を有効化)] 切り替えが [On (オン)] になっていることを確認します。
    Einstein が有効化されていることを示す [Setup (設定)] の [Einstein Setup (Einstein 設定)] ページ。
  5. [Quick Find (クイック検索)] ボックスに Einstein Bots (Einstein ボット) と入力し、[Einstein Bots (Einstein ボット)] をクリックします。
  6. [Einstein Bots (Einstein ボット)] を [On (オン)] に切り替えます。
    Einstein ボットが有効であることを示す [Setup (設定)] の [Einstein Bots (Einstein ボット)] ページ。
  7. [Quick Find (クイック検索)] ボックスに Salesforce Go と入力し、[Salesforce Go] を選択します。
  8. [Search features... (機能を検索...)] テキストボックスに Agentforce と入力し、[Agentforce (Default) (Agentforce (デフォルト))] を選択します。
  9. [使用開始] をクリックします。
  10. [Turn On (有効化)] をクリックします。
    [Turn On (有効化)] ボタンが表示されている、Salesforce の [Agentforce (Default) (Agentforce (デフォルト))] 設定ページ。
  11. [Confirm (確認)] をクリックします。

開発環境を設定する

次に、ローカル開発環境を設定します。Coral Cloud Resorts の開発チームは、VS Code と CLI コマンドの両方を使用してエージェントを構築しています。VS Code は統合開発環境 (IDE) で、コードエディター、ビルド自動化ツール、デバッガー、インテリジェントなコード補完ツールを備えています。

Salesforce 開発者で、Salesforce のプロコードツールを使用しているのであれば、おそらく VS Code (と Salesforce 拡張機能) や Salesforce CLI をすでにコンピューターにインストールしているのではないかと思います。同じ設定を使用できますが、VS Code のすべての機能を必ず最新のリリースに更新してください。Node.js もコンピューターにインストールする必要があります。

次の手順に従って、各自の環境を設定します。

  1. VS Code をコンピューターにインストールするために、code.visualstudio.com にアクセスして、[Download (ダウンロード)] をクリックします
  2. VS Code マーケットプレイスから Salesforce Extension Pack をインストールします。拡張機能のうち、Agentforce DX と Agentforce バイブスの 2 つは自動的にインストールされます。
  3. Salesforce CLI をインストールします。
  4. Node.js をインストールします。
    現時点で Node.js をコンピューターにグローバルにインストールして、この単元の後半で設定スクリプトを実行できるようにします。

サンプルリポジトリをコピーする

前述のとおり、開発チームはローカル情報エージェントの開発に着手しており、ソースコードを GitHub リポジトリにチェックインしています。ソースコードには標準の Salesforce DX プロジェクトが使用され、このプロジェクト構造に従って組織のメタデータ (コードと設定)、サンプルデータ、チームのすべてのテストが整理されています。エージェントは Salesforce 組織のほかの要素と同様にメタデータで構成されているため、エージェントの保存や作業にも DX プロジェクトを使用します。

Note

VS Code でリポジトリをコピーできるように、各自のコンピューターに Git がインストールされていることを確認します。または、サンプルリポジトリを ZIP ファイル形式でダウンロードして、ローカルで解凍することも可能です。

次の手順に従って、Git を使用してサンプルリポジトリをコピーすれば、エージェントのコーディングを開始できます。

  1. VS Code を開き、[View (表示)] | [Command Palette (コマンドパレット)] をクリックして、[Git: Clone (Git: コピー)] を選択します。
  2. リポジトリ URL に https://github.com/forcedotcom/afdx-pro-code-testdrive と入力します。
  3. ソースコードを配置するディレクトリに移動して、[Select as Repository Destination (リポジトリの保存先として選択)] をクリックします。
  4. [Open (開く)] をクリックします。

VS Code に、afdx-pro-code-testdrive という標準の Salesforce DX プロジェクトが表示されます。既存のコードを自由に確認できます。このバッジの後半で、エージェントに関連するアーティファクトについて説明します。

エクスプローラーパネルに「afdx-pro-code-testdrive」という Salesforce DX プロジェクトが開いている VS Code。

Developer Edition 組織を認証する

Developer Edition 組織のユーザー名とパスワードを使用してその組織をローカルで認証し、VS Code と CLI コマンドを組織で使用できるようにします。

  1. VS Code で、[View (表示)] | [Command Palette (コマンドパレット)] をクリックして [SFDX: Authorize an Org (SFDX: 組織を認証)] を選択します。
  2. [Product (製品)] をクリックします。
  3. 組織の別名として agentforce と入力します。
  4. 開いたブラウザーウィンドウで、ログイン情報を使用して Developer Edition 組織にサインインします。
  5. [Allow (許可)] をクリックします。これにより、Salesforce CLI が組織にアクセスできるようになります。
    [Authentication Successful (認証に成功しました)] メッセージを確認します。
  6. ブラウザーウィンドウを閉じます。

これで、Developer Edition 組織が認証され、デフォルト組織として設定されました。

スクリプトを実行して、組織に必要なアーティファクトを作成してリリースする

コピーしたサンプルリポジトリには、新しいローカル情報エージェントを実装するアーティファクト (Apex クラス、プロンプトテンプレート、フローなど) のソースファイルが含まれます。こうしたアーティファクトの説明はこのモジュールの範疇を超えていますが、 この Trailhead バッジを続行するためには、Developer Edition 組織にこうしたアーティファクトが必要なため、コピーしたリポジトリにスクリプトが用意されています。

このスクリプトを実行すると、ソースファイルがリリースされ、権限が割り当てられ、エージェントユーザーが作成されます。Agentforce エージェントは、「Einstein エージェントユーザー」プロファイルを有する専用ユーザーとして実行されます。このユーザーがエージェントのランタイム ID になります。

  1. VS Code 統合ターミナルから、設定スクリプトを実行します。
    ./setup (macOS または Linux)
    setup.cmd (Windows)
  2. このスクリプトが実行する手順を示し、各ステップが正常に完了すると緑のチェックマークが表示されます。
    重要: このスクリプトで作成される一意のユーザー名は次の単元で必要になるため、保存しておきます。
    実行中の設定スクリプトと、新たに生成されたユーザー名が強調表示されている VS Code の統合ターミナル。

エージェントコマンドを表示する

agent コマンドを使い始める前に、その内容を確認します。CLI コマンドの大半は、VS Code のコマンドパレットに相当するものがあり、そうしたコマンドも使用します。すべての CLI コマンドを確認すれば、Agentforce DX で何ができるのかをざっと理解することができます。

  1. VS Code 統合ターミナルから sf search CLI コマンドを実行すると、使用可能な agent コマンドがすべて表示されます。リストをスクロールしていくと、下部にコマンドの概要が示されます。
    Salesforce CLI コマンド「sf search」を実行している統合ターミナルが表示されている VS Code。
    次のコマンドを実行すると、agent コマンドを含む Salesforce CLI プラグインの技術的な情報が示されます。
    sf plugins inspect agent
  2. コマンドに --help フラグを付けて実行すると、そのコマンドの詳しい説明 (フラグ、使用法の例など) が表示されます。-h を使用すると、簡潔な説明が表示されます。
    sf agent validate authoring-bundle --help

この Trailhead バッジでは、agent validate authoring-bundle と agent publish authoring-bundle という CLI コマンド、またはこの 2 つに相当する VS Code コマンドを中心に説明します。

Agentforce DX について学習し、開発環境を設定したところで、「エージェントのコーディング」というお楽しみに進みましょう。

リソース

Salesforce ヘルプで Trailhead のフィードバックを共有してください。

Trailhead についての感想をお聞かせください。[Salesforce ヘルプ] サイトから新しいフィードバックフォームにいつでもアクセスできるようになりました。

詳細はこちら フィードバックの共有に進む