Dostosowywanie Microsoft 365 Copilot za pomocą agenta

Microsoft 365 Copilot w programie Power Apps umożliwia użytkownikom interakcję z agentami niestandardowymi, które rozszerzają możliwości Copilot. Dostosowując agenta, możesz tworzyć dostosowane środowiska, które pasują do procesów biznesowych i danych organizacji. Aby uzyskać więcej informacji, zobacz Używanie agentów w Microsoft 365 Copilot.

W tym artykule opisano typy agentów, które można utworzyć dla Microsoft 365 Copilot w Power Apps i ułatwiają wybór odpowiedniego podejścia do danego scenariusza.

Wybieranie typu agenta

W poniższej tabeli porównaliśmy typy agentów, które można skompilować.

Typ agenta	Description	Typowe przypadki użycia
Agent deklaratywny	Skompilowany za pomocą narzędzi i szablonów z małą ilością kodu na potrzeby szybkiej konfiguracji typowych scenariuszy w Microsoft 365 Copilot.	Automatyzuj rutynowe zadania, odpowiadaj na często zadawane pytania i udostępniaj przepływy pracy z przewodnikiem.
Agent z niestandardowym aparatem	Skompilowany za pomocą niestandardowej logiki i integracji zaawansowanych funkcji dostosowanych do twojej firmy.	Złożone procesy biznesowe, niestandardowe integracje danych i wyspecjalizowana automatyzacja.
Agent usługi Copilot Studio	Tworzone i zarządzane w programie Microsoft Copilot Studio, z integracją z aplikacją Teams i platformą Microsoft 365 na potrzeby interakcji konwersacyjnych.	Interaktywne czatboty, współpraca zespołowa i spersonalizowana obsługa w aplikacjach Microsoft 365.

Aby znaleźć najlepszą opcję dla organizacji, użyj następujących zasobów:

Zapoznaj się z omówieniem i wskazówkami dotyczącymi tego, jak wybrać typ agenta do utworzenia w artykule Omówienie agentów usługi Microsoft 365 Copilot.
Utwórz agenta deklaratywnego dla funkcji Microsoft 365 Copilot lub agenta z niestandardowym aparatem dla platformy Microsoft 365.
Użyj Microsoft Copilot Studio, aby połączyć i skonfigurować agenta dla aplikacji Teams i platformy Microsoft 365, aby był dostępny w Microsoft 365 Copilot.
Zapoznaj się ze wskazówkami, jak wybrać między Microsoft 365 Copilot a Copilot Studio, aby utworzyć agenta.

Jednym ze sposobów utworzenia agenta deklaratywnego dla aplikacji opartej na modelu jest włączenie Microsoft 365 Copilot bezpośrednio w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie aplikacji dla Microsoft 365 Copilot.

Możesz utworzyć własny tryb agenta specyficzny dla danej aplikacji w Power Apps, łącząc domyślnego agenta z interfejsami API Xrm.Copilot.*. Domyślny agent definiuje dostosowane środowisko Microsoft 365 Copilot otwierane dla użytkowników, a interfejsy API tworzą dwukierunkowe połączenie między aplikacją a Microsoft 365 Copilot.

Ustawianie agenta domyślnego

Jeśli tworzysz agenta niestandardowego jako towarzysza aplikacji opartej na modelu, możesz ustawić go jako agenta domyślnego, aby był ładowany automatycznie po otwarciu aplikacji i okienka bocznego Microsoft 365 Copilot. Dzięki temu agent staje się punktem początkowym całego środowiska i jest pierwszym krokiem w tworzeniu własnego trybu agenta.

Po ustawieniu agenta domyślnego:

Agent jest wybierany bez żadnej akcji od użytkownika.
Użytkownicy trafiają od razu do dostosowanego środowiska zaprojektowanego dla tej aplikacji.
Przepływy pracy specyficzne dla aplikacji i wskazówki są gotowe natychmiast po uruchomieniu Microsoft 365 Copilot.

Domyślny agent jest szczególnie przydatny w przypadku agentów ukierunkowanych na konkretne scenariusze, które rozszerzają podstawowy sposób korzystania z aplikacji i stanowią punkt wejścia do specyficznego dla aplikacji środowiska Microsoft 365 Copilot, jakie chcesz zapewnić użytkownikom.

Interfejsy API Xrm.Copilot

