Dostosuj Microsoft Copilot za pomocą agenta

Microsoft Copilot w programie Power Apps umożliwia użytkownikom interakcję z dostosowanymi agentami, które rozszerzają to, co Copilot potrafi zrobić. 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 Copilot.

W tym artykule opisano typy agentów, które można utworzyć dla Microsoft Copilot w Power Apps, i pomaga on wybrać odpowiednie podejście 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	Utworzony za pomocą narzędzi i szablonów low-code na potrzeby szybkiej konfiguracji typowych scenariuszy w Microsoft 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 wyboru typu agenta do utworzenia w Omówienie agentów Microsoft Copilot.
Utwórz agenta deklaratywnego dla funkcji Microsoft Copilot lub agenta z niestandardowym aparatem dla platformy Microsoft 365.
Użyj Microsoft Copilot Studio, aby nawiązać połączenie i skonfigurować agenta dla usługi Teams i Microsoft 365, aby był dostępny w Microsoft Copilot.
Zapoznaj się ze wskazówkami dotyczącymi wybierania między Microsoft Copilot i Copilot Studio, aby utworzyć agenta.

Jednym ze sposobów utworzenia agenta deklaratywnego dla aplikacji opartej na modelu jest włączenie Microsoft Copilot bezpośrednio w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie aplikacji dla Microsoft 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 Copilot otwierane dla użytkowników, a interfejsy API tworzą dwukierunkowe połączenie między Twoją aplikacją a Microsoft Copilot.

Ustawianie agenta domyślnego

Jeśli tworzysz agenta niestandardowego jako agenta towarzyszącego aplikacji opartej na modelu, możesz ustawić go jako agenta domyślnego, aby był ładowany automatycznie po otwarciu aplikacji i okienka bocznego Microsoft 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 i wskazówki specyficzne dla aplikacji są gotowe, gdy tylko zostanie otwarty program Microsoft Copilot.

Domyślny agent jest szczególnie przydatny w przypadku agentów skoncentrowanych na scenariuszach, które rozszerzają podstawowe środowisko aplikacji i działają jako drzwi wejściowe do specyficznego dla aplikacji środowiska Microsoft Copilot, które ma być dostępne dla użytkowników.

Interfejsy API Xrm.Copilot

Interfejsy API klienta Xrm.Copilot.* umożliwiają deweloperom integrację Microsoft Copilot bezpośrednio w środowiskach aplikacji opartych na modelu. Dzięki tym interfejsom API aplikacja może bezpośrednio wchodzić w interakcję z okienkiem bocznym Microsoft Copilot i reagować na akcje inicjowane przez Microsoft Copilot, dzięki czemu można tworzyć bogatsze, kompleksowe scenariusze agentów.

Gdy używasz tych interfejsów API z agentem domyślnym, dopełniają wzorzec trybu agenta: agent jest punktem początkowym, aplikacja może wysyłać polecenia i kontekst do Microsoft Copilot, a Microsoft Copilot może wywoływać akcje z powrotem wewnątrz 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ą:

Wyślij monity do Microsoft Copilot. Użyj sendPromptToM365Copilot, aby rozpocząć interakcję z Microsoft Copilot z poziomu aplikacji.
Otwórz i kontroluj okienko boczne Microsoft Copilot. Użyj polecenia openM365CopilotPanel, aby upewnić się, że okienko Microsoft Copilot jest widoczne w razie potrzeby.
Przekaż kontekst aplikacji do Microsoft 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ługa akcji Microsoft Copilot w aplikacji. Użyj funkcji addActionHandler, aby rejestrować niestandardowe procedury obsługi, które przetwarzają akcje wysyłane w odpowiedziach funkcji Microsoft 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ługuj akcje Microsoft Copilot za pomocą addActionHandler

Użyj interfejsu API addActionHandler, gdy aplikacja musi obsługiwać ustrukturyzowane akcje, które emituje Microsoft 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 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 Microsoft Copilot mogą zawierać kod HTML, który wysyła komunikaty akcji 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?

Ostatnia aktualizacja o 2026-10-20