Přidání nástrojů k vlastním agentům

Nástroje jsou stavební bloky, které umožňují agentům pracovat s externími systémy. Nástroje rozšiřují funkce vašeho agenta, což umožňuje provádět různé akce v reakci na žádosti uživatelů nebo autonomní triggery. Každý nástroj představuje konkrétní schopnost, kterou může váš agent provádět. Svého agenta můžete například vybavit nástroji, které provádějí věci 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ů

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

S generativní orchestrací (ve výchozím nastavení aktivní) může váš agent automaticky vybrat nejvhodnější nástroj nebo téma nebo prohledávat znalosti, aby odpověděl uživateli. 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 od společnosti Microsoft i od jiných než služby 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í: Zadání založené na modelu na jedné výměně, které 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.

Existují dva další mechanismy, které můžete použít k tomu, abyste svému agentovi přidali chování jako nástroj:

• Dovednosti: Kontejner pro sadu souvisejících nástrojů.
• Klientský nástroj: Odešle klientovi aktivitu události, aby klient provedl akci a vrátil odpověď.

Další informace o dovednostech a klientských nástrojích najdete v odkazech v části Související obsah.

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 agent tak, že v levém navigačním podokně zvolíte Agenti a v seznamu vyberete agent.

2. Přejděte na stránku Nástroje 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:

   • Otázka
   • Tok agenta
   • Používání 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 možnost Zadání, musíte provést následující kroky:

   • Definování šablony a pokynů k zadání
   • 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 konfigurovat. 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. Údaje se zobrazují ve třech částech:

• Detaily
• Vstupy
• Dokončování

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.

Detaily

Sekce Podrobnosti umožňuje konfigurovat základní podrobnosti o vašem 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. Generování orchestrace závisí na tomto popisu k určení, kdy má váš agent 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 agentovi dynamicky rozhodnout, kdy nástroj použít: Pokud je tato možnost vybrána, může agent použít generování orchestraci k určení, kdy se má nástroj použít. Pokud tato možnost není vybrána, agent použije nástroj jenom v případě, že je explicitně volán z tématu. (Ve výchozím nastavení je tato možnost vybrána, pokud je zapnuta generativní orchestrace.)
  • Zeptat se koncového uživatele před spuštěním: V prostředí chatu koncového uživatele požádejte koncového uživatele o potvrzení před spuštěním nástroje. Ve výchozím nastavení je tato možnost nastavena 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ěření uživatelem.
  • Popis: Volitelně můžete přidat popis nástroje, který agent zobrazí uživateli, když chce nástroj spustit. Tento popis uživateli umožní zjistit, co je potřeba k ověření.

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 sloupce Vyplnit pomocí pro každý vstup nastavena na Dynamicky vyplňovat 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. Výběrem možnosti Přizpůsobit získáte přístup k podrobnějším přizpůsobením pro shromažďování a vyplňování vstupů:

• Zobrazovaný název a popis: Jak se zobrazí vstup 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 ve výrazu uživatele neidentifikuje entitu, může otázku položit znovu.
• 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 také zvolit přepsání vstupu konkrétní hodnotou místo toho, aby ho 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 se uživatele neptá na hodnotu.

Dokončování

Tady můžete vybrat, co se má stát, když je nástroj spuštěný.

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

Případně se můžete rozhodnout vytvořit konkrétní formátovanou odpověď, kterou má váš nástroj vrátit. 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 reagovat uživateli po spuštění nástroje:

• Nereagovat (výchozí): Agent začlení výstup nástroje do své odpovědi
• Napsat odpověď pomocí generativní AI: Nechte AI vytvořit kontextovou odpověď pomocí výstupů nástroje
• Odeslat konkrétní odpověď: Vytvořte šablonovou odpověď s vložením proměnných
• Odeslat adaptivní kartu: Vytvářejte bohaté interaktivní odpovědi s tlačítky a akcemi

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ž v Copilot Studio definujete nástroj, 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á vstupní kolekci za vás za 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žívání generativního režimu ve výchozím nastavení nástroje vrací své informace zpět do agenta. Pomocí odpovědi nástroje může agent vygenerovat kontextovou odpověď na dotaz uživatele. Případně můžete svému nástroji dát pokyn, aby vždy reagoval okamžitě, a to buď vygenerováním zprávy, nebo vytvořením explicitní zprávy.

Zpropitné

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

Přidejte například další zprávu do systémového tématu Zahájení konverzace. 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 také explicitně vyvolat z tématu. V závislosti na případu použití můžete nástroj použít jako součást širšího tématu, které používá více uzlů. Stejně jako v případě počasí může být přidání uzlu do tématu přesně to, co potřebujete.

Jak provést volání toku zevnitř tématu:

1. V Copilot Studio přejděte na stránku Témata pro 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. Vyberte nástroj z dostupných nástrojů. Existují tři karty zobrazující různé typy nástrojů:

   • Základní nástroje
   • Konektor
   • Nástroj

   Váš uzel Akce je nyní přidán do vašeho tématu.

5. Zvolte 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 dynamické zadání, nebo jiné, které volají rozhraní API Dataverse. 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ějí v modulu runtime agenta v kontextu uživatele a nedají se spustit, pokud není zapnuté 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.

Otestovat nástroj

Při generativní orchestraci nástroj orchestrátor vybere, když ho považuje za relevantní pro uživatelský dotaz.

Případně mžete volat existující nástroj z 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ž do agenta přidáte nástroj, je ve výchozím nastavení zapnutý.

Vypnutí nástroje v agentu:

1. Přejděte na agenta a vyberte stránku Nástroje pro svého 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ý.

Odstranění nástroje z agenta

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

1. Přejděte na agenta a vyberte stránku Nástroje pro svého 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.

Poznámka

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

Související obsah

• Používání konektorů
• Použít výzvy
• Použití toků agentů s agentem
• Protokol kontextu modelu (MCP)
• Přidání nástrojů z rozhraní REST API
• Používání dovedností
• Klientské nástroje
• Používání počítače (Preview)