Skip to main content

​
Google Drive

ShanoneのGoogle Drive連携では、ファイル、フォルダ、共有ドライブ、権限、コメント、リビジョン履歴を扱う50のツールをエージェントが利用できるようになります——ちょっとしたアップロードから、誰がドキュメントにアクセスできるかの監査まで幅広くカバーします。

​
はじめに

1

OAuthで接続する

エージェントにDriveで何か作業をしてもらう(例:「Shared Reportsフォルダ内のファイルを一覧表示して」)か、ShanoneダッシュボードのIntegrationsから事前に接続します。
2

Googleアカウントを認可する

ShanoneがアクセスすべきDriveを持つアカウントでGoogleのOAuth同意画面を承認します。
3

リクエストを再試行する

接続が完了すると、google_drive_*ツールへのshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはGoogle Drive用に50のツールを提供しており、以下のカテゴリに分類されています。
google_drive_about, google_drive_list_files, google_drive_search, google_drive_get_file, google_drive_download_file, google_drive_export_file, google_drive_upload_file, google_drive_create_file_from_text, google_drive_create_folder, google_drive_update_file, google_drive_copy_file, google_drive_delete_file, google_drive_trash_file, google_drive_untrash_file, google_drive_empty_trash
google_drive_list_drives, google_drive_get_drive, google_drive_create_drive, google_drive_update_drive, google_drive_hide_drive, google_drive_unhide_drive, google_drive_delete_drive, google_drive_list_labels, google_drive_modify_labels, google_drive_generate_ids, google_drive_move_file, google_drive_create_shortcut
google_drive_list_permissions, google_drive_get_permission, google_drive_create_permission, google_drive_update_permission, google_drive_delete_permission
google_drive_list_comments, google_drive_get_comment, google_drive_create_comment, google_drive_update_comment, google_drive_delete_comment, google_drive_list_replies, google_drive_get_reply, google_drive_create_reply, google_drive_update_reply, google_drive_delete_reply
google_drive_list_revisions, google_drive_get_revision, google_drive_update_revision, google_drive_delete_revision, google_drive_get_start_page_token, google_drive_list_changes, google_drive_watch_changes, google_drive_stop_channel

​
よくある使い方

ドキュメントの整理

共有ドライブから特定のトピックに関連する最近のファイルを検索して要約する

アクセス監査

機密性の高いファイルやフォルダの権限を一覧表示し、アクセス権を持つべきでない人がいないか確認する

一括整理

複数のファイルを移動・コピー・再ラベル付けして正しいフォルダ構成に整理する

レビュースレッド

ブラウザを開かずにドキュメントのコメントスレッドを読んで返信する

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

ファイルIDが間違っている可能性が高いです——手入力せず、DriveのURL内(/d/と次の/の間の長い文字列)からコピーしてください。また、接続済みアカウントが実際にそのファイルへのアクセス権を持っているかも確認してください。
Google Workspaceのネイティブファイル(Docs、Sheets、Slides)は生バイトとしてダウンロードできません——代わりにgoogle_drive_export_fileを使用してください。これはまずPDFやDOCXなどの形式に変換します。
プッシュ通知には、チャンネルアドレスとして設定された公開アクセス可能なHTTPS Webhook URLが必要です——これはShanoneの範囲外のプロジェクトレベルの設定作業です。プッシュ通知が不要であれば、代わりにポーリング用にgoogle_drive_list_changesを使用してください。
google_drive_create_permissionに渡すroleとtypeフィールドを確認してください——Driveの権限モデルではuser、group、domain、anyoneが区別され、それぞれ有効なroleの組み合わせが異なります。