Skip to main content

​
OneDrive

ShanoneのOneDrive連携は、日常的なファイル管理やSharePointサイトへのアクセスに加えて、他の連携ではあまり扱われないMicrosoft 365ガバナンス系のツール(保持ラベル、機密ラベル、デルタ同期)まで含む87個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにOneDrive関連の作業を依頼(例: 「Q3予算スプレッドシートの最新バージョンを探して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Microsoftアカウントを許可する

ShanoneにOneDriveやSharePointサイトへアクセスさせたいアカウントについて、MicrosoftのOAuth同意画面を承認します。
3

リクエストを再実行する

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

​
利用可能なツール

ShanoneはOneDrive向けに87個のツールを、以下のカテゴリに整理して提供しています。
onedrive_get_file_info, onedrive_download_file, onedrive_upload_file, onedrive_delete_file, onedrive_move_file, onedrive_copy_file, onedrive_search_files, onedrive_download_file_by_path, onedrive_create_upload_session, onedrive_download_as_format, onedrive_update_metadata, onedrive_rename_item, onedrive_follow_item, onedrive_unfollow_item, onedrive_preview_item
onedrive_list_root, onedrive_list_folder, onedrive_create_folder, onedrive_delete_folder, onedrive_get_special_folder, onedrive_list_special_folder, onedrive_get_recent, onedrive_get_root_children, onedrive_list_followed
onedrive_create_sharing_link, onedrive_grant_permission_to_link, onedrive_get_shared_drive_item, onedrive_list_link_permissions, onedrive_list_permissions, onedrive_get_permission, onedrive_update_permission, onedrive_delete_permission, onedrive_invite_user, onedrive_get_shared_item, onedrive_list_shared_with_me
onedrive_list_versions, onedrive_get_version, onedrive_download_version, onedrive_restore_version, onedrive_restore_item, onedrive_permanent_delete, onedrive_list_recycle_bin_items
onedrive_get_delta, onedrive_get_delta_by_token, onedrive_create_subscription, onedrive_list_subscriptions, onedrive_delete_subscription, onedrive_update_subscription, onedrive_get_subscription
onedrive_checkout, onedrive_checkin, onedrive_discard_checkout, onedrive_get_publication_status, onedrive_list_bundles, onedrive_get_bundle, onedrive_create_bundle, onedrive_add_item_to_bundle, onedrive_remove_item_from_bundle, onedrive_update_bundle, onedrive_delete_bundle
onedrive_get_site, onedrive_list_site_drives, onedrive_get_site_drive, onedrive_list_site_lists, onedrive_get_group_drive, onedrive_search_sites, onedrive_list_site_subsites, onedrive_list_site_columns, onedrive_get_site_page_content, onedrive_get_sharepoint_list_items, onedrive_list_sharepoint_list_items_delta, onedrive_list_site_drive_items_delta
onedrive_get_retention_label, onedrive_set_retention_label, onedrive_remove_retention_label, onedrive_lock_unlock_record, onedrive_extract_sensitivity_labels, onedrive_assign_sensitivity_label
onedrive_get_analytics, onedrive_get_activities, onedrive_list_drive_activities, onedrive_get_activity_stats, onedrive_get_thumbnails, onedrive_get_thumbnail, onedrive_get_thumbnail_content, onedrive_get_my_drive, onedrive_get_drive_info

​
よくあるユースケース

チーム間のファイル共有

ドキュメントを探し、共有リンクを発行して、特定のコラボレーターにアクセス権を付与する

SharePointサイト検索

接続済みのSharePointサイトやライブラリを横断検索し、ドキュメントの最新版を見つける

コンプライアンス & 保持ポリシー監査

ドライブ内の機密ファイルに適用されている保持ラベルや機密ラベルを確認する

バージョンの復元

ファイルのバージョン履歴を確認し、意図しない編集後に以前のバージョンへ復元する

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

Microsoft Graphのシンプルアップロードは約4MBが上限です。それ以上のサイズには、代わりにonedrive_create_upload_sessionでレジューム可能なアップロードセッションを開始してください。
デルタトークンは期限切れやサーバー側の無効化が発生することがあります。トークンなしでonedrive_get_deltaを呼び出して同期ループを再開し、レスポンスから新しいトークンを保存して以降のonedrive_get_delta_by_token呼び出しに使ってください。
ほとんどのonedrive_*のSharePoint系ツールは特定のサイトIDやドライブIDが必要です。まずonedrive_search_sitesやonedrive_get_siteで正しいサイトを特定し、接続中のMicrosoftアカウントに実際のアクセス権があるか確認してください。
削除されたアイテムはまずごみ箱に移動します。onedrive_list_recycle_bin_itemsで確認し、完全に削除したい場合はonedrive_permanent_deleteを使ってください。