Přidání nástrojů do vlastních agentů

Note

Funkce v tomto článku jsou poháněny standardním kabelem, který využívá fakturační možnosti popsané v sekci Licencování pro agenty poháněné standardním kabelem. Naučte se, jak přistupovat ke standardním funkcím v Access, standardní agenti a agentové toky.

Nástroje jsou stavební kameny, které umožňují vašemu agentovi interagovat s externími systémy. Nástroje rozšiřují možnosti, které váš agent může dělat, takže může provádět různé akce v reakci na požadavky uživatelů nebo autonomní spouštěče. Každý nástroj představuje konkrétní schopnost, kterou může váš agent provádět. Například můžete svého agenta vybavit nástroji, které vykonávají úkoly jako:

• Odesílání e-mailů pomocí konektoru Office 365 Outlook
• Kontrola aktuálních povětrnostních podmínek a předpovědí
• Čtení a zápis dat z Dataverse
• Čtení a zveřejňování zpráv na Teams

Mechanismy pro přidávání nástrojů agentům

Možnosti vlastního agenta můžete rozšířit přidáním jednoho nebo více nástrojů. Váš agent může automaticky reagovat na uživatele pomocí nástrojů a generativní orchestrace. Nástroje můžete také volat přímo z tématu.

Při generování orchestrace (ve výchozím nastavení aktivní) může váš agent automaticky vybrat nejvhodnější nástroj nebo téma nebo vyhledávat ve znalostech a reagovat na uživatele. Tento režim orchestrace vytvoří dynamičtější a inteligentnější konverzační prostředí.

V klasickém režimu (generativní orchestrace je vypnutá) může agent používat témata pouze k odpovědi uživateli. Ale stále můžete navrhnout agenta tak, aby explicitně volal nástroje z konkrétních témat.

K dispozici je několik mechanismů pro přidání nástrojů do agenta:

• Konektor: Připojte se k proprietárním rozhraním API a službám pomocí konektorů Power Platform ke stažení dat nebo provádění akcí.
  • Předem připravený konektor: Vyberte si z výběru přednastavených připojení k tisícům oblíbených rozhraní API ze služeb Microsoftu i jiných společností než Microsoft.
  • Vlastní konektor: Definujte připojení k vlastní službě nebo systému a zapněte vlastní možnosti nástrojů pomocí konektorů Power Platform. Konektor potřebuje zobrazit a sdílet oprávnění pro organizaci, aby agent používal konektor.
• Tok agenta: Definujte tok agenta, včetně jedné nebo více akcí, které se mají provést.
• Zadání: Jednoobratové modelové zadání, které se může odkazovat na znalosti, které poskytujete, a generovat kód pro analýzu dat.
• REST API: Definujte připojení k rozhraní REST API a vyberte jeden nebo více koncových bodů a metod rozhraní API, které chcete přidat jako nástroje.
• Model Context Protocol: Připojte se k serveru MCP pro přístup k nástrojům a prostředkům.
• Použití počítače: Umožňuje agentovi pracovat s libovolným systémem, který má grafické uživatelské rozhraní, pro weby a desktopové aplikace, výběr tlačítek, výběr nabídek a zadávání textu do polí na obrazovce.

Dva další mechanismy, které můžete použít k přidání nástroje podobného chování vašemu agentovi, jsou:

• Azure Bot Service dovednosti: Kontejner pro sadu souvisejících nástrojů dostupných prostřednictvím Azure Bot Service.
• Nástroje klienta: Odešlete klientovi událost, aby klient provedl akci a vrátil odpověď.

Note

Dovednosti v kontextu klasického prostředí agenta nejsou stejné jako dovednosti používané při kódování agentů. Dovednosti agenta pro kódování můžete přidávat pouze agentům v novém prostředí agenta.

Vytvoření a přidání nového nástroje na úrovni agenta

Vytváření nových nástrojů přímo v nástroji Copilot Studio zjednodušuje proces vývoje a zajišťuje správnou integraci s vaším agentem. Nástroje přidané do vašeho agenta jsou k dispozici pro automatickou orchestraci během veškerých konverzací vašeho agenta.

1. Otevřete agenta tak, že v levém navigačním podokně zvolíte Agenti a v seznamu vyberete svého agenta.

