Skip to main content

​
SharePoint

ShanoneのSharePoint連携は、サイトの検索、ドキュメントライブラリの閲覧、ファイルの入出力を行う13個のツールをエージェントに提供します——SharePointの管理機能全体ではなく、エージェントが実際に必要とする操作に絞り込んだセットです。

​
はじめに

1

OAuthで接続する

エージェントにSharePoint関連の作業を依頼(例: 「財務サイトからQ3予算のファイルを探して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Microsoftアカウントを許可する

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

リクエストを再実行する

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

​
利用可能なツール

ShanoneはSharePoint向けに13個のツールを、以下のカテゴリに整理して提供しています。
sharepoint_get_file_info, sharepoint_download_file, sharepoint_upload_file, sharepoint_delete_file, sharepoint_search_files
sharepoint_list_folder, sharepoint_create_folder, sharepoint_delete_folder
sharepoint_create_sharing_link, sharepoint_list_permissions
sharepoint_list_sites, sharepoint_get_site, sharepoint_search_sites

​
よくあるユースケース

ドキュメント検索

サイト全体からファイル名やキーワードでファイルを検索し、レビュー用にダウンロードする

ファイル投入の自動化

生成したレポートを定期的に対象サイトのドキュメントライブラリにアップロードする

外部共有リンク

権限を手動で設定する代わりに、ファイルの閲覧専用共有リンクを生成する

アクセス権の監査

機密性の高いフォルダの権限を一覧表示し、現在誰がアクセスできるかを確認する

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

接続したアカウントが対象サイトの実際のメンバーである必要があります——SharePointの検索は、テナント全体ではなく認証済みユーザーが見えるサイトに限定されます。
sharepoint_upload_fileのshanone_get_tool_schemaを確認してください——非常に大きいファイル(通常数MBを超えるもの)は、小さいファイルとは異なるアップロードセッションのフローが必要になることが多いため、可能な場合は大きなアップロードを小さいファイルに分割してください。
削除したアイテムは即座に消えるのではなく、サイトのごみ箱に移動します。これはツールの不具合ではなく、SharePointの想定された動作です。