Použití akcí s vlastními agenty (Preview)
Možnosti agent můžete rozšířit přidáním jedné nebo více akcí. Akce jsou používány vaším agent k automatické odpovědi na uživatele pomocí generativní orchestrace, nebo je můžete volat explicitně z téma.
Základní typy akcí
Pokud zapnete generativní orchestraci, váš agent může automaticky vybrat nejvhodnější akci nebo téma, nebo vyhledávat napříč znalostmi, aby odpověděl uživateli.
V klasickém režimu (generativní orchestrace zakázána) může agent používat pouze témata k odpovědi uživateli. Stále však můžete svůj agent navrhnout tak, aby vyvolal akce explicitně z témat.
Akce jsou založeny na jednom z následujících základních typů akcí:
- Předem vytvořená akce konektoru
- Vlastní akce konektoru
- Cloudový tok Power Automate
- Zadání AI Builder
- Dovednost Bot Framework
Každá základní akce má další informace, které popisují její účel, což umožňuje agent používat generativní AI ke generování otázek. Tyto otázky jsou nutné k vyplnění vstupů potřebných k provedení akce. Proto nemusíte ručně vytvářet uzly otázek ke shromažďování všech potřebných vstupů, jako jsou vstupy na toku. Vstupy jsou zpracovávány za vás za běhu.
Ve výchozím nastavení při použití generativního režimu akce vrací své informace zpět do agent, takže agent může vygenerovat kontextový odpověď na dotaz uživatele. Alternativně můžete své akci nařídit, aby vždy reagovala okamžitě, buď vygenerováním zprávy, nebo vytvořením explicitní zprávy.
Tip
Při použití vygenerovaných otázek z akce informujte své uživatele, že část konverzace generuje umělá inteligence.
Přidejte například další zprávu do Zahájení konverzacesystémového tématu. Toto téma určuje zprávu, která se zobrazí vašim uživatelům, když začne nová konverzace.
Přidat akci
Otevřete svůj agent výběrem Agenti v levém navigačním panelu a výběrem agent ze seznamu.
Vyberte Akce pro zobrazení akcí pro agent.
Vyberte Přidat akci.
V průvodci Vyberte akci vyhledejte akci, kterou chcete použít, a vyberte ji.
Zobrazený výchozí seznam obsahuje toky Power Automate a vlastní konektory dostupné ve vašem prostředí. Tento seznam obsahuje běžně používané předpřipravené konektory a Bot Framework dovednosti, které jsou registrovány u vašeho agent.
Důležité
Některé akce vytvořené z pluginů AI, jako jsou dynamická zadání a ty založené na API Dataverse, vyžadují ověření.
V závislosti na akci se vaše připojení automaticky nakonfiguruje, jak je znázorněno v příkladu. V opačném případě nakonfigurujte připojení podle pokynů průvodce. Po úspěšné konfiguraci připojení vyberte Další.
Zkontrolujte zásuvná akce konfiguraci a v případě potřeby proveďte změny .
Vyberte Další.
Vyberte Dokončit a přidejte akci do agent.
Otestujte svoji akci
Pokud jste povolili generativní orchestraci, vaše akce se automaticky zavolá v odpověď na relevantní uživatelský dotaz.
Případně můžete zavolat akci explicitně z téma.
Váš agent vybere a spustí vaši akci na základě názvu a popisu. Můžete vytvářet vysoce kvalitní popisy pomocí Mapa aktivit, abyste viděli, které akce agent vybrali na stránce akce .
Na tomto snímku obrazovky můžete vidět testovanou akci počasí:
Provedení změn v konfiguraci akce
Akci můžete konfigurovat mnoha způsoby. V posledním kroku průvodce akcí, nazvaném Zkontrolovat a dokončit, můžete provést změny v konfiguraci akce kliknutím na Upravit vedle příslušné sekce. Buď z obrazovky Zkontrolovat vstupy a výstupy v průvodci, nebo ze stránky s podrobnostmi pro akci, která je již součástí vašeho agent, můžete spravovat vstup a výstup parametry pro akci.
Podrobnosti akce
Zde můžete nakonfigurovat údaje o své akci, včetně Zobrazovaného názvu modelu a Popisu modelu pro vaši akci. Obvykle jsou názvy a popisy za vás předem vyplněny na základě akce, kterou jste vybrali.
Vlastnosti zobrazované jméno a Popis pro každý vstup pomáhají agent pochopit účel vstupu, generovat vhodná otázka pro uživatele a rozpoznání správné hodnoty v odpověď uživatele. Například následující je výchozí název a popis vstupního parametru umístění pro konektor MSN Weather.
- Název: Místo
- Popis: Vyhledávací dotaz místa. Platné vstupy jsou Město, Region, Stát, Země, Orientační bod, PSČ, zeměpisná šířka a zeměpisná délka
Když agent vyzve uživatele k zadání polohy, vygeneruje otázku jako Jaké je místo, kde byste chtěli zjistit počasí? Můžete zadat město, oblast/zemi, orientační bod nebo PSČ.
Možnost Identifikovat jako můžete změnit na konkrétní typ entity v závislosti na shromažďovaném vstupu, což může agent pomoci přesně extrahovat hodnotu z odpověď uživatele.
Vstupy
Ve výchozím nastavení je každý vstup nastaven na Dynamicky vyplnit nejlepší možnost. Agent se pokouší extrahovat hodnotu z dostupného kontextu – například ze zprávy uživatele. Pokud není nalezena žádná vhodná hodnota, vygeneruje otázku, kterou se uživatele zeptá na hodnotu. Vstup můžete přepsat hodnotou namísto dotázání uživatele. Chcete-li nastavit přepsání, pro Jak agent vyplní tento vstup?, vyberte Nastavit jako hodnotu, a zadejte požadovanou hodnotu. Tato hodnota může být konkrétní hodnota, existující proměnná nebo vzorec Power Fx.
Chcete-li ovládat chování agent při dotazování na hodnotu nebo ověřování odpovědi uživatele, můžete nakonfigurovat další nastavení pro vstupy.
Výstupy
Ve výchozím nastavení je vaše akce nakonfigurována tak, aby automaticky generovala kontextovou odpověď pro uživatele na základě jeho dotazu a výsledku akce. Pokud se například uživatel zeptá: „Jaká je aktuální teplota v Londýně?“, vygeneruje se kontextová odpověď pomocí GPT, například „Aktuální teplota v Londýně je 9 stupňů Celsia“.
Případně se můžete rozhodnout napsat konkrétní odpověď, aby se vaše akce vrátila. Stejně jako v editoru potvrzení můžete vložit odkazy na výstupní proměnné z akce pomocí voliče proměnných, jak je ukázáno v tomto příkladu.
Vyvolejte akci z téma
Akci můžete volat explicitně z tématu, podobně jako volání jiných typů akcí, jako jsou toky Power Automate. V závislosti na případu použití můžete tok použít jako součást širšího tématu, které používá více uzlů. Nebo, jako v příkladu počasí, přidání jediného akčního uzlu do téma může být vše, co potřebujete.
Volání akce zevnitř tématu:
V Copilot Studio přejděte na stránku Témata pro agent, který chcete upravit.
Vytvořte nové téma a pojmenujte jej Získání počasí.
Přidejte následující spouštěcí fráze:
- bude pršet
- dnešní předpověď
- získat počasí
- jaké je počasí
Vyberte Nový uzel (+) a potom Zavolat akci. Přejděte na kartu Akce pluginu (Preview) a poté vyberte akci, kterou jste vytvořili dříve, Získat předpověď počasí.
Váš uzel akce modulu plug-in (Preview) je nyní přidán do vašeho tématu.
Zvolte Uložit.
Přepište vstupy při volání akce z tématu
Ve výchozím nastavení, když vaše akce běží, váš agent generuje otázky pro uživatele, aby naplnil požadované vstupy. Možná však budete chtít přepsat jeden nebo více vstupů a zadat explicitní hodnotu namísto otázky pro uživatele. Přepsání můžete provést v konfiguraci akce modulu plug-in v sekci Vstupy. Nebo můžete hodnoty přepsat pouze tehdy, když je vaše akce použita z konkrétního tématu:
V uzlu vyberte Nastavit hodnotu a vyberte vstup, který chcete přepsat.
Zadejte hodnotu pro vstup zadáním hodnoty, výběrem proměnné nebo použitím vzorce.
Nyní, když je tento vstup přepsán, agent se uživatele neptá na hodnotu.
Zapnutí ověření pro akce AI
Některé akce, když jsou vytvořeny na základě akcí umělé inteligence, vyžadují ke správnému fungování ověření, jako je dynamické zadání nebo jiné, které volají rozhraní API Dataverse.
Akce se vždy spouštějí v běhovém prostředí agent v kontextu koncového uživatele a nelze je spustit, pokud není povoleno ověřování. Jsou podporovány dva typy metod ověření:
Přejděte na vlastnosti akce konektoru.
V části Ověření koncového uživatele vyberte agent ověření autora.
Publikujte a otestujte zkušenosti v agent testovacím panelu nebo v požadovaném kanálu.
Používání akcí toku s přihlašovacími údaji koncového uživatele
Akce toku lze nakonfigurovat tak, aby používaly přihlašovací údaje koncového uživatele. Použití toku v podporovaném kanálu nevyžaduje žádnou speciální konfiguraci v agent dialogovém okně a uživatelé mohou spravovat svá připojení pro daný tok v poskytnutém prostředí.
Ověřování akcí na základě pluginů ve vaší knihovně
Při vytváření na základě modulů plugin AI vyžadují akce ke správnému fungování ověření. Nejčastěji je to vidět u akcí založených na zadáních nebo jiných, které volají API Dataverse. Akce založené na zásuvných modulech se vždy spouštějí v kontextu uživatele a nelze je spustit, pokud není povoleno ověřování. Jsou podporovány dva typy metod ověření:
Integrované ověřování (Teams a Power Apps): Tuto metodu ověřování můžete použít, pokud chcete svůj agent publikovat do kanálu Teams. Tato metoda funguje také pro agenty vložené do libovolného Power Platform aplikace, která používá tokeny vytvořené podle standardu PPAPI.
Manuální ověřování (agenti třetích stran) : Tato metoda ověřování zahrnuje nastavení a Microsoft Entra ID připojení.
Vytvoření připojení ručního ověřování:
Nastavte aplikaci Microsoft Entra ID.
Nastavit manuální autentizace pro váš agent.
Povolte svým aplikacím používat delegování k načtení tokenu jménem uživatele. Nezapomeňte přidat všechny potřebné rozsahy.
