Delen via

Een werkstroom bouwen in Microsoft Foundry

Werkstromen zijn gebruikersinterface-gebaseerde hulpprogramma's in Microsoft Foundry. Gebruik deze om declaratieve, vooraf gedefinieerde reeksen acties te maken waarmee agents en bedrijfslogica in een visuele opbouwfunctie worden ingedeeld.

Met werkstromen kunt u intelligente automatiseringssystemen bouwen die AI-agents naadloos combineren met bedrijfsprocessen op een visuele manier. Traditionele systemen met één agent zijn beperkt in hun vermogen om complexe, veelzijdige taken te verwerken. Door meerdere agents te organiseren, elk met gespecialiseerde vaardigheden of rollen, kunt u systemen maken die robuuster, adaptief en in staat zijn om problemen in de echte wereld samen op te lossen.

Vereiste voorwaarden

Bepalen wanneer werkstromen moeten worden gebruikt

Werkstromen zijn ideaal voor scenario's waarin u het volgende moet doen:

  • Meerdere agenten coördineren in een herhaalbaar proces.
  • Voeg vertakkingslogica (bijvoorbeeld if/else) en variabeleafhandeling toe zonder code te schrijven.
  • Maak human-in-the-loop-stappen (bijvoorbeeld goedkeuringen of verduidelijkende vragen).

Als u werkstroom YAML wilt bewerken in Visual Studio Code of werkstromen wilt uitvoeren in een lokale speeltuin, raadpleegt u:

Werkstroompatronen begrijpen

Foundry biedt sjablonen voor gebruikelijke orkestratiepatronen. Begin met een lege werkstroom of selecteer een sjabloon:

Patroon Description Typisch gebruiksscenario
Menselijke tussenkomst Stelt de gebruiker een vraag en wacht op gebruikersinvoer om door te gaan Goedkeuringsaanvragen maken tijdens de uitvoering van de werkstroom en wachten op menselijke goedkeuring of het verkrijgen van informatie van de gebruiker
Sequentieel Geeft het resultaat van de ene agent door aan de volgende in een gedefinieerde volgorde Stapsgewijze werkstromen, pijplijnen of verwerking met meerdere fasen
Groepschat Hiermee wordt de controle tussen agents dynamisch doorgegeven op basis van context of regels Dynamische werkstromen, escalatie, terugval of overdracht aan een expert-scenario's

Zie Werkstroomindelingen van Microsoft Agent Framework voor meer informatie.

Een werkstroom maken

In deze procedure ziet u hoe u een sequentiële werkstroom maakt. Dezelfde algemene stappen zijn van toepassing op andere werkstroomtypen.

  1. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).

  2. Selecteer Build in het menu rechtsboven.

  3. Selecteer Nieuwe werkstroom maken>Sequentieel.

  4. Wijs een agent toe aan de agentknooppunten door elk agentknooppunt in de werkstroom te selecteren en de gewenste agent te selecteren of een nieuwe agent te maken. Zie Agents toevoegen verderop in dit artikel voor meer informatie.

  5. Selecteer Opslaan in de visualisatie om de wijzigingen op te slaan.

    Belangrijk

    Foundry slaat werkstromen niet automatisch op. Selecteer Opslaan na elke wijziging om uw werk te behouden.

  6. Selecteer Werkstroom uitvoeren.

  7. Interactie met de werkstroom in het chatvenster.

  8. Voeg eventueel nieuwe knooppunten toe aan uw werkstroom. De volgende sectie in dit artikel bevat informatie over knooppunten.

Controleer uw workflowuitvoering

Nadat u Werkstroom uitvoeren hebt geselecteerd, controleert u of:

  • Elk knooppunt wordt voltooid in de visualisatie.
  • U ziet de verwachte antwoorden in het chatvenster.
  • Variabelen die u opslaat (bijvoorbeeld JSON-uitvoer van een agentknooppunt) bevatten de waarden die u verwacht.