Interfejsy API klienta Xrm.Copilot.* umożliwiają deweloperom bezpośrednie integrowanie rozwiązania Microsoft 365 Copilot w środowiskach aplikacji opartych na modelu. Dzięki tym interfejsom API aplikacja może bezpośrednio wchodzić w interakcje z panelem bocznym Microsoft 365 Copilot i reagować na działania inicjowane przez Microsoft 365 Copilot, co pozwala tworzyć bogatsze, kompleksowe scenariusze agentowe.

Używane wraz z agentem domyślnym te interfejsy API dopełniają wzorzec trybu agenta: Twój agent jest punktem wyjścia, Twoja aplikacja może wysyłać monity i kontekst do Microsoft 365 Copilot, a Microsoft 365 Copilot może wywoływać akcje z powrotem w Twojej aplikacji.

Aby uzyskać pełny zakres interfejsu API, zobacz Xrm.Copilot (dokumentacja referencyjna interfejsu API klienta) w aplikacjach opartych na modelach.

Te interfejsy API umożliwiają:

Wysyłaj prompty w programie Microsoft 365 Copilot. Użyj sendPromptToM365Copilot, aby rozpocząć interakcję z Microsoft 365 Copilot z poziomu aplikacji.
Otwórz i kontroluj okienko boczne Microsoft 365 Copilot. Użyj polecenia openM365CopilotPanel, aby upewnić się, że okienko Microsoft 365 Copilot jest widoczne w razie potrzeby.
Przekaż kontekst aplikacji do Microsoft 365 Copilot. Użyj funkcji updateContext (wersja zapoznawcza), aby wysyłać dodatkowe sygnały ugruntowania z aplikacji.
Praca z agentami. Użyj getCurrentAgent, aby sprawdzić, który agent jest aktywny.
Obsługuj akcje Microsoft 365 Copilot w aplikacji. Użyj funkcji addActionHandler, aby rejestrować niestandardowe programy obsługi, które przetwarzają akcje wysyłane w odpowiedziach funkcji Microsoft 365 Copilot.

Razem te interfejsy API tworzą prawdziwe dwukierunkowe środowisko między interfejsem użytkownika aplikacji a agentem, dzięki czemu agenci mogą obsługiwać aktualizacje interfejsu użytkownika, wyzwalać przepływy pracy lub uruchamiać niestandardową logikę biznesową.

Obsługa akcji Microsoft 365 Copilot za pomocą programu addActionHandler

Użyj interfejsu API addActionHandler, gdy aplikacja musi obsługiwać ustrukturyzowane akcje, które emituje Microsoft 365 Copilot.

Podczas kompilowania ładunku akcji:

Ustaw type na PowerApps, aby wskazać hosta Power Apps.
Ustaw opcję action (na przykład MyNamespace.MyMessage) na identyfikator actionId, który rejestrujesz w obiekcie addActionHandler.
Użyj actionData do danych, które kod przetwarza i przekazuje do hosta usługi Power Apps.

W poniższych sekcjach przedstawiono dwa obsługiwane scenariusze.

Karty adaptacyjne

Odpowiedzi funkcji Microsoft 365 Copilot mogą zawierać karty adaptacyjne z przyciskami Action.Submit, które wysyłają komunikaty o akcjach do hosta usługi Power Apps.

Example:

{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Click Go and I will send data to the host to process.",
      "wrap": true,
      "id": "txtSendMessage"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Go",
          "id": "btnGo",
          "data": {
            "type": "PowerApps",
            "action": "MyNamespace.MyMessage",
            "actionData": {
              "foo": "bar"
            }
          }
        }
      ]
    }
  ]
}

Aplikacje MCP

Odpowiedzi funkcji Microsoft 365 Copilot mogą zawierać kod HTML, który wysyła komunikaty o akcjach do hosta Power Apps.

Example:

<Button
  appearance="outline"
  icon={<ArrowLeft24Regular />}
  onClick={() => {
    try {
      const message = {
        eventName: 'powerapps.copilot.chat.action',
        action: 'MyNamespace.MyMessage',
        actionData: {
          foo: 'bar'
        },
      };
      window.parent.parent.postMessage(message, '*');
    } catch (error) {
      // eslint-disable-next-line no-console
      console.error('Error posting HOST_ACTION message to parent window:', error);
    }
  }}
>
  Test
</Button>

Limitations

Tworzone przez Ciebie agenty nie mogą jeszcze korzystać z kontekstu użytkownika w aplikacji, aby dostosowywać swoje odpowiedzi.
Podczas ustawiania domyślnego agenta początkowe prompty agenta nie są wyświetlane.

Opinia

Czy ta strona była pomocna?

Last updated on 2026-07-16