Přidání nástrojů do agenta Azure AI
Nástroje v rozhraní Microsoft Agent Framework umožňují vašemu agentovi AI používat existující rozhraní API a služby k provádění úloh, které nemohl provést samostatně. Nástroje pracují prostřednictvím volání funkcí a umožňují umělé inteligenci automaticky vyžadovat a používat konkrétní funkce. Architektura směruje požadavek na příslušnou funkci v základu kódu a vrátí výsledky zpět do velkého jazykového modelu (LLM), aby mohl vygenerovat konečnou odpověď.
Pokud chcete povolit automatické volání funkcí, musí nástroje zadat podrobnosti, které popisují, jak fungují. Vstup, výstup a účel funkce by měly být popsány způsobem, který dokáže AI pochopit, jinak AI nemůže funkci správně volat.
Používání nástrojů s agentem Azure AI Foundry
Rozhraní Microsoft Agent Framework podporuje jak vlastní nástroje funkcí, tak integrované nástroje, které jsou připravené k použití.
Integrované nástroje
Agenti Azure AI Foundry mají několik integrovaných nástrojů, které můžete okamžitě použít:
- Interpret kódu – spouští kód Pythonu pro výpočty, analýzu dat a další
- Hledání souborů – prohledává a analyzuje dokumenty
- Vyhledávání na webu – načítá informace z internetu.
Tyto nástroje jsou automaticky dostupné a nevyžadují žádné další nastavení.
Vlastní nástroje funkcí
Při vytváření vlastních nástrojů pro agenta Azure AI Foundry je potřeba porozumět několika klíčovým konceptům:
Definice funkce a poznámky
Vytvořte nástroj definováním běžné funkce Pythonu se správnými poznámkami k typu. Pomocí
AnnotatedAFieldz Pydantic můžete poskytnout podrobné popisy, které umělé inteligenci pomůžou pochopit účel funkce a jak používat jeho parametry. Čím popisnější jsou vaše poznámky, tím lépe dokáže AI pochopit, kdy a jak volat vaši funkci.Přidání nástrojů do agenta
Vlastní funkce předejte ChatAgent během vytváření pomocí parametru
tools. Můžete přidat jednu funkci nebo seznam více funkcí. Architektura tyto funkce automaticky zaregistruje a zpřístupní je umělé inteligenci, která bude volat.Volání nástroje prostřednictvím konverzace
Jakmile jsou vaše nástroje zaregistrované u agenta, nemusíte je ručně spouštět. Místo toho se zeptejte agenta nebo mu dejte úkoly, které by přirozeně vyžadovaly funkčnost vašeho nástroje. AI automaticky určí, kdy volat nástroje na základě kontextu konverzace a popisů nástrojů, které jste zadali.
Více nástrojů a orchestrace
Do jednoho agenta můžete přidat více nástrojů a AI automaticky zvolí, který nástroj se má použít na základě požadavku uživatele. Architektura zpracovává orchestraci, volá příslušné funkce a kombinuje jejich výsledky, aby poskytovala komplexní odpověď.
Osvědčené postupy pro vývoj nástrojů
- Jasné popisy: Napište jasné a podrobné popisy funkcí a parametrů, které umělé inteligenci pomůžou porozumět jejich účelu.
- Poznámky k typu: Použití správných tipů pro typ Pythonu k určení očekávaných vstupních a výstupních typů
- Zpracování chyb: Implementace vhodného zpracování chyb ve funkcích nástrojů pro řádné zpracování nečekaných vstupů
- Vrácení smysluplných dat: Zajistěte, aby funkce vracely data, která dokáže AI efektivně používat v odpovědích.
- Zaměřte se na funkce: Navrhujte každý nástroj tak, aby zpracovával konkrétní úlohu, místo aby se snažil dělat příliš mnoho věcí v jedné funkci.
Pomocí těchto konceptů můžete rozšířit agenta Azure AI Foundry jak pomocí integrovaných, tak vlastních nástrojů, což umožňuje interakci s rozhraními API a provádění pokročilých úloh. Díky tomuto přístupu je umělá inteligence výkonnější a schopná efektivně zpracovávat reálné aplikace.