Knooppunten toevoegen

Knooppunten zijn de bouwstenen van uw werkstroom. Elk knooppunt voert een specifieke actie op volgorde uit.

Veelvoorkomende knooppunttypen zijn:

  • Agent: Roep een agent aan.
  • Logica: Gebruik if/else, ga naar of voor elk.
  • Gegevenstransformatie: Stel een variabele in of parseert een waarde.
  • Basischat: Stuur een bericht of stel een vraag aan een agent.

Wanneer u een vooraf gemaakte werkstroom selecteert, worden de knooppunten op volgorde weergegeven. Als u de volgorde van knooppunten wilt wijzigen, selecteert u de drie puntjes op een knooppunt en selecteert u verplaatsen. Als u knooppunten wilt toevoegen, selecteert u het plusteken (+) in de werkruimte.

Agents toevoegen

Voeg een Foundry-agent uit uw project toe aan de werkstroom. Met agentknooppunten kunt u ook nieuwe agents met aangepaste mogelijkheden maken door hun model, prompt en hulpprogramma's te configureren.

Ga naar het tabblad Foundry Agent in de Foundry-portal voor geavanceerde opties voor het maken van agents.

Een bestaande agent toevoegen

  1. In de workflow-visualizer selecteer je het plusteken.

  2. Selecteer Agent oproepen in de vervolgkeuzelijst.

  3. Selecteer bestaande in het venster Nieuwe agent maken.

  4. Voer de naam van de agent in om te zoeken naar bestaande agents in uw Foundry-project.

  5. Selecteer de gewenste agent om deze toe te voegen aan uw werkstroom.

Een nieuwe agent maken

  1. In de workflow-visualizer selecteer je het plusteken.

  2. Selecteer Agent oproepen in de vervolgkeuzelijst.

  3. Voer een agentnaam en beschrijving in van wat de agent doet.

  4. Selecteer Toevoegen.

  5. Configureer de agent in het venster Een agent aanroepen .

  6. Selecteer Opslaan.

Een uitvoerantwoordindeling configureren

Een agent configureren om gestructureerde JSON-uitvoer te retourneren:

  1. Selecteer een nieuwe agent maken in het venster Agentconfiguratie aanroepen.

  2. Configureer de agent voor het verzenden van uitvoer als een JSON-schema:

    1. Selecteer Details.
    2. Selecteer het parameterpictogram.
    3. Selecteer JSON-schema voor tekstindeling.

    Schermopname van het venster voor het configureren van een JSON-schema-indeling voor uitvoer.

  3. Kopieer het gewenste JSON-schema en plak het in het venster Antwoordindeling toevoegen . In de volgende schermopname ziet u een rekenkundig voorbeeld. Selecteer Opslaan.

    Schermopname van het toevoegen van een antwoordindeling in JSON.

Belangrijk

Neem geen geheimen (wachtwoorden, sleutels, tokens) op in JSON-schema's, prompts of opgeslagen werkstroomvariabelen.

