Planowanie i projektowanie strategie integracji

Agenty stworzone w Copilot Studio zyskują nowe możliwości dzięki integracji z innymi usługami online. Usługi te mogą obejmować usługi Microsoft, takie jak SharePoint i Dataverse, usługi firm trzecich, takie jak ServiceNow, Salesforce i Databricks, oraz niestandardowe API. Power Platform oferuje bogaty ekosystem wbudowanych łączników dostępnych w Copilot Studio, dzięki czemu nie musisz ich budować samodzielnie. Masz też różne opcje tworzenia własnych integracji z wykorzystaniem niskokodowym lub kodowania profesjonalnego. Agenty mogą rozszerzać swoje możliwości dzięki Protokół kontekstu modelu (MCP), aby wchodzić w interakcję z zewnętrznymi narzędziami i danymi w sposób standardowy i skalowalny lub poprzez obsługę komputera w celu automatyzacji aplikacji webowych i stacjonarnych bezpośrednio z maszyny wirtualnej – umożliwiając szersze scenariusze integracji nawet wtedy, gdy interfejs API nie jest dostępny.

Dzięki integracjom agenty stają się wygodnym interfejsem umożliwiającym dostęp do funkcji wielu systemów. Użytkownicy mogą wykonywać wiele różnych operacji bez opuszczania agenta. Na przykład jeden agent zaprojektowany w Copilot Studio może służyć do:

  • Czytaj, twórz i aktualizuj elementy na liście SharePoint.
  • Wyślij wiadomość e-mail za pomocą Office 365 Outlook.
  • Otwórz nowe zgłoszenie serwisowe w ServiceNow.

Uwagi dotyczące wzorca integracji

Copilot Studio obsługuje integrację za pośrednictwem łączników platformy Power Platform, żądań HTTP, przepływów agentów, umiejętności platformy Bot Framework i nie tylko. Dobór odpowiedniego wzorca integracji zależy od wymagań projektu.

Łączniki platformy Power Platform

Łączniki umożliwiają agentom interakcję z bazową usługą. To jest zestaw akcji i wyzwalaczy dostępnych za pośrednictwem interfejsu niskokodowego. Działania to operacje wykonywane przez agenta, takie jak odczyt, zapis lub aktualizacja. Wyzwalacze informują agenta, gdy w innej usłudze wystąpi zdarzenie.

Użyj łączników gotowych i niestandardowych:

  • Wstępnie skompilowane łączniki: firma Microsoft oferuje rozbudowany ekosystem łączników SaaS, przygotowanych do użycia z funkcją Copilot Studio.
  • Łączniki niestandardowe: Gdy nie ma gotowego łącznika, możesz utworzyć własny dla danej usługi. To nakładka bezkodowa lub niskokodowa dla interfejsu API REST.

Łączniki Power Platform spełniają te wymagania:

  • Twórcy korzystający z Power Platform są zaznajomieni z łącznikami bez kodowania lub niskokodowymi.
  • Kod Power Fx jest obsługiwany, w tym zmienne, warunki, parametry i inne.
  • Analiza składniowa i obsługa błędów są wbudowane.
  • Gotowe łączniki wymagają jedynie konfiguracji, bez konieczności tworzenia oprogramowania.
  • Niestandardowe łączniki można stworzyć raz i wykorzystać w wielu agentach.
  • Możliwość monitorowania aktywności w ramach integracji Copilot Studio z Application Insights (funkcja Azure Monitor).
  • Niektóre łączniki, w tym niestandardowe, obsługują Virtual Network.

Korzystając z łączników Power Platform do integracji, rozważ następujące kwestie:

  • Zwracanie setek wyników powoduje znaczne opóźnienie w odpowiedzi agenta dla użytkownika.
  • Łączniki firm trzecich wyświetlają monit użytkownikom o wprowadzenie danych uwierzytelniających przed połączeniem się z usługą. Użytkownik może nie rozumieć, jak nawiązać połączenie bez wskazówek. Rozważ użycie poświadczeń twórcy, gdy użytkownik nie ma potrzebnych informacji do nawiązania połączenia.

Żądania HTTP

Agent może integrować się z inną usługą, wykonując żądanie HTTP. Programista musi za każdym razem określić następujące wartości podczas wykonywania zapytania HTTP:

  • URI
  • Metoda (GET, POST, PATCH itd.)
  • Nagłówki
  • Treść

