Životní cyklus vývoje agentů

Životní cyklus vývoje agenta ve Microsoft Foundry zahrnuje od počátečního vytvoření až po monitorování v produkčním prostředí. Jádrem každého agenta je model z katalogu modelů Foundry, který řídí odůvodnění a generování odpovědí. Tento životní cyklus vám pomůže sestavovat spolehlivé agenty, zachytávat problémy včas a dodávat s jistotou. Pomocí portálu Foundry nebo kódu můžete vytvářet, přizpůsobovat a testovat chování agenta. Pak iterujte trasováním, hodnocením a monitorováním, abyste zlepšili kvalitu a spolehlivost. Až budete připraveni, publikujte svého agenta jako aplikaci, abyste ho mohli sdílet a integrovat do svých aplikací.

Tento článek je určený pro vývojáře, kteří chtějí vytvářet, testovat a dodávat agenty připravené pro produkční prostředí.

Požadavky

Životní cyklus na první pohled

Tento životní cyklus použijte jako praktický kontrolní seznam při vytváření a nasazování agenta.

  1. Zvolte typ agenta: Začněte s agentem založeným na příkazovém řádku nebo hostovaným agentem.
  2. Vytvořte agenta a začněte testovat: Iterujte v dětském prostředí nebo v kódu.
  3. Přidání nástrojů a dat: Připojte nástroje pro načtení a akce a před uložením ověřte konfiguraci.
  4. Uložte změny jako verze: Zachyťte smysluplné milníky a porovnejte verze.
  5. Ladění pomocí trasování: Pomocí trasování můžete potvrdit volání nástrojů, latenci a komplexní chování. Podrobnosti najdete v tématu Přehled trasování agentů.
  6. Vyhodnocení kvality a bezpečnosti: Před publikováním spusťte opakovatelné vyhodnocení, abyste zachytili regresi. Koncepční pokyny najdete v tématu Vyhodnocovače agentů.
  7. Optimalizace hostovaných agentů (Preview):: Automaticky vylepšete pokyny hostovaného agenta a objevte dovednosti pomocí optimalizátoru agentů.
  8. Publikování a integrace: Publikujte stabilní koncový bod a integrujte ho do vaší aplikace. Postup najdete v Aplikace agenta v Microsoft Foundry.
  9. Monitorování a iterace: Monitorujte výkon a kvalitu v produkčním prostředí a podle potřeby aktualizujte a znovu publikujte. Pokyny najdete v tématu Monitorování agentů.

Typy agentů v Microsoft Foundry

Existují dva typy agentů:

  • Založeno na výzvách: Agent založený na výzvách je deklarativně definovaný agent, který kombinuje model Foundry, pokyny, nástroje a podněty přirozeného jazyka k řízení chování. Rozšiřte ho připojením nástrojů pro znalosti a paměť. Editovat, verzovat, testovat, vyhodnocovat, monitorovat a publikovat agenty založené na výzvách z hřiště Agents na portálu Foundry.

  • Hostované: Hostovaní agenti jsou kontejnerizované agenty, které sestavujete v kódu pomocí podporovaných architektur nebo vlastního kódu. Služba Foundry Agent Service nasazuje a spravuje tyto agenty. Hostované agenty v uživatelském rozhraní pro sestavování agentů neupravujete, ale můžete je pořád vyvolat, vyhodnotit, monitorovat a publikovat. Podrobnosti najdete v tématu Co jsou hostovaní agenti?

Vytvářejte agenty založené na výzev na portálu Foundry nebo ve vlastním vývojovém prostředí pomocí rozhraní příkazového řádku, sady SDK nebo rozhraní REST API. Další informace najdete v rychlém startu.

Vytvoření agenta založeného na příkazu

Pokud už víte, jaký druh agenta chcete vytvořit, pojmenujte ho a začněte konfigurovat jeho pokyny a nástroje modelu.

Poznámka

Po pojmenování agenta nemůžete název změnit. V kódu odkazujete na svého agenta pomocí <agent_name>:<version>.

Vývoj agentů v kódu

Pokud dáváte přednost práci v kódu, použijte podporované způsoby, jak přenést kód agenta do vývojového prostředí, ze kterého můžete testovat místně a pak ho nasadit do Azure.

Na kartě Code v podokně chatu v prostředí pro experimentování agenta si můžete vzít fragment kódu, který odkazuje na vašeho agenta, do dedikovaného cloudového prostředí Visual Studio Code pro web. Fragment kódu je předem nakonfigurovaný s balíčky a rozšířeními, které potřebujete, a pokyny k efektivnímu vývoji a nasazení agenta Foundry do Azure. Fragment kódu můžete také zkopírovat přímo do upřednostňovaného vývojového prostředí. Podrobnosti najdete v dokumentaci k dětskému hřišti.

Základní funkce životního cyklu vývoje agenta

Prostředí pro vytváření agentů nabízí integrovaná prostředí pro každý základní krok životního cyklu vývoje agenta. Při vývoji aplikace agenta připraveného pro produkční prostředí využijte tyto základní funkce. Každá funkce obsahuje podrobnou dokumentaci, kde se můžete dozvědět více.

Uložit změny jako verze

Po vytvoření první verze agenta založeného na příkazovém řádku uložte následné změny jako nové verze. Neuložené změny můžete otestovat v testovacím prostředí agenta. Pokud ale chcete zobrazit historii konverzací, monitorovat výkon agenta nebo spouštět úplné vyhodnocení, musíte změny uložit.

