Asana Microsoft 365 Copilot コネクタを使用すると、organizationで Asana タスクのインデックスを作成できます。 Asana ワークスペースからコネクタとインデックスコンテンツを構成した後、ユーザーは Microsoft Search とMicrosoft 365 Copilotでそれらのアイテムを検索できます。
この記事は、Microsoft 365 管理者、または Asana Copilot コネクタを構成、実行、監視するユーザーを対象とします。
機能
- インデックス タスク。
- ユーザーが Copilot のプロジェクト追跡とタスク情報に関連する質問を行えるようにします。 例:
- すべてのプロジェクトに割り当てられていないタスクを特定します。
- プロジェクト内の期限切れのタスクを特定します。
- 次の 2 週間のタスクを要約します。
- Copilot でセマンティック検索を使用すると、ユーザーはキーワード、個人の好み、ソーシャル接続に基づいて関連するコンテンツを見つけることができます。
制限事項
- コネクタはコメントのインデックスを作成しません。
- コネクタは、カスタマイズされたフィールドのインデックスを作成しません。
前提条件
- organizationの Microsoft 365 テナントの検索管理者である必要があります。
- Asana ワークスペースに接続するには、Asana URL が必要です。 URL は通常、
https://app.asana.comです。 - Asana に接続し、Copilot コネクタが Asana タスクを定期的に更新できるようにするには、読み取りアクセス許可を持つサービス アカウントが必要です。 サービス アカウントには、管理 ロールが必要です。
作業の開始
表示名を選択する
表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は信頼されたコンテンツも示し、 コンテンツ ソース フィルターとして使用されます。
既定値が提供されます。organization内のユーザーが認識する名前にカスタマイズできます。
Asana URL を追加する
Asana ワークスペースに接続するには、Asana URL が必要です。 URL は通常、 https://app.asana.comです。
認証の種類を選択する
認証に Asana OAuth を使用するには、Asana 管理者が Asana 開発者コンソールでアプリを作成する必要があります。
OAuth クライアント作成フォームを完了するには、次の表の情報を使用します。
| フィールド | 説明 | おすすめの値 |
|---|---|---|
| アプリ名 | OAuth アクセスが必要なアプリケーションを識別する一意の値。 | Microsoft Search |
| アプリが何を行うかを最も適切に説明するものはどれですか? | アプリの目的について説明します。 | Asana からデータを取得してレポートを作成します。 |
| リダイレクト URL | 承認サーバーがリダイレクトする必要なコールバック URL。 |
Microsoft 365 Enterpriseの場合: https://gcs.office.com/v1.0/admin/oauth/callbackFor Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback |
| 配布の管理 | 配布するワークスペースを選択します。 | コネクタがアクセスできる特定のワークスペースを追加するか、[ 任意のワークスペース] を選択します。 |
作成した Asana アプリの [OAuth] タブからクライアント ID とクライアント シークレットをコピーし、コネクタのセットアップに貼り付けます。 [ 承認] を選択し、同じ Asana 管理者アカウントの資格情報を使用してクロールのアクセス許可を認証します。
注:
ポップアップ ウィンドウで Asana アプリへのアクセスを承認する必要があります。 ポップアップ ウィンドウがブロックされている場合は、ブラウザーでポップアップ ウィンドウが許可されているか、アクセス権が付与されていることを確認します。
限られた対象ユーザーにロールアウトする
制限付きユーザー ベースへの接続をデプロイします。広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する必要がある場合は、その接続をデプロイします。 詳細については、「 コネクタの段階的ロールアウト」を参照してください。
この時点で、Asana の接続を作成する準備ができました。 [ 作成] を 選択して、接続とインデックス記事を Asana アカウントから発行します。
アクセス許可、スキーマ、クロール頻度などの他の設定の場合、既定値は Asana データに最適な内容に基づいて設定されます。
| ユーザー | 説明 |
|---|---|
| アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
| ID のマッピング | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
| コンテンツ | 説明 |
|---|---|
| プロパティの管理 | 既定のプロパティとそのスキーマの詳細については、コンテンツに関する ページを参照してください。 |
| 同期 | 説明 |
|---|---|
| 増分クロール | 15 分ごとに実行されます。 |
| フル クロール | 毎日実行されます。 |
これらの値のいずれかを編集する場合は、[ カスタム セットアップ ] オプションを選択します。
カスタム セットアップ
カスタム セットアップでは、ユーザー、コンテンツ、同期の既定値を編集できます。
ユーザー
アクセス許可
Asana Copilot コネクタでは、このデータ ソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可がサポートされています。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 Atlassian Asana では、セキュリティアクセス許可は、サイトレベルのグループとプロジェクトロールを含むプロジェクト権限スキームを使用して定義されます。 タスク レベルのセキュリティは、タスク レベルのアクセス許可スキームを使用して定義することもできます。
ID のマッピング
データ ソース ID を Microsoft Entra ID にマップする既定の方法は、Asana ユーザーのメール ID が、Microsoft Entra IDのユーザーのユーザー プリンシパル名 (UPN) と同じであることを確認することです。 既定のマッピングがorganizationに対して機能しない場合は、カスタム マッピング式を指定できます。 詳細については、「 Azure AD 以外の ID をマップする」を参照してください。
organizationに最適なオプションを特定するには:
- Asana ユーザーのメール ID が Microsoft Entra ID の UPN と同じである場合は、Microsoft Entra ID オプションを選択します。
- Asana ユーザーのメール ID が、Microsoft Entra IDのユーザーの UPN やメールと異なる場合は、[Microsoft Entra ID以外] オプションを選択します。
コンテンツ
プロパティの管理
Asana で使用可能なプロパティを追加または削除するには、スキーマをプロパティに割り当てます (プロパティが検索可能、クエリ可能、取得可能、またはリファイン可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加します。 既定では、次のプロパティにインデックスが付けられます。
| 既定のプロパティ | Label | 説明 | Schema |
|---|---|---|---|
| Assignee | 該当なし | このタスクを完了する必要があるユーザー | クエリ、取得、検索 |
| 完了 | 該当なし | 記事の本文 | クエリ、取得 |
| CompletedAt | 該当なし | タスクが完了した日付と時刻 | クエリ、取得 |
| CreatedAt | 作成日時 | タスクが作成された日付と時刻 | クエリ、取得 |
| CreateBy | 作成者 | このタスクを作成したユーザー | クエリ、取得、検索 |
| DueOn | 該当なし | このタスクを完了する必要がある場合 | クエリ、取得 |
| Gid | 該当なし | このタスクのグローバル ID | クエリ、取得 |
| ModifiedAt | 最終更新日時 | タスクが変更された日付と時刻 | クエリ、取得 |
| 名前 | タイトル | タスク名 | クエリ、取得、検索 |
| メモ | 該当なし | タスクの説明 | 検索 |
| ProjectIds | 該当なし | プロジェクト ID | 該当なし |
| ProjectNames | 該当なし | プロジェクト名 | クエリ、取得 |
| タグ | tags | このタスクに割り当てられたタグ | クエリ、取得 |
| TaskUrl | url | タスクのリンク | クエリ、取得、検索 |
| WorkspaceName | 該当なし | ワークスペース名 | クエリ、取得、検索 |
データのプレビュー
プレビュー結果ボタンを使用して、選択したプロパティとクエリ フィルターのサンプル値を確認します。
同期
更新間隔によって、データ ソースと Asana Copilot コネクタ インデックスの間でデータが同期される頻度が決まります。 更新間隔には、フル クロールと増分クロールの 2 種類があります。 詳細については、「 更新設定」を参照してください。
更新間隔の既定値を変更できます。
次の手順
接続を発行したら、管理センターの [コネクタ] セクションで状態を確認できます。 更新と削除を行う方法については、「接続を監視する」をご覧ください。
問題がある場合、またはフィードバックを提供する場合は、「 Microsoft Graph サポート」を参照してください。