Skip to main content
Looker アカウントを接続すると、次のアクションを Agent のステップとして使用できるようになります。各ステップでは、ドロップダウンから接続済みの Looker Account を選択する必要があります。 Profound が Looker から取得するのはクエリ結果、つまりアナリティクスチームがすでにモデル化した指標とディメンションの行であり、Looker のダッシュボードやビジュアライゼーションではありません。結果は構造化データ (通常は JSON) として返され、後続の Agent ステップで要約、比較したり、他のインテグレーションと組み合わせたりできます。

​
利用可能なアクション

​
Run Look

Looker インスタンスの保存済みの Look を実行し、結果を構造化データとして返します。必須の入力
  • Looker Account
  • Look — 選択したアカウントの保存済みの Look。ドロップダウンには Looker から読み込んだ Look が、それぞれのタイトルと ID とともに表示されます。
任意の入力
  • Result Format — Looker が返す形式。デフォルトは json_bi で、後続の Agent ステップにはこの形式をおすすめします。
  • Row Limit — 返す行の最大数。
出力
  • Look Results — 返された Looker の結果を含む JSON 値。
ヒント: クエリがすでに Looker に保存済みの Look として存在する場合は、Run Look を使用してください。ビジネスロジックを Looker で一元管理でき、定期的な Agent の自動化に最も安全な選択肢です。

​
利用可能なデータ

クエリ結果は、実行する Look または Explore によって異なります。一般的に、Looker は LookML モデルで定義されたフィールドを返します。 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 が返すことはできません。

​
アクションの選択

​
一般的なユースケース

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

​
ベストプラクティス

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

​
よくあるエラー

Look のドロップダウンは、選択した Looker アカウントに依存します。保存済みの Look を選択する前に、Looker Account を選択してください。
接続した Looker ユーザーが保存済みの Look にアクセスできないか、Look がそのユーザーのアクセスできないフォルダにある可能性があります。
インラインクエリでは、Looker に存在するとおりのモデル名、Explore 名、フィールド名を正確に使用する必要があります。
Profound は、接続した Looker の API ユーザーを使用します。Agent が要求したデータにアクセスできない場合は、そのユーザーの Looker ロール、モデルセット、フォルダの権限を更新してください。