2. Přejděte na stránku Nástroje pro agenta.

3. Vyberte Přidat nástroj.

4. V podokně Přidat nástroj vyberte Nový nástroj.

5. Ze seznamu, který se zobrazí, vyberte typ nástroje, který chcete přidat:

   • Výzva
   • Tok agenta
   • Použití počítače
   • Vlastní konektor
   • Protokol kontextu modelu
   • REST API

   

6. Proveďte kroky konfigurace specifické pro typ nástroje, který jste vybrali. Pokud například vyberete Výzva, musíte provést následující kroky:

   • Definování šablony výzvy a pokynů
   • Zadejte vstupní parametry
   • Konfigurace zdrojů znalostí
   • Nastavení formátu odpovědi a omezení

7. Výběrem možnosti Uložit nebo Publikovat podle potřeby vytvořte nový nástroj.

8. Vyberte Přidat a nakonfigurovat. Nástroj se přidá do vašeho agenta. Zobrazí se stránka konfigurace vašeho nástroje. Tady můžete zobrazit a změnit konfiguraci nástroje.

Nový nástroj se zobrazí na stránce Nástroje pro agenta.

Zobrazení a změna konfigurace nástroje

Konfiguraci nástroje můžete kdykoli zobrazit a upravit: přejděte na stránku Nástroje pro vašeho agenta a v seznamu nástrojů vyberte nástroj.

Otevře se stránka konfigurace vašeho nástroje. Podrobnosti se zobrazují ve třech částech:

• Podrobnosti
• Vstupy
• Completion

U serverů MCP připojených jako nástroje agenta se stránka konfigurace liší od jiných typů nástrojů. Část Údaje je podobná, ale místo částí Vstupy a Dokončení jsou k dispozici části Nástroje a Zdroje s informacemi o dostupných nástrojích a prostředcích pro server MCP. Další informace najdete v tématu Zobrazení nástrojů a prostředků na existujícím serveru MCP.

Podrobnosti

V části Podrobnosti můžete nakonfigurovat základní podrobnosti o nástroji.

Tady můžete zobrazit a aktualizovat:

• Název: Název nástroje. Tento název se zobrazí v seznamu nástrojů pro vašeho agenta. Zvolte název, který jasně označuje funkci nástroje.

• Popis: Popis nástroje. Generativní orchestrace se spoléhá na tento popis, aby určilo, kdy by váš agent měl nástroj používat. Zadejte jasné a konkrétní popisy, včetně toho, co nástroj dělá a kdy se má použít.

• Další údaje:

  • Povolit agenta dynamicky rozhodnout, kdy nástroj použít: Pokud je tato možnost vybrána, může agent použít generování orchestrace k určení, kdy se má nástroj použít. Pokud tato možnost není vybrána, agent použije nástroj pouze v případě, že je výslovně volán z tématu. (Ve výchozím nastavení je tato možnost vybrána, pokud je zapnuta generativní orchestrace.)
  • Zeptejte se koncového uživatele před spuštěním: V prostředí chatu koncového uživatele požádejte agenta o potvrzení před spuštěním nástroje. Tato možnost je ve výchozím nastavení nastavená na Ne .
  • Ověřování: Vyberte, zda chcete pro nástroj použít přihlašovací údaje uživatele (koncový uživatel) nebo tvůrce (poskytnuté tvůrcem). Ve výchozím nastavení se používá ověřování uživatelů.
  • Popis: Volitelně můžete přidat popis nástroje, který agent zobrazí uživateli, když chce nástroj spustit. Tento popis umožňuje uživateli zjistit, co je po něm žádáno k autentizaci.

Vstupy

Tady můžete zobrazit a nakonfigurovat vstupy pro svůj nástroj. Vstupy slouží ke shromažďování informací od uživatele k vyplnění požadovaných vstupů pro nástroj. Informace se zobrazí jako tabulka, jeden řádek pro každý vstup.

Ve výchozím nastavení je hodnota fill using column pro každý vstup nastavena na Dynamické doplňování pomocí AI. Agent se pokusí 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. Pokud chcete získat přístup k jemněji odstupňovaným přizpůsobením pro vstupní kolekci a vyplňování, vyberte Přizpůsobit :

