---
title: "Bright DataでSalesforce Agentforceのアカウントリサーチエージェントを構築する"
slug: salesforce-agentforce-bright-data
date: 2026-05-26T11:42:07+00:00
modified: 2026-05-26T11:42:08+00:00
permalink: https://brightdata.jp/blog/ai/salesforce-agentforce-bright-data
type: blog
---

[ ブログ ](https://brightdata.jp/blog "ブログ") / [AI](https://brightdata.jp/blog/ai)







 [AI](https://brightdata.jp/blog/ai)

# Bright DataでSalesforce Agentforceのアカウントリサーチエージェントを構築する

顧客との通話前のアカウントリサーチは、営業担当者1人あたり10〜15分かかることがあります。Bright DataとSalesforce Agentforceを使ってリサーチエージェントを構築する方法を学びましょう。

 11 分読





 [ ![Satyam Tripathi](https://media.brightdata.jp/2024/09/Satyam-Tripathi-50x50.png) ](https://brightdata.com/blog/authors/satyam-tripathi)

 [Satyam Tripathi

Technical Writer

 ](https://brightdata.com/blog/authors/satyam-tripathi)





 ![Build an account research agent in Salesforce Agentforce with Bright Data](https://media.brightdata.jp/2026/05/Build-an-account-research-agent-in-Salesforce-Agentforce-with-Bright-Data.png)





顧客との通話前のアカウントリサーチは、営業担当者1人あたり10〜15分かかることが多いです。ワークフローはほぼ手作業で、担当者はSalesforceを離れてGoogleを開き、複数のタブをスキャンして、調査結果をメモフィールドに貼り付けます。作業のほとんどは検索と情報の統合です。

[Bright DataのWeb Unlocker](/products/web-unlocker)は、ほとんどの公開URLからクリーンなMarkdownを返します。これをSalesforce Agentforceに組み込むことで、担当者はSalesforceを離れることなく、チャットプロンプトから出典付きのアカウントリサーチを取得できます。内部的には、1つのAgentforceサブエージェント、3つのApexクラス、小さなCloudflare Workerプロキシで構成されています。

### TL;DR

- Agentforceサブエージェントが営業担当者からの自然言語プロンプトを受け取り、Bright Data Web Unlockerを呼び出して、Salesforceチャット内で出典付きのアカウントブリーフィングを返します。
- ApexのHTTPクライアントは、数キロバイトを超えるチャンク転送レスポンスに対して警告なしに失敗します（API v66.0で確認済み）。そのため、この統合では小さなCloudflare Workerを経由してバッファリングし、明示的な`Content-Length`ヘッダーで再送信します。
- AgentforceのCanvas UIは、チャット駆動エージェントがプロンプトから抽出した入力を受け取るために必要な`is_user_input: True` YAMLフラグを隠しています。修正はScriptモードで行います。
- SalesforceのExternal Credentialパターンは3つのオブジェクト（External Credential、Named Credential、Permission Set）に分かれており、スキップすると401を返す見落としやすいチェックボックスが1つあります。
- Agentforceはデフォルトでエージェントのレスポンスから外部URLを削除します。エージェントは内部的にURLを読み取りますが、ドメインがTrusted URLsの許可リストに登録されていない限り表示されません。
- 合計フットプリントは約6KBのApex、1つのCloudflare Worker、3つのSalesforce資格情報オブジェクト、1つのサブエージェントです。すべてのコードブロックは実際のSalesforce Developer Edition組織でテスト済みです。

### 始める前に

このチュートリアルには4つのアカウントとツールが必要です。すべて無料です：

- **Bright Dataアカウント**（少なくとも1つのWeb Unlockerゾーンがプロビジョニングされていること）。新規アカウントには無料トライアルクレジットが含まれており、チュートリアルのリクエスト量はそのクレジット内に十分収まります。
- **Cloudflareアカウント**（Workerプロキシ用）。無料ティアにクレジットカードは不要で、初回使用時に`workers.dev`サブドメインを選択します。
- **Agentforceが有効なSalesforce Developer Edition組織。**最近のDeveloper Edition組織にはAgentforce、Data Cloud、Agentforce Studioがプリインストールされています。パート5に進む前に、App Launcherに**Agentforce Studio**アプリが表示されることを確認してください。表示されない場合は、Agentforce非対応の組織であり、後半のパートは機能しません。
- **テスト用HTTPリクエストを送信する方法。**パート2にはWorkerを検証するための`curl`コマンドが含まれています。macOS、Linux、Windows 11には`curl`が同梱されています。GUIを使いたい場合は、PostmanやInsomniaも同じヘッダーとボディで動作します。これらがなくインストールもしたくない場合は、単独のWorkerテストをスキップして、パート3でSalesforceからエンドツーエンドで検証することもできます。
- **System Administratorプロファイル（またはAuthor Apex、Modify All Data、Customize Applicationを持つプロファイル）。**新規のDeveloper Edition組織では自動的に付与されます。ロックダウンされたプロファイルを持つ会社のサンドボックスで作業している場合は、代わりに新しいDeveloper Edition組織に切り替えてください。

### 作成するもの

*Account Briefing Agent*というAgentforceエージェントを構築します。担当者が自然言語で質問を入力すると、エージェントはプロンプトをカスタムサブエージェントにルーティングし、適切なツールを選択して、薄いCloudflare WorkerプロキシからBright Dataを呼び出し、出典付きのアカウントブリーフィングを合成してチャットに投稿します。アーキテクチャは5つの要素で構成されています：

- **Bright Data Web Unlocker**（Webデータのプリミティブとして）。ほとんどのURLを受け取り、[クリーンなMarkdown](/blog/web-data/scrape-websites-to-markdown)を返す単一エンドポイントです。
- **Cloudflare Worker**（SalesforceとBright Data間のプロキシとして）。無料ティアで小規模チームをカバーします。
- **Salesforce External Credential + Named Credential + Permission Set**（認証レイヤーとして）。
- **Apex**（3つのクラス）：共有サービス1つと、`@InvocableMethod`を使用した2つのラッパー（Agentforceから呼び出し可能にするアノテーション、Agent Actionごとに1つ）。
- **Agentforceサブエージェント**（2つのアクション、インストラクションブロック、分類説明を持つ）。

### アーキテクチャの概要

担当者のプロンプトからブリーフィングまでのリクエストフローを示します：

```none
Rep prompt in Agentforce
        │
        ▼
Agent Router  ──►  Account Web Intelligence subagent
                          │
                          ├─► Apex: BrightDataNewsAction
                          │     └─► Named Credential → Cloudflare Worker → Web Unlocker → Google News
                          │
                          └─► Apex: BrightDataFetchAction
                                └─► Named Credential → Cloudflare Worker → Web Unlocker → target URL
        │
        ▼
LLM synthesis  ──►  Briefing back to the rep
```

Cloudflare Workerが必要な理由は、Salesforce ApexがHTTP/1.1のチャンク転送レスポンスを確実に処理できず、Bright Dataは数キロバイトを超えるペイロードにチャンクエンコーディングを使用するためです。Workerはレスポンスを単一のArrayBufferにバッファリングし、明示的な`Content-Length`ヘッダーを付けて再送信します。これがないと、Apexからのすべての呼び出しは200ステータスとゼロバイトのボディを返します。以下のパート2でデバッグと修正の手順を説明します。

Bright Dataにはこの種の構築に適した製品がいくつかあります：解析済みGoogle結果用の[SERP API](/products/serp-api)、LinkedInやCrunchbase専用のスクレイパーなどです。このビルドではWeb Unlockerのみを使用します。任意のURLに対して同じエンドポイントで動作するため、Apex側をシンプルに保てます。パート2のCloudflare WorkerプロキシはすべてのBright Data APIエンドポイントを同様にカバーするため、後でSERP APIや専用スクレイパーに切り替えてもSalesforce側の配線は変わりません。

### パート1：Bright Dataのセットアップ

Bright Dataアカウントをお持ちでない場合は、[Bright Dataのサインアップページでアカウントを作成してください](/)。使用するWeb UnlockerゾーンはダッシュボードのWeb Access APIセクションにあります。

#### Web Unlockerゾーンの作成または確認

ダッシュボードを開き、左ナビゲーションの**Web Access API**に移動して、[Web Unlockerゾーン](https://docs.brightdata.com/scraping-automation/web-unlocker/quickstart)が存在することを確認します。アカウントにない場合は、**Create API**（右上）をクリックしてドロップダウンから**Unlocker API**を選択します。任意の名前を付けてください（ゾーン名は作成後に変更できないため、`agentforce_unlocker`のような安定した名前を選んでください）。名前を書き留めておいてください。パート4の`BrightDataService.cls`の`UNLOCKER_ZONE`定数と、パート2のcurlテストに使用します。

![Web Access APIゾーンリストを表示するBright Dataダッシュボード](https://media.brightdata.com/2026/05/B1tSNnqyfe.png)*Web Unlockerゾーンは、両方のAgentforceアクションが使用するプリミティブです。*

#### APIトークンの作成

**Settings**（左下）→ **Users and API keys**タブ → **Add API key**（**User**権限）をクリックします。キーは生成時に一度だけ表示され、その後はマスクされます。今すぐコピーして安全な場所に保存してください。パート3でSalesforceに貼り付けます。

![APIキーセクションを表示するBright Dataアカウント設定。キーはActive状態、User権限、Unlimited有効期限で表示されています。](https://media.brightdata.com/2026/05/SJAGH2cJGx.png)これでBright Dataのセットアップは完了です。

### パート2：Cloudflare Workerプロキシのデプロイ

Salesforceを設定する前に、Bright Dataの前にプロキシが必要です。理由はSalesforce ApexがチャンクTransferレスポンスを読み取る方法の制限にあります。非trivialなHTTPコールアウトを行うApex開発者なら誰でも遭遇する可能性があります。

#### バグの説明

Salesforce Apexの`Http`クライアントは標準HTTPをサポートしていますが、実用上の欠点が1つあります：`Content-Length`ヘッダーのない[チャンク転送エンコーディング](https://datatracker.ietf.org/doc/html/rfc9112#section-7.1)を使用するHTTP/1.1レスポンスを確実に解析できません。チャンクレスポンスの場合、コールアウトは`Status Code = 200`、`Content-Type = null`、`Response Size = 0 bytes`を返し、例外や警告はありません。`getBody()`と`getBodyAsBlob().toString()`はどちらも空文字列を返します。

Bright Dataの`/request`エンドポイントは、数キロバイトを超えるレスポンスにチャンク転送エンコーディングを使用します。小さなテストページ（Bright Dataのwelcome.txt）へのWeb Unlocker呼び出しはしきい値以下に収まり、content-lengthレスポンスを返すためApexはクリーンに解析できます。しかし実際のページ（企業のホームページ、Google Newsの検索）はしきい値を超えてチャンク化され、Apexは空のボディを返します。

これがApex側の問題であってネットワーク側ではないことを証明する2つの事実があります：同じエンドポイントへの同じペイロードの`curl`呼び出しは9KBのボディをクリーンに返し、Apex匿名実行からの同じ呼び出しはレスポンスヘッダーに`Transfer-Encoding: chunked`が含まれた状態で0バイトを返します。

修正は設定変更ではなく構造的なものです：SalesforceとBright Dataの間にバッファリングプロキシを配置します。プロキシはBright Dataのチャンクストリームを完全に読み取り、明示的な`Content-Length`ヘッダーを付けてSalesforceにレスポンスを再送信します。Apexはそのレスポンスをクリーンに解析します。

Cloudflare Workerはこのプロキシのホスティングに適しています。低ボリュームでは無料、数分でデプロイでき、エッジで動作し、ボディ全体が1画面のJavaScriptに収まります。

#### Workerの作成

アカウントをお持ちでない場合は[Cloudflareダッシュボード](https://dash.cloudflare.com)でサインアップしてください。ダッシュボードで**Workers**を見つけます（ダッシュボードのバージョンによって**Compute** → **Workers &amp; Pages**の下に表示されます）。**Create application**をクリックし、テンプレートから**Hello World**を選択します。初回使用時にCloudflareが`workers.dev`サブドメインの選択を促します（無料の開発サブドメインです）。Workerに覚えやすい名前を付けてください。このビルドでは`bd-proxy`を使用します。プレースホルダーがデプロイされたら、**Edit code**をクリックします。

エディタ内のプレースホルダーコードをすべて選択し、代わりに以下を貼り付けます：

```none
/**
 * Bright Data to Salesforce Apex proxy.
 *
 * Salesforce Apex does not reliably consume HTTP/1.1 chunked-transfer
 * responses, which is what Bright Data returns for any non-trivial payload.
 * This Worker buffers the full response and re-serves it with an explicit
 * Content-Length header. Apex parses that response cleanly.
 *
 * Production deployments typically route external API calls through an
 * integration layer like MuleSoft or Heroku. This Worker is the minimal
 * stand-in for that role.
 */

export default {
  async fetch(request) {
    const url = new URL(request.url);
    const bdUrl = 'https://api.brightdata.com' + url.pathname + url.search;

    // Strip Cloudflare-injected headers we shouldn't forward upstream.
    const forwardHeaders = new Headers(request.headers);
    forwardHeaders.delete('host');
    forwardHeaders.delete('cf-connecting-ip');
    forwardHeaders.delete('cf-ray');
    forwardHeaders.delete('cf-visitor');
    forwardHeaders.delete('x-forwarded-for');
    forwardHeaders.delete('x-forwarded-proto');
    forwardHeaders.delete('x-real-ip');

    try {
      const bdResponse = await fetch(bdUrl, {
        method: request.method,
        headers: forwardHeaders,
        body: ['GET', 'HEAD'].includes(request.method)
          ? undefined
          : await request.arrayBuffer(),
      });

      // Buffer the entire response into a single ArrayBuffer. This collapses
      // chunked transfer into a buffer of known length.
      const bodyBuffer = await bdResponse.arrayBuffer();

      const responseHeaders = new Headers();
      const ct = bdResponse.headers.get('Content-Type');
      if (ct) responseHeaders.set('Content-Type', ct);
      responseHeaders.set('Content-Length', bodyBuffer.byteLength.toString());
      const brdStatus = bdResponse.headers.get('x-brd-status-code');
      if (brdStatus) responseHeaders.set('X-Brd-Status-Code', brdStatus);

      return new Response(bodyBuffer, {
        status: bdResponse.status,
        headers: responseHeaders,
      });
    } catch (err) {
      return new Response(
        JSON.stringify({ error: 'Proxy error', message: err.message }),
        { status: 502, headers: { 'Content-Type': 'application/json' } }
      );
    }
  },
};
```

統合を修正する2行は`await bdResponse.arrayBuffer()`（チャンクストリーム全体をメモリに読み込む）と、`bodyBuffer.byteLength`から設定される明示的な`Content-Length`ヘッダー（Apexはそこからボディをクリーンに解析する）です。それ以外はヘッダー転送を処理します：受信リクエストのCloudflare注入ヘッダーを削除し、送信レスポンスのアップストリームステータスコードを保持します。

**Deploy**（右上）をクリックします。Cloudflareから`https://<worker-name>.<your-subdomain>.workers.dev`のようなURLが提供されます。コピーしておいてください。パート3でSalesforceに必要になります。

![bd-proxy worker.jsファイルを表示するCloudflare Workerコードエディタ。バッファリングロジック（`const bodyBuffer = await bdResponse.arrayBuffer()`）とContent-Lengthヘッダーの書き換えが表示されています。ステータスインジケーターはWorkerがActiveであることを示しています。](https://media.brightdata.com/2026/05/BJpochq1Gl.png)*重要な行：`await bdResponse.arrayBuffer()`がチャンクストリーム全体をメモリに読み込み、レスポンスオブジェクトの明示的な`Content-Length`ヘッダーによりApexがボディをクリーンに解析できます。*

#### Workerの動作確認

ローカルターミナルから、Workerに対してクイックテストを実行します。URLをご自身のものに置き換え、Bright Data APIトークンを使用してください：

```none
curl -i https://<your-worker>.workers.dev/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-bd-token>" \
  -d '{"zone":"mcp_unlocker","url":"https://www.salesforce.com","format":"raw","data_format":"markdown"}' \
  | head -20
```

レスポンスヘッダーには`200`ステータスと`content-length: <数値>`ヘッダーが含まれているはずです。`transfer-encoding: chunked`は含まれていないはずです。これがプロキシが正常に動作している証拠です。よくある失敗：**401**はBright Dataトークンが間違っている（`Authorization: Bearer ...`ヘッダーを再確認）；Workerからの**502**はWorkerコードがデプロイされていない（`Deploy`ステップを再確認）；`transfer-encoding: chunked`ヘッダーがまだ表示される場合はWorkerソースの`arrayBuffer()` + `Content-Length`行が抜けています。

エンタープライズ展開では、このWorkerはMuleSoftのAnypoint上で動作するもの、Herokuマイクロサービス、または認証・可観測性・レート制限を備えたカスタムAPIゲートウェイなど、本番グレードの統合ティアに置き換えられます。Workerはその役割の最小限の代替ですが、同じパターンはそれらの本番セットアップでも機能します。

### パート3：Salesforce資格情報の設定

Salesforceの[External Credentialパターン](https://help.salesforce.com/s/articleView?id=xcloud.nc_named_creds_and_ext_creds.htm)は、サードパーティの資格情報を3つのオブジェクトに分割します：**External Credential**（トークンを保持）、**Named Credential**（エンドポイントを保持）、**Permission Set**（External Credentialのプリンシパルへのアクセスをユーザーに付与）。

#### External Credentialの作成

歯車アイコン（任意のSalesforceページの右上）→ **Setup**をクリックします。Setupで、左レールの上部にある**Quick Find**ボックスを使用して**Named Credentials**を検索します。結果をクリックします。表示されたページで**External Credentials**タブをクリックし、**New**をクリックします。

以下のフィールドを入力します：

- **Label**: `Bright Data Cred`
- **Name**: `Bright_Data_Cred`（自動入力）
- **Authentication Protocol**: `Custom`

**Save**をクリックします。

詳細ページで**Principals**セクションを見つけて**New**をクリックします：

- **Parameter Name**: `BrightDataPrincipal`
- **Sequence Number**: `1`
- **Identity Type**: `Named Principal`

プリンシパルの下の**Authentication Parameters**セクションに以下を追加します：

- **Name**: `api_key`
- **Value**: Bright Data APIトークンを貼り付ける

**Save**をクリックします。

External Credentialページに戻り、**Custom Headers**セクションを見つけて**New**をクリックします：

- **Name**: `Authorization`
- **Value**: `Bearer {!$Credential.Bright_Data_Cred.api_key}`
- **Sequence Number**: `1`

> ⚠️ **マージフィールドは設定した名前と一致する必要があります。**数式内の`Bright_Data_Cred`はExternal CredentialのAPI Nameと一致する必要があります。`api_key`はPrincipalで設定したAuthentication Parameterの名前と一致する必要があります。どちらかの名前を変更した場合は、数式を編集して一致させてください。

これは重要です：このカスタムヘッダーの**Allow Formulas in HTTP Header**チェックボックスをオンにしてください。見つけ方：ヘッダー行を保存した後、行をクリックして詳細ビューを開きます。チェックボックスはその詳細ページにあり、親のExternal Credentialページにはありません。スキップすると、Salesforceはリテラル文字列`Bearer {!$Credential...}`をBright Dataに送信し、401が返されますが、どのチェックボックスを見逃したかはエラーメッセージに表示されません。**Save**をクリックします。

> ⚠️ **次のセクションでも同じ名前のチェックボックスが表示されます。**「Allow Formulas in HTTP Header」は**2か所**に表示されます。**チェックボックスA**は今チェックしたもの（Custom Headerの詳細ページ）です。**チェックボックスB**はNamed CredentialのCallout Optionsにあります。両方をチェックする必要があります。どちらか一方だけがチェックされている場合、マージフィールドはリテラルテキストとして送信され、Bright Dataは401を返します。

![Salesforce SetupのBright_Data_Cred External Credential詳細ページ。Authentication ProtocolがCustomに設定され、BrightDataPrincipalという名前のPrincipalと、値が'Bearer {!$Credential.Bright_Data_Cred.api_key}'のCustom Headerが表示されています。](https://media.brightdata.com/2026/05/HkEN225kMe.png)*Custom Headerのマージフィールド値は、リクエスト時にAPIトークンを解決する部分です。`Allow Formulas in HTTP Header`チェックボックス（この深さでは表示されません；ヘッダーの詳細ページにあります）をオンにしないと、マージフィールドはリテラルテキストとして送信されます。*

#### Named Credentialの作成

同じ**Named Credentials**セクションで、**Named Credentials**タブに戻り**New**をクリックします：

- **Label**: `Bright Data API`
- **Name**: `Bright_Data_API`
- **URL**: Cloudflare WorkerのURLを貼り付ける（例：`https://bd-proxy.<your-subdomain>.workers.dev`）
- **Enabled for Callouts**: チェック済み
- **External Credential**: `Bright Data Cred`を選択

**Callout Options**の下で以下を設定します：

- **Generate Authorization Header**: **チェックなし**（Custom Headerで独自に提供するため）
- **Allow Formulas in HTTP Header**: **チェック済み**（マージフィールドが解決されるように）
- **Allow Formulas in HTTP Body**: **チェック済み**（動的JSONボディが機能するように）

**Save**をクリックします。

![Salesforce Named Credential 'Bright Data API'の詳細ページ。URLがCloudflare Workerを指し、External CredentialがBright Data Credに設定され、Generate Authorization Headerがチェックなし、Allow Formulas in HTTP Headerがチェック済み、Allow Formulas in HTTP Bodyがチェック済みになっています。](https://media.brightdata.com/2026/05/r1Fn33ckze.png)*URLはapi.brightdata.comではなくCloudflare Workerを指しています。これがチャンク転送の修正が機能する仕組みです。3つのチェックボックスの状態はそれぞれ独立して重要です；どれか1つが間違っていると警告なしにコールアウトが失敗します。*

#### Permission Setの作成

SalesforceはPermission Setが明示的にアクセスを付与するまで、System AdministratorでさえExternal Credentialのプリンシパルを使用できません。このステップをスキップすると、Apexは有用な診断情報のない`INVALID_OPERATION`エラーを返します。

Setupで**Permission Sets**を検索し、**New**をクリックします：

- **Label**: `Bright Data Access`
- **API Name**: `Bright_Data_Access`
- **License**: 空白のまま

**Save**をクリックします。

詳細ページで**External Credential Principal Access**までスクロールし、**Edit**をクリックします。`Bright_Data_Cred - BrightDataPrincipal`をAvailableリストからEnabledリストに移動します。**Save**をクリックします。

詳細ページに戻り、上部の**Manage Assignments**をクリックし、**Add Assignments**をクリックして自分のユーザーを選択し、割り当てを完了します。

![Salesforce Permission Set 'Bright Data Access'。External Credential Principal AccessセクションにBright_Data_Cred - BrightDataPrincipalが付与され、ページ上部にManage Assignmentsボタンが表示されています。](https://media.brightdata.com/2026/05/HJG9An9yMg.png)*Permission Setは、どのユーザーがBright Dataを呼び出すコードを実行できるかをスコープするゲーティングメカニズムです。エンタープライズ組織では、個々の管理者ではなく、Permission Set Groupを介してサービスユーザーや特定のプロファイルに割り当てられます。*

#### 先に進む前に配線を確認する

歯車アイコン（右上）→ **Developer Console**をクリックします。新しいブラウザウィンドウで開きます。そのウィンドウにフォーカスが当たったら、**Debug → Open Execute Anonymous Window**でAnonymous Apexを開きます。以下のコードを貼り付けて**Execute**をクリックします：

```none
HttpRequest req = new HttpRequest();
req.setEndpoint('callout:Bright_Data_API/request');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setBody('{"zone":"mcp_unlocker","url":"https://geo.brdtest.com/welcome.txt?product=unlocker&method=api","format":"raw"}');
req.setTimeout(60000);
HttpResponse res = new Http().send(req);
System.debug('STATUS: ' + res.getStatusCode());
System.debug('BODY: ' + res.getBody().left(500));
```

Executeをクリックすると、Developer Consoleの下部パネルに新しいログ行が表示されます。その行をダブルクリックしてログビューアを開き、下部の**Debug Only**をチェック（またはフィルターボックスに`USER_DEBUG`と入力）します。STATUSとBODYの値を表示する2行が表示されるはずです。`STATUS: 200`とBright Dataのウェルカムテキストを含むボディを確認してください。401が表示される場合は、Custom Headerの「Allow Formulas in HTTP Header」チェックボックス（ヘッダーの詳細ページのもの**と**Named CredentialのCallout Optionsのもの）を再確認してください。`INVALID_OPERATION`が表示される場合は、Permission Setの割り当てを再確認してください。

### パート4：Apexレイヤーの作成

Apexはクラスごとに1つの[`@InvocableMethod`](https://developer.salesforce.com/docs/ai/agentforce/guide/agent-invocablemethod.html)のみをAgentforce呼び出し可能なアクションとして登録します。そのため、統合では1つではなく3つのクラスを使用します：HTTPの配管用の共有サービスと、Agent Actionごとに1つのクラスです。

各ブロックをそのまま貼り付けてください。変更したい可能性がある主な行は、Bright Dataゾーンの名前が異なる場合（パート1）の`BrightDataService.cls`内の`private static final String UNLOCKER_ZONE = 'mcp_unlocker';`です。

Setupで**Apex Classes**をQuick Findで検索し、結果をクリックします。**New**をクリックします。エディタが`public class YourClassName {}`のようなプレースホルダークラスで開きます。コードエリア（右側のVersion Settingsパネルではなく大きなテキストボックス）をクリックし、プレースホルダーテキストをすべて選択してDeleteを押し、以下のソースを貼り付けます。クラス名はソースから取得されるため、他のフィールドを入力する必要はありません。**Save**をクリックします。

`BrightDataNewsAction`と`BrightDataFetchAction`はどちらも`BrightDataService`を参照するため、この順序で3つのクラスを作成します。サービスを最初に保存する必要があります：

#### `BrightDataService.cls`：共有HTTPおよび解析レイヤー

このクラスはHTTPの配管と、両方のAgent Actionが呼び出す2つのヘルパーメソッド（`searchNews`と`fetchUrlAsMarkdown`）を保持します。`@InvocableMethod`はここにはありません；そのアノテーションは以下のアクションラッパークラスにあります。クラスは以下の通りです：

```none
public with sharing class BrightDataService {

    private static final String BD_ENDPOINT      = 'callout:Bright_Data_API/request';
    private static final String UNLOCKER_ZONE    = 'mcp_unlocker';
    private static final Integer CALLOUT_TIMEOUT = 60000;
    private static final Integer MAX_RESPONSE_CHARS = 50000;

    /**
     * Fetches the Google News results page for `companyName` (past month) as
     * clean Markdown via Bright Data Web Unlocker. The LLM downstream is
     * responsible for extracting individual articles, sources, and dates.
     */
    public static String searchNews(String companyName) {
        String googleNewsUrl =
            'https://www.google.com/search?q='
            + EncodingUtil.urlEncode(companyName, 'UTF-8')
            + '&tbm=nws&tbs=qdr:m';

        Map<String, Object> body = new Map<String, Object>{
            'zone'        => UNLOCKER_ZONE,
            'url'         => googleNewsUrl,
            'format'      => 'raw',
            'data_format' => 'markdown'
        };

        HttpResponse res = sendRequest(JSON.serialize(body));

        if (res.getStatusCode() != 200) {
            return 'Bright Data returned status '
                + res.getStatusCode() + ': ' + res.getBody().left(300);
        }

        String content = res.getBody();
        if (String.isBlank(content)) {
            return 'No content returned for "' + companyName
                + '". The page may have been empty or blocked.';
        }
        if (content.length() > MAX_RESPONSE_CHARS) {
            content = content.left(MAX_RESPONSE_CHARS)
                + '\n\n[Content truncated at ' + MAX_RESPONSE_CHARS + ' characters]';
        }

        return 'Google News results for "' + companyName
            + '" (past month). Extract article titles, sources, '
            + 'publication dates, and URLs from the Markdown below:\n\n'
            + content;
    }

    /**
     * Fetches any URL via Bright Data Web Unlocker and returns the page as
     * clean Markdown.
     */
    public static String fetchUrlAsMarkdown(String url) {
        Map<String, Object> body = new Map<String, Object>{
            'zone'        => UNLOCKER_ZONE,
            'url'         => url,
            'format'      => 'raw',
            'data_format' => 'markdown'
        };

        HttpResponse res = sendRequest(JSON.serialize(body));

        if (res.getStatusCode() != 200) {
            return 'Web Unlocker returned status '
                + res.getStatusCode() + ': ' + res.getBody().left(300);
        }

        String content = res.getBody();
        if (content.length() > MAX_RESPONSE_CHARS) {
            content = content.left(MAX_RESPONSE_CHARS)
                + '\n\n[Content truncated at ' + MAX_RESPONSE_CHARS + ' characters]';
        }
        return content;
    }

    private static HttpResponse sendRequest(String jsonBody) {
        HttpRequest req = new HttpRequest();
        req.setEndpoint(BD_ENDPOINT);
        req.setMethod('POST');
        req.setHeader('Content-Type', 'application/json');
        req.setBody(jsonBody);
        req.setTimeout(CALLOUT_TIMEOUT);
        return new Http().send(req);
    }
}
```

このクラスには意図的に`@InvocableMethod`がありません。2つのアクションクラスが使用する共有HTTPレイヤーです。

#### `BrightDataNewsAction.cls`：ニュース検索アクション

エージェントがニュースを検索すると判断したとき、Agentforceはこの薄い呼び出し可能ラッパーを呼び出します。入力を検証し、HTTPの作業を`BrightDataService.searchNews()`に委譲し、Agentforceが期待するResponseの形式で結果を返します。クラスは以下の通りです：

```none
public with sharing class BrightDataNewsAction {

    public class Request {
        @InvocableVariable(
            required=true
            label='Company Name'
            description='The name of the company to search news about. E.g. "Salesforce" or "Acme Corp".')
        public String companyName;
    }

    public class Response {
        @InvocableVariable(
            label='News Results'
            description='Formatted summary of recent news with titles, sources, dates, URLs, and snippets.')
        public String newsResults;
    }

    @InvocableMethod(
        label='Search Recent Company News (Bright Data)'
        description='Searches Google News via Bright Data for recent (past month) articles about a specific named company. Use this whenever the user asks about recent news, announcements, press releases, funding rounds, acquisitions, leadership changes, or current events for a named company.'
        callout=true)
    public static List<Response> searchCompanyNews(List<Request> requests) {
        List<Response> responses = new List<Response>();
        for (Request req : requests) {
            Response resp = new Response();
            try {
                resp.newsResults = String.isBlank(req.companyName)
                    ? 'Error: A company name is required.'
                    : BrightDataService.searchNews(req.companyName);
            } catch (Exception e) {
                resp.newsResults = 'Error fetching news for ' + req.companyName + ': ' + e.getMessage();
            }
            responses.add(resp);
        }
        return responses;
    }
}
```

Agentforceの推論エンジンは`@InvocableMethod`アノテーションの`description`フィールドを読み取り、このアクションをいつ呼び出すかを決定します。

#### `BrightDataFetchAction.cls`：URLフェッチアクション

2番目の呼び出し可能ラッパーはニュースアクションと同じパターンに従いますが、担当者が言及した任意のURLをフェッチします。検証ブロックはコールアウト前に不正な入力も拒否します。クラスは以下の通りです：

```none
public with sharing class BrightDataFetchAction {

    public class Request {
        @InvocableVariable(
            required=true
            label='URL to Fetch'
            description='The full URL of a web page to retrieve. Must start with http:// or https://.')
        public String url;
    }

    public class Response {
        @InvocableVariable(
            label='Page Content'
            description='Clean Markdown representation of the page content.')
        public String pageContent;
    }

    @InvocableMethod(
        label='Fetch Web Page as Markdown (Bright Data)'
        description='Retrieves the content of any web URL via Bright Data Web Unlocker and returns it as clean Markdown. Use this when you need to read a specific URL: a company homepage, blog post, press release, or any link the user mentions.'
        callout=true)
    public static List<Response> fetchUrlAsMarkdown(List<Request> requests) {
        List<Response> responses = new List<Response>();
        for (Request req : requests) {
            Response resp = new Response();
            try {
                if (String.isBlank(req.url)
                    || (!req.url.startsWithIgnoreCase('http://')
                        && !req.url.startsWithIgnoreCase('https://'))) {
                    resp.pageContent = 'Error: A valid URL starting with http:// or https:// is required.';
                } else {
                    resp.pageContent = BrightDataService.fetchUrlAsMarkdown(req.url);
                }
            } catch (Exception e) {
                resp.pageContent = 'Error fetching ' + req.url + ': ' + e.getMessage();
            }
            responses.add(resp);
        }
        return responses;
    }
}
```

3つすべてを保存すると、Setup → Apex ClassesにActiveとして表示されるはずです。

!['Bright'でフィルタリングされたSalesforce Apex Classesリスト。BrightDataFetchAction（1,820文字、Active）、BrightDataNewsAction（1,787文字、Active）、BrightDataService（2,820文字、Active）がすべてAPI Version 66.0で表示されています。](https://media.brightdata.com/2026/05/SJNiAhqkGg.png)*Apexの合計フットプリントは3つのクラスで約6.4KBです。共有サービスとAgent Actionごとに1つのアクションクラスというパターンは、複数の呼び出し可能が必要な場合の標準的なSalesforceパターンです。*

#### アクションのテスト

アクションをAgentforceに接続する前に、エンドツーエンドで動作することを確認します。Anonymous Apexで：

```none
BrightDataNewsAction.Request r = new BrightDataNewsAction.Request();
r.companyName = 'Salesforce';
List<BrightDataNewsAction.Response> out =
    BrightDataNewsAction.searchCompanyNews(new List<BrightDataNewsAction.Request>{ r });
System.debug('LENGTH: ' + out[0].newsResults.length());
System.debug('PREVIEW: ' + out[0].newsResults.left(800));
```

`LENGTH`は5,000〜10,000の間で、プレビューはサービスクラスのプレフィックスで始まり、その後にGoogle News markdownが続くことを期待します。`LENGTH: 0`またはエラー文字列が表示される場合は、パート3の検証ステップに戻ってください。

### ![Agentforce Builderで、Account Web Intelligenceサブエージェントの「Actions Available For Reasoning」セクションに両方のBright Dataアクションが追加されている様子：Search Recent Company News (Bright Data)（入力：Company Name = Agent Populated）とFetch Web Page as Markdown (Bright Data)（入力：URL to Fetch = Agent Populated）](https://media.brightdata.com/2026/05/B1hJyp9JGe.png)

*「Agent Populated」とは、実行時にLLMの推論によって入力が埋められる場合にSalesforceが使用するラベルです。これは、チャット駆動型エージェントの統合に必要な状態です。*

### パート7：エージェントをテストする

Agent Builderで**Preview**タブをクリックします。チャットインターフェースが開き、**Reset Simulator**ボタンを含む黄色のバナーが表示されます。バナーが表示されたらクリックしてください。シミュレーターの会話メモリはセッションごとに管理されるため、テスト間でリセットすることが独立したトレースを取得する最も簡単な方法です。以下の4つのテストで、ルーティング、単一アクション呼び出し、並列呼び出し、および正直な失敗モードを検証します。

> **Preview**タブがグレーアウトしている場合は、キャンバス上部の**Activate**トグルを探してオンにしてください。ここでのアクティベートはPreview/Simulator用にエージェントを有効にするだけです。エンドユーザーがアクセスできるようにするには、Setup → Agentforce Studio → Connectionsからも割り当てる必要がありますが、それはこのビルドのスコープ外です。

#### テスト1：ニュース検索のみ

ニュースアクションがエンドツーエンドで実行されることを確認するには、次のように入力します：

```none
What's new at Salesforce in the past month?
```

エージェントはAccount Web Intelligenceにルーティングし、「Searching recent news…」というローディング状態を表示した後、ソース名をインラインで引用したテーマ別ニュースサマリーを返すはずです。キャンバス下部の**Trace**タブを開くと、完全な推論チェーンを確認できます。プレビュー右側の**Interaction Summary**パネルには、同じチェーンがコンパクトな形式で表示されます：Routerが選択したサブエージェント、呼び出されたアクション、エージェントの推論内容が確認できます。

![Agentforce Previewで「What's new at Salesforce in the past month?」というプロンプトに対し、「AI & Product Expansion」と「Strategic Partnerships」にグループ化されたテーマ別ニュースサマリーが表示され、ソース（Forbes、UC Today、PR Newswire）が引用されている。右側のInteraction Summaryには、Input → Transition to Subagent: Account Web Intelligence → Reasoning → Action: Search Recent Company News Bright Data → Reasoningの流れが表示されている。レスポンス内のソースURLはURL_Redactedとして表示されている](https://media.brightdata.com/2026/05/SkvlJT5kzg.png)*これはクリーンな単一アクション実行です。Routerが正しくルーティングし、エージェントは自然言語プロンプトから`companyName="Salesforce"`を抽出し、アクションを呼び出して、テーマ別サマリーを生成しました。`URL_Redacted`プレースホルダーは、SalesforceのURLトラストポリシーによるものです（以下の「エンタープライズガバナンス」セクションで説明）。*

> ルーティングはLLM駆動のため、まれにAccount Web Intelligenceサブエージェントの説明がテンプレート内の類似したもの（例：General FAQ）に負けることがあります。最初のテストが誤ったサブエージェントにルーティングされた場合は、説明により具体的なキーワード（「company news」「press release」「recent funding」「fetch URL」）を追加し、保存して**Reset Simulator**をクリックし、再試行してください。ルーターは新しいセッションごとに再分類を行います。

#### テスト2：URLフェッチのみ

直接URLプロンプトがフェッチアクションにルーティングされることを確認するには、**Reset Simulator**をクリックして次のように入力します：

```none
Read https://www.snowflake.com and tell me what they do
```

エージェントはニュースアクションではなく、Fetchアクションを呼び出すはずです。異なるプロンプトは異なるツールにルーティングされます。

![Agentforce Previewで「Read https://www.snowflake.com and tell me what they do」というプロンプトに対し、AI Data CloudとしてのSnowflakeの2文の概要が表示され、取得したコンテンツが限定的だったという正直な補足が続いている。右側のInteraction Summaryには1つのアクションのみ表示：Fetch Web Page as Markdown Bright Data。レスポンス内のURLはURL_Redactedとして表示されている](https://media.brightdata.com/2026/05/Hy-Z1TqJMe.png)*同じエージェントですが、異なるプロンプトが異なるツールにルーティングされます。Agent RouterはプロンプトをURLフェッチ（ニュース検索ではなく）として分類し、フェッチアクションのみを呼び出しました。これはエージェントが固定パイプラインを実行しているのではなく、推論していることの証拠です。*

#### テスト3：両方のアクションを並列実行

テスト3は、両方のアクションが呼び出されれば成功です。両方が200を返すかどうかは問いません。両方が成功すれば、クリーンな統合ブリーフィングが表示されます。一方が失敗した場合（以下のスクリーンショットのように）、エージェントは成功した方のデータを使ってブリーフィングを生成するはずです。これはルール5を実証します。**Reset Simulator**の後、次のように入力します：

```none
Give me a briefing on Anthropic, recent news plus what their homepage says about their product
```

エージェントは両方のアクションを呼び出し、統合ブリーフィングを生成するはずです。Traceには同じ推論チェーン内に2つの別々のActionの行が表示されます。

![Agentforce Previewの上半分で、AnthropicのブリーフィングにSAPパートナーシップ、Claude for Small Business、Claude Design、Financial Servicesローンチを含む5つのテーマ別ニュースが表示されている。ソース（SAP News Center、Anthropic、CNBC）が引用されている。右側のInteraction Summaryには両方のアクションが呼び出されていることが表示：Search Recent Company News Bright DataとFetch Web Page as Markdown Bright Data。レスポンス内のソースURLはURL_Redactedとして表示されている](https://media.brightdata.com/2026/05/HJRbJp9yGx.png)*エージェントは単一のユーザープロンプトから両方のアクションを呼び出しました。AnthropicのニュースセクションはBright DataのWeb UnlockerがGoogle Newsを呼び出した結果です。*

同じレスポンスがホームページセクションとして以下に続きますが、このランでは詳細を確認する価値のある部分的な失敗が発生しました：

![Agentforce Previewの同じレスポンスの下半分で「What Their Homepage Says」セクションが表示されている。エージェントはホームページコンテンツの取得に技術的な問題があったことを正直に報告し、直前に取得したニュースに基づいてAnthropicのポジショニングを説明するフォールバックを行っている。Interaction Summaryには「Fetch_Web_Page_as_Markdown_Bright_Data for https://www.anthropic.com（520エラーページが返された）」と、エージェントが「ソースURLを編集した要約ブリーフィングを生成した」ことが明示されている](https://media.brightdata.com/2026/05/ByUz1pcyfg.png)*ホームページのフェッチが520を返しました。これはWeb Unlockerが特定の試行でターゲットサイトを取得できなかった場合に使用するステータスです。エージェントはホームページのコンテンツを捏造せず、失敗を認め、直前に受信したニュースデータを使って企業の説明を行い、再試行を提案しました。*

部分的なツール失敗時のグレースフルデグラデーションは、サブエージェント指示のルール5が生み出すよう設計された本番動作です。これが重要なのは、公開ウェブが敵対的だからです：ターゲットサイトは防御を変更し、CDNが時折失敗し、ライブURLを呼び出すエージェントは時折発生する非200に対応しなければなりません。エージェントが*「ホームページのフェッチに失敗しました。ニュースから得た情報をお伝えします」*と言う場合、それは本番グレードの動作です。

#### テスト4：ハルシネーションなしの確認

実際の回答がない場合にエージェントが正直に失敗することを確認するには、**Reset Simulator**をクリックして次のように入力します：

```none
What's the latest news about Triposat Industries?
```

これは架空の会社名なので、実際のニュースは存在しません。Bright Dataは520、空の結果、または無関係なスニペットを返す可能性がありますが、いずれも実際の回答ではありません。エージェントは何が返ってきても、ニュースを捏造してはなりません。ここでの成功基準は**ステータスコードではなく動作**です：「最近のニュースは見つかりませんでした」「結果を取得できませんでした」などの正直な開示が許容される回答です。失敗とは、エージェントが存在しないForbesの記事や資金調達ラウンドを捏造することです。

![Agentforce Previewで「What's the latest news about Triposat Industries?」というプロンプトに対し、正直な開示が表示されている：「Triposat Industriesの最新ニュースを取得しようとしましたが、ニュースソースへのアクセスに問題があり、現時点では最新情報を取得できませんでした。」エージェントは再試行または特定の側面への転換を提案している。Interaction Summaryは検索アクションが呼び出されたことを確認し、自然言語サマリーには「プロバイダーからエラーに近い結果（ステータス520と部分的なHTML）を受信した」ことが明示されている](https://media.brightdata.com/2026/05/rJl7yT5yfg.png)*エージェントはニュースアイテムを捏造せず、ソースも作り上げませんでした。アクションを呼び出し、不良な結果を受け取り、それを開示しました。サブエージェント指示のルール5が意図通りに機能しました。*

### AgentforceにおけるURLの編集

上記のスクリーンショットのすべてのデモレスポンスでは、ソースURLが`URL_Redacted`として表示されています。これはSalesforce Agentforceの組み込みURLトラストポリシーによるものです。

デフォルトでは、Agentforceはエンドユーザーに届く前にエージェントのレスポンスから任意の外部URLを除去します。ただし、エージェントはツールが返した際に内部的には実際のURLを読み取り、推論に使用します。ドメインが明示的な許可リストに登録されていない限り、チャット出力に含めることができないだけです。

設定は可能です：Setupで**Trusted URLs**を検索し、許可したいドメインを追加します。営業ブリーフィングエージェントの場合、現実的な許可リストにはGoogleドメイン、自社のマーケティングドメイン、厳選されたニュースソース（Forbes、Reuters、Bloomberg、TechCrunch）が含まれます。

デフォルトの編集を有効のままにしておいてください。これによりデモが強化されます：エージェントはソースを名前（Forbes、TechAfrica News、SAP News Center）で引用し、編集によってSalesforceのガバナンスレイヤーが可視化されます。生のURLを含むデモはコンシューマー向けチャットボットと区別がつきませんが、編集されたバージョンはガバナンスレイヤーを可視化します。

### コスト

Bright Dataは[従量課金制および段階的プラン](/pricing/web-unlocker)において、Web Unlockerの成功したレスポンスに対してのみ課金します。失敗したレスポンスは課金されません。定価では、両方のアクションを呼び出すブリーフィングは数分の一セントの範囲に収まります。段階的プランではリクエストあたりのコストがさらに削減されます。

自社の支出を見積もるには、次の計算式を使用します：

```none
requests/month = reps × briefings_per_rep_per_day × workdays × actions_per_briefing
```

100人の営業担当者チームが22営業日に各5件のブリーフィングを実行し、ブリーフィングあたり2つのアクションを使用する場合、月間22,000リクエストになります。それにBright Dataの現在のリクエストあたりの料金（料金ページより）を掛けると月間コストが算出されます。

Cloudflare側では、Workerは一般的な営業チームの使用量において無料枠内に収まります。単一チームを超えてスケールする前に[Workersの料金](https://developers.cloudflare.com/workers/platform/pricing/)を確認してください。

Salesforce側では、コストは組織の既存のEinsteinジェネレーティブAIクレジット枠から引き落とされます。これはAgentforceのアクションが使用するのと同じ従量制プールです。**Setup → Einstein Generative AI → Usage**で組織の現在の枠と使用状況を確認してください。

### 次のステップ

上記のビルドは、アカウントインテリジェンスレイヤーの最小単位です。本番環境に移行する前に行うべき3つのことを以下に示します：

- Cloudflare Workerをカスタムドメイン（自社のDNS上の独自サブドメイン）の背後に移動し、組織のAPIゲートウェイを通じてルーティングします。Workerはこのプロキシの役割に適しています。カスタムドメインとゲートウェイの組み合わせが、運用上の所有権を確立します。
- Bright DataゾーンをエグレスIPレンジにロックします。Bright Dataダッシュボードで、Web Unlockerゾーンを編集し、CloudflareワーカーのアウトバウンドIP（[Cloudflareが公開しています](https://www.cloudflare.com/ips/)）をゾーンの許可リストに追加します。これにより、APIトークンが統合外で使用されることを防ぎます。
- `HttpCalloutMock`を使用して`BrightDataService`のApexテストクラスを追加します。3つのテストメソッド（成功パス、空のボディ、非200）で現実的な失敗モードをカバーし、Salesforceの75%カバレッジ要件を満たします。[Salesforce HttpCalloutMockドキュメント](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_classes_restful_http_testing_httpcalloutmock.htm)にパターンが記載されています。

ターゲットサイトに対してWeb Unlockerでは対応できなくなった場合は、Bright Dataの事前構築済みスクレイパーに切り替えてください。同じCloudflare Workerプロキシがそれらにも対応します。同じ`/request`エンドポイントを使用し、`zone`と`dataset_id`パラメーターが異なるだけです。例えば、専用の[LinkedIn Company Profile](/products/web-scraper/linkedin/company)、LinkedIn Jobs、[Crunchbaseスクレイパー](/products/web-scraper/crunchbase)はMarkdownではなく構造化JSONを返すため、エージェントはLLM抽出ステップをスキップしてSalesforceのカスタムフィールドに直接書き込めます。より広く言えば、[Bright DataのWeb Scraper API](/products/web-scraper)は数百のサイト向けの事前構築済みスクレイパーをカバーしています。

上記のビルドは足場として扱ってください。クレデンシャルレイヤー、プロキシ、サブエージェント構造、アクションの配線：同じ`/request`エンドポイントで別のBright Data製品に切り替えても、基盤は変わりません。営業担当者が実際に必要とするアカウントインテリジェンスの種類を選び、サブエージェント指示のプロンプトを変更してください。エージェントはそのまま残り、答える質問が変わります。

### よくある質問

#### Apexのコールアウトが空のボディを返すのはなぜですか？

ApexのHTTPクライアントは、`Content-Length`ヘッダーなしでチャンク転送エンコーディングを使用するHTTP/1.1レスポンスを確実に解析できません。Bright Dataや多くの最新APIは数キロバイトを超えるレスポンスをチャンク化します。修正方法は、明示的な`Content-Length`を付けてレスポンスを再送するバッファリングプロキシを通じて呼び出しをルーティングすることです。

#### このビルドでBright DataのSERP APIを使用できますか？

はい。Cloudflare Workerプロキシは、SERP API、Web Scraper API、データセットトリガーを含む`api.brightdata.com`でホストされているすべてのBright Data APIエンドポイントで機能します。ApexサービスクラスのSERPゾーン名に`zone`の値を変更し、URLパラメーターを`brd_json=1`付きのGoogle検索URLに変更してください。

#### MCPの代わりにApex InvocableMethodsを使用する理由は？

このビルドではApex InvocableMethodsを通じてBright Dataを公開しています。各アクションが独自のPermission Setガバナンスを持つ監査可能なAgent Actionになるためです。組織でSalesforceホスト型MCPサーバー（Spring ’26時点でベータ）が有効になっている場合は、Bright Data独自のMCPサーバーを通じてBright Dataを公開することもできます。どちらのパスも機能します。ここで示したInvocableMethodパスはSalesforceネイティブのガバナンスフックを提供し、MCPパスはBright Dataがサーバーを運用するため軽量です。

#### Agentforceのアクションはユーザー入力をどのように読み取りますか？

Agentforceのアクションは、各入力に設定された`is_user_input: True`というYAMLフラグを通じてユーザー入力を読み取ります。Canvas UIはこのフラグを非表示にし、入力をデフォルトで静的変数に設定するため、Agent BuilderでScriptモードに切り替えてYAMLを直接編集して値を変更します。

#### AgentforceがソースURLを非表示にするのはなぜですか？

外部URLは、そのドメインがSetup → Trusted URLsに追加されていない限り、エージェントのレスポンスから除去されます。これは組み込みのガバナンスレイヤーです。それでも、エージェントは内部的には実際のURLを読み取り、推論に使用します。特定のURLをユーザーに表示するには、ソースドメイン（Forbes、Reuters、自社サイト）を許可リストに追加してください。

#### Bright Dataの520エラーとは何ですか？

520は、特定の試行でターゲットサイトを取得できなかった場合にWeb Unlockerが返すステータスです。通常、サイトの防御がリクエストをブロックしたためです。サブエージェント指示のルール5はツールが失敗した場合にコンテンツを捏造することを禁止しているため、エージェントは失敗を正直に報告し、再試行を提案します。

#### このパターンが対応できる他のユースケースは何ですか？

チャーンリスク、競合インテリジェンス、更新リスクブリーフィングはすべてこのパターンに適合します。2つのApexアクション（ニュース検索、URLフェッチ）がほとんどのアカウントインテリジェンスタイプをカバーするためです。チャーンリスクには、ニュース検索を使ってレイオフやリーダーシップの変化を追跡します。競合インテリジェンスには、競合他社の料金ページをフェッチします。変わるのはプロンプトだけです。



お問い合わせ無料トライアル![google social icon](/wp-content/themes/brightdata/assets/images/ic_google.svg)









 目次







日本企業向けデータソリューション

日本のトップ企業が信頼するスケーラブルなウェブデータプラットフォーム。日本語24時間サポート、GDPR・個人情報保護法準拠、日本企業20社以上の導入実績。

[詳細を見る](https://brightdata.jp/solutions/data-solutions-for-japanese-companies "詳細を見る")







 [ ](https://news.ycombinator.com/submitlink?t=Bright+Data%E3%81%A7Salesforce+Agentforce%E3%81%AE%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%83%AA%E3%82%B5%E3%83%BC%E3%83%81%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%92%E6%A7%8B%E7%AF%89%E3%81%99%E3%82%8B&u=https://brightdata.jp/blog/ai/salesforce-agentforce-bright-data) [ ](https://www.linkedin.com/shareArticle?mini=true&title=Bright+Data%E3%81%A7Salesforce+Agentforce%E3%81%AE%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%83%AA%E3%82%B5%E3%83%BC%E3%83%81%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%92%E6%A7%8B%E7%AF%89%E3%81%99%E3%82%8B&url=https://brightdata.jp/blog/ai/salesforce-agentforce-bright-data) [ ](http://www.reddit.com/submit?title=Bright+Data%E3%81%A7Salesforce+Agentforce%E3%81%AE%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%83%AA%E3%82%B5%E3%83%BC%E3%83%81%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%82%92%E6%A7%8B%E7%AF%89%E3%81%99%E3%82%8B&url=https://brightdata.jp/blog/ai/salesforce-agentforce-bright-data)







##  あなたは下記にもご興味がおありかもしれません

 [ ![OpenHuman with Bright Data](https://media.brightdata.jp/2026/09/OpenHuman-with-Bright-Data.png) ](https://brightdata.jp/blog/ai/openhuman-with-bright-data "Bright Data CLIを通じたOpenHumanにおける本番対応ウェブアクセス")

 [AI



 ![Antonello Zanini](https://media.brightdata.jp/2022/12/Antonello-Zanini-2-50x50.jpg)

Antonello Zanini

Technical Writer





### Bright Data CLIを通じたOpenHumanにおける本番対応ウェブアクセス

Bright Data CLIをOpenHumanに統合して、AIエージェント向けの本番対応ウェブアクセスとデータ収集を実現します。



 09-Sep-2026

 3 分読

 ](https://brightdata.jp/blog/ai/openhuman-with-bright-data)

 [ ![Multimodal Web Scraping with MiniMax](https://media.brightdata.jp/2026/09/Multimodal-Web-Scraping-with-MiniMax.png) ](https://brightdata.jp/blog/%e3%82%a6%e3%82%a7%e3%83%96%e3%83%87%e3%83%bc%e3%82%bf/multimodal-web-scraping-with-minimax "MiniMaxによるマルチモーダルウェブスクレイピング")

 [ウェブデータ



 ![Antonello Zanini](https://media.brightdata.jp/2022/12/Antonello-Zanini-2-50x50.jpg)

Antonello Zanini

Technical Writer





### MiniMaxによるマルチモーダルウェブスクレイピング

Bright Data Web UnlockerとMiniMax M3ビジョンを組み合わせて、画像やウェブページのスクリーンショットから構造化データを抽出します。



 09-Sep-2026

 1 分読

 ](https://brightdata.jp/blog/%e3%82%a6%e3%82%a7%e3%83%96%e3%83%87%e3%83%bc%e3%82%bf/multimodal-web-scraping-with-minimax)

 [ ![The 10 Best CLI Tools for Codex in 2026](https://media.brightdata.jp/2026/08/The-10-Best-CLI-Tools-for-Codex-in-2026.png) ](https://brightdata.jp/blog/ai/best-cli-tools-for-codex "2026年版 Codex向けCLIツール10選 – テスト＆ランキング")

 [AI



 ![Daniel Shashko](https://media.brightdata.jp/2022/04/Daniel-Shashko-2-50x50.png)

Daniel Shashko

Web Data &amp; AI Expert





### 2026年版 Codex向けCLIツール10選 – テスト＆ランキング

Codexをより速く、より有能にする10のCLIツール。サンドボックス内から実際のウェブアクセスを提供するBright Data CLIから始まります。



 06-Sep-2026

 4 分読

 ](https://brightdata.jp/blog/ai/best-cli-tools-for-codex)
