Sdílet prostřednictvím

Vytvoření pracovního postupu v Microsoft Foundry

Pracovní postupy jsou nástroje založené na uživatelském rozhraní v Microsoft Foundry. Slouží k vytváření deklarativních předdefinovaných sekvencí akcí, které orchestrují činnost agentů a obchodní logiku ve vizuálním nástroji.

Pracovní postupy umožňují vytvářet inteligentní automatizační systémy, které hladce prolínají agenty umělé inteligence s obchodními procesy vizuálně. Tradiční systémy s jedním agentem jsou omezené na schopnost zpracovávat složité a vícestranné úlohy. Orchestrací několika agentů, z nichž každý má specializované dovednosti nebo role, můžete vytvářet systémy, které jsou robustnější, adaptivní a schopné řešit reálné problémy ve spolupráci.

Předpoklady

Rozhodněte, kdy použít pracovní postupy

Pracovní postupy jsou ideální pro scénáře, ve kterých potřebujete:

  • Orchestrace více agentů v opakovatelném procesu
  • Přidejte logiku větvení (například if/else) a zpracování proměnných bez psaní kódu.
  • Vytvořte kroky v rámci procesu s lidmi (například schválení nebo objasnění otázek).

Pokud chcete upravit YAML pracovního postupu ve Visual Studio Code nebo spouštět pracovní postupy v místním zkušebním prostředí, viz:

Porozumět vzorům pracovních postupů

Foundry poskytuje šablony pro běžné vzory orchestrace. Začněte s prázdným pracovním postupem nebo vyberte šablonu:

Vzor Description Typický případ použití
Člověk v procesu Položí uživateli otázku a čeká na vstup uživatele, aby pokračoval. Vytváření žádostí o schválení během provádění pracovního postupu, čekání na schválení od člověka nebo získávání informací od uživatele
Sekvenční Předá výsledek z jednoho agenta do dalšího v definovaném pořadí. Postupné pracovní postupy, pipeline nebo zpracování ve více fázích
Skupinové chaty Dynamicky předává řízení mezi agenty na základě kontextu nebo pravidel. Dynamické pracovní postupy, eskalace, záložní scénáře nebo scénáře předání expertů

Další informace naleznete v tématu Orchestrace pracovních postupů rozhraní Microsoft Agent Framework.

Vytvoření pracovního postupu

Tento postup ukazuje, jak vytvořit sekvenční pracovní postup. Stejný obecný postup platí i pro jiné typy pracovních postupů.

  1. Přihlaste se k Microsoft Foundry. Ujistěte se, že je zapnutý přepínač New Foundry . Tyto kroky odkazují na Foundry (nové).

  2. V pravé horní nabídce vyberte Sestavit.

  3. Vyberte Vytvořit nový pracovní postup>Sekvenční.

  4. Přiřaďte agenta k uzlům agenta tak, že vyberete každý uzel agenta v pracovním postupu a buď vyberete požadovaného agenta, nebo vytvoříte nový. Další informace najdete v části Přidání agentů dále v tomto článku.

  5. Výběrem možnosti Uložit v vizualizéru uložte změny.

    Důležité

    Foundry automaticky neukládá pracovní postupy. Po každé změně vyberte Uložit , aby se zachovala vaše práce.

  6. Vyberte Spustit pracovní postup.

  7. Interakce s pracovním postupem v okně chatu

  8. Volitelně můžete do pracovního postupu přidat nové uzly. Další část tohoto článku obsahuje informace o uzlech.

Ověření spuštění pracovního postupu

Po výběru možnosti Spustit pracovní postup ověřte, že:

  • Každý uzel se dokončí ve vizualizačním nástroji.
  • V okně chatu se zobrazí očekávané odpovědi.
  • Všechny proměnné, které uložíte (například výstup JSON z uzlu agenta), obsahují očekávané hodnoty.

Přidání uzlů

Uzly jsou stavební bloky pracovního postupu. Každý uzel provádí určitou akci v posloupnosti.

Mezi běžné typy uzlů patří:

  • Agent: Vyvolání agenta.
  • Logika: Použijte if/else, příkaz goto nebo for each.
  • Transformace dat: Nastavte proměnnou nebo parsujte hodnotu.
  • Základní chat: Odeslání zprávy nebo položení otázky agentu

Když vyberete předem vytvořený pracovní postup, tvůrce zobrazí uzly v posloupnosti. Pokud chcete změnit pořadí uzlů, vyberte tři tečky na uzlu a pak vyberte přesunout. Pokud chcete přidat uzly, vyberte ikonu plus (+) v pracovním prostoru.

Přidání agentů

Do pracovního postupu přidejte libovolného agenta Foundry z vašeho project. Uzly agentů také umožňují vytvářet nové agenty s přizpůsobenými možnostmi konfigurací jejich modelu, výzvy a nástrojů.

Pro rozšířené možnosti tvorby agentů přejděte na kartu Foundry Agent v portálu Foundry.

Přidání existujícího agenta

  1. V vizualizéru pracovního postupu vyberte znaménko plus.

  2. V rozevíracím seznamu v překryvném okně vyberte Vyvolat agenta.

  3. V okně Vytvořit nového agenta vyberte existující.

  4. Zadejte název agenta a vyhledejte existující agenty v project Foundry.

  5. Vyberte požadovaného agenta, který chcete přidat do pracovního postupu.

Vytvoření nového agenta

  1. V vizualizéru pracovního postupu vyberte znaménko plus.

  2. V rozevíracím seznamu v překryvném okně vyberte Vyvolat agenta.

  3. Zadejte název agenta a popis toho, co agent dělá.

  4. Vyberte Přidat.

  5. V okně Vyvolat agenta nakonfigurujte agenta.

  6. Vyberte Uložit.

Konfigurace formátu výstupní odpovědi

Konfigurace agenta pro vrácení strukturovaného výstupu JSON:

  1. V okně Konfigurace vyvolání agenta vyberte Vytvořit nového agenta.

  2. Nakonfigurujte agenta tak, aby odesílal výstup jako schéma JSON:

    1. Vyberte podrobnosti.
    2. Vyberte ikonu parametru.
    3. V případě textového formátu vyberte schéma JSON.

    Snímek obrazovky znázorňující okno pro konfiguraci formátu schématu JSON pro výstup

  3. Zkopírujte požadované schéma JSON a vložte ho do okna Přidat formát odpovědi . Následující snímek obrazovky ukazuje příklad matematiky. Vyberte Uložit.

    Snímek obrazovky znázorňující přidání formátu odpovědi ve formátu JSON

Důležité

Nezahrnujte tajné kódy (hesla, klíče, tokeny) do schémat JSON, výzvy ani uložené proměnné pracovního postupu.

{
  "name": "math_response",
  "schema": {
    "type": "object",
    "properties": {
      "steps": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "explanation": {
              "type": "string"
            },
            "output": {
              "type": "string"
            }
          },
          "required": [
            "explanation",
            "output"
          ],
          "additionalProperties": false
        }
      },
      "final_answer": {
        "type": "string"
      }
    },
    "additionalProperties": false,
    "required": [
      "steps",
      "final_answer"
    ]
  },
  "strict": true
}

  1. Vyberte nastavení akce. Poté vyberte Uložit jako výstupní json_object/json_schema.

  2. Vyberte Vytvořit novou proměnnou. Zvolte název proměnné a pak vyberte Hotovo.

    Snímek obrazovky znázorňující možnosti vytvoření nové proměnné v pracovním postupu Microsoft Foundry

Konfigurace dalších funkcí

  • Zobrazení vizualizéru YAML: Nastavte přepínač Zobrazení vizualizéru YAML na Zapnuto , aby se pracovní postup ukládal jako soubor YAML. Upravte v vizualizéru nebo v zobrazení YAML. Uložení vytvoří novou verzi s úplnou historií verzí.

    Vizualizér i YAML je možné upravovat. Změny souboru YAML se okamžitě zobrazí ve vizualizéru.

  • Správa verzí: Každé uložení vytvoří novou neměnnou verzi. Pokud chcete zobrazit historii verzí nebo odstranit starší verze, otevřete rozevírací seznam Verze vlevo od tlačítka Uložit .

  • Poznámky: Přidejte poznámky do vizualizéru pracovního postupu pro další kontext. V levém horním rohu vizualizéru vyberte Přidat poznámku.

Vytváření výrazů pomocí Power Fx

Power Fx je jazyk s minimem kódu, který používá podobné vzorce jako Excel. Pomocí Power Fx můžete vytvořit složitou logiku, která umožňuje vašim agentům manipulovat s daty. Například vzorec Power Fx může nastavit proměnnou hodnotu, parsovat řetězec nebo vyhodnotit podmínku. Další informace viz Přehled jazyka Power Fx a informace o vzorcích.

Použití proměnných ve vzorci

Chcete-li použít proměnnou ve vzorci Power Fx, musíte přidat předponu k jeho názvu, abyste označili rozsah proměnné:

  • Pro systémové proměnné použijte System.
  • Pro místní proměnné použijte Local.

Tady jsou systémové proměnné:

Název Description
Activity Informace o aktuální aktivitě
Bot Informace o agentu
Conversation Informace o aktuální konverzaci
Conversation.Id Jedinečné ID aktuální konverzace
Conversation.LocalTimeZone Časové pásmo uživatele ve formátu databáze IANA Time Zone Database
Conversation.LocalTimeZoneOffset Časový posun od času UTC pro aktuální místní časové pásmo
Conversation.InTestMode Logický příznak, který představuje, zda konverzace probíhá na testovacím plátně
ConversationId Jedinečné ID aktuální konverzace
InternalId Interní identifikátor systému
LastMessage Informace o předchozí zprávě, kterou uživatel odeslal
LastMessage.Id ID předchozí zprávy, kterou uživatel odeslal
LastMessage.Text Předchozí zpráva, kterou uživatel odeslal
LastMessageId ID předchozí zprávy, kterou uživatel odeslal
LastMessageText Předchozí zpráva, kterou uživatel odeslal
Recognizer Informace o rozpoznávání záměru a aktivační zprávě
User Informace o uživateli, který aktuálně hovoří s agentem
User.Language Uživatelské jazykové nastavení podle konverzace
UserLanguage Uživatelské jazykové nastavení podle konverzace

Použití hodnot literálů ve vzorci

Kromě použití proměnných ve vzorci Power Fx můžete zadat hodnoty literálů. Chcete-li použít hodnotu literálu ve vzorci, musíte ji zadat ve formátu, který odpovídá správnému typu.

Následující tabulka uvádí datové typy a formát jejich odpovídajících literálních hodnot.

