Skip to main content
Google アカウントを接続すると、Profound の Agents で次のノードが利用できるようになります。これらのノードは、Agent Builder の Google Suite にある Google Docs グループと Google Sheets グループ、および Google Slides ノードにあります。 各ノードは、Google Account で選択した Google アカウントとして実行されます。アクセスできるのは、Google のファイルピッカーで追加したファイルと Profound が作成したファイルのみなので、ノードを使って構築する前にファイルを追加してください。
Agents を初めて使用する場合は、Profound ヘルプセンターの Agents の使い方をご覧ください。

利用可能なノード

Create Document

Google ドキュメントを作成します。

必須の入力

  • Google Account — ドロップダウンから接続済みのアカウントを選択します
  • Document Title — 新しいドキュメントのタイトル

任意の入力

出力

新しいドキュメントの documentId、document_url、title を含む JSON オブジェクト。
フォルダ内に作成したばかりのドキュメントに Profound がコンテンツを書き込めなかった場合、フォルダに空のファイルがたまらないよう、その空のドキュメントはゴミ箱に移動されます。

主要な概念

Profound がアクセスできるファイル

Profound は Google の drive.file 権限を保持しており、その対象は Google のファイルピッカーで選択したファイルと Profound が作成したファイルのみです。各ファイルドロップダウンには、選択したアカウントのこれらのファイルが一覧表示されます。ドロップダウンの下部にある Add files from Google Drive アクションを使用すると、ピッカーが開き、ファイルを追加できます。 Profound が Create Document と Create Spreadsheet で作成したファイルは、追加しなくても後続のノードで利用できます。

ファイルの選択

Document、Spreadsheet、Presentation の入力には、次のものを指定できます。
  • ドロップダウンから選択したファイル
  • ファイルの URL (例: https://docs.google.com/document/d/<FILE_ID>/edit や https://drive.google.com/open?id=<FILE_ID>)
  • ファイルの ID
  • 前のノードの出力の変数 (例: Create Document が返す documentId)
値が ID でも URL でもない場合、Profound はそれをファイル名として扱い、アクセスできるファイルの中から大文字と小文字を区別せずに完全一致するものを探します。一致するファイルがない場合や、複数のファイルが一致する場合、ノードはエラーで停止します。その場合は ID または URL を使用してください。

シート、範囲、値

  • Sheet name は、スプレッドシート内のタブの名前です。最初のタブを使用する場合は空のままにします。
  • Range と Cell には A1 形式を使用します (例: A1:D10 や B2)。シート全体を読み取る場合は Range を空のままにします。
  • Value input option は、書き込んだ内容を Google がどのように保存するかを決定します。Formula / number (interpret as typed) では、セルに直接入力した場合と同様に、=SUM(A1:B1) は数式として、42 は数値として扱われます。Plain text (no parsing) では、テキストとして保存されます。

トラブルシューティング

  • 最初に Google Account を選択してください。選択するまでドロップダウンは無効のままです。
  • ドロップダウンに No files granted yet と表示される場合、Profound はまだこのアカウントのどのファイルにもアクセスできません。Add files from Google Drive を選択し、Google のピッカーでファイルを選択してください。
  • アカウントごとにアクセスできるファイルが異なるため、Google Account を変更すると、選択したファイルはクリアされます。
Profound が開けるのは、ピッカーで追加したファイルと Profound が作成したファイルのみです。そのファイルがこれらのいずれかであり、Drive にまだ存在していることを確認してください。URL または ID を貼り付けた場合は、選択した Google アカウントと同じアカウントのものであることを確認してください。
入力した値が ID でも URL でもないため、Profound は名前で検索しました。ドロップダウンからファイルを選択するか、URL または ID を貼り付けてください。
Sheet name は、スプレッドシートのタブ名と完全に一致している必要があります。スプレッドシートからコピーするか、フィールドを空のままにして最初のタブを使用してください。
エラーには、シートの行数と列数が示されます。その範囲内に収まる範囲を使用するか、先にシートに行や列を追加してください。
Records と Columns の出力形式では 1 行目がキーとして使用されるため、すべてのヘッダーが一意である必要があります。スプレッドシートで重複している列の名前を変更するか、Output format を Rows、CSV、またはその他の形式に切り替えてください。
Input format は、Rows のデータと一致している必要があります。たとえば、Input format が CSV に設定されている状態で JSON データを指定すると拒否されます。Input format をデータの形式に変更してください。
Content format が HTML に設定されている場合、Initial Content には <p>...</p> などの HTML タグが含まれている必要があります。テキストをタグで囲むか、Content format を Plain Text または Markdown に切り替えてください。
  • Profound がフォルダを見つけられない場合は、Add a folder from Google Drive からもう一度フォルダを選択してください。
  • Profound がフォルダにアクセスできない場合は、接続した Google アカウントがファイルを追加できるフォルダを選択してください。
  • 共有ドライブ内のフォルダの場合、接続したアカウントがその共有ドライブのメンバーであり、Google Workspace のルールでそこへのファイルの追加が許可されている必要があります。
  • ドライブまたはフォルダの容量がいっぱいの場合は、空き容量を確保するか、別のドライブのフォルダを選択してください。
Profound がエクスポートできるのは、ドキュメントまたはプレゼンテーション 1 件あたり最大 5 MB です。ファイルを分割するか、より小さなドキュメントを読み取ってください。
接続した Google アカウントには、そのファイルの閲覧権限しかありません。ファイルのオーナーに編集者のアクセス権を依頼してから、ノードを再度実行してください。
Google は、一定期間に受け付けるリクエストの数を制限しています。しばらく待ってから、Agent を再度実行してください。この問題が繰り返し発生する場合は、Google Workspace の管理者に API の割り当ての見直しを依頼してください。
Google がそのアカウントに対する Profound のトークンを受け付けなくなっています。Settings > Integrations > Google Drive で接続を取り消し、アカウントを再接続してください。