Żądania HTTP spełniają następujące wymagania:

  • Możliwość łączenia się z usługami i wykonywania działań, które nie znajdują się na liście predefiniowanych łączników.
  • Mniej czasu na opracowanie niż przy niestandardowym złączu.

Korzystając z żądań HTTP, weź pod uwagę następujące czynniki:

  • Wielu twórców niskokodowych i bezkodowych nie rozumie, jak skonfigurować żądanie HTTP i może mieć trudności z jego obsługą.
  • Nie można udostępniać żądań HTTP w całej organizacji do ponownego użycia, tak jak łączników niestandardowych.

Przepływy agenta

Przepływy agentów wykonują serię działań w określonej kolejności. Wykorzystują niskokodowe akcje dostępne w łącznikach Power Platform. Agenty mogą przekazywać wartości jako dane wejściowe do przepływu agenta i otrzymywać jego dane wyjściowe.

Przepływy agentów są funkcjonalnie podobne do przepływów w chmurze w Power Automate, z kilkoma istotnymi różnicami:

  • Przepływy agentów pozwalają osiągnąć wysoką przepustowość i niskie opóźnienia.
  • Przepływy agentów oferują więcej możliwości niż przepływy Power Automate, takie jak działania „z udziałem człowieka”.
  • Przepływy agentów wykorzystują kredyty Copilot w zależności od ich użycia. Przepływy Power Automate są zwykle uruchamiane w ramach modelu licencjonowania na użytkownika lub modelu dla procesów.

Przepływy agentów spełniają następujące wymagania:

  • Bez kody lub niskokodowe.
  • Deterministyczne łańcuchowanie działań.
  • Aktywność może być monitorowana niezależnie.
  • Ukrywa wrażliwe wartości, takie jak klucze i sekrety, w akcjach przepływu. Pobiera dane uwierzytelniające z Azure Key Vault do uwierzytelniania.
  • Obsługuje duże wolumeny danych oraz pliki o dużych rozmiarach.
  • Wykorzystuje wątki współbieżności i równoległego wykonywania, aby umożliwić lepszą wydajność.
  • Istniejące przepływy w chmurze Power Automate można przekształcić w przepływy agenta.

Projektując agenta wykorzystującego przepływy agentów, należy wziąć pod uwagę następujące punkty:

  • Wydajność jest ograniczona przez limity API usług i działań wykorzystywanych przez agenta.
  • Programista musi zaprojektować wzorzec obsługi wyjątków, aby agent wiedział, jak postępować w przypadku wystąpienia błędów.
  • Odpowiedź do agenta według przepływu ma limit rozmiaru.
  • Logika długotrwała może być nadal wykonywana po akcji Odpowiedz agentowi.

Umiejętności Bot Framework

Umiejętności są wielokrotnego użytku modułami konstrukcyjnymi konwersacji, które budujesz za pomocą Bot Framework. Wdrażaj umiejętności, korzystając z kodu profesjonalnego. Zarejestruj umiejętności w Copilot Studio, aby móc z nich korzystać. Po zarejestrowaniu umiejętności w Copilot możesz ją wywołać jako element w temacie konwersacji.

Umiejętności Bot Framework spełniają następujące wymagania:

  • Wykonywanie synchroniczne.
  • Obsługa prywatnych punktów końcowych.
  • Istniejące umiejętności Bot Framework można ponownie wykorzystać w Copilot Studio.

