コピロットを検索

このピースでできること

  • Microsoft 365 Copilot を使って、OneDrive 内の仕事・学校用コンテンツを自然言語でハイブリッド検索(意味検索+語彙検索)します。
  • KQLフィルタ式で検索対象フォルダを絞り込んだり、特定のメタデータを取得したりすることができます。

Microsoft 365 Copilot の接続方法

workrun と Microsoft 365 Copilot を接続するには、Microsoft Azure で作成した OAuth クライアント(クライアントID・クライアントシークレット) が必要です。
なお、このピースを利用するには Microsoft 365 Copilot ライセンス が必要です。

ステップ 1:workrun のリダイレクト URL を確認する

  1. workrun で Microsoft 365 Copilot のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。

ステップ 2:Azure で OAuth クライアントを作成する

  1. Azure ポータル にサインインします。
  1. 「Azure Active Directory」(Microsoft Entra ID)→ 「アプリの登録」「新規登録」 をクリックします。
  1. アプリ名を入力し、「リダイレクト URI」 にステップ 1 でコピーした URL を貼り付けます。
  1. 「登録」 をクリックし、表示される 「アプリケーション(クライアント)ID」 をコピーします。
  1. 「証明書とシークレット」「新しいクライアント シークレット」 をクリックし、シークレットを作成して をコピーします。
  1. 「API のアクセス許可」「アクセス許可の追加」「Microsoft Graph」「委任されたアクセス許可」 から以下のスコープを追加し、「管理者の同意を与える」 をクリックします。
      • Sites.Read.All
      • Mail.Read
      • Files.ReadWrite.All
      • People.Read.All
      • OnlineMeetingTranscript.Read.All
      • Chat.Read
      • ChannelMessage.Read.All
      • ExternalItem.Read.All
      • AiEnterpriseInteraction.Read
      • Files.Read.All

ステップ 3:workrun に接続を追加する

  1. ステップ 1 の接続画面に戻り、クライアントIDクライアントシークレット をそれぞれ貼り付けます。
  1. 「クラウド環境」 で使用する Microsoft クラウド環境を選択します(通常は「Commercial (Global)」を選択してください)。
  1. 「接続」 をクリックすると、Microsoft の認証画面が開きます。
  1. Microsoft アカウントにサインインし、workrun に対するアクセスを 「許可」 します。
  1. 画面が自動で閉じ、接続が完了します。

ピースの設定項目

1. 検索クエリ(必須)

  • OneDrive内のコンテンツを検索するための自然言語のクエリを入力します。最大1,500文字まで入力できます。

2. フィルタ式(任意)

  • OneDrive データソースに対する KQL フィルタ式を入力します。特定のフォルダ下のファイルのみ検索したい場合に利用します。任意項目なので不要な場合は空白にしてください。

3. リソースメタデータ名(任意)

  • 検索結果に含めるメタデータフィールド名の配列をJSON形式で入力します。不要な場合は空白またはを入力してください。