Integracja z aplikacjami natywnymi za pomocą SDK klienta Agentów

Note

W tym artykule opisano funkcje używane w agentach lub przepływach agentów obsługiwanych przez standardowe środowisko uruchomieniowe.

Ważna

Ta zawartość jest przeznaczona dla doświadczonych specjalistów IT, takich jak administratorzy IT lub deweloperzy, którzy znają narzędzia deweloperskie, narzędzia i zintegrowane środowiska programistyczne (IDE). Tworzenie tej integracji wymaga specjalistycznej wiedzy na temat tworzenia oprogramowania.

Zestaw SDK klienta agentów to zestaw SDK dla platform Android, iOS i Windows. Ten zestaw SDK umożliwia komunikowanie się z agentami opracowanymi przy użyciu programu Copilot Studio lub zestawu SDK agentów platformy Microsoft 365 z natywnych aplikacji dla systemów Android, iOS i Windows.

W przypadku zestawu SDK klienta agentów wprowadzamy wielomodalność interakcji między agentami użytkownika. Użytkownicy mogą teraz komunikować się z agentami za pośrednictwem tekstu lub głosu podczas udostępniania kontekstu za pośrednictwem obrazów lub przechwytywania ekranu.

Pierwsza wersja zestawu SDK obsługuje komunikację tekstową i renderowanie kart adaptacyjnych dla nieuwierzytelnionych lub anonimowych użytkowników końcowych z agentami utworzonymi w programie Copilot Studio. Karty adaptacyjne można dodawać do tematów przy użyciu opcji Zapytaj z kartą adaptacyjną .

Ważna

Obecnie zestaw SDK obsługuje tylko nieuwierzytelnionych użytkowników i może być używany w aplikacjach natywnych, jeśli uznasz takie użycie za odpowiednie i niezbędne dla użytkowników końcowych.

Konfigurowanie agenta dla aplikacji natywnych

  1. Przejdź do agenta w programie Copilot Studio, wybierając pozycję Agenci, a następnie wybierz swojego agenta.

  2. W obszarze Ustawienia>zabezpieczenia>uwierzytelnianie, wybierz pozycję Brak uwierzytelniania.

    Zrzut ekranu przedstawiający ustawienie zabezpieczeń Brak uwierzytelniania włączone dla agenta w programie Copilot Studio.

  3. Przejdź do strony Kanały dla agenta.

    Jeśli wybrano Brak uwierzytelniania, zaleca się przejrzenie.

    Zrzut ekranu strony Kanały, pokazujący zalecenie przeglądu z powodu braku wyboru opcji uwierzytelniania.

  4. Wybierz opcję Publikuj.

    Zostanie wyświetlony ekran Opublikuj tego agenta .

    Zrzut ekranu przedstawiający ekran potwierdzenia publikowania agenta w programie Copilot Studio.

  5. Wybierz opcję Publikuj. Agent jest opublikowany i dostępny do użycia z SDK klienta.

Uzyskaj informacje potrzebne do zintegrowania z zestawem SDK

Przed dodaniem integracji agenta do kodu aplikacji potrzebne są szczegółowe informacje z aplikacji Copilot Studio dotyczące agenta.

  1. Przejdź do agenta w programie Copilot Studio, wybierając pozycję Agenci, a następnie wybierając agenta.

  2. Przejdź do Ustawienia>Zaawansowane ustawienia>Metadane.

    Zanotuj identyfikator środowiska i nazwę schematu.

    Zrzut ekranu przedstawiający stronę Ustawienia zaawansowane z identyfikatorem środowiska i nazwą schematu agenta.

  3. Zwróć uwagę na środowisko wdrażania swojego agenta. W przypadku copilotstudio.microsoft.com i copilotstudio.preview.microsoft.com środowisko wdrożeniowe to prod. W przypadku copilotstudio.preprod.microsoft.com środowisko wdrażania to preprod.

Dowiedz się więcej o SDK klienta agentów

Następnie, korzystając z zebranych informacji, możesz zintegrować agenta z kodem aplikacji natywnej przy użyciu zestawu SDK klienta agentów.

Aby uzyskać kod i więcej informacji na temat sposobu integrowania agenta z aplikacją natywną, zapoznaj się z repozytorium GitHub dla wybranej platformy aplikacji: