Sdílet prostřednictvím

Životní cyklus vývoje agentů

Životní cyklus vývoje agenta v Microsoft Foundry zahrnuje od počátečního vytvoření až po monitorování v produkčním prostředí. 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í.

Předpoklady

Životní cyklus na první pohled

Tento proces použijte jako praktický kontrolní seznam při sestavování a nasazení agenta.

  1. Zvolte typ agenta: Začněte s agentem založeným na výzvě, pracovním postupem 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 chování od začátku do konce. 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. Viz Hodnotitelé agentů pro koncepční pokyny.
  7. Publikování a integrace: Publikujte stabilní koncový bod a integrujte ho do vaší aplikace. Postup najdete v tématu Publikování a sdílení agentů v Microsoft Foundry.
  8. 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í tři typy agentů:

  • Na základě výzvy: Agent založený na příkazovém řádku je deklarativní definovaný jeden agent, který kombinuje konfiguraci modelu, pokyny, nástroje a výzvy přirozeného jazyka k řízení chování. Rozšiřte ho připojením nástrojů pro znalosti a paměť. Editujte, verzujte, testujte, vyhodnocujte, monitorujte a publikujte agenty založené na výzvách z playground Agents v portálu Foundry.

  • Pracovní postup: Pomocí pracovních postupů můžete vytvořit pokročilejší pracovní postup, který orchestruje posloupnost akcí nebo koordinuje více agentů. Pracovní postupy mají na portálu vlastní rozhraní, ale platí stejný životní cyklus. Podrobnosti najdete v tématu Vytvoření pracovního postupu v Microsoft Foundry.

  • Hostované (Preview):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 přesto vyvolat, vyhodnotit, monitorovat a publikovat. Podrobnosti najdete v tématu Co jsou hostovaní agenti?

Vytvářejte agenty a pracovní postupy založené na výzvách na portálu Foundry nebo ve vlastním vývojovém prostředí pomocí rozhraní příkazového řádku, SDK nebo rozhraní REST API. Další informace najdete v rychlém průvodci.

Vytvoření agenta založeného na podnětu

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 ve zkušebním prostředí agenta si můžete vzít fragment kódu, který odkazuje na vašeho agenta, do vyhrazeného cloudového prostředí Visual Studio Code for the 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 nebo pracovního postupu uložte následné změny jako nové verze. Neuložené změny můžete otestovat na dětském hřišti 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 konceptu: Pro experimentování můžete testovat agenty v neuloženém stavu. 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í Description
    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 jazyka 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í (Preview)

Když přidáváte nástroje a iterujete na výzvy, použijte trasování k ověření chování od začátku do konce.

  • Ověřte, jestliže agent volal 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 testování, abyste zachytili regrese a změřili kvalitu konzistentním způsobem mezi 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 trasování při změnách 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 může dojít ke změně jeho identity a modelu oprávnění. Ujistěte se, že váš publikovaný agent má jenom přístup, který potřebuje.

Podrobnosti najdete v tématu Koncepty identit agenta v Microsoft Foundry.

Zabezpečení a přístup

Zacházejte s konfigurací agenta jako by to byl kód 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é aplikaci agenta mají pouze přístup, který potřebují. Podrobnosti najdete v tématu Koncepty identit agenta v Microsoft Foundry.

Publikujte agenta nebo pracovní postup

Po vytvoření verze agenta nebo pracovního postupu, 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 znovu 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