Agents Client SDK を使用してネイティブ アプリと統合する

Important

このコンテンツは、開発者ツール、ユーティリティ、統合開発環境 (IDE) に精通している IT 管理者や開発者などの経験豊富な IT プロフェッショナルを対象としています。 この統合を作成するには、ソフトウェア開発の専門知識が必要です。

Agents Client SDK は、Android、iOS、および Windows プラットフォーム用の SDK です。 この SDK を使用すると、ネイティブ Android、iOS、Windows アプリから、Copilot Studio または Microsoft 365 エージェント SDK を使用して開発されたエージェントと通信できます。

Agents Client SDK では、ユーザーとエージェントの対話にマルチモダリティが導入されています。 ユーザーは、テキストまたは音声を介してエージェントと通信しながら、画像または画面キャプチャを介してコンテキストを共有できるようになりました。

SDK の最初のバージョンでは、Copilot Studio で作成されたエージェントを使用して認証されていないエンド ユーザーまたは匿名のエンド ユーザー向けに、テキストベースの通信とアダプティブ カードのレンダリングがサポートされています。 アダプティブ カードをトピックに追加するには、[ Ask with adaptive card]\(アダプティブ カードで要求 \) オプションを使用します。

Important

現在、SDK は認証されていないユーザーのみをサポートしており、エンド ユーザーにとって適切で必要と見なされる場合はネイティブ アプリで使用できます。

ネイティブ アプリ用にエージェントを構成する

  1. Copilot Studio で [エージェント] を選択し、その後あなたのエージェントを選択します。

  2. > >] で、[認証なし] を選択します。

    Copilot Studio のエージェントに対して [認証なし] セキュリティ設定が有効になっているスクリーンショット。

  3. エージェントの [チャネル] ページに移動します。

    [ 認証なし ] が選択されている場合は、レビューをお勧めします。

    認証の選択がないときに推奨されるレビューを示すエージェントの [チャネル] ページのスクリーンショット。

  4. 公開を選択します。

    このエージェントを発行する画面が表示されます。

    Copilot Studio のエージェントの発行確認画面のスクリーンショット。

  5. 公開を選択します。 エージェントが公開され、クライアント SDK で使用できます。

SDK と統合するために必要な情報を取得する

アプリ コードにエージェントの統合を追加する前に、エージェントに関する Copilot Studio の詳細が必要です。

  1. エージェント を選択し、次にあなたのエージェントを選んで、Copilot Studioでエージェントに移動します。

  2. [設定]>[Advanced settings>Metadata] に移動します。

    環境 ID とスキーマ名を書き留めます。

    エージェントの environmentID とスキーマ名を示す [詳細設定] ページのスクリーンショット。

  3. エージェントのデプロイ環境を書き留めておきます。 copilotstudio.microsoft.comとcopilotstudio.preview.microsoft.comの場合、デプロイ環境はprod。 copilotstudio.preprod.microsoft.comの場合、デプロイ環境はpreprod。

エージェント クライアント SDK の詳細

次に、収集した情報を使用して、エージェント クライアント SDK を使用してネイティブ アプリ コードにエージェントを統合できます。

ネイティブ アプリにエージェントを統合する方法のコードと詳細については、選択したアプリ プラットフォームの GitHub リポジトリを確認してください。

  • Last updated on