{
  "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. Selecteer Actie-instellingen. Selecteer de uitvoer opslaan als json_object/json_schema.

  2. Selecteer Nieuwe variabele maken. Kies een variabelenaam en selecteer Vervolgens Gereed.

    Schermopname met opties voor het maken van een nieuwe variabele in een Microsoft Foundry-werkstroom.

Aanvullende functies configureren

  • YAML Visualizer-weergave: Stel de YAML Visualizer-weergave in op Aan om de workflow op te slaan als een YAML-bestand. Bewerk in de visualizer of de YAML-weergave. Opslaan creëert een nieuwe versie met de volledige versiegeschiedenis.

    Zowel de visualizer als YAML kunnen worden bewerkt. Wijzigingen in het YAML-bestand worden direct in de visual weergegeven.

  • Versiebeheer: elke save maakt een nieuwe, onveranderbare versie. Als u de versiegeschiedenis wilt weergeven of oudere versies wilt verwijderen, opent u de vervolgkeuzelijst Versie links van de knop Opslaan .

  • Notities: Voeg notities toe aan de werkstroom visualiseren voor extra context. Selecteer In de linkerbovenhoek van de visualisatie de optie Notitie toevoegen.

Expressies maken met Power Fx

Power Fx is een taal met weinig code die Excel-achtige formules gebruikt. Gebruik Power Fx om complexe logica te maken waarmee uw agents gegevens kunnen bewerken. Een Power Fx-formule kan bijvoorbeeld een variabelewaarde instellen, een tekenreeks parseren of een voorwaarde evalueren. Zie voor meer informatie het Power Fx-overzicht en -formuleverwijzing.

Variabelen gebruiken in een formule

Als u een variabele wilt gebruiken in een Power Fx-formule, moet u een voorvoegsel aan de naam toevoegen om het bereik van de variabele aan te geven:

  • Gebruik voor systeemvariabelen System.
  • Voor lokale variabelen gebruikt u Local.

Dit zijn de systeemvariabelen:

Naam Description
Activity Informatie over de huidige activiteit
Bot Informatie over de agent
Conversation Informatie over het huidige gesprek
Conversation.Id Unieke ID van het huidige gesprek
Conversation.LocalTimeZone Tijdzone van de gebruiker, in de IANA Time Zone Database-indeling
Conversation.LocalTimeZoneOffset Tijdsverschil van UTC voor de huidige lokale tijdzone
Conversation.InTestMode Booleaanse vlag die aangeeft of het gesprek plaatsvindt op een testcanvas
ConversationId Unieke ID van het huidige gesprek
InternalId Interne id voor het systeem
LastMessage Informatie over het vorige bericht dat de gebruiker heeft verzonden
LastMessage.Id Id van het vorige bericht dat de gebruiker heeft verzonden
LastMessage.Text Vorig bericht dat de gebruiker heeft verzonden
LastMessageId Id van het vorige bericht dat de gebruiker heeft verzonden
LastMessageText Vorig bericht dat de gebruiker heeft verzonden
Recognizer Informatie over intentieherkenning en het activerende bericht
User Informatie over de gebruiker die momenteel met de agent praat
User.Language Taalinstellingen per gebruiker per gesprek
UserLanguage Taalinstellingen per gebruiker per gesprek

Letterlijke waarden in een formule gebruiken

Naast het gebruik van variabelen in een Power Fx-formule, kunt u letterlijke waarden invoeren. Als u een letterlijke waarde in een formule wilt gebruiken, moet u deze invoeren in de indeling die overeenkomt met het bijbehorende type.

De volgende tabel bevat de gegevenstypen en de indeling van de bijbehorende letterlijke waarden:

Typologie Voorbeelden van notaties
Snaar / Touwtje "hi", "hello world!", "copilot"
Booleaan Uitsluitend true of false
Number 1, 532, 5.258, -9201
Record en tabel [1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
Datum en tijd Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Keuze Niet ondersteund
Blank Uitsluitend Blank()

Algemene Power Fx-formules

De volgende tabel bevat de Power Fx-formules die u met elk gegevenstype kunt gebruiken.

Typologie Power Fx-formules
Snaar / Touwtje De functie Text
De functies Concat en Concatenate
De functie Len
De functies Lower, Upper en Proper
De functies IsMatch, Match en MatchAll
De functies EndsWith en StartsWith
De functie Find
De functies Replace en Substitute
Booleaan De functie Boolean
De functies And, Or en Not
De functies If en Switch
Number Functies Decimaal, Drijvend en Waarde
De functies Int, Round, RoundDown, RoundUp en Trunc
Record en tabel De functies Concat en Concatenate
De functies Count, CountA, CountIf en CountRows
De functie ForAll
De functies First, FirstN, Index, Last en LastN
De functies Filter, Search en LookUp
JSON-functie
De functie ParseJSON
Datum en tijd Date-, DateTime- en Time-functies
De functies DateValue, TimeValue en DateTimeValue
De functies Day, Month, Year, Hour, Minute, Second en Weekday
De functies Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday
De functies DateAdd, DateDiff en TimeZoneOffset
De functie Text
Blank De functies Blank, Coalesce, IsBlank en IsEmpty
De functies Error, IfError, IsError en IsBlankOrError

Een variabele instellen met Power Fx

In dit voorbeeld ziet u hoe u de naam van een klant opslaat en uitvoert in hoofdletters:

  1. Maak een werkstroom en voeg een vraagknooppunt toe.

  2. Voer in het deelvenster dat wordt weergegeven in het vak Een vraag stellenWat is uw naam? of een ander bericht in. Voer in het vak Gebruikersantwoord opslaan als een variabelenaam in; bijvoorbeeld Var01. Selecteer Gereed.

    Schermopname van de configuratie van een vraag voor het verzenden van een bericht.

  3. Voeg een actie Bericht verzenden toe. Voer in het deelvenster dat wordt weergegeven in het gebied Bericht voor verzenden de tekst {Upper(Local.Var01)}in. Selecteer Gereed.

    Schermopname van de variabele instantiëring voor de actie van het verzenden van een bericht.

  4. Selecteer Voorbeeld.

  5. Verzend in het voorbeeldvenster een bericht naar de agent om de werkstroom aan te roepen.

    Schermopname van het voorbeeld van een vraag voor de actie van het verzenden van een bericht.

If/else-stromen maken met Power Fx

In dit voorbeeld ziet u hoe u een if/else-stroom toevoegt en een voorwaarde bouwt met systeemvariabelen.

  1. Maak een werkstroom en voeg een vraagknooppunt toe.

  2. Selecteer het + pictogram en voeg een if/else-stroom toe.

  3. Typ System. in het vak Voorwaarde om een voorwaarde-instructie te maken voor elke if/else-vertakking.

    Een schermopname van de systeemvariabelen in het tekstvak if-else-voorwaarde.

  4. Selecteer een volgende actie voor de volgende stap in de werkstroom.

  5. Kies Gereed. Selecteer Opslaan om uw werkstroom op te slaan.

Probleemoplossingsproces

Probleem Solution
De optie Werkstromen is niet zichtbaar of kan geen werkstromen maken/bewerken Controleer of u de rol Inzender of hoger voor uw project hebt. Zie op rollen gebaseerd toegangsbeheer (RBAC) van Azure in Foundry.
Wijzigingen worden niet weergegeven na bewerking Selecteer Opslaan in de visualisatie. Foundry slaat wijzigingen niet automatisch op.
Uitvoering van de workflow produceert onverwachte uitvoer Controleer of aan elk agentknooppunt een agent is toegewezen. Controleer of opgeslagen uitvoer (JSON-schema) geldig is.
Power Fx-formulefout: 'Naam is ongeldig' Voeg het juiste bereikvoorvoegsel toe. Gebruiken System. voor systeemvariabelen en Local. voor lokale variabelen.
Power Fx-formulefout: 'Type-onverenigbaarheid' Controleer of het variabeletype overeenkomt met de verwachte invoer. Gebruik conversiefuncties zoals Text() of Value() indien nodig.
Time-out voor werkstroom Complexe werkstromen opsplitsen in kleinere segmenten. Controleer of externe services binnen de verwachte periodes reageren.

De hulpbronnen opschonen

Ga als volgt te werk om een werkstroom te verwijderen die u niet meer nodig hebt:

  1. Open de werkstroom in het Foundry-portaal.
  2. Selecteer de vervolgkeuzelijst Versie links van de knop Opslaan .
  3. Selecteer Verwijderen voor de versie die u wilt verwijderen.

Verwante inhoud

  • Last updated on