> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows で PartnerStack を使用する

> Workflow ノードを使ってパートナーのドメインを確認し、PartnerStack に引用データを送信する方法を説明します

PartnerStack の Workflow ノードを使用すると、AI アンサーエンジンが引用しているドメインのうち、どれがすでに PartnerStack ネットワークのパートナーであるかを確認したり、PartnerStack に引用データを送信して新しいパートナーの募集に役立てたりできます。

どちらのノードも、Workflow Builder のノードピッカーの **Integrations** セクションにある **PartnerStack** の下に表示されます。**Recruit** を使用する前に、[PartnerStack アカウントを接続](https://docs.tryprofound.com/ja-jp/integrations/partnerstack/connect-partnerstack-to-profound.md)してください。**Check Network** は接続しなくても動作します。

## 利用可能なノード

> [tab] Check Network
>
> ### Check Network
>
> ドメインのリストを PartnerStack のパートナーネットワークと照合し、それぞれが一致するかどうかを返します。このノードでは、PartnerStack アカウントを接続する必要はありません。
>
> #### 必須の入力
>
> * **Domains** — 1〜500 件のドメインのリスト。フィールドにドメインを入力するか、`/` を入力して前のノードの変数を挿入します。
>
> #### ドメインの照合方法
>
> Profound は各ドメインを小文字に変換し、`www.` と末尾のスラッシュを削除します。そのうえで完全一致を検索します。完全一致がない場合は登録ドメインで照合するため、`blog.example.com` は `example.com` として登録されているパートナーと一致します。
>
> #### 出力
>
> オブジェクトのリストで、デフォルトのラベルは **Domains** です。各オブジェクトには 2 つのフィールドがあります。
>
> | フィールド | 説明 |
> | - | - |
> | `domain` | 正規化されたドメイン。登録ドメインで一致した場合は、登録ドメインになります。 |
> | `matched` | ドメインが PartnerStack のパートナーネットワークに含まれている場合は `true`、含まれていない場合は `false`。 |
>
> 正規化後に同じ値になるドメインは 1 回だけ表示されます。

> [tab] Recruit
>
> ### Recruit
>
> 接続済みのアカウントを通じて PartnerStack に引用データを送信し、パートナーの募集に役立てます。
>
> #### 必須の入力
>
> * **PartnerStack Account** — ドロップダウンから接続済みのアカウントを選択するか、**Add account** を選択して[アカウントを接続](https://docs.tryprofound.com/ja-jp/integrations/partnerstack/connect-partnerstack-to-profound.md)します。
> * **Citations** — 1 件以上の引用を含む JSON リスト。エディターにリストを入力するか、前のノードの出力 (例: `{{citation_pages.output}}`) を参照します。
>
> 各引用は、次のフィールドを持つオブジェクトです。
>
> | フィールド | 必須 | 説明 |
> | - | - | - |
> | `url` | はい | 引用されたページの URL。 |
> | `citation_count` | いいえ | AI モデルがその URL を引用または言及した回数。デフォルトは `1` です。 |
> | `mentioned_on_page` | いいえ | `true` または `false`: その URL のコンテンツで自社が言及されているかどうか。 |
> | `category` | いいえ | 評価対象の観点 (例: `Customer Experience`)。 |
> | `model_provider` | いいえ | 回答の提供元の AI プロバイダー (例: `OpenAI`)。最大 255 文字。 |
>
> ```json Citations example wrap theme={null}
> [
>   {
>     "url": "https://example.com/page",
>     "citation_count": 5,
>     "mentioned_on_page": true,
>     "category": "Customer Experience",
>     "model_provider": "OpenAI"
>   }
> ]
> ```
>
> > [!NOTE]
> >
> > 送信前に、Profound は同じ URL を持つ行を 1 つのレコードにまとめます。`citation_count` の値は合計され、その他のフィールドには最初に見つかった値が使用されます。
>
> #### 出力
>
> **Status**: PartnerStack が引用を受け付けた場合は `success`。

***

## Workflow の例: PartnerStack に引用データを送信する

この Workflow の例では、引用されたページを PartnerStack に送信します。

**1. 引用されたページを取得する**

[Citation Pages](https://docs.tryprofound.com/ja-jp/agents/workflows/nodes/data/citation-pages.md) ノードを追加します。**Metric** と **Date Range** を選択し、**Output Label** を `citation_pages` に設定します。

**2. ページを PartnerStack に送信する**

**Recruit** ノードを追加します。**PartnerStack Account** でアカウントを選択し、**Citations** に `{{citation_pages.output}}` を入力します。

> [!TIP]
>
> 引用されたドメインのうち、どれがすでに PartnerStack ネットワークに含まれているかを確認するには、**Check Network** ノードを追加し、引用データのドメインを渡します。

## トラブルシューティング

> [accordion] Recruit が認証情報エラーで失敗する
>
> PartnerStack が接続を拒否しました。[PartnerStack アカウントを追加](https://docs.tryprofound.com/ja-jp/integrations/partnerstack/connect-partnerstack-to-profound.md)し直し、**PartnerStack Account** ドロップダウンでそのアカウントを選択してから、Workflow を再実行します。

> [accordion] 引用が空または無効なため Recruit が失敗する
>
> * **Citations** が 1 件以上の項目を含むリストであることを確認します。
> * すべての項目に `url` があることを確認します。
> * 変数を使用している場合は、前のノードが実行され、引用のリストを返したことを確認します。そのノードの **Output Format** が JSON であることを確認してください。

> [accordion] Recruit がレート制限エラーで失敗する
>
> PartnerStack がリクエストを制限しています。しばらく待ってから Workflow を再実行します。

> [accordion] 一致するはずのドメインで Check Network が false を返す
>
> **Domains** に、ページの完全な URL ではなく、`example.com` のようなドメインが含まれていることを確認します。

> [accordion] Check Network が失敗する
>
> **Domains** に 1 件以上 500 件以下のドメインが含まれていることを確認します。
