Copilot Agent Kitのエージェントライブラリにおけるコンポーネント参照

エージェントライブラリのコンポーネントは再利用可能で、任意のCopilot Studioエージェントに追加できるプリビルドのコンポーネントコレクションです。 各コンポーネントは独立した コンポーネントコレクションとしてパッケージ化されているので、必要なコンポーネントだけをインストールします。

この記事はコンポーネントごとの参考文献です。 コンポーネントの概要、キットからコンポーネントの閲覧やインストール方法、エージェントへの追加方法については、 エージェントライブラリのコンポーネント管理をご覧ください。

コンポーネントの概要

エージェントライブラリには、各社のソリューション全体に出荷される以下のコンポーネントが含まれています。 接続参照を必要としないコンポーネントは、それぞれのベースソリューションに存在します。 共通のコネクタを共有するコンポーネントはグループ化されます。

Prerequisites

開始する前に、次の前提条件が満たされていることを確認してください。

• Power Platform環境にCopilot Agent Kitをインストールし、設定してください。
• サインインしたユーザーは、Copilot Agent KitでCSK - Makerのセキュリティロールを割り当ててコンポーネントの閲覧やインストールを行います。
• Power Platform環境ではCopilot Studioが有効になっています。
• 環境内でAI Builderのクレジットを用意してください(プロンプトベースのコンポーネントに必須)。
• ServiceNowチケットアシスタントでは、REST APIアクセスとPower Platformで設定済みのServiceNow接続を持つServiceNowインスタンスを用意してください。 ServiceNowのサービスプリンシパル設定について詳しくはこちらをご覧ください。

Document Extraction

ドキュメント抽出はアップロードされた文書を構造化データに変換します。 AI Builderのプロンプトを使って、設定可能なスキーマに基づいてキーフィールドを解析・抽出します。

使用タイミング:請求書処理、契約書の確認、フォームのデジタル化、または非構造化文書から構造化情報を引き出す必要があるあらゆるシナリオ。

ドキュメント抽出の仕組み

1. ユーザーはエージェントとの会話にドキュメントをアップロードします。
2. コンポーネントはAI Builderで文書を処理します。
3. コンポーネントは抽出したデータを構造化出力として返し、それを保存、表示、または下流のフローに渡すことができます。

文書抽出入力

ドキュメント抽出出力

すべてのAI Builderのプロンプト出力は返されます。

Content Synthesizer

Content Synthesizerは、生の検索結果を構造化されたエビデンスに基づく研究セクションに変換し、インライン引用も含めます。 これはリサーチコンポーネントとエグゼクティブブリーフコンポーネントパイプラインの両方で使われる共有合成エンジンです。 また、オンデマンドコンテンツ合成のための単独ツールとして任意のエージェントに追加することも可能です。

使用時期:複数のソース文書を統合し、多段階のパイプラインの一部として、または独立したコンテンツ生成ツールとして一貫した引用に基づく物語にまとめるシナリオ。

Content Synthesizerの仕組み

1. 親パイプライン(またはエージェント)は、リサーチプロンプト、生の検索結果コンテンツ、オプションのスタイル指示を渡します。
2. このプロンプトはテーマごとにすべての情報源の洞察を統合しています。 出典ごとに要約しているわけではありません。
3. 証拠は、数値、パーセンテージ、日付、名前のある主体などの具体的なデータポイントを含む、提供された内容に基づいています。
4. 出力はJSONオブジェクトで、合成されたマークダウンセクションと抽出された引用の配列が入っています。

コンテンツ合成器入力

コンテンツシンセサイザーの出力

プロンプトは2つのフィールドを持つJSONオブジェクトを返します:

コンテンツシンセサイザーの出力構造

合成されたセクションは以下の構成に従います。

• 冒頭:最も重要な発見を紹介し、主要なテーマをプレビューします。
• 本文:テーマ別(出典別ではなく)で整理されており、インラインの帰属と [n] 引用マーカー、太字の キー・ファインディング の注釈、オプションの [CHART SUGGESTION] マーキングがあります。
• 主なポイント:3〜5つの簡潔で実行可能な箇条書き。
• フッター:信頼度評価(高から低)、データの最新性、そして顕著なギャップ。

Research Component

リサーチコンポーネントは複数の情報源から情報を統合し、包括的な研究報告書を作成します。 3段階のAIパイプラインを用いて調査結果を計画、調査、まとめています。

利用時期:競合分析、市場調査、政策レビュー、または複数の情報源を統合した視点が必要なあらゆるシナリオ。

リサーチコンポーネントの仕組み

