{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"Salesforce Agentforce を Treasure AI Studio に接続する","description":"静的トークン方式の MCP エンドポイントで Salesforce Agentforce を Treasure AI Studio に接続し、Studio のアクションやチャットを実行できる Employee Agent を構築する手順を解説します。","siteUrl":"https://docs.treasure.ai","image":"/assets/treasure-ai-social-preview.e6fefb35676f6da91c2d1bc783bd39e618e7af2b1ad3aa52a96ae69d72e700fe.b1bff462.png","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"salesforce-agentforce-を-treasure-ai-studio-に接続する","__idx":0},"children":["Salesforce Agentforce を Treasure AI Studio に接続する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["静的トークン（指定した実行者）"]}," 方式の MCP エンドポイントを Salesforce の Agentforce Registry に登録し、その 6 つのツールを Agentforce Employee Agent に割り当てることで、Salesforce Agentforce を ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/"},"children":["Treasure AI Studio"]}," に接続できます。これにより、マーケティング担当者やビジネスユーザーは、Marketing Cloud のインストール済みパッケージやローカルの ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx mcp"]}," プロセスを使わずに、Salesforce Lightning のパネルから直接顧客データの照会、オーディエンスの確認、保存済み Studio アクションの実行を行えます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["普段 Salesforce Lightning 内で業務を行っており、Agentforce から Treasure AI Studio の結果を取得したい場合にこのガイドを利用してください。この連携では、ユーザーごとの OAuth ではなく Salesforce の Custom External Credential に保管した静的トークン方式の MCP エンドポイントを使用するため、エージェントにアクセスできるすべての Salesforce ユーザーは、エンドポイントに紐づく 1 人の共有実行者として動作し、その実行者の共有作業フォルダ・権限・クレジットを使用します。"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-architecture.7067bde648880615db213df160354419813bb53242b80132b077a62977b6d3b2.5866d770.webp","alt":"マーケティングユーザーが Salesforce Lightning の Agentforce Employee Agent に顧客データに関する質問を送信し、CDP サブエージェントが Authorization Bearer ヘッダー付き Streamable HTTP 経由で Treasure AI Studio の静的トークン MCP エンドポイントを呼び出して list_work_folders・list_actions・run_action・start_chat を実行し、結果を Lightning チャットパネルに要約して返す構成図","framed":false,"withLightbox":true,"width":"800px"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"接続の仕組み","__idx":1},"children":["接続の仕組み"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salesforce が MCP クライアントとして動作し、Treasure AI Studio が Streamable HTTP 経由でリモート MCP サーバーを提供します。2 つのプラットフォームにまたがって 3 つのロールが設定と利用に関わります。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"28%","data-label":"ロール"},"children":["ロール "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"32%","data-label":"作業場所"},"children":["作業場所 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","data-label":"作業内容"},"children":["作業内容 "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Studio 共有作業フォルダの管理者"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treasure AI Studio の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["設定 → エージェントチャネル"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["承認済みの共有作業フォルダを公開し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["静的トークン（指定した実行者）"]}," 方式の MCP エンドポイントを 1 つ作成して、接続 URL と生の Bearer トークンをコピーする"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salesforce 管理者"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Salesforce Lightning の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup"]}," および ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce Builder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["トークンを Custom External Credential に保存し、MCP サーバーを登録してツールを許可リストに追加し、MCP 権限セットを割り当て、Employee Agent を構築・有効化してエージェントアクセス権を付与する"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salesforce エンドユーザー"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Salesforce Lightning（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sales"]}," アプリなど）"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agentforce パネルを開いて Employee Agent を選択し、Treasure AI Studio のツールを呼び出すリクエストを送信する"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salesforce が登録済みエンドポイントに接続すると、Agentforce Registry は Treasure AI Studio の標準 MCP ツール 6 つを検出します。各ツールの詳細、引数、レスポンス仕様は ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/mcp-clients#%E3%83%84%E3%83%BC%E3%83%AB"},"children":["ツール"]}," を参照してください。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"28%","data-label":"ツールグループ"},"children":["ツールグループ "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"72%","data-label":"ツール"},"children":["ツール "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["読み取り専用"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_work_folders"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_actions"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_chat_result"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["書き込み / 実行"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["run_action"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_chat"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["continue_chat"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これらのツールから実行できるデータ操作の範囲は、Treasure AI Studio 側で設定された共有作業フォルダ、保存済みアクション、連携先、実行者の権限、およびクレジットに依存します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"前提条件","__idx":2},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce 対応の Salesforce Lightning"]},"：",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce Registry"]}," と ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Employee Agent Builder"]}," が利用可能な承認済み Salesforce Lightning 組織、および External Credential の作成、外部 MCP サーバーの登録、エージェントの構築・有効化、権限セット割り当てを行える Salesforce 管理者。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Studio の共有作業フォルダ"]},"：Salesforce ユーザーからアクセスしてよいアクションやファイルのみを含み、自分が",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["管理権限"]},"を持つ承認済みの",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/shared-folders/"},"children":["共有作業フォルダ"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["静的トークン方式 MCP エンドポイントの作成権限"]},"：Treasure AI Studio アカウントの作成ポリシー（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["設定 → エージェントチャネル"]},"）で静的トークン方式の MCP エンドポイントを作成できること。作成ポリシーが ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["アカウント管理者のみ"]}," に設定されており、自分がアカウント管理者でない場合、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["新規 MCP エンドポイント"]}," は無効になります。"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"環境固有の ID を別の組織へコピーしないでください"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Asset Library のアクション ID、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source"]},"・",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target"]}," 識別子、権限セット名は Salesforce 組織ごとに生成され、接続 URL・トークン・フォルダ ID も Treasure AI Studio のエンドポイントごとに異なります。後述のリファレンススクリプトから生成済み ID をコピーするのではなく、ご自身の組織で MCP サーバーを登録し、ご自身の Asset Library から 6 つのツールを追加してください。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-1studio-で静的トークン方式の-mcp-エンドポイントを作成する","__idx":3},"children":["手順 1：Studio で静的トークン方式の MCP エンドポイントを作成する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["静的トークン方式の MCP エンドポイントは 1 つの共有作業フォルダを公開し、すべての呼び出しをエンドポイントの実行者として実行します。共有作業フォルダの作成や公開がまだの場合は ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/shared-folders/sharing-a-work-folder"},"children":["作業フォルダを共有する"]}," を、エンドポイント管理の詳細は ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/mcp-endpoints"},"children":["静的トークン方式の MCP エンドポイント"]}," を参照してください。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Web 版または Desktop 版の Treasure AI Studio で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["設定 → エージェントチャネル"]}," を開きます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP エンドポイント"]}," セクションで ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["新規 MCP エンドポイント"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["接続方式"]}," は ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["静的トークン（指定した実行者）"]}," のままにし、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["エンドポイント名"]},"（例：",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Salesforce Agentforce MCP"]},"）と、必要に応じて",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["コメント"]},"を入力して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["次へ"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["管理権限を持つ承認済みの ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["共有作業フォルダ"]}," を選び、自分が ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["実行者"]}," として表示されている同意内容を確認したうえで、トークンの ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["有効期限"]},"（7 日、30 日、90 日、カスタム日付、または無期限）を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["エンドポイントを作成して最初のトークンを発行"]}," を選択します。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP クライアントを接続"]}," 完了画面に次の 2 つの値が表示されます。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["接続 URL"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://<アカウントの Agent Gateway>/v1/mcp/<エンドポイント ID>"]},"（US01 の場合は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://agent-gateway.us01.treasure.ai/v1/mcp/<エンドポイント ID>"]}," など）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["認証ヘッダー"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer tasgwt_<シークレット>"]},"。"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["両方の値をすぐにパスワードマネージャーまたはシークレット管理ツールに保存します。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["値を保管しました"]}," をオンにして ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["完了"]}," を選択します。エンドポイント詳細画面がステータス ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["有効"]}," で開きます。"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"完了画面を閉じる前にトークンを保存してください"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tasgwt_"]}," トークンが表示されるのはこの 1 回限りで、後から復元することはできません。紛失した場合は、エンドポイント詳細画面からトークンを失効させ、新しいトークンを発行してください。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-2salesforce-で-custom-external-credential-を設定する","__idx":4},"children":["手順 2：Salesforce で Custom External Credential を設定する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salesforce は Treasure AI Studio の静的トークンを Custom External Credential に保管し、カスタムヘッダーの数式を使って ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer"]}," ヘッダーを自動付与します。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Salesforce Lightning の右上にある歯車アイコンを選択し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup"]},"（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Cloud Setup"]}," ではない）を開きます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["左側の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quick Find"]}," ボックスに ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Agentforce"]}," と入力し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Einstein → Agentforce Registry"]}," の下にある ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Registered MCP Servers"]},"（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Registered APIs"]}," ではない）を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce Registry"]}," ページで ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New → Register MCP Server"]}," を選択します。このサーバーは Treasure AI がホストしているため、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Salesforce Server"]}," は選択しないでください。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-register-menu.6e3cca8bf8b93b9c9413a17abbae31e22352b822b0326ea53e5611feef890a91.5866d770.webp","alt":"Salesforce Setup のサイドバーで Einstein → Agentforce Registry → Registered MCP Servers が選択され、New メニューから Register MCP Server が強調表示されている画面","framed":false,"withLightbox":true,"width":"640px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Connection"]}," で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication Method"]}," を ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use External Credential"]}," に変更し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New External Credential"]}," を選択します。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Named Credentials"]}," タブが開いた場合は ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["External Credentials"]}," タブに切り替えて ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}," を選択してください（この手順では別途 Named Credential フォームを入力する必要はありません）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["次の値で External Credential を作成し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択します。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Label"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Treasure AI MCP"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Treasure_AI_MCP"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication Protocol"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Custom"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["保存された ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI MCP"]}," External Credential のラベルを選択して詳細画面を開きます。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Related Named Credentials"]}," が空であってもそのまま次の手順に進みます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Principals"]}," の下にある ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}," を選択し、次の設定で名前付きプリンシパルを作成して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択します。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameter Name"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureMCPPrincipal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sequence Number"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Type"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Named Principal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication Parameters"]},"：",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]}," を選択し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," に ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BearerToken"]}," を入力します。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}," には手順 1 の認証ヘッダーから ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tasgwt_"]}," で始まる生のトークンのみを貼り付けます。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization:"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer"]},"、引用符、前後の空白は含めないでください（次の手順のカスタムヘッダー数式が ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer "]}," プレフィックスを付与します）。"]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-edit-principal.3f0a3ea3bd3715771a08e6cc75f3f7c400ea155c84f8986c6f0badbc2aa02bc3.5866d770.webp","alt":"Salesforce の Edit Principal ダイアログ。Parameter Name に TreasureMCPPrincipal、Sequence Number に 1、Identity Type に Named Principal、Authentication Parameter に BearerToken とマスクされた Value が設定されている","framed":false,"withLightbox":true,"width":"480px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":8},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom Headers"]}," の下にある ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}," を選択し、次の値を入力して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択します。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{!'Bearer ' & $Credential.Treasure_AI_MCP.BearerToken}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sequence Number"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-edit-header.c8775a8e7cfb0267a994043f439dc3b6e083a9e47bdb456a4a186f447a70d226.5866d770.webp","alt":"Salesforce の Edit Custom Header ダイアログ。Name に Authorization、Value に {!'Bearer ' & $Credential.Treasure_AI_MCP.BearerToken}、Sequence Number に 1 が設定されている","framed":false,"withLightbox":true,"width":"480px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":9},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["レジストリへ戻る前に、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI MCP"]}," 詳細画面に名前付きプリンシパル（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureMCPPrincipal"]},"）が 1 件とカスタムヘッダー（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]},"）が 1 件登録されていることを確認します。パラメーター値がマスク表示されている状態が正常です。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-3mcp-サーバーを登録してツールを許可リストに追加する","__idx":5},"children":["手順 3：MCP サーバーを登録してツールを許可リストに追加する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["External Credential を保存したら、Agentforce Registry に Treasure AI Studio の MCP エンドポイントを登録し、Salesforce エージェントから呼び出せるツールを選択します。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce Registry → Registered MCP Servers"]}," の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Connection"]}," ダイアログに戻ります。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server Name"]}," に ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]},"（英数字のみ）、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}," に ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Treasure AI MCP"]}," を入力します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Server URL"]}," に手順 1 でコピーした ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["接続 URL"]},"（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://<アカウントの Agent Gateway>/v1/mcp/<エンドポイント ID>"]},"）をそのまま貼り付けます。トークンを末尾に付けたり、認証ヘッダーを貼り付けたりしないでください。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication Method"]}," は ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use External Credential"]}," のままにし、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New External Credential"]}," 横の更新アイコンを選択してから ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI MCP"]},"（種別 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom"]},"）を選択します。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-create-connection.db7a51cf0327c0cbdd93216f7fea26d744bdf1f02070c4e6a8e09589f2dc2c04.5866d770.webp","alt":"Salesforce の Create Connection ダイアログ。MCP Server Name に TreasureAIMCP、Description に Treasure AI MCP、一部マスクされた US01 Agent Gateway の Server URL、Authentication Method に Use External Credential が設定され、Treasure AI MCP が選択されて Create and Continue が有効になっている","framed":false,"withLightbox":true,"width":"560px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create and Continue"]}," を選択します。Salesforce が接続を検証し、Treasure AI Studio の 6 つのツールを検出します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server Allowlist"]}," でエージェントに許可するツールを選び、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow and Continue"]}," を選択します。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["手順 5 のフル構成の Employee Agent を構築する場合は、6 つのツールすべて（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_work_folders"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_actions"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_chat_result"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["run_action"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_chat"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["continue_chat"]},"）を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["検出確認のみのパイロット運用の場合は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_work_folders"]}," のみを許可し、フル構成のエージェントを構築するときに残りのツールを追加します。"]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-allowlist-tools.6b2e6b7cf6292610f90a54d2ab38740ba1845fe2ad616a30c4ed99d0cfc8c799.5866d770.webp","alt":"Salesforce の MCP Server Allowlist 画面。Risk Assessment が Low と表示され、run_action、list_actions、get_chat_result、start_chat、list_work_folders、continue_chat の 6 つの TreasureAIMCP ツールすべてが選択されている","framed":false,"withLightbox":true,"width":"600px"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"登録時の Risk Assessment が示す意味"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["登録スキャンでは ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risk Assessment: Low"]}," と表示されますが、これは登録時のスキャン結果であり、許可リストに追加した全ツールが読み取り専用であることを保証するものではありません。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["run_action"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_chat"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["continue_chat"]}," は Treasure AI Studio 側でタスクを実行します。"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":7},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grant Access to Users"]}," で自動生成された権限セット（例：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP_Perm_Set"]},"）を確認し、必要なユーザーのみに割り当てて ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apply Policies"]}," で組織に必要なポリシーがあれば適用し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Registered MCP Servers"]}," を開き、保存された ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]}," の行が ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type: Manual"]},"、ツール数 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["6"]},"、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection Status: Active"]},"、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection Health: Connected"]}," になっていることを確認します。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-registry-connected.822c0a9f52721eb4289c9a0712539c590a4271294af9749c0349ba7d42afd8d7.5866d770.webp","alt":"Salesforce の Agentforce Registry の Registrations 一覧。TreasureAIMCP が Type Manual、ツール数 6、Connection Status Active、Connection Health Connected、Risk Score Low で表示されている","framed":false,"withLightbox":true,"width":"720px"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-4mcp-権限セットを割り当てる","__idx":6},"children":["手順 4：MCP 権限セットを割り当てる"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salesforce では、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP ツールアクセス権"]},"（Named Credential 経由で Treasure AI Studio を呼び出す権限）と ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["エージェントアクセス権"]},"（手順 7 で設定する Salesforce Lightning 上での Employee Agent の表示権限）が別々に管理されます。対象となるすべてのエンドユーザーには両方の権限が必要です。エージェントやツールを利用させるためだけに ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["System Administrator"]}," プロファイルを付与しないでください。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Agentforce Registry → Registered MCP Servers → TreasureAIMCP → Details"]}," を開きます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions"]}," の下にある、登録済みサーバー用に生成された ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Named Credential Permission Set"]}," リンク（例：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP_Perm_Set"]},"）を選択します。似た名前のエージェント用権限セットではなく、必ずご自身の登録済みサーバーに表示されたリンクを使用してください。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-server-details-permissions.979023fea93d49fa5f2933a6a5c4754ba0a2f72331d1ddc0ff72ee4dfe51f6b0.5866d770.webp","alt":"Salesforce の TreasureAIMCP サーバー Details 画面。Connection Status が Active、Connection Health が Connected、Authentication Method が External Credential と表示され、オレンジ色の Permissions 注意バナーの下に Named Credential Permission Set のリンク TreasureAIMCP_Perm_Set がある","framed":false,"withLightbox":true,"width":"680px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["権限セットの概要ページで API 名を確認し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage Assignments"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Current Assignments"]}," を確認します。対象ユーザーがすでに一覧にある場合は重複割り当て不要です。含まれていない場合は ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Assignment"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["対象ユーザーの Salesforce ユーザー名を検索して該当行のみを選択し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," を選択します。ユーザー一覧全体や無関係な連携アカウントを選択しないでください。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["展開計画に合った有効期限（パイロットの場合は期限付き割り当てを推奨）を選び、対象ユーザーを確認して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Assign"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Assignment Summary"]}," で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status: Success"]}," を確認して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done"]}," を選択し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Current Assignments"]}," にユーザーが表示されていることを確認します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-5agentforce-builder-で-employee-agent-を構築する","__idx":7},"children":["手順 5：Agentforce Builder で Employee Agent を構築する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["社内の Salesforce ユーザーが Lightning のヘッダーパネルから開けるよう、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Employee Agent"]},"（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AgentforceEmployeeAgent"]},"）を作成します。Service Agent も Preview では MCP サーバーに到達できますが、Lightning の Sales パネルには表示されません。"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"初回公開前に AgentforceEmployeeAgent であることを確認してください"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["初めて公開する前に、ドラフトが ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agent_type: \"AgentforceEmployeeAgent\""]}," になっていることを確認してください。公開済みエージェントの種別変更は Salesforce 側で拒否される場合があります。誤って Service Agent を公開してしまった場合は、新しい Employee Agent を作成し、登録済みの MCP ツールを再利用してください（Treasure AI Studio のエンドポイントやトークンを作り直す必要はありません）。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"エージェントの役割を記述し-optimizer-の提案を確認する","__idx":8},"children":["エージェントの役割を記述し Optimizer の提案を確認する"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["次のいずれか一方の入口から Agentforce Builder を開きます（両方は不要です）。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Agentforce Agents → New Agent"]},"（案内ダイアログが表示された場合は ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Agent"]}," を選択）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Launcher → Agentforce Studio → Agents → New Agent"]},"。"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Builder のプロンプト入力欄に次の説明を貼り付けて送信します。"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Create an internal employee agent for marketing users that answers questions about Treasure Data CDP, our customer data platform. That data is not in Salesforce, so never answer these questions from Salesforce Knowledge or general knowledge. Don't add or configure any actions; I'll add the TreasureAIMCP actions from the Asset Library myself.\n\nCreate one subagent called \"Treasure AI Studio\" that follows this:\n1. Call list_work_folders to get the work folder ID. Never ask the user for it.\n2. Call list_actions for that folder and find the saved Action that best matches the request. If one matches, run it with run_action.\n3. If no Action fits, use start_chat with a clear, self-contained task describing exactly what the user asked for. Use continue_chat for follow-ups on the same result, and get_chat_result if a result is still running.\n4. Summarize the result in plain language with the key numbers, and say which Action or chat produced it. If a tool returns an error or no result, say so. Never guess.\n\nConfirmation: before any request that sends emails or notifications, activates or exports an audience, runs or resumes a workflow or journey, or creates, changes, or deletes anything in Treasure AI, first tell the user exactly what will happen and ask them to confirm. Only proceed after they say yes. Reading, listing, querying, and reporting need no confirmation.\n\nIf a request isn't about Treasure AI, explain what this agent can help with.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name your agent"]}," で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]},"（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Treasure_AI_Agent"]},"）を入力し、組織のユーザー割り当てオプションに従って ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Let's Go"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["承認前に Agent Optimizer が提案した構成を確認します。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["developer_name"]}," が ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Treasure_AI_Agent"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agent_label"]}," が ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Treasure AI Agent"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agent_type"]}," が ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AgentforceEmployeeAgent"]}," になっており、メッセージング専用の変数（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EndUserId"]}," など）が追加されていないか確認してください。Optimizer が名前を変更したりメッセージング変数を追加したりした場合は、進める前に次のように修正を指示します。"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Proceed, with two changes: keep developer_name Treasure_AI_Agent and agent_label Treasure AI Agent, and remove the EndUserId variable because this isn't a messaging agent.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optimizer が変更案（既定のサブエージェント削除と ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Studio"]}," サブエージェント追加）を生成したら、内容を確認して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accept All"]}," を選択し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"登録済み-mcp-アクションを接続して入力を確認する","__idx":9},"children":["登録済み MCP アクションを接続して入力を確認する"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explorer"]}," で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Studio"]}," サブエージェントにカーソルを合わせ、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ → Add from Asset Library"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]}," を検索し、登録済みの 6 つのアクション（または未追加のもの）をすべて選択して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add to Agent"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Actions Available For Reasoning"]}," で、各操作に対応するローカルアクションを選択します。重複アクションは作成しないでください。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explorer"]}," の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Studio"]}," 配下に 6 つの ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]}," アクションがすべて並んでいることを確認します。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-builder-linked-tools.f067db6a677342ce56b4617faf1977fc81daf39f7dcfa8415e1715875a030b03.5866d770.webp","alt":"Agentforce Builder の Explorer で、Treasure AI Studio サブエージェント配下に list_work_folders、list_actions、run_action、start_chat、continue_chat、get_chat_result の 6 つの TreasureAIMCP アクションすべてが接続されている画面","framed":false,"withLightbox":true,"width":"440px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Script view"]},"（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["</>"]},"）を開き、サブエージェントのバインド内容を",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%97%E3%83%88"},"children":["リファレンスエージェントスクリプト"]},"と比較します。推論アクションの入力行で ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["..."]}," が指定されており、エージェントがツール結果や会話コンテキストから ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["work_folder_id"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["action_name"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chat_id"]}," を動的に渡せること、および指示文が自組織のローカル Asset Library アクション ID を参照していることを確認します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Problems"]}," が ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["0 errors"]}," であることを確認します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-6preview-でエージェントをテストする","__idx":10},"children":["手順 6：Preview でエージェントをテストする"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["エージェントを有効化する前に、Agentforce Builder の Preview でライブ MCP ツール実行を確認します。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Preview"]}," で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["↻"]}," を選択して新しいテストセッションを開始します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["「作業フォルダにある保存済みアクションを一覧表示して」"]},"（英語の場合は ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["“List the saved actions in my work folder.”"]},"）のような読み取り専用の確認プロンプトを送信します。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent Preview Details"]}," のトレースで、Salesforce が ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_work_folders"]}," に続いて返された ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["work_folder_id"]}," で ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_actions"]}," を実行したことを確認します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["「最初の 3 つの親セグメントを一覧表示して」"]},"（英語の場合は ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["“List the first 3 parent segments.”"]},"）のような顧客データ照会の質問を送信します。共有作業フォルダに該当する保存済みアクションがある場合は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["run_action"]}," が、該当するアクションがない場合は無関係なアクションではなく ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_chat"]}," が実行されることを確認します。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-preview-trace.52d09555b2a50ab07f94509efc321183bf6e1ce8f4f522c57de753d32f91e656.5866d770.webp","alt":"Agentforce Builder の Preview 画面。保存済みアクションと親セグメントの一覧を取得するテスト会話と並んで、Agent Preview Details トレースに MCP RPC initialize、tools/list、tools/call の成功ステップが表示されている","framed":false,"withLightbox":true,"width":"760px"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["もっともらしく見える回答や緑色の ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tools/list"]}," 呼び出しだけでは実行の証明になりません。トレースに実際の ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MCP RPC tools/call"]}," ステップが含まれ、ご自身の Treasure AI Studio 作業フォルダの結果と一致することを確認してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-7employee-agent-を有効化してユーザーアクセスを付与する","__idx":11},"children":["手順 7：Employee Agent を有効化してユーザーアクセスを付与する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["コミットはテスト用にエージェントのバージョンを固定する操作であり、有効化によって接続済みの Salesforce Lightning チャネルから利用可能になります。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agent_type: \"AgentforceEmployeeAgent\""]}," と Preview での動作を確認したら、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Commit Version → Commit"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Activate → Activate"]}," を選択し、コミット済みバージョンを接続チャネルに公開します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Agentforce Agents"]}," を開き、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]}," が ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type: AgentforceEmployeeAgent"]}," になっており、エージェント本体と ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Version 1"]}," の両方に ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}," のチェックマークが付いていることを確認します。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-active-agent.3a2996efbc7773f93346a2986ee806eb4dece22119a93bf177c10edb99c9a6b9.5866d770.webp","alt":"Salesforce Setup の Agentforce Agents 一覧。Treasure AI Agent の Type が AgentforceEmployeeAgent であり、エージェント本体と Version 1 の両方に Active チェックマークが付いている（Created By の氏名はマスク済み）","framed":false,"withLightbox":true,"width":"760px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["対象の Salesforce ユーザーにエージェントの表示権限を付与します。本番展開では、対象ユーザーのみに絞った専用の権限セットを通じて ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," を付与してください（エージェントを表示するためだけに ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["System Administrator"]}," を割り当てないでください）。権限セットまたはプロファイルでアクセスを付与する手順は次のとおりです。",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Users"]}," から対象の権限セットまたはプロファイルを開き、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," を選択して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Available Agents"]}," から ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]}," を ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agents"]}," へ移動し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," を選択します。"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["すべての対象ユーザーに ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]}," の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," と、手順 4 の MCP 権限セット（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP_Perm_Set"]},"）の両方が付与されていることを確認します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"手順-8salesforce-lightning-からエージェントを利用する","__idx":12},"children":["手順 8：Salesforce Lightning からエージェントを利用する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Agentforce Builder の外にある Salesforce Lightning の画面から、有効化したエージェントの動作を確認します。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Launcher"]},"（9 つの点）を開き、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sales"]}," を検索して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sales"]}," アプリ（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup"]}," ではない）を選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["上部ヘッダーの ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce"]}," アイコンを選択して右側のパネルを開きます。初回利用時に ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agentforce Memory"]}," の案内が表示された場合は、設定を選んで ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Got It"]}," を選択してください（メモリの保存は MCP に必須ではありません）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Agentforce パネルのエージェントドロップダウンから ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]}," が選択されていない場合は選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["「Treasure AI Studio の作業フォルダ名と保存済みアクションを一覧表示して」"]},"（英語の場合は ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["“List the Treasure AI Studio work folder name and its saved actions”"]},"）のような読み取り専用の確認プロンプトに続けて、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["「親セグメントを 10 件見せて」"]},"（英語の場合は ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["“Show me 10 parent segments.”"]},"）のようなクエリを送信します。パネルに Treasure AI Studio の共有作業フォルダのデータが返り、保存済みアクションまたはフリーテキストチャットのどちらで生成されたかが示されることを確認します。"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-agentforce-live-result.8852427242238ede8ddcbb5eb3c2f31c13a1f86412095834a3614e616bafe2f5.5866d770.webp","alt":"Salesforce Lightning の Agentforce パネル。Treasure AI Agent が Treasure AI Studio のフォルダと保存済みアクションを一覧表示し、続いてフリーテキストの CDP クエリで 10 件の親セグメントとメンバー数を返している画面","framed":false,"withLightbox":true,"width":"440px"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["管理者以外のユーザーへ展開する場合は、対象となる非管理者ユーザーとしてログインした状態でも同じ検証を行い、エージェント表示権限と MCP 権限セットの両方が機能することを確認してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"studio-側での実行内容とセキュリティ管理","__idx":13},"children":["Studio 側での実行内容とセキュリティ管理"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salesforce Agentforce からのリクエストはすべて、静的トークン方式エンドポイントに紐づく 1 人の共有実行者として Treasure AI Studio 内で実行され、その実行者の権限とクレジットを消費します。Studio は公開された共有作業フォルダを読み取り専用で参照し、書き込みはチャット終了時に破棄される一時作業領域に限定されます。チャネルのチャットで影響し得る範囲の詳細は ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/channel-chats"},"children":["エージェントチャネルのチャットが到達できる範囲"]}," を参照してください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["パイロット運用を超えて展開する前に、次のセキュリティ管理を徹底してください。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["共有作業フォルダと実行者の範囲を絞る"]},"：Salesforce ユーザーから呼び出して問題ない保存済みアクション、ファイル、コネクタのみを共有作業フォルダに含めます。エージェントにアクセスできるすべての Salesforce ユーザーは、実行者の Treasure AI 権限を引き継ぎます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["指示文の確認ゲートを多層防御として位置づける"]},"：プロンプトとリファレンススクリプトでは、通知の送信、オーディエンスのアクティベーション・エクスポート、ワークフローやジャーニーの実行、データの変更前にユーザーへ確認するよう指示しています。ただし、登録済み MCP アクション定義自体は ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["require_user_confirmation: False"]}," であるため、実効的な境界は実行者の権限、共有作業フォルダの中身、および許可リストのツールによって担保してください。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["静的トークンを保護・ローテーションする"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tasgwt_"]}," トークンは Salesforce の External Credential プリンシパルのみに保管し、Server URL、エージェントプロンプト、Agent Script、スクリーンショットには絶対に貼り付けないでください。アクセス変更時、パイロット終了時、または漏洩の懸念がある場合はトークンをローテーションしてください（",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/tokens#gateway-token-%E3%82%92%E3%83%AD%E3%83%BC%E3%83%86%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%99%E3%82%8B"},"children":["Gateway Token をローテーションする"]}," を参照）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salesforce 側の割り当てを制限する"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP_Perm_Set"]}," と ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," は承認済みユーザーのみに付与し、パイロットでは期限付き割り当てを使用してください。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"接続を停止する","__idx":14},"children":["接続を停止する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アクセスは Treasure AI Studio 側・Salesforce 側のどちらからでも即座に停止できます。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salesforce からの全リクエストを即座に停止する（Studio）"]},"：",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["設定 → エージェントチャネル"]}," で対象エンドポイントを開き、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["有効 / 無効"]}," スイッチをオフにします。トークンを失効させずにリクエストを即座に拒否できます。資格情報を恒久的に無効化する場合は、トークンを失効させるかエンドポイントを削除してください。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["特定の Salesforce ユーザーを停止する（Salesforce）"]},"：対象ユーザーを ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP_Perm_Set"]}," から除外する（MCP ツール呼び出しを遮断）か、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]}," の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," を外します（Lightning 上でエージェントを非表示にする）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["全 Salesforce ユーザーに対してエージェントを停止する（Salesforce）"]},"：",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Agentforce Agents"]}," で ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI Agent"]}," を開き、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deactivate"]}," を選択します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"リファレンスエージェントスクリプト","__idx":15},"children":["リファレンスエージェントスクリプト"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次の検証済み Employee Agent スクリプトは、Agentforce Builder の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Script view"]},"（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["</>"]},"）で確認する際の構造リファレンスとして使用してください。別組織へそのままコピーせず、組織ごとに生成されるアクション ID（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["a4c7ec..."]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["a95d21..."]}," など）、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source"]},"・",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target"]}," 識別子、および ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["model_config"]}," の値は、ご自身の Asset Library から 6 つの ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]}," アクションを接続した際に生成される値に置き換えてください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"system:\n    instructions: \"You are a Treasure AI CDP assistant for marketing users. All answers must come directly from Treasure AI tools — never use Salesforce Knowledge or general knowledge to answer questions.\"\n    messages:\n        welcome: |\n            Hi, I'm your Treasure AI assistant. I can help you explore audiences, run analyses, and work with your customer data in Treasure AI CDP. What would you like to know?\n        error: \"Sorry, something went wrong. Please try again.\"\n\nconfig:\n    developer_name: \"Treasure_AI_Agent\"\n    agent_label: \"Treasure AI Agent\"\n    description: \"Internal marketing agent that answers questions and runs analyses using Treasure AI CDP. Never uses Salesforce Knowledge or general knowledge.\"\n    agent_type: \"AgentforceEmployeeAgent\"\n\nmodel_config:\n    model: \"model://sfdc_ai__DefaultGPT56Luna\"\n\nlanguage:\n    default_locale: \"en_US\"\n    all_additional_locales: False\n\nvariables:\n    work_folder_id: mutable string = \"\"\n        description: \"Cached work folder ID retrieved from Treasure AI Studio; avoids re-fetching on every turn\"\n    chat_id: mutable string = \"\"\n        description: \"ID of the active Treasure AI chat session, used for continue_chat and get_chat_result\"\n\nknowledge:\n    rag_feature_config_id: \"\"\n    citations_url: \"\"\n    citations_enabled: False\n\nstart_agent agent_router:\n    label: \"Agent Router\"\n    description: \"Welcome the user and route all requests to the Treasure AI Studio subagent\"\n    model_config:\n        model: \"model://sfdc_ai__DefaultEinsteinHyperClassifier\"\n    reasoning:\n        instructions: ->\n            | Select the best tool to call based on conversation history and user's intent.\n        actions:\n            go_to_treasure_ai_studio: @utils.transition to @subagent.treasure_ai_studio\n\n\nsubagent treasure_ai_studio:\n    label: \"Treasure AI Studio\"\n    description: \"Handles all Treasure AI CDP questions by discovering work folders and saved Actions, running the best match, falling back to free-text chat, and summarizing results in plain language.\"\n    reasoning:\n        instructions: ->\n            |You are connected to Treasure AI CDP. All answers must come directly from Treasure AI tools — never use Salesforce Knowledge or general knowledge.\n\n             If the request is not about Treasure AI CDP, politely explain that this agent can help with Treasure AI CDP questions, analyses, audience management, and data workflows, and do not attempt to answer it.\n\n             Confirmation gate: Before taking any of the following actions, tell the user exactly what will happen and ask them to confirm. Only proceed after they say yes.\n             - Sending emails or notifications\n             - Activating or exporting an audience\n             - Running or resuming a workflow or journey\n             - Creating, changing, or deleting anything in Treasure AI\n             Reading, listing, querying, and reporting need no confirmation.\n\n             Workflow:\n             Step 1 — Get the work folder: Call {!@actions.a4c7ec23334353fc7a73dd098254ca6eb} to get the work folder ID, and reuse it for the rest of the conversation. Never ask the user for it.\n             Step 2 — List available Actions: Call {!@actions.a95d21b38c6273c2c8d8c2f508296fe9f} for the work folder and inspect action names and descriptions to find the one that best matches the user's request.\n             Step 3 — Run a saved Action: If a matching saved Action is found, call {!@actions.a957880df5db732a393e6b85fde2af16b} with the exact action name and the work folder ID.\n             Step 4 — Fall back to free-text chat: If no saved Action fits, call {!@actions.a87dd54c253ef3974bd5e07eafeff72eb} with the work folder ID and a clear, self-contained description of exactly what the user asked for. Keep the chat_id it returns. For follow-ups on the same result, call {!@actions.aed3e4d64a89532f4b0943e4a226247fe} with that chat_id. If the status is \"running\", call {!@actions.a1466fa95345b3dce8621350804423a33} with that chat_id to get the final result.\n             Step 5 — Summarize: Present the result in plain language, highlighting key numbers. Say which Action or chat produced it. If a tool returns an error or no result, say so clearly. Never guess or fabricate results.\n        actions:\n            a95d21b38c6273c2c8d8c2f508296fe9f: @actions.a95d21b38c6273c2c8d8c2f508296fe9f\n                with work_folder_id = ...\n            a957880df5db732a393e6b85fde2af16b: @actions.a957880df5db732a393e6b85fde2af16b\n                with work_folder_id = ...\n                with action_name = ...\n            a87dd54c253ef3974bd5e07eafeff72eb: @actions.a87dd54c253ef3974bd5e07eafeff72eb\n                with work_folder_id = ...\n                with message = ...\n            aed3e4d64a89532f4b0943e4a226247fe: @actions.aed3e4d64a89532f4b0943e4a226247fe\n                with chat_id = ...\n                with message = ...\n            a1466fa95345b3dce8621350804423a33: @actions.a1466fa95345b3dce8621350804423a33\n                with chat_id = ...\n            a4c7ec23334353fc7a73dd098254ca6eb: @actions.a4c7ec23334353fc7a73dd098254ca6eb\n    actions:\n        a1466fa95345b3dce8621350804423a33:\n            description: |\n                Retrieves the result of the latest instruction in a chat, including follow-ups sent with continue_chat. Does not submit a new instruction. If execution is still in progress, waits for the result and may return status \"running\" again.\n            label: \"get_chat_result - TreasureAIMCP\"\n            require_user_confirmation: False\n            include_in_progress_indicator: False\n            source: \"a1466fa95345b3dce8621350804423a33\"\n            target: \"mcpTool://TreasureAIMCP/mcptoolx5fx5fgetx5fchatx5fresult\"\n\n            inputs:\n                \"chat_id\": string\n                    description: |\n                      The chat_id returned by run_action or start_chat through this connection.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n        a4c7ec23334353fc7a73dd098254ca6eb:\n            description: |\n                Lists the work folders available in Treasure AI Studio. Start here to find configured actions for the user's task. Tasks may involve Treasure Data or other connected services. Inspect available capabilities before giving generic advice or asking about unfamiliar project or business names. A work folder is a persistent server-side workspace with files and reusable actions; its purpose depends on its configuration. Use folder names and any author-provided descriptions to select candidates, then call list_actions with each candidate's id to inspect the available tasks.\n            label: \"list_work_folders - TreasureAIMCP\"\n            require_user_confirmation: False\n            include_in_progress_indicator: False\n            source: \"a4c7ec23334353fc7a73dd098254ca6eb\"\n            target: \"mcpTool://TreasureAIMCP/mcptoolx5fx5flistx5fworkx5ffolders\"\n        a87dd54c253ef3974bd5e07eafeff72eb:\n            description: |\n                Delegates the free-text task in message to a server-side agent in a new chat. Check list_actions in relevant work folders first. Use start_chat only when no available action can perform the task. The agent can read work folder files and use configured connectors. Waits for the result and returns status \"running\" if execution is still in progress.\n            label: \"start_chat - TreasureAIMCP\"\n            require_user_confirmation: False\n            include_in_progress_indicator: False\n            source: \"a87dd54c253ef3974bd5e07eafeff72eb\"\n            target: \"mcpTool://TreasureAIMCP/mcptoolx5fx5fstartx5fchat\"\n\n            inputs:\n                \"work_folder_id\": string\n                    description: |\n                      The folder id returned by list_work_folders.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n                \"message\": object\n                    description: |\n                      The task to delegate, including necessary context and the expected result. The agent does not see your conversation.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n                    complex_data_type_name: \"lightning__richTextType\"\n        a957880df5db732a393e6b85fde2af16b:\n            description: |\n                Delegates an action selected from list_actions to a server-side agent in a new chat. The agent follows the action's configured instructions and can read work folder files and use configured connectors. Each call starts a separate execution. This tool accepts no action arguments or additional instructions, and the agent does not see your conversation. Waits for the result and returns status \"running\" if execution is still in progress.\n            label: \"run_action - TreasureAIMCP\"\n            require_user_confirmation: False\n            include_in_progress_indicator: False\n            source: \"a957880df5db732a393e6b85fde2af16b\"\n            target: \"mcpTool://TreasureAIMCP/mcptoolx5fx5frunx5faction\"\n\n            inputs:\n                \"work_folder_id\": string\n                    description: |\n                      The folder id returned by list_work_folders.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n                \"action_name\": string\n                    description: |\n                      The exact name returned by list_actions for this folder.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n        a95d21b38c6273c2c8d8c2f508296fe9f:\n            description: |\n                Lists executable actions in one work folder returned by list_work_folders. An action delegates a predefined task to a server-side agent. Inspect action names and descriptions to find a task matching the user's request, including unfamiliar project or business names. When an action fits, pass its exact name and this work_folder_id to run_action.\n            label: \"list_actions - TreasureAIMCP\"\n            require_user_confirmation: False\n            include_in_progress_indicator: False\n            source: \"a95d21b38c6273c2c8d8c2f508296fe9f\"\n            target: \"mcpTool://TreasureAIMCP/mcptoolx5fx5flistx5factions\"\n\n            inputs:\n                \"work_folder_id\": string\n                    description: |\n                      The folder id returned by list_work_folders.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n        aed3e4d64a89532f4b0943e4a226247fe:\n            description: |\n                Sends a new instruction to an existing chat to request additional work or revise a result. To wait for an existing result without sending a message, use get_chat_result. Waits for the reply and returns status \"running\" if execution is still in progress.\n            label: \"continue_chat - TreasureAIMCP\"\n            require_user_confirmation: False\n            include_in_progress_indicator: False\n            source: \"aed3e4d64a89532f4b0943e4a226247fe\"\n            target: \"mcpTool://TreasureAIMCP/mcptoolx5fx5fcontinuex5fchat\"\n\n            inputs:\n                \"chat_id\": string\n                    description: |\n                      The chat_id returned by run_action or start_chat through this connection.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n                \"message\": object\n                    description: |\n                      The follow-up task for this chat, including any new context and the expected result.\n                    label: \"string\"\n                    is_required: True\n                    is_user_input: False\n                    complex_data_type_name: \"lightning__richTextType\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"トラブルシューティング","__idx":16},"children":["トラブルシューティング"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"34%","data-label":"症状"},"children":["症状 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"原因"},"children":["原因 "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"36%","data-label":"対処"},"children":["対処 "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["レジストリの検証に失敗する、またはサーバーに接続できない"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Server URL"]},"、エンドポイント方式、External Credential のトークンが同じ静的トークン方式エンドポイントのものになっていないか、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BearerToken"]}," の値に ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer "]}," が含まれている"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["同じ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["静的トークン（指定した実行者）"]}," エンドポイントから ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["接続 URL"]}," とトークンをコピーし直してください。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Server URL"]}," には URL のみを貼り付け、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BearerToken"]}," には ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tasgwt_"]}," で始まる生のトークンのみを貼り付け、カスタムヘッダーの数式が ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{!'Bearer ' & $Credential.Treasure_AI_MCP.BearerToken}"]}," であることを確認してください"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Salesforce で資格情報または権限不足のエラーが表示される"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["生成された Named Credential Permission Set が対象ユーザーに割り当てられていない"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Setup → Agentforce Registry → Registered MCP Servers → TreasureAIMCP → Details"]}," を開き、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Named Credential Permission Set"]}," リンクから対象ユーザーへ割り当ててください"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lightning にエージェントは表示されるが、Treasure AI のツールを呼び出せない"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["エージェントの表示権限と MCP ツールアクセス権は別管理であり、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," はあっても MCP 権限セットが付与されていない"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["対象ユーザーに Employee Agent の ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled Agent Access"]}," と ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP_Perm_Set"]},"（または自組織で生成された権限セット）の両方を付与してください"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["エージェントが Treasure AI ではなく一般知識や Salesforce のデータから回答してしまう"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6 つの ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]}," アクションがサブエージェントに接続されていないか、サブエージェントの指示文が Treasure AI ツール利用を強制していない"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Asset Library から 6 つの登録済み ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TreasureAIMCP"]}," アクションをすべて追加し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Script view"]},"（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["</>"]},"）でバインドを確認して ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["0 errors"]}," で保存したうえで、Preview のトレースに ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MCP RPC tools/call"]}," ステップが出ることを確認してください"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["公開したエージェントの種別が異なり、Lightning の Sales パネルに表示されない"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Employee Agent（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AgentforceEmployeeAgent"]},"）ではなく Service Agent として公開されている"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["新しく Employee Agent（",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AgentforceEmployeeAgent"]},"）を作成し、登録済みの MCP ツールを再利用してください。公開後の種別変更は Salesforce 側で拒否される場合があります"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treasure AI Studio から ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}," または ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]}," が返される"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["静的トークンの期限切れ・失効、エンドポイントの無効化、または実行者の辞任やフォルダアクセス喪失が発生している"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["設定 → エージェントチャネル"]}," でエンドポイントのステータスとトークン一覧を確認し、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/mcp-endpoints#%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0"},"children":["静的トークン方式の MCP エンドポイントのトラブルシューティング"]}," を参照してください"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"次のステップ","__idx":17},"children":["次のステップ"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/mcp-endpoints"},"children":["静的トークン方式の MCP エンドポイント"]},"：エンドポイントのステータス管理、実行者の交代、トークンのライフサイクル。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/mcp-clients"},"children":["MCP クライアントを接続する"]},"：6 つの MCP ツールの詳細、結果の読み方、制限値。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/ai-studio/agent-channels/channel-chats"},"children":["エージェントチャネルのチャットが到達できる範囲"]},"：チャネルチャットの作業領域の分離、クレジット、監査ログ。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.salesforce.com/s/articleView?language=en_US&id=ai.agent_mcp_connect_register.htm&type=5"},"children":["Salesforce ヘルプ：Register a Third-Party MCP Server"]}," および ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.salesforce.com/s/articleView?language=en_US&id=ai.agent_mcp_tool_action_add.htm&type=5"},"children":["Add MCP Tool Actions to an Agent"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/headless"},"children":["Headless"]},"：外部の AI ツールを Treasure AI に接続する概要。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ほかの Headless ガイド：",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/headless/chatgpt"},"children":["ChatGPT"]},"、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/headless/claude-web"},"children":["Claude"]},"、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/headless/gemini"},"children":["Gemini"]},"、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/headless/databricks-genie-one"},"children":["Databricks Genie One"]},"。"]}]}]},"headings":[{"value":"Salesforce Agentforce を Treasure AI Studio に接続する","id":"salesforce-agentforce-を-treasure-ai-studio-に接続する","depth":1},{"value":"接続の仕組み","id":"接続の仕組み","depth":2},{"value":"前提条件","id":"前提条件","depth":2},{"value":"手順 1：Studio で静的トークン方式の MCP エンドポイントを作成する","id":"手順-1studio-で静的トークン方式の-mcp-エンドポイントを作成する","depth":2},{"value":"手順 2：Salesforce で Custom External Credential を設定する","id":"手順-2salesforce-で-custom-external-credential-を設定する","depth":2},{"value":"手順 3：MCP サーバーを登録してツールを許可リストに追加する","id":"手順-3mcp-サーバーを登録してツールを許可リストに追加する","depth":2},{"value":"手順 4：MCP 権限セットを割り当てる","id":"手順-4mcp-権限セットを割り当てる","depth":2},{"value":"手順 5：Agentforce Builder で Employee Agent を構築する","id":"手順-5agentforce-builder-で-employee-agent-を構築する","depth":2},{"value":"エージェントの役割を記述し Optimizer の提案を確認する","id":"エージェントの役割を記述し-optimizer-の提案を確認する","depth":3},{"value":"登録済み MCP アクションを接続して入力を確認する","id":"登録済み-mcp-アクションを接続して入力を確認する","depth":3},{"value":"手順 6：Preview でエージェントをテストする","id":"手順-6preview-でエージェントをテストする","depth":2},{"value":"手順 7：Employee Agent を有効化してユーザーアクセスを付与する","id":"手順-7employee-agent-を有効化してユーザーアクセスを付与する","depth":2},{"value":"手順 8：Salesforce Lightning からエージェントを利用する","id":"手順-8salesforce-lightning-からエージェントを利用する","depth":2},{"value":"Studio 側での実行内容とセキュリティ管理","id":"studio-側での実行内容とセキュリティ管理","depth":2},{"value":"接続を停止する","id":"接続を停止する","depth":3},{"value":"リファレンスエージェントスクリプト","id":"リファレンスエージェントスクリプト","depth":2},{"value":"トラブルシューティング","id":"トラブルシューティング","depth":2},{"value":"次のステップ","id":"次のステップ","depth":2}],"frontmatter":{"seo":{"title":"Salesforce Agentforce を Treasure AI Studio に接続する","description":"静的トークン方式の MCP エンドポイントで Salesforce Agentforce を Treasure AI Studio に接続し、Studio のアクションやチャットを実行できる Employee Agent を構築する手順を解説します。"}},"lastModified":"2026-11-20T01:00:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/headless/salesforce-agentforce","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}