Typ Příklady formátu
String "hi", "hello world!", "copilot"
logický Pouze true nebo false
Number 1, 532, , 5.258-9201
Záznam a tabulka [1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, , { message: "hello" }{ name: "John", info: { age: 25, weight: 175 } }
Datum a čas Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Volba Nepodporováno
prázdný Pouze Blank()

Běžné vzorce Power Fx

Následující tabulka uvádí vzorce Power Fx, které můžete použít s každým datovým typem.

Typ Vzorce Power Fx
String Funkce Text
Funkce Concat a Concatenate
Funkce Len
Funkce Lower, Upper a Proper
Funkce IsMatch, Match a MatchAll
Funkce EndsWith a StartsWith
Funkce Find
Funkce Replace a Substitute
logický Funkce Boolean
Funkce And, Or a Not
Funkce If a Switch
Number Funkce Decimal, Float a Value
Funkce Int, Round, RoundDown, RoundUp a Trunc
Záznam a tabulka Funkce Concat a Concatenate
Funkce Count, CountA, CountIf a CountRows
Funkce ForAll
Funkce First, FirstN, Index, Last a LastN
Funkce Filter, Search a LookUp
Funkce JSON
Funkce ParseJSON
Datum a čas Funkce Date, DateTime a Time
Funkce DateValue, TimeValue a DateTimeValue
Funkce Day, Month, Year, Hour, Minute, Second a Weekday
Funkce Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday
Funkce DateAdd, DateDiff a TimeZoneOffset
Funkce Text
prázdný Funkce Blank, Coalesce, IsBlank a IsEmpty
Funkce Error, IfError, IsError, IsBlankOrError

Nastavení proměnné pomocí Power Fx

Tento příklad ukazuje, jak uložit a zobrazit jméno zákazníka velkými písmeny:

  1. Vytvořte pracovní postup a přidejte uzel Položit otázku .

  2. V podokně, které se zobrazí, zadejte do pole Položit otázkusvé jméno? nebo jinou zprávu. Do pole Uložit odpověď uživatele jako zadejte název proměnné; například Var01. Pak vyberte Hotovo.

    Snímek obrazovky znázorňující konfiguraci otázky pro odeslání zprávy

  3. Přidání akce Odeslat zprávu V podokně, které se zobrazí, v oblasti Pro odeslání zprávy zadejte {Upper(Local.Var01)}. Pak vyberte Hotovo.

    Snímek obrazovky znázorňující instanci proměnné pro akci odeslání zprávy

  4. Vyberte Náhled.

  5. V podokně náhledu odešlete agentu zprávu, která vyvolá pracovní postup.

    Snímek obrazovky znázorňující náhled otázky pro akci odeslání zprávy

Vytvoření toků if/else pomocí Power Fx

Tento příklad ukazuje, jak přidat tok if/else a sestavit podmínku se systémovými proměnnými.

  1. Vytvořte pracovní postup a přidejte uzel Položit otázku .

  2. + Vyberte ikonu a přidejte tok if/else.

  3. Zadáním System. do pole Podmínka vytvořte příkaz podmínky pro každou větev if/else.

    Snímek obrazovky zobrazující systémové proměnné v textovém poli podmínky if-else

  4. Vyberte další akci pro další krok v pracovním postupu.

  5. Vyberte Hotovo. Vyberte Uložit a uložte pracovní postup.

Řešení problémů

Problém Řešení
Možnost Pracovní postupy nejsou viditelné nebo nemůžou vytvářet nebo upravovat pracovní postupy Ověřte, zda máte roli Contributor nebo vyšší ve vašem projektu. Viz řízení přístupu na základě rolí (RBAC) v Azure v Foundry.
Změny se po úpravách nezobrazí Vyberte Uložit v vizualizéru. Foundry neukládá změny automaticky.
Spuštění pracovního postupu vytváří neočekávaný výstup. Ověřte, že každý uzel agenta má přiřazeného agenta. Zkontrolujte, jestli jsou uložené výstupy (schéma JSON) platné.
Chyba vzorce Power Fx: Název není platný Přidejte správnou předponu oboru. Používá se System. pro systémové proměnné a Local. pro místní proměnné.
Chyba vzorce Power Fx: Neshoda typů Ověřte, že typ proměnné odpovídá očekávanému vstupu. Použijte funkce převodu, jako Text() nebo Value() v případě potřeby.
Časový limit pracovního postupu vypršel. Rozdělte složité pracovní postupy do menších segmentů. Zkontrolujte, jestli externí služby reagují v rámci očekávaných časových rámců.

Vyčistěte zdroje

Pokud chcete odstranit pracovní postup, který už nepotřebujete:

  1. Otevřete pracovní postup na portálu Foundry.
  2. Vyberte rozevírací seznam Verze vlevo od tlačítka Uložit .
  3. Vyberte Odstranit pro verzi, kterou chcete odebrat.

Související obsah

  • Last updated on