1. ユーザーは研究の質問やトピックを提供します。
2. ステージ1(リサーチプランナー):セクションやクエリを含む構造化されたリサーチプランを作成します。
3. ステージ2(コンテンツ合成):各セクションのウェブソースを検索し、引用を含むコンテンツを生成します。
4. ステージ3(レポート最終化):すべてのセクションと引用をまとめて洗練されたレポートを作成します。
5. 最終報告は会話内にインライン表示されます。

研究コンポーネントの入力

研究コンポーネントの成果物

コンポーネントは会話内でレポートを表示します。

エグゼクティブ・ブリーフ構成要素

エグゼクティブブリーフコンポーネントは、複雑な入力から簡潔で意思決定志向の要約を生成します。 3段階のAIパイプラインを用いて、インサイトを計画し、統合し、洗練された経営者ブリーフを作成します。

使用タイミング:取締役会準備、プロジェクト進捗報告、四半期ごとの事業レビュー、または利害関係者向けに洗練された要約が必要なあらゆるシナリオ。

エグゼクティブ・ブリーフ・コンポーネントの仕組み

1. ユーザーは簡単なトピックや質問を提供します。
2. ステージ1(エグゼクティブブリーフプランナー):研究分野を含む戦略的研究計画を作成します。
3. ステージ2(Insight Synthesizer、 Content Synthesizerによる支援):各分野の内部およびウェブ情報を検索し、重要な事実や引用を抽出します。
4. ステージ3(ブリーフ最終決定):すべての洞察と引用をまとめて洗練されたエグゼクティブブリーフを作成する。
5. ブリーフは会話の中でインライン表示されます。

エグゼクティブブリーフコンポーネントの意見

エグゼクティブブリーフコンポーネントの出力

コンポーネントは会話の中でエグゼクティブブリーフを表示します。

ServiceNowチケットアシスタント

ServiceNowチケットアシスタントは、Copilot Studioのエージェントから直接サービスNowのインシデント管理をエンドツーエンドで提供します。 インシデントライフサイクル全体をカバーする5つのトピックが含まれています。

利用タイミング:ITヘルプデスク、従業員セルフサービス、またはServiceNowインシデント管理を含むあらゆるシナリオ。

ServiceNowにはトピックが含まれていました

ServiceNow prerequisites

このコンポーネントはインポート時にServiceNowの接続参照が必要なため、独自のソリューション(CopilotStudioKit_ServiceNow_Components)で出荷されます。 このソリューションをインポートする前に、以下の条件を確認してください:

• REST APIアクセスを持つServiceNowインスタンスです。
• ServiceNow用にPower Platformで設定された接続です。 ソリューションインポート中に設定するよう促されます。
• 必要な操作に対して適切なServiceNowユーザー権限を割り当てること。

ServiceNowサービスプリンシパル設定

Microsoft Entra IDを使用するServiceNow Power Platform接続を設定するには、「How to set up a ServiceNow Power Platform connection with the Microsoft Entra ID」の手順に従ってください。

ServiceNowチケットアシスタントの仕組み

1. ユーザーは意図を表現します(例えば、「チケットを作成する必要があります」や「INC0012345の状況はどうなっていますか?」)。
2. 適切なトピックがトリガーされ、必要な入力を収集するための適応カードが表示されます。
3. コンポーネントはコネクタを通じてServiceNow APIを呼び出し、その結果を返します。
4. 操作が完了すると、「 次のアクション 」トピックで次のステップの選択肢が表示されます。

Create incident

ユーザーから詳細を収集し、コネクタを通じてServiceNowに送信することで、新しいServiceNowインシデントを作成します。

利用すべきタイミング:ITヘルプデスク、従業員セルフサービス、またはユーザーが会話から直接新しいインシデントを記録する必要があるあらゆるシナリオ。

インシデントフローの作成

1. ユーザーが「壊れたノートパソコンのためにチケットを作成する必要がある」といったインシデント作成の意図を表明します。
2. 適応型カードは必要なインシデントの詳細を収集します。
3. コンポーネントはServiceNow APIを呼び出してインシデントを作成し、インシデント番号付きの確認を返します。
4. 次の アクション メニューが表示され、ユーザーは別のServiceNow操作を続けることができます。

アダプティブカードを通じてインシデント入力を作成する

インシデント出力の作成

作成されたインシデント番号がインラインに表示される確認メッセージ。

インシデントの状況を確認してください

既存のServiceNowインシデントの最新状況と詳細を取得します。

インシデントの状況の確認

1. ユーザーがインシデントについて尋ねるとき、例えば「INC0010002の状況はどうですか?」と。
2. アダプティブカードがインシデント番号を収集します。
3. コンポーネントはServiceNowにクエリし、インシデントの詳細を返します。

アダプティブカードを通じてインシデントステータス入力を確認してください

インシデントステータス出力の確認

解決または事故

既存のServiceNowインシデントの状態を「解決済み」「閉鎖済み」「キャンセル済み」「保留中」「進行中」と更新し、解決の詳細も含めて更新します。

