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

2025-06-17

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. Agenta můžete například vybavit nástroji, které dělají například:

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 publikování zpráv do 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 automaticky reagovat na uživatele pomocí nástrojů a generativní orchestrace. Nástroje můžete také explicitně vyvolat 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 (vypnuté generování orchestrace) může agent používat pouze témata k odpovídání na uživatele. 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:

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 povolte vlastní možnosti nástrojů pomocí konektorů Power Platform.
Tok agenta: Definujte tok agenta, včetně jedné nebo více akcí, které se mají provést.
Výzva: Jednoturnový podnět založený na modelu, který může odkazovat na znalosti, které poskytnete.
Připojení rozhraní 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.
Nástroj MCP (Model Context Protocol): Připojte se k serveru MCP a získejte přístup k nástrojům.
Agent pro použití počítače (náhled): 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.

Když mluvíme o nástrojích v tomto článku a této části dokumentace, znamenáme jeden z mechanismů v této skupině. Tyto typy nástrojů je možné přidat do agenta a nakonfigurovat podobným způsobem.

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.

Otevřete agent tak, že v levém navigačním podokně zvolíte Agenti a v seznamu vyberete agent.
Přejděte na stránku Nástroje pro agenta.
Vyberte Přidat nástroj.
V podokně Přidat nástroj vyberte Nový nástroj.
Ze seznamu, který se zobrazí, vyberte typ nástroje, který chcete přidat:
- Výzva: Vytvoření nástrojů pro generování a analýzu textu využívajících AI
- Průběh agenta: Sestavení vícekrokových procesů pomocí podmíněné logiky
- Použití počítače: Povolení automatizace grafického uživatelského rozhraní pro starší systémy
- Vlastní konektor: Připojení k proprietárním rozhraním API a službám
- REST API: Přímá integrace s webovými službami
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ů
- Zadání vstupních parametrů
- Konfigurace zdrojů znalostí
- Nastavení formátu odpovědi a omezení
Otestujte konfiguraci nástroje pomocí panelu náhledu, abyste měli jistotu, že funguje podle očekávání.
Vyberte Uložit a vytvořte nový nástroj.
Vyberte Přidat do agenta a přidejte ho do svého agenta. Nový nástroj se zobrazí na stránce Nástroje pro agenta.

Zobrazení a změny 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 s podrobnostmi nástroje s konfigurací vašeho nástroje. Podrobnosti se zobrazují ve třech částech:

Podrobnosti
Vstupy
Dokončování (nástroje pro konektory 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. Generování orchestrace spoléhá na tento popis 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ší podrobnosti:
- 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 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 povolena generování 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, jestli chcete pro nástroj použít přihlašovací údaje uživatele nebo tvůrce. Ve výchozím nastavení se používá ověřování uživatelů.
- Popis: Volitelně můžete přidat popis nástroje, který se uživateli zobrazí při spuštění nástroje. 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 váš 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 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čení

Zde můžete vybrat, co se má stát, když nástroj dokončí běh.

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 Studiu, poskytnete také informace, které popisují jeho účel. Tyto informace umožňují agentu identifikovat, kdy nástroj používat, a také použít generování AI k vygenerování otázek. Tyto otázky slouží ke shromáždění informací k vyplnění vstupů potřebných k provedení 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. Shromažďování vstupů se zpracovává za běhu.

Agent používá k určení výběru nástroje několik faktorů:

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

Ve výchozím nastavení nástroje při použití režimu generování vrátí informace zpět do agenta, aby agent mohl 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.

Návod

Při použití vygenerovaných otázek z nástroje informujte uživatele, že některá konverzace je generována AI.

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 také explicitně vyvolat z tématu. V závislosti na vašem 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:

V Copilot Studio přejděte na stránku Témata pro agenta, kterého 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 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
Uzel Akce se teď přidá do vašeho tématu.
Zvolte Uložit.

Nástroje (pouze konektory MCP)

V části Nástroje můžete zobrazit názvy a popisy nástrojů, které jsou k dispozici pro konektor MCP. Nástroje se zobrazí v tabulce, jeden řádek pro každý nástroj. U každého nástroje můžete vidět:

Název a verze nástroje
Vstupní a výstupní parametry
Odhadovaná doba provádění
Statistika využití

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í:

Ověřování uživatele: Agent používá přihlašovací údaje uživatele k ověření ve službě. Tato metoda zajišťuje, že uživatelé přistupují jenom k datům, která mají oprávnění k zobrazení.
Ověřování autora Copilot: Agent používá přihlašovací údaje svého 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.