Korzystając z umiejętności Bot Framework, weź pod uwagę następujące czynniki:

  • Wymaga kodowania przez programistów do ciągłego rozwoju i wsparcia (np. C#).
  • Działa w usłudze Azure AI Bot Service.
  • W Azure ponosisz dodatkowe koszty, które wymagają opłacenia w ramach subskrypcji Azure.
  • Zarządzanie cyklem życia aplikacji (ALM) poza Microsoft Power Platform.

Inne kwestie dotyczące wzorców integracji

Oprócz wytycznych dla każdego typu integracji, rozważ następujące punkty dotyczące ogólnej strategii integracji:

  • Wzorce integracji Copilot Studio nie wykluczają się i można je łączyć.
  • Integracje są tak szybkie, jak punkty końcowe, do których się łączą.
  • Zawsze optymalizuj zapytania, aby wyniki były zwracane jak najszybciej i zapewniać dobrą jakość rozmowy.
  • Jeśli przepływy agentów i Copilot Studio nie wykonują logiki wystarczająco szybko, rozważ następujące opcje:
    • Niestandardowe interfejsy API usługi Dataverse
    • Niskokodowe wtyczki Dataverse
    • Funkcje Azure
  • W określonych scenariuszach integracja danych musi być wykonywana w warstwie pośredniej, która modyfikuje wiadomości podczas ich przesyłania.

Dodawanie integracji do agenta

Dodaj integracje do agenta za pomocą następujących metod:

  • Narzędzia

    • Dodaj integrację jako narzędzie, aby rozszerzyć funkcjonalność agenta.
    • Użyj języka naturalnego, aby opisać, kiedy orkiestrator powinien wybrać narzędzie do wykonania zadania.
    • Określ, w jaki sposób agent powinien ustalać wartości wejściowe narzędzia oraz jak powinno wyglądać wyjście. Generatywna AI może dynamicznie uzupełniać dane wejściowe na podstawie opisu, lub możesz ręcznie określić wartości i formuły.
    • Wywołaj jako część planu stworzonego przez orkiestrację generatywną.

  • Tematy

    • Wywołaj integrację przez węzeł tematu. Wykonuje się na tym samym miejscu w sekwencji tematu za każdym razem.
    • Podaj dane wejściowe do węzła za pomocą Power Fx.

  • Agenci

    • Stwórz agenta podrzędnego, który ma własny zestaw instrukcji i definiuj dostęp do wiedzy i narzędzi dostępnych dla agenta nadrzędnego.
    • Alternatywnie, połącz się z istniejącym agentem w Copilot Studio, Microsoft 365 SDK, Microsoft Foundry, Fabric, Agent-To-Agent i innych tego typu systemach.

Normy i limity

Sprawdź aktualne limity usług dla Copilot Studio i Power Platform:

Musisz określić limity API dla tych usług oddzielnie:

  • Limity API OpenAI: limity ilości żądań nie są udokumentowane.
  • Umiejętności Bot Framework: Zapoznaj się z dokumentacją Azure dotyczącą wykorzystywanych usług.

Przegląd planowania integracji

Podczas planowania integracji z Copilot Studio należy określić następujące informacje dla każdej usługi:

  • System docelowy: Usługa, do której się łączysz.
  • Wywołane z pomocą: składnik bota funkcji Copilot Studio, który wywołuje usługę.
  • Wywołano z: wybrany typ integracji.
  • Oczekiwany dzienny wolumen: Średnia liczba żądań.
  • Oczekiwany szczyt: Najwyższa przewidywana liczba dziennych zgłoszeń.
  • Szczegóły: Inne informacje dotyczące integracji.

Oto przykład agenta z wieloma integracjami:

Połączony system Wywołane przez Wywołane za pomocą Oczekiwana dzienna liczba żądań Oczekiwane maksimum Wywołania interfejsu API na minutę Szczegóły
ServiceNow Temat bazy danych Service Desk Przepływ pracy 5000 1000 600 Zapytanie użytkownika służy jako dane wejściowe do wykonania zapytania w bazie wiedzy ServiceNow za pomocą standardowego łącznika. Kod JSON wyników jest zwracany do funkcji Copilot Studio w celu niestandardowych danych akcji generatywnych.
Strona internetowa Contoso Wiedza Odpowiedzi generatywne 1000 100 Brak https://contoso.com/en-us/FAQ przy czym /en-us/ jest dynamicznie ustalany na podstawie zmiennej lokalizacji użytkownika.
Wewnętrzny interfejs API katalogu Temat rozpoczęcia konwersacji Przepływ pracy 15 000 5000 Brak Wykorzystanie łączników niestandardowych uruchamianych w ramach Azure Virtual Network do połączenia z wewnętrznym interfejsem API.
Interfejs API pogody Temat Pogoda HTTP 500 100 Brak Żądanie GET do interfejsu API REST.
Teams Temat rezerwacji spotkań Narzędzia 1500 300 100 Utwórz spotkanie w Teams na podstawie informacji z konwersacji.
SAP Co 24 godzin Przepływ pracy 20 000 - 2500 Codzienna synchronizacja wsadowa katalogu produktów z SAP do Dataverse.

Następne kroki

Dowiedz się, jak polecenia AI, Protokół kontekstu modelu oraz agenty obsługi komputera mogą rozszerzać możliwości agenta.

Użyj narzędzi dla agentów, aby rozbudować, zautomatyzować i udoskonalić swoich agentów

  • Last updated on