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

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 publikování zpráv do 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 (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:

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 povolte 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.

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:
- Podnět
- Tok agenta
- Použití počítače
- Vlastní konektor
- Protokol kontextu modelu
- REST API
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í
Výběrem možnosti Uložit nebo Publikovat podle potřeby vytvořte nový nástroj.
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ě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 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. 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ší ú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 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, 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 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.

Completion

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. 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
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

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.

Návod

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 také explicitně vyvolat z 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í jednoho uzlu akce (nástroje) k tématu může být vše, 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 ho, například Získání předpovědi počasí.
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í
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
- Connector
- Tool
Uzel Akce se teď přidá do vašeho tématu.
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é přistupují jenom k datům, která mají oprávnění k zobrazení.
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ý.

Vypnutí nástroje v agentu:

Přejděte na agenta a vyberte stránku Nástroje pro svého agenta.
Výběrem nástroje přejděte na stránku konfigurace nástroje.
V horní části stránky konfigurace vypněte nástroj pomocí přepínače Zapnuto.
Vyberte tlačítko Uložit, chcete-li změnu použít.

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:

Přejděte na agenta a vyberte stránku Nástroje pro svého agenta.
Najděte nástroj v seznamu nástrojů a najeďte myší na název nástroje. Vyberte tři tečky (...).
Vyberte Odstranit. Zobrazí se potvrzovací okno.
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.

Omezení nástrojů v agentech

Při použití generativní orchestrace může orchestrátor zpracovat maximálně 128 nástrojů na 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 podagenty mají podřízení agenti vlastní orchestraci a mohou spravovat vlastní sadu až 128 nástrojů.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-01-29