• Název a popis: Jak se vstup zobrazí uživateli.
• Identifikovat jako: Jak se interpretuje odpověď uživatele, například jako řetězec textu nebo namapovaný na předdefinovanou entitu.
• Logika opakování: Pokud agent v příkazu uživatele neidentifikuje entitu, může se na tuto otázku znovu zeptat.
• Ověření vstupu: Nakonfigurujte další chování ověřování u vstupu uživatele nad rámec výchozí hodnoty pro typ entity.

Můžete se také rozhodnout nahradit vstup výslovně určenou hodnotou, místo aby jej agent extrahoval. Chcete-li nastavit přepsání, nastavte Vyplnit pomocí na Vlastní hodnotu a zadejte hodnotu, vyberte proměnnou nebo použijte vzorec Power FX. Pokud je vstup přepsán, agent uživatele na hodnotu nedotazuje.

Completion

Tady můžete vybrat, co se má stát po dokončení běhu nástroje.

Agenta můžete nechat automaticky vygenerovat kontextovou odpověď pro uživatele na základě dotazu a výsledku nástroje.

Alternativně můžete vytvořit konkrétní formátovanou odpověď, kterou nástroj vrátí. Pomocí nástroje pro výběr proměnné můžete vložit odkazy na výstupní proměnné. K formátování odpovědi můžete použít také vzorce Power Fx.

V části Po spuštění vyberte jednu z několika různých možností, jak má nástroj po spuštění nástroje reagovat na uživatele:

• Nereagovat (výchozí):: Agent začlení výstup nástroje do odpovědi.
• Napsání odpovědi pomocí generující umělé inteligence: Nechte AI vytvořit kontextovou odpověď pomocí výstupů nástroje.
• Odeslání konkrétní odpovědi: Vytvoření šablonované odpovědi s vloženou proměnnou
• Odeslání adaptivní karty: Vytváření bohatých interaktivních odpovědí pomocí tlačítek a akcí

Můžete také nakonfigurovat, které výstupní proměnné budou dostupné agentům a dalším nástrojům.

Výběr nástrojů a vstupní kolekce

Když definujete nástroj v Copilot Studio, poskytnete také informace, které popisují jeho účel. Tyto informace umožňují agentu identifikovat, kdy nástroj používat. Popis nástroje také pomáhá orchestrátoru používat generativní AI k vygenerování otázek podle potřeby ke shromažďování vstupů. Váš agent může pomocí otázek shromáždit informace k vyplnění vstupů potřebných k použití nástroje. V důsledku toho nemusíte ručně vytvářet uzly otázek, abyste shromáždili všechny potřebné vstupy, například vstupy v toku. Orchestrátor agenta zpracovává sběr vstupů za vás v době běhu.

Agent bere v úvahu několik faktorů k určení výběru nástroje:

• Název a popis nástroje
• Aktuální kontext konverzace
• Záměr uživatele odvozený ze zprávy
• Dostupné vstupy a výstupy
• Předchozí použití nástroje v konverzaci

Při použití generativního režimu nástroje ve výchozím nastavení vracejí své informace agentovi. Pomocí odpovědi nástroje může agent vygenerovat kontextovou odpověď na dotaz uživatele. Případně můžete dát nástroji pokyn, aby vždy odpověděl okamžitě, buď vygenerováním zprávy, nebo vytvořením explicitní zprávy.

Tip

Pokud používáte vygenerované otázky z nástroje, informujte uživatele, že část konverzace vygenerovala umělá inteligence.

Do systémového tématu Zahájení konverzace můžete například přidat další zprávu. Toto téma určuje zprávu, která se zobrazí vašim uživatelům, když začne nová konverzace.

Volejte existující nástroj z tématu

Nástroj můžete explicitně vyvolat v rámci tématu. Podle vašeho případu použití můžete svůj nástroj použít jako součást širšího tématu, které využívá více uzlů. Nebo, jako v následujícím příkladu, přidání jediného akčního (nebo nástrojového) uzlu k tématu je možná vše, co je potřeba.

Jak volat nástroj v rámci tématu:

1. V Copilot Studiu přejděte na stránku Topics agenta, kterého chcete upravit.

2. Vytvořte nové téma a pojmenujte ho, například Získání předpovědi počasí.