インシデントフローを解決するか、閉鎖するか

1. ユーザーが「チケットINC0010002を閉じる」など、インシデントの解決またはクローズの意思表示を行います。
2. 適応カードはインシデント番号、ターゲット状態、解決コード、解決ノートを収集します。
3. コンポーネントはServiceNowでインシデントを更新し、確認を返します。

事故解決または終了の前提条件

REST APIアクセスを持つServiceNowインスタンスとPower Platform内のServiceNow接続があります。

アダプティブカードを通じたインシデント入力の解決または終了

インシデント出力の解決または終了

インシデント状態の更新を含む確認メッセージがインラインに表示されます。

最近の出来事を入手

現在のユーザーに対して最大10件の最近のServiceNowインシデントを取得し表示します。 入力フィールドは不要です。 コンポーネントはサインインしたユーザーのメールアドレスを自動的に使用します。

利用時期:ユーザーが最近または未解決のインシデントの概要を簡単に知りたい場合。

最近のインシデントの流れを把握しましょう

1. ユーザーは「最近のインシデントを見せてください」など、自分のインシデントについて尋ねます。
2. コンポーネントは、サインインしたユーザーのメールアドレスに一致する最大10件の最近のインシデントをServiceNowに問い合わせます。
3. インシデントの詳細は会話内にインライン表示されます。

最近のインシデント情報を得る

None. コンポーネントは自動的にサインイン中のユーザーのメールアドレスを使用します。

最近のインシデント出力を取得

コンポーネント詳細パネル

Copilot Agent Kitのエージェントライブラリからコンポーネントを開くと、詳細パネルにコンポーネントの説明、カテゴリ、入力・出力変数、使用技術が表示されます。

コンポーネントをインストールしてエージェントのワークフローに追加するには、「 コンポーネント管理」をご覧ください。

管理型ソリューションでコンポーネントを活用してください

ほとんどのユーザーはマネージドソリューションを使いましょう。 インポートされたコンポーネントは読み取り専用です。 エージェントに追加して、元のトピックやプロンプト、フローを誤って変更するリスクなく使用できます。

コンポーネント自体を編集しなくても、動作を制御する方法は2つあります:エージェント命令とツール入力のデフォルトです。

Agent instructions

Copilot Studioエージェントの指示フィールドは、コンポーネントの使い方を形作る主要な方法です。 自然言語の指示を通じて、以下の操作が可能です:

• コンポーネントが呼び出されるとき:各ツールをトリガーすべきシナリオやユーザーの意図を説明してください。
• どのデータを渡すか:エージェントに、どのコンテキスト、変数、または会話履歴を含めるべきかを伝えます。
• 結果の提示方法:コンポーネントが出力を返した後のフォーマット、トーン、フォローアップアクション、ルーティングを指定する。
• 全体的な調整:複数の要素が関与する場合の運用順序を定義します。例えば「研究完了後、その結果からエグゼクティブブリーフを作成する」などです。

ツール入力のデフォルト

AI Builderのプロンプトなどのツールとしてコンポーネントを追加すると、管理型ソリューションを使っていてもCopilot Studioで直接入力パラメータを設定できます。 これらの入力により、エージェント命令だけでは達成できないより具体的なデフォルト設定が可能です。 For example:

• ビジネス文書に合わせたデフォルトの ExtractionSchema 、例えば氏名、請求書番号、日付などの請求書欄を用意しましょう。
• 組織の好みの執筆スタイルやコンプライアンス要件を事前に入力 AdditionalInstructions 。

入力デフォルトはエージェントごとに設定されているため、異なるエージェントが同じ共有コンポーネントに異なる値を渡すことができます。

管理されていないソリューションでコンポーネントをカスタマイズする

プロンプトロジックの変更、トピックフローの編集、コネクタの配線のやり直しなど、コンポーネント内部を修正する必要がある場合は、管理されていないソリューションをインポートする必要があります。 このソリューションにより、エージェントライブラリ内のすべてのトピック、プロンプト、フローに対して完全な編集権限が得られます。

一般的なカスタマイズには以下があります:

• プロンプトの修正:AI Builderのプロンプトをドメインや出力形式に合わせて調整します。
• データソースの変更:コンポーネントを自分のDataverseテーブル、SharePointリスト、または外部コネクタに割り当てます。
• トピックの調整:会話の流れを組織の用語やプロセスに合わせて更新しましょう。
• トリガーフレーズの更新:ユーザーが自然にリクエストする仕組みを反映したトリガーフレーズを追加しましょう。
• 認証を追加する:コンポーネントがユーザー固有のデータにアクセスする必要がある場合、認証を設定しましょう。

Related information

• Components management
• AI Builder のドキュメント