Správa verzí agenta poskytuje následující funkce pro správu konfigurací a iterací agentů. Tento systém zajišťuje, že všechny změny budou sledovány, testovatelné a srovnatelné napříč verzemi.

  • Neměnnost verze: Každá verze agenta je neměnná po uložení. Všechny změny existující verze vyžadují uložení a vytvoření nové verze. Tento požadavek pomáhá zajistit integritu verzí a zabránit náhodnému přepsání.

  • Správa stavu návrhu: Můžete testovat agenty ve stavu, který není uložený, pro experimentální účely. Pokud opustíte portál Foundry, přijdete o neuložené změny, proto je často uložte, abyste zachovali důležité změny.

  • Operace správy verzí: Žádosti můžete směrovat na konkrétní verze agenta, abyste umožnili řízené nasazení a vrácení zpět.

  • Navigace historie verzí: Přístup k historii verzí pro libovolného agenta, přejděte na libovolnou konkrétní verzi a proveďte následující porovnání:

    Typ porovnání Popis
    Nastavení agenta Porovnání nastavení konfigurace mezi verzemi pomocí rozevíracího seznamu verzí
    Výstup chatu Analýza rozdílů v odpovědích mezi verzemi agenta pomocí identických vstupů
    Definice YAML Kontrola rozdílů v definicích agentů

Přidání nástrojů

Zvýrazněte agenta tím, že mu poskytnete znalosti (konkrétní soubory nebo indexy) nebo povolíte provádění akcí (volání externích rozhraní API). Nástroje jsou k dispozici pro většinu případů použití, od jednoduchých nahrávání souborů po vlastní připojení serveru MCP (Model Context Protocol). V případě složitějších nástrojů možná budete muset nakonfigurovat ověřování nebo přidat připojení jako součást jejich připojení k agentu.

Pokud chcete uložit agenta s připojeným nástrojem, musíte nástroj úspěšně nakonfigurovat. Opakovaně používejte nakonfigurované nástroje napříč agenty. Informace o dostupných nástrojích najdete v katalogu nástrojů.

Ladění a ověřování pomocí trasování (náhled)

Když přidáváte nástroje a iterujete na výzvách, použijte trasování k ověření koncového chování.

  • Ověřte, jestli agent použil očekávané nástroje.
  • Zkontrolujte vstupy a výstupy nástrojů.
  • Identifikace hotspotů latence napříč voláními modelu a nástrojů

Další informace najdete v tématu Přehled trasování agentů.

Vyhodnocení kvality a bezpečnosti (Preview)

Před publikováním agenta (a po jakékoli smysluplné změně) spusťte vyhodnocení, abyste zachytili regrese a změřili kvalitu konzistentně napříč verzemi.

Monitorování po publikování

Po publikování aplikace agenta s ní zacházet jako s produkčním softwarem:

  • Monitorujte kvalitu a bezpečnostní signály.
  • Zkontrolujte stopy, když se změní chování.
  • Aktualizujte a znovu publikujte, když opravíte problémy nebo provedete vylepšení.

Pokyny najdete v tématu Agenti trasování.

Plánování identit a oprávnění

Nástroje a podřízené prostředky často vyžadují ověřování. Při publikování agenta se může změnit jeho identita a model oprávnění. Ujistěte se, že váš publikovaný agent má jenom přístup, který potřebuje.

Podrobnosti najdete v tématu o konceptech identity Agent v Microsoft Foundry.

Zabezpečení a přístup

Zacházejte s konfigurací agenta stejně pečlivě jako s kódem aplikace. Ochrana tajných kódů a oprávnění v průběhu životního cyklu:

  • Místo vkládání klíčů používejte nejnižší oprávnění a přiřazení rolí. Další informace najdete v tématu Řízení přístupu na základě role na portálu Foundry.
  • Ukládejte tajné kódy do spravovaného úložiště tajných kódů a odkazujte na ně prostřednictvím připojení místo jejich pevně zakódování v kódu, konfiguračních souborech nebo výzev. Pokyny najdete v tématu Nastavte připojení Key Vault.
  • Před publikováním ověřte, že identita agenta a připojení nástrojů v publikované agentní aplikaci mají pouze nezbytný přístup. Podrobnosti najdete v tématu o konceptech identity Agent v Microsoft Foundry.

Publikování agenta

Po vytvoření verze agenta, se kterou jste spokojení, ji publikujte jako aplikaci agenta. Získáte stabilní koncový bod, který můžete otevřít a otestovat v prohlížeči, sdílet s ostatními nebo vložit do stávajících aplikací. Vy i vaši spolupracovníci můžete ověřit výkon a identifikovat, co je potřeba upřesnit. Proveďte všechny potřebné aktualizace a publikujte novou verzi kdykoli.

Důležité

Oprávnění přiřazená identitě projektu se automaticky nepřenesou do publikovaného agenta. Po publikování znovu přiřaďte potřebná oprávnění identitě aplikace agenta.

Běžné nástrahy vývoje agentů

  • Neuložené změny jsou dočasné: Pokud chcete porovnat verze, zobrazit historii nebo spustit úplné vyhodnocení, uložte změny jako verzi.
  • Nástroje musí být před uložením nakonfigurovány: Pokud nástroj vyžaduje ověření nebo připojení, dokončete nastavení před uložením.
  • Publikování může vyžadovat aktualizace oprávnění: Po publikování znovu zkontrolujte přístup k prostředkům pro identitu publikovaného agenta a odeberte veškerý přístup, který už agent nepotřebuje.

Související obsah

Další informace o typech agentů:

Konfigurace a rozšíření agentů:

Publikování a monitorování agentů:

Ladění a vyhodnocení:

  • Last updated on