3. Přidejte odpovídající spouštěcí fráze. Pokud chcete pokračovat ve stejném příkladu počasí z předchozího kroku, spouštěcí fráze můžou zahrnovat:

   • bude pršet
   • dnešní předpověď
   • získat počasí
   • jaké je počasí

4. Vyberte Přidat uzel (+) a pak vyberte Přidat nástroj.

5. Vyberte nástroj z dostupných nástrojů. Existují tři karty zobrazující různé typy nástrojů:

   • Základní nástroje
   • Connector
   • nástroj

   Uzel Akce se teď přidá do vašeho tématu.

6. Vyberte Uložit.

Informace o konektoru MCP

U konektoru MCP můžete zobrazit názvy a popisy nástrojů a prostředků MCP, které konektor MCP zpřístupnil. Informace o nástrojích a prostředcích se zobrazují v tabulce, jeden řádek pro každý nástroj.

Důležité informace o ověřování pro nástroje

Některé nástroje vyžadují ověření, aby fungovaly správně, například Dynamic Prompt nebo jiné, které volají rozhraní Dataverse API. Správná konfigurace ověřování zajišťuje zabezpečení při zachování bezproblémového uživatelského prostředí.

Nástroje se vždy spouští v modulu runtime agenta v kontextu uživatele a nejde je spustit, pokud není povolené ověřování. Jsou podporovány dva typy metod ověření:

• Přihlašovací údaje koncového uživatele: Agent používá přihlašovací údaje uživatele k ověření ve službě. Tato metoda zajišťuje, že uživatelé mají přístup pouze k datům, ke kterým mají oprávnění.
• Přihlašovací údaje poskytnuté tvůrcem: Agent používá přihlašovací údaje autora k ověření ve službě. Tento režim ověřování použijte pro sdílené prostředky nebo v případě, že by uživatelé neměli potřebovat individuální přístup.

Otestování nástroje

S generativní orchestrací orchestrátor vybere váš nástroj, když jej považuje za relevantní pro uživatelský dotaz.

Můžete také použít existující nástroj zevnitř tématu.

Zapnutí nebo vypnutí nástroje v agentu

Nástroj můžete pro svého agenta zapnout nebo vypnout ze stránky konfigurace nástroje. Vypnutí nástroje blokuje agenta v používání nástroje, ale nástroj je stále připojený k agentu a můžete ho později znovu zapnout. Když přidáte nástroj agentovi, nástroj je ve výchozím nastavení zapnutý.

Pro vypnutí nástroje u agenta:

1. Přejděte ke svému agentovi a vyberte stránku Nástroje pro agenta.
2. Výběrem nástroje přejděte na stránku konfigurace nástroje.
3. V horní části stránky konfigurace vypněte nástroj pomocí přepínače Zapnuto.
4. Výběrem možnosti Uložit se změna uplatní.

Nástroj se stále zobrazuje v seznamu nástrojů agenta, ale už není zapnutý.

Odstraňte nástroj z agenta

Vypnutí nástroje blokuje použití nástroje, ale také vám dává flexibilitu, abyste ho později znovu zapnuli. Ze svého agenta můžete také nástroj trvale odebrat. Odstranit nástroj z agenta:

1. Přejděte ke svému agentovi a vyberte stránku Nástroje pro agenta.
2. Najděte nástroj v seznamu nástrojů a najeďte myší na název nástroje. Vyberte tři tečky (...).
3. Vyberte Odstranit. Zobrazí se potvrzovací okno.
4. Pokud chcete nástroj odebrat, vyberte Odstranit.

Nástroj zmizí ze seznamu nástrojů agenta.

Note

Nástroje můžete odstranit jenom ze stránky nástrojů agenta. Nástroje nemůžete odstranit z hlavní stránky Copilot Studio Tools.

Omezení nástrojů v agentech

• Při použití generativní orchestrace může orchestrátor zpracovat maximálně 128 nástrojů pro jednoho agenta. Pro nejlepší výkon a výsledky však doporučujeme omezit počet nástrojů u vašeho makléře na maximálně 25–30.
• Při použití multiagentní orchestrace s podřízenými agenty mají tito agenti vlastní orchestraci a mohou spravovat sadu až 128 nástrojů.