エージェントライブラリのコンポーネントは再利用可能で、任意のCopilot Studioエージェントに追加できるプリビルドのコンポーネントコレクションです。 各コンポーネントは独立した コンポーネントコレクションとしてパッケージ化されているので、必要なコンポーネントだけをインストールします。
この記事はコンポーネントごとの参考文献です。 コンポーネントの概要、キットからコンポーネントの閲覧やインストール方法、エージェントへの追加方法については、 エージェントライブラリのコンポーネント管理をご覧ください。
Note
エージェントライブラリはマネージドおよび非マネージドの両方のソリューションとして利用可能です。 マネージドソリューションを使って、修正せずにエージェントにコンポーネントを追加できます。 コンポーネント内部を編集する必要がある場合にのみ 、管理されていない ソリューションを使いましょう。 各環境ごとにコンポーネントは1つだけインスタンスなので、エージェントライブラリ内でトピック、プロンプト、フローを編集しても、同じ環境内でそのコンポーネントを使うすべてのエージェントに適用されます。
コンポーネントの概要
エージェントライブラリには、各社のソリューション全体に出荷される以下のコンポーネントが含まれています。 接続参照を必要としないコンポーネントは、それぞれのベースソリューションに存在します。 共通のコネクタを共有するコンポーネントはグループ化されます。
| Component collection | Description | Components | Connections |
|---|---|---|---|
| Document Extraction | アップロードされた文書をAI Builderを使って構造化データに変換します。 | 1 prompt | Dataverse |
| Content Synthesizer | 研究内容をエビデンスに基づくセクションに統合し、引用を含む共有AI Builderプロンプト。 | 1 prompt | Dataverse |
| Research Component | ウェブソースを総合的にまとめて包括的な研究報告書を作成する三段階のAIパイプライン。 | トピック1+プロンプト3(ステージ2はコンテンツシンセサイザーを呼び出します) | Dataverse |
| エグゼクティブ・ブリーフ構成要素 | 意思決定志向のエグゼクティブサマリーを生成する3段階のAIパイプライン。 | トピック1+プロンプト3(ステージ2はコンテンツシンセサイザーを呼び出します) | Dataverse |
| ServiceNowチケットアシスタント | アダプティブカードを用いたエンドツーエンドのServiceNowインシデント管理。 | トピック5+接続参照1件 | Dataverse, ServiceNow |
Important
「必要不可」とマークされたフィールドにはデフォルトが内蔵されており、設定なしでも動作します。 デフォルトの動作を上書きするためだけに値を指定してください。
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
| Property | Value |
|---|---|
| タイプ | AI Builder プロンプト(TaskDialog) |
| Category | データ取得と統合 |
| Interaction model | Tool-initiated. エージェント・オーケストレーターは、ユーザーの意図がツールの説明と一致したときにこのツールを呼び出します。 |
ドキュメント抽出はアップロードされた文書を構造化データに変換します。 AI Builderのプロンプトを使って、設定可能なスキーマに基づいてキーフィールドを解析・抽出します。
使用タイミング:請求書処理、契約書の確認、フォームのデジタル化、または非構造化文書から構造化情報を引き出す必要があるあらゆるシナリオ。
ドキュメント抽出の仕組み
- ユーザーはエージェントとの会話にドキュメントをアップロードします。
- コンポーネントはAI Builderで文書を処理します。
- コンポーネントは抽出したデータを構造化出力として返し、それを保存、表示、または下流のフローに渡すことができます。
文書抽出入力
| Name | Display name | Required | Description |
|---|---|---|---|
| DocumentContent | Document Content | Yes | ファイルからの全文または貼り付けた内容。 |
| ExtractionSchema | Extraction Schema | Yes | 文書の内容から抽出するキーフィールド。 例えば、請求書スキーマには名前、請求書番号、日付などのフィールドが含まれていることがあります。 |
ドキュメント抽出出力
すべてのAI Builderのプロンプト出力は返されます。
Content Synthesizer
| Property | Value |
|---|---|
| タイプ | AI Builder プロンプト(TaskDialog) |
| Category | コンテンツ生成と変革 |
| Interaction model | Module. 親パイプライン(リサーチコンポーネント または エグゼクティブブリーフコンポーネント)によってステージ2の統合ステップとして呼び出されます。 単独のツールとしても使えます。 |
Content Synthesizerは、生の検索結果を構造化されたエビデンスに基づく研究セクションに変換し、インライン引用も含めます。 これはリサーチコンポーネントとエグゼクティブブリーフコンポーネントパイプラインの両方で使われる共有合成エンジンです。 また、オンデマンドコンテンツ合成のための単独ツールとして任意のエージェントに追加することも可能です。
使用時期:複数のソース文書を統合し、多段階のパイプラインの一部として、または独立したコンテンツ生成ツールとして一貫した引用に基づく物語にまとめるシナリオ。
Content Synthesizerの仕組み
- 親パイプライン(またはエージェント)は、リサーチプロンプト、生の検索結果コンテンツ、オプションのスタイル指示を渡します。
- このプロンプトはテーマごとにすべての情報源の洞察を統合しています。 出典ごとに要約しているわけではありません。
- 証拠は、数値、パーセンテージ、日付、名前のある主体などの具体的なデータポイントを含む、提供された内容に基づいています。
- 出力はJSONオブジェクトで、合成されたマークダウンセクションと抽出された引用の配列が入っています。
コンテンツ合成器入力
| Name | Display name | Required | タイプ | Description |
|---|---|---|---|---|
| Content | Content | Yes | Automatic | Markdownはユーザーのクエリから生成されたリサーチアウトで、コンテンツの統合に使われます。 予想されるフォーマットは Title:、 Source:、 Content: ブロックです。 |
| ResearchPrompt | Research Prompt | Yes | Automatic | ユーザーの調査質問や問い合わせ。 すべてのコンテンツはこの目的を中心に構成されています。 |
コンテンツシンセサイザーの出力
プロンプトは2つのフィールドを持つJSONオブジェクトを返します:
| Field | タイプ | Description |
|---|---|---|
| SectionContentMarkdown | String | Markdownでフルシンセサイズセクションを聴く。 テーマ別に整理されており、見出し、主要な発見、重要なポイント、そして自信度や最近性のフッターが記載されています。 |
| Citations | Array | 引用資料の一覧は "Title - URL"形式で表しています。 各項目はセクション内容内のインライン [n] マーカーに対応しています。 |
コンテンツシンセサイザーの出力構造
合成されたセクションは以下の構成に従います。
- 冒頭:最も重要な発見を紹介し、主要なテーマをプレビューします。
-
本文:テーマ別(出典別ではなく)で整理されており、インラインの帰属と
[n]引用マーカー、太字の キー・ファインディング の注釈、オプションの[CHART SUGGESTION]マーキングがあります。 - 主なポイント:3〜5つの簡潔で実行可能な箇条書き。
- フッター:信頼度評価(高から低)、データの最新性、そして顕著なギャップ。
Research Component
| Property | Value |
|---|---|
| タイプ | トピック+3つのAI Builderプロンプト+ウェブ検索 |
| Category | データ分析と洞察 |
| Interaction model | Tool-initiated. 3段階のパイプライン:研究計画、内容統合、報告書最終化。 |
リサーチコンポーネントは複数の情報源から情報を統合し、包括的な研究報告書を作成します。 3段階のAIパイプラインを用いて調査結果を計画、調査、まとめています。
利用時期:競合分析、市場調査、政策レビュー、または複数の情報源を統合した視点が必要なあらゆるシナリオ。
リサーチコンポーネントの仕組み
- ユーザーは研究の質問やトピックを提供します。
- ステージ1(リサーチプランナー):セクションやクエリを含む構造化されたリサーチプランを作成します。
- ステージ2(コンテンツ合成):各セクションのウェブソースを検索し、引用を含むコンテンツを生成します。
- ステージ3(レポート最終化):すべてのセクションと引用をまとめて洗練されたレポートを作成します。
- 最終報告は会話内にインライン表示されます。
研究コンポーネントの入力
| Name | Display name | Required | Description |
|---|---|---|---|
| ResearchPrompt | Research Prompt | Yes | 主なテーマや研究対象は「電気自動車市場の概要」などです。 |
| AdditionalInstructions | Additional Instructions | No | 焦点領域や制約などの任意のコンテキストも含めて。 空の場合はデフォルトで「明確な研究目標から始める」となります。 |
| InstructionsForInformationCompiler | 情報コンパイラの指示 | No | 各合成セクションのスタイルと長さをコントロールします。 空の場合はデフォルトで「シンプルスタイル、最大200語」になります。 |
| InstructionsForReportFinalizer | レポートファイナライザーの手順 | No | 最終報告書のまとめ方を管理します。 すべてのセクションを統合して一貫した報告書にまとめるのがデフォルトです。 |
研究コンポーネントの成果物
コンポーネントは会話内でレポートを表示します。
エグゼクティブ・ブリーフ構成要素
| Property | Value |
|---|---|
| タイプ | トピック+3つのAI Builderプロンプト+内部/ウェブ検索 |
| Category | コンテンツ生成と変革 |
| Interaction model | Tool-initiated. 三段階のパイプライン:戦略的計画、インサイト統合、簡単な最終決定。 |
エグゼクティブブリーフコンポーネントは、複雑な入力から簡潔で意思決定志向の要約を生成します。 3段階のAIパイプラインを用いて、インサイトを計画し、統合し、洗練された経営者ブリーフを作成します。
使用タイミング:取締役会準備、プロジェクト進捗報告、四半期ごとの事業レビュー、または利害関係者向けに洗練された要約が必要なあらゆるシナリオ。
エグゼクティブ・ブリーフ・コンポーネントの仕組み
- ユーザーは簡単なトピックや質問を提供します。
- ステージ1(エグゼクティブブリーフプランナー):研究分野を含む戦略的研究計画を作成します。
- ステージ2(Insight Synthesizer、 Content Synthesizerによる支援):各分野の内部およびウェブ情報を検索し、重要な事実や引用を抽出します。
- ステージ3(ブリーフ最終決定):すべての洞察と引用をまとめて洗練されたエグゼクティブブリーフを作成する。
- ブリーフは会話の中でインライン表示されます。
エグゼクティブブリーフコンポーネントの意見
| Name | Display name | Required | Description |
|---|---|---|---|
| ResearchPrompt | Research Prompt | Yes | 「中堅企業のAI導入戦略」のような簡単なトピックや質問。 |
| AdditionalInstructions | Additional Instructions | No | 任意の会社の文脈、焦点領域、または制約。 |
エグゼクティブブリーフコンポーネントの出力
コンポーネントは会話の中でエグゼクティブブリーフを表示します。
ServiceNowチケットアシスタント
| Property | Value |
|---|---|
| タイプ | 5トピック+ServiceNowコネクタ+アダプティブカード |
| Category | アクション実行とシステム統合 |
| Interaction model | Conversation-initiated. エージェントはユーザーの意図に基づいて適切なトピックにルーティングします。 各トピックは適応カードを使って必要な項目を集めます。 |
ServiceNowチケットアシスタントは、Copilot Studioのエージェントから直接サービスNowのインシデント管理をエンドツーエンドで提供します。 インシデントライフサイクル全体をカバーする5つのトピックが含まれています。
利用タイミング:ITヘルプデスク、従業員セルフサービス、またはServiceNowインシデント管理を含むあらゆるシナリオ。
ServiceNowにはトピックが含まれていました
| Topic | Description |
|---|---|
| Create Incident | アダプティブカードを通じて短い説明、詳細な説明、影響、緊急性を収集し、ServiceNowでインシデントを作成します。 |
| Check Status | インシデント番号(例: INC0010002)を受け付け、状態、優先度、日付、説明を返します。 |
| Resolve/Close Incident | インシデントの状態(解決済み、終了済み、キャンセル済み、保留中、進行中)を解決コードとメモで更新します。 |
| 最近のインシデントを入手 | サインインしているユーザーの最近のインシデントを最大10件自動取得します。 入力は不要です。 |
| Next Actions | ServiceNow操作終了後、他のServiceNowトピックへのルーティング、または一般的な会話の後にナビゲーションメニューを表示します。 |
Note
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チケットアシスタントの仕組み
- ユーザーは意図を表現します(例えば、「チケットを作成する必要があります」や「INC0012345の状況はどうなっていますか?」)。
- 適切なトピックがトリガーされ、必要な入力を収集するための適応カードが表示されます。
- コンポーネントはコネクタを通じてServiceNow APIを呼び出し、その結果を返します。
- 操作が完了すると、「 次のアクション 」トピックで次のステップの選択肢が表示されます。
Create incident
ユーザーから詳細を収集し、コネクタを通じてServiceNowに送信することで、新しいServiceNowインシデントを作成します。
利用すべきタイミング:ITヘルプデスク、従業員セルフサービス、またはユーザーが会話から直接新しいインシデントを記録する必要があるあらゆるシナリオ。
インシデントフローの作成
- ユーザーが「壊れたノートパソコンのためにチケットを作成する必要がある」といったインシデント作成の意図を表明します。
- 適応型カードは必要なインシデントの詳細を収集します。
- コンポーネントはServiceNow APIを呼び出してインシデントを作成し、インシデント番号付きの確認を返します。
- 次の アクション メニューが表示され、ユーザーは別のServiceNow操作を続けることができます。
アダプティブカードを通じてインシデント入力を作成する
| Field | Required | Description |
|---|---|---|
| ShortDescription | Yes | 問題の簡単な概要 |
| Description | No | 問題の詳細な説明 |
| Impact | Yes | ビジネスインパクトレベル(1-高、2-中、3-低) |
| Urgency | Yes | 緊急性レベル(1-ハイ、2-ミディアム、3-ロー) |
インシデント出力の作成
作成されたインシデント番号がインラインに表示される確認メッセージ。
インシデントの状況を確認してください
既存のServiceNowインシデントの最新状況と詳細を取得します。
インシデントの状況の確認
- ユーザーがインシデントについて尋ねるとき、例えば「INC0010002の状況はどうですか?」と。
- アダプティブカードがインシデント番号を収集します。
- コンポーネントはServiceNowにクエリし、インシデントの詳細を返します。
アダプティブカードを通じてインシデントステータス入力を確認してください
| Field | Required | Description |
|---|---|---|
| IncidentNumber | Yes |
INC0010002のようなインシデント番号を調べてください。 |
インシデントステータス出力の確認
| Field | Description |
|---|---|
| IncidentNumber | インシデント識別子 |
| State | 事件の現状 |
| Priority | Priority level |
| CreatedDate | 事件が生まれた時 |
| LastUpdatedDate | 事件が最後に修正された時期 |
解決または事故
既存のServiceNowインシデントの状態を「解決済み」「閉鎖済み」「キャンセル済み」「保留中」「進行中」と更新し、解決の詳細も含めて更新します。
インシデントフローを解決するか、閉鎖するか
- ユーザーが「チケットINC0010002を閉じる」など、インシデントの解決またはクローズの意思表示を行います。
- 適応カードはインシデント番号、ターゲット状態、解決コード、解決ノートを収集します。
- コンポーネントはServiceNowでインシデントを更新し、確認を返します。
事故解決または終了の前提条件
REST APIアクセスを持つServiceNowインスタンスとPower Platform内のServiceNow接続があります。
アダプティブカードを通じたインシデント入力の解決または終了
| Field | Required | Description |
|---|---|---|
| IncidentNumber | Yes | インシデント番号は更新予定です |
| State | Yes | ターゲット状態(解決済み、クローズ済み、キャンセル済み、保留中、進行中) |
| ResolutionCode | Yes | 解決カテゴリ(リモート解決や発信者による解決など) |
| ResolutionNotes | Yes | 決議の説明 |
インシデント出力の解決または終了
インシデント状態の更新を含む確認メッセージがインラインに表示されます。
最近の出来事を入手
現在のユーザーに対して最大10件の最近のServiceNowインシデントを取得し表示します。 入力フィールドは不要です。 コンポーネントはサインインしたユーザーのメールアドレスを自動的に使用します。
利用時期:ユーザーが最近または未解決のインシデントの概要を簡単に知りたい場合。
最近のインシデントの流れを把握しましょう
- ユーザーは「最近のインシデントを見せてください」など、自分のインシデントについて尋ねます。
- コンポーネントは、サインインしたユーザーのメールアドレスに一致する最大10件の最近のインシデントをServiceNowに問い合わせます。
- インシデントの詳細は会話内にインライン表示されます。
最近のインシデント情報を得る
None. コンポーネントは自動的にサインイン中のユーザーのメールアドレスを使用します。
最近のインシデント出力を取得
| Field | Description |
|---|---|
| IncidentNumber | インシデント識別子 |
| State | 事件の現状 |
| Priority | Priority level |
| ShortDescription | 問題の簡単な概要 |
| CreatedDate | 事件が生まれた時 |
| LastUpdatedDate | 事件が最後に修正された時期 |
Note
すべてのServiceNowコンポーネントには、各操作後に表示される 「次のアクション」 ナビゲーションメニューがあり、ユーザーはすぐに別のServiceNowアクションに移動したり、一般的な会話に戻ったりできます。
コンポーネント詳細パネル
Copilot Agent Kitのエージェントライブラリからコンポーネントを開くと、詳細パネルにコンポーネントの説明、カテゴリ、入力・出力変数、使用技術が表示されます。
コンポーネントをインストールしてエージェントのワークフローに追加するには、「 コンポーネント管理」をご覧ください。
管理型ソリューションでコンポーネントを活用してください
ほとんどのユーザーはマネージドソリューションを使いましょう。 インポートされたコンポーネントは読み取り専用です。 エージェントに追加して、元のトピックやプロンプト、フローを誤って変更するリスクなく使用できます。
コンポーネント自体を編集しなくても、動作を制御する方法は2つあります:エージェント命令とツール入力のデフォルトです。
Agent instructions
Copilot Studioエージェントの指示フィールドは、コンポーネントの使い方を形作る主要な方法です。 自然言語の指示を通じて、以下の操作が可能です:
- コンポーネントが呼び出されるとき:各ツールをトリガーすべきシナリオやユーザーの意図を説明してください。
- どのデータを渡すか:エージェントに、どのコンテキスト、変数、または会話履歴を含めるべきかを伝えます。
- 結果の提示方法:コンポーネントが出力を返した後のフォーマット、トーン、フォローアップアクション、ルーティングを指定する。
- 全体的な調整:複数の要素が関与する場合の運用順序を定義します。例えば「研究完了後、その結果からエグゼクティブブリーフを作成する」などです。
ツール入力のデフォルト
AI Builderのプロンプトなどのツールとしてコンポーネントを追加すると、管理型ソリューションを使っていてもCopilot Studioで直接入力パラメータを設定できます。 これらの入力により、エージェント命令だけでは達成できないより具体的なデフォルト設定が可能です。 For example:
- ビジネス文書に合わせたデフォルトの
ExtractionSchema、例えば氏名、請求書番号、日付などの請求書欄を用意しましょう。 - 組織の好みの執筆スタイルやコンプライアンス要件を事前に入力
AdditionalInstructions。
入力デフォルトはエージェントごとに設定されているため、異なるエージェントが同じ共有コンポーネントに異なる値を渡すことができます。
管理されていないソリューションでコンポーネントをカスタマイズする
プロンプトロジックの変更、トピックフローの編集、コネクタの配線のやり直しなど、コンポーネント内部を修正する必要がある場合は、管理されていないソリューションをインポートする必要があります。 このソリューションにより、エージェントライブラリ内のすべてのトピック、プロンプト、フローに対して完全な編集権限が得られます。
Important
コンポーネントコレクションは環境全体で共有されます。 各環境ごとにコンポーネントは1つだけインスタンスなので、エージェントライブラリ内でトピック、プロンプト、フローを編集しても、同じ環境内でそのコンポーネントを使う すべてのエージェント に適用されます。 コンポーネントを変更する前に、その変更がすべての消費者に適切かどうかを確認してください。
一般的なカスタマイズには以下があります:
- プロンプトの修正:AI Builderのプロンプトをドメインや出力形式に合わせて調整します。
- データソースの変更:コンポーネントを自分のDataverseテーブル、SharePointリスト、または外部コネクタに割り当てます。
- トピックの調整:会話の流れを組織の用語やプロセスに合わせて更新しましょう。
- トリガーフレーズの更新:ユーザーが自然にリクエストする仕組みを反映したトリガーフレーズを追加しましょう。
- 認証を追加する:コンポーネントがユーザー固有のデータにアクセスする必要がある場合、認証を設定しましょう。
Tip
異なるエージェントごとに異なる振る舞いが必要な場合は、共有インスタンスを編集するのではなく、別のソリューションでコンポーネントのコピーを作成することを検討してください。