> ## 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.

# Agents で Looker を使用する

Looker アカウントを接続すると、次のアクションを Agent のステップとして使用できるようになります。各ステップでは、ドロップダウンから接続済みの **Looker Account** を選択する必要があります。

Profound が Looker から取得するのは**クエリ結果**、つまりアナリティクスチームがすでにモデル化した指標とディメンションの行であり、Looker のダッシュボードやビジュアライゼーションではありません。結果は構造化データ (通常は JSON) として返され、後続の Agent ステップで要約、比較したり、他のインテグレーションと組み合わせたりできます。

## 利用可能なアクション

| アクション | 内容 |
| - | - |
| **Run Look** | 保存済みの Look を ID で実行し、結果を返します |
| **Run Inline Query** | Agent で指定したモデル、Explore、フィールドリストに対してクエリを作成して実行します |

<Tabs>
  <Tab title="Run Look" icon="chart-line">
    #### **Run Look**

    Looker インスタンスの保存済みの Look を実行し、結果を構造化データとして返します。

    **必須の入力**

    * **Looker Account**
    * **Look** — 選択したアカウントの保存済みの Look。ドロップダウンには Looker から読み込んだ Look が、それぞれのタイトルと ID とともに表示されます。

    **任意の入力**

    * **Result Format** — Looker が返す形式。デフォルトは `json_bi` で、後続の Agent ステップにはこの形式をおすすめします。
    * **Row Limit** — 返す行の最大数。

    **出力**

    * **Look Results** — 返された Looker の結果を含む JSON 値。

    <Callout icon="lightbulb" color="#376CFF">
      **ヒント:** クエリがすでに Looker に保存済みの Look として存在する場合は、**Run Look** を使用してください。ビジネスロジックを Looker で一元管理でき、定期的な Agent の自動化に最も安全な選択肢です。
    </Callout>
  </Tab>

  <Tab title="Run inline query" icon="code">
    #### **Run Inline Query**

    フィールド、フィルタ、並べ替え、詳細なクエリオプションを指定して、特定の Looker モデルと Explore に対してクエリを実行します。

    **必須の入力**

    * **Looker Account**
    * **Model** — Looker のモデル名 (例: `marketing`)
    * **Explore** — Explore 名 (例: `web_event`)
    * **Fields** — カンマ区切りの Looker フィールド (例: `web_event.date, web_event.unique_users`)

    **任意の入力**

    * **Sorts** — カンマ区切りの並べ替え (例: `web_event.date desc`)
    * **Row Limit** — 返す行の最大数。デフォルトは `500` です。
    * **Result Format** — デフォルトは `json_bi` です

    **詳細な入力**

    * **Filter Expression** — `${field}` 構文を使用した Looker のフィルタ式
    * **Pivots** — ピボットするカンマ区切りのフィールド
    * **Subtotals** — 小計を出すカンマ区切りのフィールド
    * **Fill Fields** — 欠落した行を補完するカンマ区切りのフィールド (通常は日付フィールド)
    * **Dynamic Fields** — 表計算やカスタムディメンション用の JSON 文字列
    * **Column Limit** — 返す列の最大数
    * **Total** — Looker が合計を含めるかどうか
    * **Row Total** — 行合計の種類 (例: `right`)
    * **Query Timezone** — 任意の IANA タイムゾーン (例: `America/Los_Angeles`)
    * **Server Table Calcs** — 表計算をサーバー上で実行するかどうか
    * **Apply Formatting** — 結果に Looker の書式設定を適用するかどうか

    **出力**

    * **Query Results** — 返された Looker の結果を含む JSON 値。

    <Callout icon="lightbulb" color="#376CFF">
      **ヒント:** フィールド名は、`view.field` のプレフィックスも含め、Looker に表示されているとおりに正確に使用してください。日付フィルタには、LookML モデルの Looker フィルタ構文を使用します (例: 日付フィールドに対して `30 days`)。
    </Callout>
  </Tab>
</Tabs>

***

## 利用可能なデータ

