Integration in systemeigene Apps mithilfe des Agents Client SDK

Von Bedeutung

Dieser Inhalt richtet sich an erfahrene IT-Experten, z. B. IT-Administratoren oder Entwickler, die mit Entwicklertools, Hilfsprogrammen und integrierten Entwicklungsumgebungen (IDEs) vertraut sind. Die Erstellung dieser Integration erfordert Know-how zur Softwareentwicklung.

Agents Client SDK ist ein SDK für Android-, iOS- und Windows-Plattformen. Mit diesem SDK können Sie mit Agents kommunizieren, die mit Copilot Studio oder dem Microsoft 365 Agents SDK entwickelt wurden, von nativen Android-, iOS- und Windows-Apps.

Mit agents Client SDK führen wir eine multimodale Interaktion mit dem Benutzer-Agent ein. Benutzer können jetzt über Text oder Sprache mit Agenten kommunizieren, während sie den Kontext über Bilder oder Bildschirmaufnahmen teilen.

Die erste Version des SDK unterstützt textbasierte Kommunikation und adaptive Kartenrendering für nicht authentifizierte oder anonyme Endbenutzer mit Agents, die in Copilot Studio erstellt wurden. Sie können Themen adaptive Karten hinzufügen, indem Sie die Option " Mit adaptiver Karte fragen " verwenden.

Von Bedeutung

Derzeit unterstützt das SDK nur nicht authentifizierte Benutzer und kann in nativen Apps verwendet werden, wenn Sie diese Nutzung für Ihre Endbenutzer geeignet und erforderlich halten.

Konfigurieren Ihres Agents für systemeigene Apps

  1. Wechseln Sie zu Ihrem Agenten in Copilot Studio, indem Sie Agents und dann Ihren Agenten auswählen.

  2. Wählen Sie unter Einstellungen>Sicherheit>Authentifizierung die Option Keine Authentifizierung aus.

    Screenshot der aktivierten Sicherheitseinstellung

  3. Wechseln Sie zur Seite "Kanäle" für Ihren Agenten.

    Wenn keine Authentifizierung ausgewählt ist, wird eine Überprüfung empfohlen.

    Screenshot der Seite „Kanäle“ für den Agenten mit der Überprüfung, die aufgrund der Auswahl „Keine Authentifizierung“ empfohlen wurde.

  4. Wählen Sie Veröffentlichen aus.

    Der Bildschirm " Diesen Agent veröffentlichen " wird angezeigt.

    Screenshot des Bildschirms

  5. Wählen Sie Veröffentlichen aus. Ihr Agent wird veröffentlicht und steht für die Verwendung mit dem Client SDK zur Verfügung.

Abrufen der Informationen, die Sie für die Integration in das SDK benötigen

Bevor Sie ihre Integration für Ihren Agent in Ihren App-Code hinzufügen, benötigen Sie einige Details von Copilot Studio zu Ihrem Agent.

  1. Gehen Sie zu Ihrem Agenten in Copilot Studio, indem Sie Agenten und dann Ihren Agenten auswählen.

  2. Wechseln Sie zu Einstellungen>Erweiterte Einstellungen>Metadaten.

    Notieren Sie sich die Umgebungs-ID und den Schemaname.

    Screenshot der Seite

  3. Beachten Sie die Bereitstellungsumgebung für Ihren Agent. Für copilotstudio.microsoft.com und copilotstudio.preview.microsoft.com, die Bereitstellungsumgebung ist prod. Für copilotstudio.preprod.microsoft.com, die Bereitstellungsumgebung ist preprod.

Weitere Informationen zum Agents-Client-SDK

Als Nächstes können Sie ihren Agenten mithilfe des Agenten-Client-SDK in Ihren nativen App-Code integrieren.

Weitere Informationen zum Integrieren Ihres Agenten in Ihre native App finden Sie im GitHub-Repository für die App-Plattform Ihrer Wahl:

  • Last updated on