ヘッドレス機能に向けてデータを準備する
学習の目的
この単元を完了すると、次のことができるようになります。
- データ基盤とは何か、またそれがどのように信頼性の高いヘッドレスワークフローをサポートするかを説明する。
- Salesforce のメタデータが、ツールやコール元に組み込みのコンテキストをどのように提供するかを説明する。
- メタデータの監査、インテグレーションユーザーの設定、および [Setup (設定)] での Model Context Protocol (MCP) サーバーの有効化に必要な、システム管理者と開発者のチェックリストを特定する。
ツールの準備は整っています。データの準備はできていますか?
Agentforce Vibes、Cursor、Claude などの Salesforce AI ネイティブツールを使用すると、ブラウザー UI に切り替えることなく、組織の調査、定型タスクの実行、ワークフローの自動化、トラブルシューティングが行えます。AI エージェントはこれらの操作の多くをプログラムで処理し、必要なときに UI を表示します。
その柔軟性は強力ですが、ツールが接続する前にデータがどのような状態であるべきかが変わってきます。強固なデータ基盤を構築するために、開発者である必要はありません。作業内容はなじみのあるものです。メタデータのクリーンアップ、明確な権限の設定、そして意図的な設定です。
エージェントが確実に行動するために必要なコンテキスト (進行中のエスカレーション、更新日、SLA 状況、リレーション履歴など) は、組織内に蓄積されるまでに長い年月がかかります。クリーンなメタデータの基盤があれば、各インターフェースで再作成することなく、接続されたツールがそのコンテキストを利用できるようになります。ヘッドレス機能により、データ、ワークフロー、ガバナンスを含むビジネスコンテキストを、サポートされているサーフェス全体で利用できるようになります。これにより、エージェントは設定済みのセキュリティおよびガバナンスコントロールを遵守しながら、最新の信頼できる情報にアクセスできます。
一方、ブラウザーで操作する場合は、ページレイアウト、項目の表示ラベル、ツールチップが視覚的なコンテキストを提供します。ツールチップや画面上のヘルプは、STAT_3 のような選択リスト値を説明するものです。プログラムによるコール元には、そのような視覚的なレイヤーがありません。利用可能なスキーマのメタデータ (オブジェクトの説明、項目の表示ラベル、選択リスト値など) を使用して、データモデルを解釈し、関連する項目を特定しています。
オブジェクトの説明、項目の表示ラベル、明示的な選択リスト値が明確でなければ、ツールは項目の定義を解決したり、ビジネスコンテキストを推測したりすることができません。クリーンなメタデータ基盤により、外部ツールが組織と予測可能かつ正確にやり取りできるようになります。ツールを接続すること自体は簡単ですが、強固な基盤を築くには本格的な取り組みが必要です。
この単元では、データ基盤とは何か、それが AI ネイティブなワークフローにとってなぜ重要なのかを確認します。
データ基盤とは?
AI モデルが、ガバナンスの効いたデータ基盤を介さずに生のデータベーステーブルを直接参照すると、問題が急速に増大します。それぞれのユーザーが同じワークフローの各自のバージョンを作成することになります。プロセスに一貫性がなくなります。本来ビジネスルールが行うべき判断を、AI が代わりに行うようになります。ガバナンスが失われます。正しいアプローチは、ビジネスロジックを Salesforce ドメイン内に保持することです。データはガバナンスが効いた状態で統合され、エージェントがすぐに活用できる状態にする必要があります。それこそが、データ基盤の提供するものです。
強固なデータ基盤は、5 つの機能を組み合わせたものです。
Master Data Management
マスターデータ管理 (MDM) は、すべてのエンティティに対して 1 つの信頼できるレコードを割り当てます。Salesforce Data 360 は、顧客プロファイル全体にわたってネイティブの ID 解決 (複数のシステムのレコードを 1 つの信頼できるプロファイルに照合すること) を処理します。また、Informatica MCP サーバーは、Salesforce の範囲を超えてエンタープライズ全体のマスタリングと重複排除を拡張します。
データ品質
データ品質は、完全性、正確性、鮮度を確保し、プログラムツールが常に信頼性の高い入力データに基づいて動作できるようにします。Informatica MCP サーバーは、Informatica Intelligent Data Management Cloud (IDMC) から直接、堅牢なデータ品質、データ系統、データ健全性チェックを提供します。
データインテグレーションとデータフェデレーション
データインテグレーションとデータフェデレーションは、分散したシステムを連携させ、ツールはエンタープライズデータがどこに存在してもアクセスできるようになります。Data 360 はゼロコピーフェデレーションを採用しており、データを Salesforce にコピーすることなく、データウェアハウスやハイパースケーラー (AWS、Azure、Google Cloud などのクラウドプラットフォーム) に対してその場でクエリを実行できます。MuleSoft MCP サーバーは、既存のエンタープライズ API とインテグレーションを MCP ツールとして直接公開します。
ガバナンス
ガバナンスでは、データを参照できるユーザーを定義し、アクセスルールとコンプライアンスルールを適用します。Salesforce Platform は項目レベルセキュリティ (FLS)、共有ルール、およびロールベースのアクセス制御 (RBAC) を適用し、Data 360 は自動タグ付けと動的マスキングを追加します。ガバナンスを設定せずにサービスを実行すると、アクセスが統制されない状態でサービスが動作し、機密項目がマスキングされないまま公開されます。ガバナンスは自動的に適用されることはなく、明示的に設定する必要があります。
Data Catalog
データカタログは、アクションを実行する前にコール元がビジネスアセットを検出して参照するのに役立つ構造化されたインデックスを提供します。Headless 360 MCP サーバーは、AI ツールが外部プラットフォームと通信する方法を定義するオープン標準である MCP 上に構築されています。この機能は現在、Discover ツールと Describe ツールを通じて提供されており、これらのツールによりコール元は組織のスキーマとメタデータでグラウンディングされます。
この 5 つの機能が組み合わさることで、成熟した信頼性の高いデータモデルが生まれます。これは、あらゆるツールが安全にクエリを実行してアクションを起こせる、構造化された一貫性のあるビジネスの全体像です。
データ基盤は、メタデータとコンテキストのグラウンディング、Data 360、クロスクラウド MCP という 3 つの中核的な柱を通じてこのモデルに対応します。この単元では、最初の柱について説明します。
メタデータ: 組織に組み込まれたグラウンディングレイヤー
Salesforce 組織内のすべてのオブジェクトと項目には、表示ラベル、説明、ヘルプテキスト、リレーション定義などのメタデータが含まれています。たとえば、Account (取引先) オブジェクトには、表示ラベル (Account (取引先))、ビジネスにおける意味の説明、および Industry (業種) や Annual Revenue (年間売上) などの項目が含まれており、それぞれに独自の表示ラベルと説明があります。
ツールが Salesforce MCP サーバーを通じて接続すると、Salesforce はオブジェクトや項目の表示ラベル、説明、データ型、選択リスト値、リレーションなど、利用可能なスキーマメタデータを提供します。このメタデータにより、ツールはレコードの要約、関連データの検索、応答のドラフト作成などのタスクに関連するオブジェクトや項目を特定できます。明確で正確なメタデータは解釈の精度を高めますが、組織の運用を管理する入力規則、オートメーション、権限、アプリケーションロジックの代わりにはなりません。 問題は、それが十分に活用できる状態に保たれているかどうかです。
エージェントによるメタデータの読み取り方法
エージェントが Headless 360 MCP サーバーを通じて組織に接続する際、最初にクエリを実行したりアクションを実行したりするわけではありません。まず、組織の構造を読み取ります。
組織のデータモデルを把握するために、エージェントはデータのクエリやアクションの実行前に 2 つのメタデータツールを使用できます。
- Discover (検出): 組織で利用可能なオブジェクトのリストと、その API 参照名、表示ラベル、説明を返します。エージェントはこのリストを使用して、組織に含まれる内容を把握し、当面のタスクに関連するオブジェクトを特定します。
- Describe (説明): 特定のオブジェクトの詳細、すべての項目の API 参照名、表示ラベル、データ型、説明、選択リスト値、およびほかのオブジェクトとのリレーションを返します。エージェントはこのコンテキストを使用して、ユーザーの要求を適切な項目に対応付け、正確なアクションを実行します。
これらのツールは、認証済みユーザーが利用可能なスキーマメタデータを返します。結果には、設定済みの表示ラベル、説明、項目、選択リスト値、リレーション、およびアクセス権限が反映されます。入力規則、フロー、Apex コード、その他のオートメーションを通じて実装されたすべてのビジネスルールや動作が提供されるわけではありません。
メタデータの品質がエージェントの解釈をサポートするしくみ
エージェントに必要なもの | 適切に管理されたメタデータ | 管理が行き届いていないメタデータ |
|---|---|---|
このオブジェクトは何を表しているか? | Object description (オブジェクトの説明): エンタープライズ取引先の有効なサービス契約を追跡します。更新日と SLA 層が含まれます。 | Object description (オブジェクトの説明): 空白。エージェントには API 参照名のみが表示されます。 |
この項目はどういう意味か? | Field label (項目の表示ラベル): | Field label (項目の表示ラベル): |
どの選択リスト値を選択すればよいか? | Pending — Legacy Contract Review (保留中 — 旧契約レビュー) | PND_LGCY_2 |
メタデータをクリーンに保つ
クリーンなメタデータは、外部ツールが適切な項目をシームレスに見つけるのに役立ちます。メタデータが整理されていないと、プログラムによるコール元が推測に頼らざるを得なくなり、処理の停止や誤った操作につながります。ワークフローを公開する前に、トラフィックの多いオブジェクトから順に、組織のメタデータ基盤を監査します。
- メタデータ監査の基準: メタデータレイヤーには、組織に含まれる内容のみが表示されます。項目の説明を空白のままにすると、サーバーは API 参照名のみを返します。たとえば、
revenue(収益) を検索するコール元は、説明的な表示ラベルがなければOpp_Rev_Adj_Q3という名前の項目とその概念を結びつけることができません。
次のチェックリストを使用して、リリース前にメタデータを監査します。
監査対象 | 確認すべき内容 | プログラムによるコール元にとっての重要性 |
|---|---|---|
オブジェクトの表示ラベル | カスタムオブジェクトの表示ラベルは、わかりやすくビジネスに適した内容になっているか? | エージェントは表示ラベルを使用して、オブジェクトが何を表しているかを識別します。 |
オブジェクトの説明 | 組織内のすべてのカスタムオブジェクトに詳細な説明が設定されているか? | 表示ラベルだけでは伝えられない、重要なビジネスコンテキストを補完します。 |
項目の表示ラベル | 項目の表示ラベルは、開発者向けの略称ではなく、わかりやすい名前になっているか? | エージェントは、人間が読める表示ラベルを使用して、ユーザーのインテントを特定の項目に対応付けます。 |
項目の説明 | 主要な項目 (特にカスタム項目や選択リスト) に説明を記載したか? | エージェントが項目の目的、ビジネスロジック、有効な値を理解するのに役立ちます。 |
Help Text (ヘルプテキスト) | ヘルプテキストは正確で最新の状態になっているか? | 古くなったヘルプテキストや過去の仕様に基づくヘルプテキストは、AI エージェントの推論を誤った方向に導く原因になります。 |
選択リスト値 | 値の名前は、略語や従来のコードを使わず、わかりやすく付けられているか? | コール元は、明示的な名前に基づいて選択リスト値を選択します (例: |
メタデータが不完全な場合、エージェントは意図された意味を推論したり、明確化を求めたり、アクションを完了できなかったりすることがあります。サポートされていない推論は、サイレントエラーを引き起こす可能性があります。適切に管理されたメタデータレイヤーは、あいまいさを軽減し、エージェントがスキーマをより正確に解釈するのに役立ちます。信頼性の高いアクションを実現するには、効果的な権限、入力規則、オートメーション、エラー処理、およびアプリケーションロジックも必要です。
- UI に依存しないエラー処理: ブラウザーでは、エンドユーザーが赤いエラーバナーを確認し、手動で入力を修正します。プログラムツールや AI エージェントは、代わりに構造化された決定論的なエラーメッセージを使用します。
カスタム Apex コード、フロー、入力規則を設定する際は、次の点を確認してください。
- 汎用的なシステム例外ではなく、明確で具体的なエラー文字列を返すこと。
- 外部の AI エージェントがエラー応答をプログラムで処理し、適切に回復し、ワークフローを失敗させることなく操作を再試行できるよう、実行可能なエラーの詳細を提供すること。
本番稼働前に
最初の外部ツールまたはエージェントを接続する前に、以下のステップが完了していることを確認してください。強固なデータ基盤を構築するには、単に有効化するだけでなく、入念な準備が必要です。
設定と認証
- [Setup (設定)] > [Salesforce Hosted MCP Servers (Salesforce でホストされている MCP サーバー)] で、Salesforce でホストされている MCP サーバーを有効化します。
- PKCE を用いた OAuth 2.0 を認証に使用して、
mcp_api scopeを指定して外部クライアントアプリケーションを設定します。
インテグレーションユーザーと権限
- インテグレーションユーザーに割り当てられた権限セットとロール階層を確認します。
- プログラム型ツールに接続されているすべてのプロファイルに対して、FLS を適用して機密項目をマスクまたは非表示にします。
メタデータ
- トラフィックの多いすべてのカスタムオブジェクトのオブジェクト表示ラベルと説明を確認します。
- 主要な項目 (特にカスタム項目と選択リスト) の項目表示ラベル、項目の説明、ヘルプテキストを確認します。
- 選択リスト値に含まれる略語や従来のコードを、明確でわかりやすい名前に置き換えます。
エラー処理
- カスタム Apex コード、フロー、および入力規則が、汎用的なシステム例外ではなく、明示的なエラー文字列を返すことを確認します。
セキュリティは基盤の一部
プログラム的なツールが Salesforce に接続する場合、セキュリティモデルを回避するショートカットは存在しません。すべてのユーザーに適用される FLS、オブジェクト権限、共有ルールが、そのまま継承されます。このガバナンスレイヤーこそが、基盤の信頼性を支えています。
すべての MCP サーバートランザクションは、mcp_api scope を使用した外部クライアントアプリケーションを通じて範囲設定された、認証済みユーザーとして実行されます。標準の CRUD、FLS、共有ルール、プロファイル権限、および権限セットがすべて直接適用されます。すべてのアクションはログに記録され、監査履歴において認証済みユーザーに関連付けられます。
次のステップ
次の単元では、Data 360 とクロスクラウド MCP によって基盤を拡張し、あらゆるコール元がエンタープライズデータの完全で統合されたビューを取得できるようにする方法について学習します。
リソース
- Trailhead: Salesforce Headless 360 入門
- Trailhead: Salesforce ヘッドレスツールキット
- Salesforce News and Insights: Introducing Salesforce Headless 360 (Salesforce Headless 360 のご紹介)
- Salesforce ブログ: Introduction to Salesforce Headless 360 for Admins (システム管理者向け Salesforce Headless 360 入門)
- 360 ブログ: Entering a New Era of Salesforce Development with Headless 360 (Headless 360 で Salesforce 開発の新時代へ)
- Salesforce 開発者ブログ: What Salesforce Headless 360 Means for Developers (開発者にとって Salesforce Headless 360 とは?)