Aha! 機能とアイデア Microsoft 365 Copilot コネクターにより、組織は Aha! のインデックス作成と検索を行えるようになります。 企業全体の機能とアイデア。 この記事では、Aha! のデプロイとカスタマイズ手順について説明します。 コネクター。
高度な Aha! 構成情報については、「コネクター インジェスト用に Aha! サービスを設定する」を参照してください。
前提条件
Aha! をデプロイする前に コネクターを使用する場合は、必ず Aha! 組織内で環境が構成されています。 次の表は、Aha! を構成する手順をまとめたものです。 環境を構築し、コネクターをデプロイします。
| タスク | 役割 |
|---|---|
| 環境を構成する | Aha! 管理者 |
| Microsoft 365 管理センターでコネクターをデプロイする | Microsoft 365 管理者 |
| コネクターの設定をカスタマイズする (オプション) | Microsoft 365 管理者 |
コネクターをデプロイする前に、次の前提条件を満たしていることを確認してください:
- Microsoft 365 管理者である必要があります。
- Aha! を持っています。 インスタンス URL (たとえば、
https://contoso.aha.io)。 - Aha! を作成しました。 OAuth アプリケーションを作成し、クライアント ID とクライアント シークレットを取得します。
- Microsoft 365 Copilot の IP アドレスに対して、ネットワークおよび API アクセスが有効になっています。
コネクターをデプロイする
Aha! を追加するには 組織用のコネクター:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot]>[コネクター] を選択します。
- [コネクター] タブに移動し、左側のウィンドウで [ギャラリー] を選択します。
- 使用可能なコネクターの一覧から [Aha!] を選択します。
表示名の設定
表示名は、Copilot 応答内の参照を識別するために使用され、ユーザーが関連するファイルまたはアイテムを認識しやすくなります。 表示名は信頼されたコンテンツを示すとともに、コンテンツ ソースのフィルターとしても使用されます。
既定の Aha! 表示名をそのまま使用するか、値をカスタマイズして組織内のユーザーが認識できる表示名を使用することもできます。
コネクターの表示名と説明の詳細については、「コネクター コンテンツの Copilot 検出を強化する」を参照してください。
インスタンス URL の設定
Aha! の提供 インスタンス URL。 URL は、https://<company>.aha.io の形式です。
認証の種類を選択する
Aha! コネクターは認証に OAuth 2.0 を使用します。 構成するには:
- Aha! を作成する Aha! の OAuth アプリケーション 開発者コンソール。
- OAuth アプリの登録中に取得したクライアント ID とクライアント シークレットを入力します。
- リダイレクト URI を使用します:
- Microsoft 365 Enterprise の場合:
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 Government の場合:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Enterprise の場合:
ロールアウト
限定された対象ユーザーにロールアウトするには、[限定された対象ユーザーへのロールアウト] の横のトグルをオンにし、コネクターをロールアウトするユーザーとグループを指定します。 詳細については、「Copilot コネクターの段階的ロールアウト」を参照してください。
[作成] を選択して接続をデプロイします。 Aha! Copilot コネクターは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| ユーザー | アクセス許可: データ ソース内のコンテンツにアクセスできるユーザーのみ。 Microsoft Entra ID を使用してマップされた ID。 |
| コンテンツ | 機能とアイデアのインデックスが作成された既定のプロパティ。 |
| 同期 | インクリメンタル更新は 15 分ごとに実行されます。フル更新は毎日実行されます。 |
これらの値をカスタマイズするには、[カスタム セットアップ] を選択します。 詳細については、「設定のカスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクター] セクションで状態を確認できます。
設定のカスタマイズ (オプション)
Aha! の既定値をカスタマイズできます。 コネクターの設定。 設定をカスタマイズするには、管理センターのコネクター ページで [カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
Asana コネクターでは、次のユーザー アクセス許可がサポートされています:
- このデータ ソースへのアクセス権を持つユーザーのみ (既定)
- すべてのユーザー
[すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス データが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、アクセス権を持つユーザーの検索結果にインデックス データが表示されます。
ID のマッピング
Aha! のマップ ID を Microsoft Entra ID にマッピングして、セキュリティで保護されたアクセス制御を行います。
コンテンツ設定をカスタマイズする
プロパティを管理する
プロパティの追加や削除、セマンティック ラベルの割り当て、スキーマ属性の構成が可能です。
次のプロパティは、Aha! に対して既定でインデックスが作成されます。 機能。
| 既定のプロパティ | Label | 説明 | Schema |
|---|---|---|---|
| assignToUser | 機能が割り当てられているユーザー。 | 検索 | |
| assignToUserEmail | 割り当てられたユーザーのメール アドレス。 | 検索 | |
| createTime | 作成日時 | データ ソース内で機能が作成された日付と時間。 | クエリ、取得 |
| createdBy | 作成者 | 機能を作成したユーザー。 | クエリ、取得、検索 |
| 説明 | コンテンツ | 機能の説明。 | 検索 |
| dueDate | 機能のターゲット完了日。 | クエリ | |
| epicName | 機能が属するエピックの名前。 | 取得、検索 | |
| id | 機能の一意識別子。 | クエリ、取得 | |
| リンク | 機能へのリンクまたは参照。 | クエリ、取得、検索 | |
| name | タイトル | Copilot と検索エクスペリエンスに表示される機能のタイトル。 | クエリ、取得、検索 |
| リファレンス | 内部参照識別子または外部参照識別子。 | クエリ | |
| releaseName | 関連付けられているリリースの名前。 | 検索 | |
| score | 機能に関連付けられた定量または定性スコア。 | クエリ、検索 | |
| startDate | 機能の計画された開始日。 | クエリ | |
| status | 機能の現在の状態 (計画済み、進行中、完了など)。 | クエリ、絞り込み、検索 | |
| tag | 機能に関連付けられたタグまたはラベル。 | クエリ、取得、検索 | |
| updateTime | 最終更新日時 | データ ソースで機能が最後に更新された日付と時間。 | クエリ、取得 |
| url | url | データ ソース内の機能のターゲット URL。 | 取得、検索 |
次のプロパティは、Aha! に対して既定でインデックスが作成されます。 アイデア。
| 既定のプロパティ | Label | 説明 | Schema |
|---|---|---|---|
| assignToUser | アイデアが割り当てられているユーザー。 | クエリ、検索 | |
| assignToUserEmail | 割り当てられたユーザーのメール アドレス。 | クエリ、検索 | |
| categories | アイデアに関連付けられたカテゴリまたはグループ。 | クエリ、取得 | |
| createTime | 作成日時 | アイデアがデータ ソース内で作成された日付と時間。 | クエリ、取得 |
| createdBy | 作成者 | アイデアを作成したユーザー。 | クエリ、取得、検索 |
| 説明 | コンテンツ | アイデアの説明または詳細。 | 検索 |
| iconUrl | IconUrl | アイデアを表すアイコンの URL。 | 取得 |
| id | アイデアの一意識別子。 | クエリ、取得 | |
| リンク | アイデアへのリンクまたは参照。 | クエリ、取得、検索 | |
| name | タイトル | Copilot やその他の検索エクスペリエンスに示されているアイデアのタイトル。 | クエリ、取得、検索 |
| リファレンス | 内部参照識別子または外部参照識別子。 | クエリ | |
| score | 重要度または関連性を示す定量または定性スコア。 | クエリ、検索 | |
| status | アイデアの現在の状態 (たとえば、新規、計画済み、出荷済み)。 | クエリ、絞り込み、取得 | |
| updateTime | 最終更新日時 | データ ソースでアイデアが最後に更新された日付と時間。 | クエリ、取得 |
| url | url | データ ソース内のアイデアのターゲット URL | 取得、検索 |
| 投票 | アイデアに送信された投票数。 | クエリ、取得 |
同期間隔をカスタマイズする
フル更新とインクリメンタル更新の同期間隔をカスタマイズできます。 既定値:
- インクリメンタル更新: 15 分ごと
- フル更新: 毎日
詳細については、「同期設定のガイドライン」を参照してください。
レート制限
次の表に、Aha! に適用されるレート制限の一覧を示します。 コネクター (機能とアイデアの両方用)。
| アイテムのおおよその数 | インジェストを完了するまでのおおよその時間 |
|---|---|
| 最大 10,000 | 最大 1 時間 |
| 10,000 から 300,000 | 数時間から 1 日 |
| 300,000 から 2,000,000 | 2 日から 1 週間 |
| 2,000,000 以上 | 1 - 2 週間 (環境の負荷によって異なります) |