クエリ結果は、実行する Look または Explore によって異なります。一般的に、Looker は LookML モデルで定義されたフィールドを返します。

| データの種類 | 説明 |
| - | - |
| **ディメンション** | グループ化やフィルタに使用する属性 (日付、チャネル、地域、製品など) |
| **メジャー** | 集計された指標 (収益、セッション数、コンバージョン率、ユニークユーザー数など) |
| **フィルタと並べ替え** | クエリ時に適用されます。保存済みの Look に組み込まれているか、インラインクエリで指定します |
| **合計と小計** | インラインクエリで有効にした場合の、任意の行合計または列合計 |

Profound は、生のクエリ結果を構造化データ (通常は JSON) として返します。要約する、期間を比較する、行を別のステップに渡すなど、結果をどう扱うかは Agent やシートで決定します。

## サポートされている結果の形式

どちらのアクションも、複数の Looker 結果形式をサポートしています。**`json_bi`** はデフォルトの形式で、後続のステップが確実に解析できる構造化 JSON を返すため、Agent のワークフローにおすすめです。

その他のサポートされている形式: `json`、`csv`、`txt`、`html`、`md`、`xlsx`、`sql`、`png`、`jpg`。JSON 以外の形式は、後続のステップでその出力形式が明示的に必要な場合にのみ使用してください。

## 制限

* **Run Inline Query** のデフォルトは **500 行**で、1 回の実行で最大 **5,000 行**までサポートします。
* **Run Look** では、任意で行数の上限を最大 **5,000 行**まで上書きできます。
* 接続した Looker ユーザーの権限は引き続き適用されます。API ユーザーがアクセスできないデータを Profound が返すことはできません。

***

## アクションの選択

| **Run Look** を使用する場合 | **Run Inline Query** を使用する場合 |
| - | - |
| クエリがすでに Looker に保存され、承認されている | Agent で動的なフィールド、フィルタ、期間が必要である |
| クエリロジックの信頼できる情報源を Looker にしておきたい | Agent 内でパラメータ化されたレポートを作成している |
| シンプルで管理された定期レポートが必要である | 前の Agent ステップで取得する指標が決まる |

***

## 一般的なユースケース

* 保存済みのトラフィックや収益の Look を週次サマリーの Agent に取り込む
* Looker から管理された KPI を取得し、コンテンツ生成ステップに渡す
* Agent の入力に応じて変化する期間を指定して、動的なインラインクエリを実行する
* 1 つの Agent で、Looker の指標を他のインテグレーションのデータと組み合わせる
* 保存済みの Look を Sheet にインポートし、Agent が生成した列と並べて指標を分析する

***

## ベストプラクティス

* 後続の Agent ステップには、構造化データを返す `json_bi` を優先して使用します
* 可能な場合は保存済みの Look から始め、Agent に動的なロジックが必要な場合にのみインラインクエリを使用します
* 後続のステップが必要なデータのみを受け取れるよう、行数の上限を絞り込みます
* 接続した Looker ユーザーが、Agent で使用するすべてのモデル、Explore、フィールド、Look にアクセスできることを確認します

***

## よくあるエラー

<AccordionGroup>
  <Accordion title="Select an integration first">
    Look のドロップダウンは、選択した Looker アカウントに依存します。保存済みの Look を選択する前に、**Looker Account** を選択してください。
  </Accordion>

  <Accordion title="No Looks found">
    接続した Looker ユーザーが保存済みの Look にアクセスできないか、Look がそのユーザーのアクセスできないフォルダにある可能性があります。
  </Accordion>

  <Accordion title="無効なモデル、Explore、またはフィールド">
    インラインクエリでは、Looker に存在するとおりのモデル名、Explore 名、フィールド名を正確に使用する必要があります。
  </Accordion>

  <Accordion title="Permission denied">
    Profound は、接続した Looker の API ユーザーを使用します。Agent が要求したデータにアクセスできない場合は、そのユーザーの Looker ロール、モデルセット、フォルダの権限を更新してください。
  </Accordion>
</AccordionGroup>