.NET Workflows - Rename folder containing sample workflows (#836)

* coolio * Update dotnet/samples/GettingStarted/Workflows/Declarative/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-06-16 21:04:09 +08:00 · 2025-09-19 10:40:51 -07:00
parent 965918b883
commit 7cd45e313b
23 changed files with 7 additions and 7 deletions
@@ -0,0 +1,516 @@
+#
+# This workflow demonstrates a multi-agent orchestrator that attempts to address complex user requests.
+# 
+# For this workflow, several agents used, each with a prompt specific to their role:
+# 
+# 1. Analyst Agent: Able to analyze the current task.
+#    Enable "Bing Grounding Tool" in the agent settings.
+#    See: ./setup/AnalystAgent.yaml
+# 
+# 2. Manager Agent: Able to create plans and delegate tasks to other agents.
+#    See: ./setup/ManagerAgent.yaml
+# 
+# 3. Research Agent:
+#    Enable "Bing Grounding" in the agent settings.
+#    See: ./setup/WebAgent.yaml
+#
+#    With instructions: 
+#    
+#    Only provide requested information in a way that is throughfully organized and formatted.
+#    Never include any analysis or code.
+#    Never generate a file.
+#    Avoid repeating yourself.
+# 
+# 4. Coder Agent: 
+#    Enable "Code Interpreter" in the agent settings.
+#    See: ./setup/CoderAgent.yaml
+#
+# 5. Weather Agent: Able to retrieve factual information from the web.
+#    Enable "Open API" in the agent settings using the wttr.json schema.
+#    See: ./setup/WeatherAgent.yaml
+# 
+kind: AdaptiveDialog
+beginDialog:
+
+  kind: OnActivity
+  id: activity_xyz123
+  type: Message
+  actions:
+    - kind: SetVariable
+      id: setVariable_aASlmF
+      displayName: List all available agents for this orchestrator
+      variable: Topic.AvailableAgents
+      value: |-
+        =[
+            {
+                name: "WeatherAgent", 
+                description: "Able to retrieve weather information",
+                agentid: Env.FOUNDRY_AGENT_RESEARCHWEATHER
+            },
+            {
+                name: "CoderAgent", 
+                description: "Able to write and execute Python code",
+                agentid: Env.FOUNDRY_AGENT_RESEARCHCODER
+            },
+            {
+                name: "WebAgent", 
+                description: "Able to perform generic websearches",
+                agentid: Env.FOUNDRY_AGENT_RESEARCHWEB
+            }
+        ]
+
+    - kind: SetVariable
+      id: setVariable_V6yEbo
+      displayName: Get a summary of all the agents for use in prompts
+      variable: Topic.TeamDescription
+      value: "=Concat(ForAll(Topic.AvailableAgents, $\"- \" & name & $\": \" & description), Value, \"\n\")"
+
+    - kind: SetVariable
+      id: setVariable_NZ2u0l
+      displayName: Set Task
+      variable: Topic.InputTask
+      value: =System.LastMessage.Text
+
+    - kind: SetVariable
+      id: setVariable_10u2ZN
+      displayName: Set Task
+      variable: Topic.SeedTask
+      value: =Topic.InputTask
+
+    - kind: SendActivity
+      id: sendActivity_yFsbRy
+      activity: Analyzing facts...
+
+    - kind: CreateConversation
+      id: conversation_1a2b3c
+      conversationId: Topic.InternalConversationId
+
+    - kind: InvokeAzureAgent
+      id: question_UDoMUw
+      displayName: Get Facts
+      conversationId: =Topic.InternalConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_RESEARCHANALYST
+      output:
+        messages: Topic.TaskFacts
+      input:
+        messages: =[UserMessage(Topic.InputTask)]
+        additionalInstructions: |-
+          In order to help begin addressing the user request, please answer the following pre-survey to the best of your ability. 
+          Keep in mind that you are Ken Jennings-level with trivia, and Mensa-level with puzzles, so there should be a deep well to draw from.
+
+          Here is the pre-survey:
+
+              1. Please list any specific facts or figures that are GIVEN in the request itself. It is possible that there are none.
+              2. Please list any facts that may need to be looked up, and WHERE SPECIFICALLY they might be found. In some cases, authoritative sources are mentioned in the request itself.
+              3. Please list any facts that may need to be derived (e.g., via logical deduction, simulation, or computation)
+              4. Please list any facts that are recalled from memory, hunches, well-reasoned guesses, etc.
+
+          When answering this survey, keep in mind that 'facts' will typically be specific names, dates, statistics, etc. Your answer must only use the headings:
+
+              1. GIVEN OR VERIFIED FACTS
+              2. FACTS TO LOOK UP
+              3. FACTS TO DERIVE
+              4. EDUCATED GUESSES
+
+          DO NOT include any other headings or sections in your response. DO NOT list next steps or plans until asked to do so.
+
+    - kind: SendActivity
+      id: sendActivity_yFsbRz
+      activity: Creating a plan...
+
+    - kind: InvokeAzureAgent
+      id: question_DsBaJU
+      displayName: Create a Plan
+      conversationId: =Topic.InternalConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_RESEARCHMANAGER
+      output:
+        messages: Topic.Plan
+      input:
+        messages: =[UserMessage(Topic.InputTask)]
+        additionalInstructions: |-
+          Your only job is to devise an efficient plan that identifies (by name) how a team member may contribute to addressing the user request.
+
+          Only select the following team which is listed as "- [Name]: [Description]"
+
+          {Topic.TeamDescription}
+
+          The plan must be a bullet point list must be in the form "- [AgentName]: [Specific action or task for that agent to perform]"
+  
+          Remember, there is no requirement to involve the entire team -- only select team member's whose particular expertise is required for this task.
+
+    - kind: SetVariable
+      id: setVariable_Kk2LDL
+      displayName: Define instructions
+      variable: Topic.TaskInstructions
+      value: |-
+        ="# TASK
+        Address the following user request:
+
+        " & Topic.InputTask & "
+
+
+        # TEAM
+        Use the following team to answer this request:
+
+        " & Topic.TeamDescription & "
+
+
+        # FACTS
+        Consider this initial fact sheet:
+
+        " & Trim(Topic.TaskFacts.Text) & "
+
+
+        # PLAN
+        Here is the plan to follow as best as possible:
+  
+        " & Topic.Plan.Text
+
+    - kind: SendActivity
+      id: sendActivity_bwNZiM
+      activity: {Topic.TaskInstructions}
+
+    - kind: InvokeAzureAgent
+      id: question_o3BQkf
+      displayName: Progress Ledger Prompt
+      conversationId: =Topic.InternalConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_RESEARCHMANAGER
+      output:
+        messages: Topic.ProgressLedgerUpdate
+      input:
+        messages: =[UserMessage(Topic.AgentResponseText)]
+        additionalInstructions: |-
+          Recall we are working on the following request:
+
+          {Topic.InputTask}
+
+          And we have assembled the following team:
+
+          {Topic.TeamDescription}
+
+          To make progress on the request, please answer the following questions, including necessary reasoning:
+
+              - Is the request fully satisfied? (True if complete, or False if the original request has yet to be SUCCESSFULLY and FULLY addressed)
+              - Are we in a loop where we are repeating the same requests and / or getting the same responses from an agent multiple times? Loops can span multiple turns, and can include repeated actions like scrolling up or down more than a handful of times.
+              - Are we making forward progress? (True if just starting, or recent messages are adding value. False if recent messages show evidence of being stuck in a loop or if there is evidence of significant barriers to success such as the inability to read from a required file)
+              - Who should speak next? (select from: {Concat(Topic.AvailableAgents, name, ",")}) 
+              - What instruction or question would you give this team member? (Phrase as if speaking directly to them, and include any specific information they may need)
+
+          Please output an answer in pure JSON format according to the following schema. The JSON object must be parsable as-is. DO NOT OUTPUT ANYTHING OTHER THAN JSON, AND DO NOT DEVIATE FROM THIS SCHEMA:
+
+              {{
+                  "is_request_satisfied": {{
+                      "reason": string,
+                      "answer": boolean
+                  }},
+                  "is_in_loop": {{
+                      "reason": string,
+                      "answer": boolean
+                  }},
+                  "is_progress_being_made": {{
+                      "reason": string,
+                      "answer": boolean
+                  }},
+                  "next_speaker": {{
+                      "reason": string,
+                      "answer": string (select from: {Concat(Topic.AvailableAgents, name, ",")})
+                  }},
+                  "instruction_or_question": {{
+                      "reason": string,
+                      "answer": string
+                  }}
+              }}
+
+    - kind: ParseValue
+      id: parse_rNZtlV
+      displayName: Parse ledger response
+      variable: Topic.TypedProgressLedger
+      value: =Topic.ProgressLedgerUpdate.Text
+      valueType:
+        kind: Record
+        properties:
+          instruction_or_question:
+            type:
+              kind: Record
+              properties:
+                answer: String
+                reason: String
+
+          is_in_loop:
+            type:
+              kind: Record
+              properties:
+                answer: Boolean
+                reason: String
+
+          is_progress_being_made:
+            type:
+              kind: Record
+              properties:
+                answer: Boolean
+                reason: String
+
+          is_request_satisfied:
+            type:
+              kind: Record
+              properties:
+                answer: Boolean
+                reason: String
+
+          next_speaker:
+            type:
+              kind: Record
+              properties:
+                answer: String
+                reason: String
+
+    - kind: ConditionGroup
+      id: conditionGroup_mVIecC
+      conditions:
+        - id: conditionItem_fj432c
+          condition: =Topic.TypedProgressLedger.is_request_satisfied.answer
+          displayName: If Done
+          actions:
+
+            - kind: SendActivity
+              id: sendActivity_kdl3mC
+              activity: Completed! {Topic.TypedProgressLedger.is_request_satisfied.reason}
+
+            - kind: InvokeAzureAgent
+              id: question_Ke3l1d
+              displayName: Generate Response
+              conversationId: =System.ConversationId
+              agent:
+                name: =Env.FOUNDRY_AGENT_RESEARCHMANAGER
+              output:
+                messages: Topic.FinalResponse
+              input:
+                messages: =[UserMessage(Topic.SeedTask)]
+                additionalInstructions: |-
+                  We have completed the task.
+                  Based only on the conversation and without adding any new information, synthesize the result of the conversation as a complete response to the user task.
+                  The user will only every see this last response and not the entire conversation, so please ensure it is complete and self-contained.
+
+            - kind: EndConversation
+              id: end_SVoNSV
+
+        - id: conditionItem_yiqund
+          condition: =Topic.TypedProgressLedger.is_in_loop.answer || Not(Topic.TypedProgressLedger.is_progress_being_made.answer)
+          displayName: If Stalling
+          actions:
+    
+            - kind: SetVariable
+              id: setVariable_H5lXdD
+              displayName: Increase stall count
+              variable: Topic.StallCount
+              value: =Topic.StallCount + 1
+
+
+            - kind: ConditionGroup
+              id: conditionGroup_vBTQd3
+              conditions:
+
+                - id: conditionItem_fpaNL9
+                  condition: =.TypedProgressLedger.is_in_loop.answer
+                  displayName: Is Loop
+                  actions:
+                    - kind: SendActivity
+                      id: sendActivity_fpaNL9
+                      activity: {Topic.TypedProgressLedger.is_in_loop.reason}
+
+                - id: conditionItem_NnqvXh
+                  condition: =Not(Topic.TypedProgressLedger.is_progress_being_made.answer)
+                  displayName: Is No Progress
+                  actions:
+                    - kind: SendActivity
+                      id: sendActivity_NnqvXh
+                      activity: {Topic.TypedProgressLedger.is_progress_being_made.reason}
+
+
+            - kind: ConditionGroup
+              id: conditionGroup_xzNrdM
+              conditions:
+                - id: conditionItem_NlQTBv
+                  condition: =Topic.StallCount > 2
+                  displayName: Stall Count Exceeded
+                  actions:
+
+                    - kind: SendActivity
+                      id: sendActivity_H5lXdD
+                      activity: Unable to make sufficient progress...
+
+                    - kind: ConditionGroup
+                      id: conditionGroup_4s1Z27
+                      conditions:
+                        - id: conditionItem_EXAlhZ
+                          condition: =Topic.RestartCount > 2
+                          actions:
+                            - kind: SendActivity
+                              id: sendActivity_xKxFUU
+                              activity: Stopping after attempting {Topic.RestartCount} restarts...
+
+                            - kind: EndConversation
+                              id: end_GHVrFh
+
+                    - kind: SendActivity
+                      id: sendActivity_cwNZiM
+                      activity: Re-analyzing facts...
+
+                    - kind: InvokeAzureAgent
+                      id: question_wFJ123
+                      displayName: Get New Facts Prompt
+                      conversationId: =Topic.InternalConversationId
+                      agent:
+                        name: =Env.FOUNDRY_AGENT_RESEARCHANALYST
+                      output:
+                        messages: Topic.TaskFacts
+                      input:
+                        messages: |-
+                          =[
+                            UserMessage(
+                            "As a reminder, we are working to solve the following task:
+
+                            " & Topic.InputTask)
+                          ]
+                        additionalInstructions: |-
+                          It's clear we aren't making as much progress as we would like, but we may have learned something new.
+                          Please rewrite the following fact sheet, updating it to include anything new we have learned that may be helpful. 
+                          Example edits can include (but are not limited to) adding new guesses, moving educated guesses to verified facts if appropriate, etc. 
+                          Updates may be made to any section of the fact sheet, and more than one section of the fact sheet can be edited. 
+                          This is an especially good time to update educated guesses, so please at least add or update one educated guess or hunch, and explain your reasoning.
+
+                          Here is the old fact sheet:
+
+                          {Topic.TaskFacts}
+
+                    - kind: SendActivity
+                      id: sendActivity_dsBaJU
+                      activity: Re-analyzing plan...
+                      
+                    - kind: InvokeAzureAgent
+                      id: question_uEJ456
+                      displayName: Create new Plan Prompt
+                      conversationId: =Topic.InternalConversationId
+                      agent:
+                        name: =Env.FOUNDRY_AGENT_RESEARCHMANAGER
+                      output:
+                        messages: Topic.Plan
+                      input:
+                        additionalInstructions: |-
+                          Please briefly explain what went wrong on this last run (the root cause of the failure),
+                          and then come up with a new plan that takes steps and/or includes hints to overcome prior challenges and especially avoids repeating the same mistakes. 
+                          As before, the new plan should be concise, be expressed in bullet-point form, and consider the following team composition
+                          (do not involve any other outside people since we cannot contact anyone else):
+
+                          {Topic.TeamDescription}
+
+                    - kind: SetVariable
+                      id: setVariable_jW7tmM
+                      displayName: Set Plan as Context
+                      variable: Topic.TaskInstructions
+                      value: |-
+                        ="# TASK
+                        Address the following user request:
+
+                        " & Topic.InputTask & "
+
+
+                        # TEAM
+                        Use the following team to answer this request:
+
+                        " & Topic.TeamDescription & "
+                        
+
+                        # FACTS
+                        Consider this initial fact sheet:
+
+                        " & Topic.TaskFacts.Text & "
+
+
+                        # PLAN
+                        Here is the plan to follow as best as possible:
+  
+                        " & Topic.Plan.Text
+
+                    - kind: SetVariable
+                      id: setVariable_6J2snP
+                      displayName: Reset Stall count
+                      variable: Topic.StallCount
+                      value: 0
+
+                    - kind: SetVariable
+                      id: setVariable_S6HCgh
+                      displayName: Increase Restart count
+                      variable: Topic.RestartCount
+                      value: =Topic.RestartCount + 1
+
+                    - kind: GotoAction
+                      id: goto_LzfJ8u
+                      actionId: question_o3BQkf
+
+      elseActions:
+        - kind: SendActivity
+          id: sendActivity_L7ooQO
+          activity: |-
+           ({Topic.TypedProgressLedger.next_speaker.reason})
+
+           {Topic.TypedProgressLedger.next_speaker.answer} - {Topic.TypedProgressLedger.instruction_or_question.answer}
+
+        - kind: SetVariable
+          id: setVariable_L7ooQO
+          variable: Topic.StallCount
+          value: 0
+
+    - kind: SetVariable
+      id: setVariable_nxN1mE
+      variable: Topic.NextSpeaker
+      value: =Search(Topic.AvailableAgents, Topic.TypedProgressLedger.next_speaker.answer, name)
+
+    - kind: ConditionGroup
+      id: conditionGroup_QFPiF5
+      conditions:
+        - id: conditionItem_GmigcU
+          condition: =CountRows(Topic.NextSpeaker) = 1
+          displayName: If next Agent tool Exists
+          actions:
+
+            - kind: InvokeAzureAgent
+              id: question_orsBf06
+              displayName: Progress Ledger Prompt
+              conversationId: =System.ConversationId
+              agent:
+                name: =First(Topic.NextSpeaker).agentid
+              output:
+                messages: Topic.AgentResponse
+              input:
+                messages: =[UserMessage(Topic.SeedTask)]
+                additionalInstructions: |-
+                  {Topic.TypedProgressLedger.instruction_or_question.answer}
+
+            - kind: SetVariable
+              id: setVariable_XzNrdM
+              variable: Topic.AgentResponseText
+              value: =Topic.AgentResponse.Text
+
+            - kind: ResetVariable
+              id: setVariable_8eIx2A
+              displayName: Clear seed task
+              variable: Topic.SeedTask
+
+      elseActions:
+        - kind: SendActivity
+          id: sendActivity_BhcsI7
+          activity: Unable to choose next agent...
+
+        - kind: SetVariable
+          id: setVariable_BhcsI7
+          displayName: Increase stall count
+          variable: Topic.StallCount
+          value: =Topic.StallCount + 1
+
+    - kind: GotoAction
+      id: goto_76Hne8
+      actionId: question_o3BQkf
@@ -0,0 +1,63 @@
+#
+# This workflow demonstrates a single agent interaction based on user input.
+#
+# Any Foundry Agent may be used to provide the response.
+# See: ./setup/QuestionAgent.yaml
+#
+kind: AdaptiveDialog
+beginDialog:
+
+  kind: OnActivity
+  id: workflow_demo
+  actions:
+  
+    # Capture original input
+    - kind: SetVariable
+      id: set_project
+      variable: Topic.OriginalInput
+      value: =System.LastMessage.Text
+
+    # Request input from user
+    - kind: Question
+      id: question_confirm
+      alwaysPrompt: false
+      property: Topic.ConfirmedInput
+      prompt:
+        kind: Message
+        text:
+            - "CONFIRM:"
+      entity:
+        kind: StringPrebuiltEntity
+
+    # Confirm input
+    - kind: ConditionGroup
+      id: check_completion
+      conditions:
+
+        # Didn't match
+        - condition: =Topic.OriginalInput <> Topic.ConfirmedInput
+          id: check_confirm
+          actions:
+
+            - kind: SendActivity
+              id: sendActivity_mismatch
+              activity: |-
+                "{Topic.ConfirmedInput}" does not match the original input of "{Topic.OriginalInput}". Please try again.
+
+            - kind: GotoAction
+              id: goto_again
+              actionId: question_confirm
+
+      # Confirmed
+      elseActions:
+        - kind: SendActivity
+          id: sendActivity_confirmed
+          activity: |-
+            You entered:
+            {Topic.OriginalInput}
+
+            Confirmed input:
+            {Topic.ConfirmedInput}
+
+
+
@@ -0,0 +1,46 @@
+#
+# This workflow demonstrates a single agent interaction based on user input.
+#
+# Any Foundry Agent may be used to provide the response.
+# See: ./setup/QuestionAgent.yaml
+#
+kind: AdaptiveDialog
+beginDialog:
+
+  kind: OnActivity
+  id: workflow_demo
+  actions:
+
+    - kind: InvokeAzureAgent
+      id: invoke_analyst
+      conversationId: =System.ConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_ANSWER
+      input:
+        messages: =[UserMessage(System.LastMessageText)]
+        additionalInstructions: |-
+          You are a marketing analyst. Given a product description, identify:
+          - Key features
+          - Target audience
+          - Unique selling points          
+
+    - kind: InvokeAzureAgent
+      id: invoke_writer
+      conversationId: =System.ConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_ANSWER
+      input:
+        additionalInstructions: |-
+          You are a marketing copywriter. Given a block of text describing features, audience, and USPs,
+          compose a compelling marketing copy (like a newsletter section) that highlights these points.
+          Output should be short (around 150 words), output just the copy as a single text block.
+
+    - kind: InvokeAzureAgent
+      id: invoke_editor
+      conversationId: =System.ConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_ANSWER
+      input:
+        additionalInstructions: |-
+          You are an editor. Given the draft copy, correct grammar, improve clarity, ensure consistent tone,
+          give format and make it polished. Output the final improved copy as a single text block.
@@ -0,0 +1,88 @@
+#
+# This workflow demonstrates conversation between two agents: a student and a teacher.
+# The student attempts to solve the input problem and the teacher provides guidance.
+#
+# For this workflow, two agents are used, each with a prompt specific to their role.
+#
+# Student:
+# See: ./setup/StudentAgent.yaml
+#
+# With instructions: 
+#    
+# Your job is help a math teacher practice teaching by making intentional mistakes.  
+# You Attempt to solve the given math problem, but with intentional mistakes so the teacher can help.
+# Always incorporate the teacher's advice to fix your next response.
+# You have the math-skills of a 6th grader.    
+
+# Teacher:
+# See: ./setup/TeacherAgent.yaml
+#
+# With instructions: 
+#    
+# Review and coach the student's approach to solving the given math problem.  
+# Don't repeat the solution or try and solve it.  
+# If the student has demonstrated comprehension and responded to all of your feedback, 
+# give the student your congraluations by using the word "congratulations".    
+#
+kind: AdaptiveDialog
+beginDialog:
+
+  kind: OnActivity
+  id: workflow_demo
+  actions:
+
+    - kind: SetVariable
+      id: set_project
+      variable: Topic.Project
+      value: =System.LastMessage.Text
+
+    - kind: InvokeAzureAgent
+      id: question_student
+      conversationId: =System.ConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_STUDENT
+      input:
+        messages: =[UserMessage(Topic.Project)]
+
+    - kind: ResetVariable
+      id: reset_project
+      variable: Topic.Project
+
+    - kind: InvokeAzureAgent
+      id: question_teacher
+      conversationId: =System.ConversationId
+      agent:
+        name: =Env.FOUNDRY_AGENT_TEACHER
+      output:
+        messages: Topic.TeacherResponse
+
+    - kind: SetVariable
+      id: set_count_increment
+      variable: Topic.TurnCount
+      value: =Topic.TurnCount + 1
+
+    - kind: ConditionGroup
+      id: check_completion
+      conditions:
+
+        - condition: =!IsBlank(Find("CONGRATULATIONS", Upper(Topic.TeacherResponse.Text)))
+          id: check_turn_done
+          actions:
+
+            - kind: SendActivity
+              id: sendActivity_done
+              activity: GOLD STAR!
+    
+        - condition: =Topic.TurnCount < 4
+          id: check_turn_count
+          actions:
+    
+            - kind: GotoAction
+              id: goto_student_agent
+              actionId: question_student
+
+      elseActions:
+    
+        - kind: SendActivity
+          id: sendActivity_tired
+          activity: Let's try again later...
@@ -0,0 +1,27 @@
+# Declarative Workflows
+
+This folder contains sample workflow definitions than be ran using the
+[Declarative Workflow](../dotnet/samples/GettingStarted/Workflows/Declarative) demo.
+
+Each workflow is defined in a single YAML file and contains 
+comments with additional information specific to that workflow.
+
+A _Declarative Workflow_ may be executed locally no different from any `Workflow` defined by code.  
+The difference is that the workflow definition is loaded from a YAML file instead of being defined in code.
+
+```c#
+Workflow<string> workflow = DeclarativeWorkflowBuilder.Build<string>("HelloWorld.yaml", options);
+```
+
+Workflows may also be hosted in your _Azure Foundry Project_.
+
+> _Python_ support in the works!
+
+#### Agents
+
+The sample workflows rely on agents defined in your Azure Foundry Project.
+
+To create agents, run the [`Create.ps1`](./setup) script.
+This will create the agents used in the sample workflows in your Azure Foundry Project and format a script you can copy and use to configure your environment.
+
+> Note: `Create.ps1` relies upon the `FOUNDRY_PROJECT_ENDPOINT` setting.  See [README.md](../dotnet/demos/DeclarativeWorkflow/README.md) from the demo for configuration details.
@@ -0,0 +1,405 @@
+## Ignore Visual Studio temporary files, build results, and
+## files generated by popular Visual Studio add-ons.
+##
+## Get latest from https://github.com/github/gitignore/blob/main/VisualStudio.gitignore
+
+# User-specific files
+*.rsuser
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# User-specific files (MonoDevelop/Xamarin Studio)
+*.userprefs
+
+# Mono auto generated files
+mono_crash.*
+
+# Build results
+[Dd]ebug/
+[Dd]ebugPublic/
+[Rr]elease/
+[Rr]eleases/
+x64/
+x86/
+[Ww][Ii][Nn]32/
+[Aa][Rr][Mm]/
+[Aa][Rr][Mm]64/
+[Aa][Rr][Mm]64[Ee][Cc]/
+bld/
+[Bb]in/
+[Oo]bj/
+[Ll]og/
+[Ll]ogs/
+
+# Visual Studio 2015/2017 cache/options directory
+.vs/
+# Uncomment if you have tasks that create the project's static files in wwwroot
+#wwwroot/
+
+# Visual Studio 2017 auto generated files
+Generated\ Files/
+
+# MSTest test Results
+[Tt]est[Rr]esult*/
+[Bb]uild[Ll]og.*
+
+# NUnit
+*.VisualState.xml
+TestResult.xml
+nunit-*.xml
+
+# Build Results of an ATL Project
+[Dd]ebugPS/
+[Rr]eleasePS/
+dlldata.c
+
+# Benchmark Results
+BenchmarkDotNet.Artifacts/
+
+# .NET Core
+project.lock.json
+project.fragment.lock.json
+artifacts/
+
+# ASP.NET Scaffolding
+ScaffoldingReadMe.txt
+
+# StyleCop
+StyleCopReport.xml
+
+# Files built by Visual Studio
+*_i.c
+*_p.c
+*_h.h
+*.ilk
+*.meta
+*.obj
+*.iobj
+*.pch
+*.pdb
+*.ipdb
+*.pgc
+*.pgd
+*.rsp
+# but not Directory.Build.rsp, as it configures directory-level build defaults
+!Directory.Build.rsp
+*.sbr
+*.tlb
+*.tli
+*.tlh
+*.tmp
+*.tmp_proj
+*_wpftmp.csproj
+*.log
+*.tlog
+*.vspscc
+*.vssscc
+.builds
+*.pidb
+*.svclog
+*.scc
+
+# Chutzpah Test files
+_Chutzpah*
+
+# Visual C++ cache files
+ipch/
+*.aps
+*.ncb
+*.opendb
+*.opensdf
+*.sdf
+*.cachefile
+*.VC.db
+*.VC.VC.opendb
+
+# Visual Studio profiler
+*.psess
+*.vsp
+*.vspx
+*.sap
+
+# Visual Studio Trace Files
+*.e2e
+
+# TFS 2012 Local Workspace
+$tf/
+
+# Guidance Automation Toolkit
+*.gpState
+
+# ReSharper is a .NET coding add-in
+_ReSharper*/
+*.[Rr]e[Ss]harper
+*.DotSettings.user
+
+# TeamCity is a build add-in
+_TeamCity*
+
+# DotCover is a Code Coverage Tool
+*.dotCover
+
+# AxoCover is a Code Coverage Tool
+.axoCover/*
+!.axoCover/settings.json
+
+# Coverlet is a free, cross platform Code Coverage Tool
+coverage*.json
+coverage*.xml
+coverage*.info
+
+# Visual Studio code coverage results
+*.coverage
+*.coveragexml
+
+# NCrunch
+_NCrunch_*
+.NCrunch_*
+.*crunch*.local.xml
+nCrunchTemp_*
+
+# MightyMoose
+*.mm.*
+AutoTest.Net/
+
+# Web workbench (sass)
+.sass-cache/
+
+# Installshield output folder
+[Ee]xpress/
+
+# DocProject is a documentation generator add-in
+DocProject/buildhelp/
+DocProject/Help/*.HxT
+DocProject/Help/*.HxC
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/Html2
+DocProject/Help/html
+
+# Click-Once directory
+publish/
+
+# Publish Web Output
+*.[Pp]ublish.xml
+*.azurePubxml
+# Note: Comment the next line if you want to checkin your web deploy settings,
+# but database connection strings (with potential passwords) will be unencrypted
+*.pubxml
+*.publishproj
+
+# Microsoft Azure Web App publish settings. Comment the next line if you want to
+# checkin your Azure Web App publish settings, but sensitive information contained
+# in these scripts will be unencrypted
+PublishScripts/
+
+# NuGet Packages
+*.nupkg
+# NuGet Symbol Packages
+*.snupkg
+# The packages folder can be ignored because of Package Restore
+**/[Pp]ackages/*
+# except build/, which is used as an MSBuild target.
+!**/[Pp]ackages/build/
+# Uncomment if necessary however generally it will be regenerated when needed
+#!**/[Pp]ackages/repositories.config
+# NuGet v3's project.json files produces more ignorable files
+*.nuget.props
+*.nuget.targets
+
+# Microsoft Azure Build Output
+csx/
+*.build.csdef
+
+# Microsoft Azure Emulator
+ecf/
+rcf/
+
+# Windows Store app package directories and files
+AppPackages/
+BundleArtifacts/
+Package.StoreAssociation.xml
+_pkginfo.txt
+*.appx
+*.appxbundle
+*.appxupload
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!?*.[Cc]ache/
+
+# Others
+ClientBin/
+~$*
+*~
+*.dbmdl
+*.dbproj.schemaview
+*.jfm
+*.pfx
+*.publishsettings
+orleans.codegen.cs
+
+# Including strong name files can present a security risk
+# (https://github.com/github/gitignore/pull/2483#issue-259490424)
+#*.snk
+
+# Since there are multiple workflows, uncomment next line to ignore bower_components
+# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
+#bower_components/
+
+# RIA/Silverlight projects
+Generated_Code/
+
+# Backup & report files from converting an old project file
+# to a newer Visual Studio version. Backup files are not needed,
+# because we have git ;-)
+_UpgradeReport_Files/
+Backup*/
+UpgradeLog*.XML
+UpgradeLog*.htm
+ServiceFabricBackup/
+*.rptproj.bak
+
+# SQL Server files
+*.mdf
+*.ldf
+*.ndf
+
+# Business Intelligence projects
+*.rdl.data
+*.bim.layout
+*.bim_*.settings
+*.rptproj.rsuser
+*- [Bb]ackup.rdl
+*- [Bb]ackup ([0-9]).rdl
+*- [Bb]ackup ([0-9][0-9]).rdl
+
+# Microsoft Fakes
+FakesAssemblies/
+
+# GhostDoc plugin setting file
+*.GhostDoc.xml
+
+# Node.js Tools for Visual Studio
+.ntvs_analysis.dat
+node_modules/
+
+# Visual Studio 6 build log
+*.plg
+
+# Visual Studio 6 workspace options file
+*.opt
+
+# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
+*.vbw
+
+# Visual Studio 6 auto-generated project file (contains which files were open etc.)
+*.vbp
+
+# Visual Studio 6 workspace and project file (working project files containing files to include in project)
+*.dsw
+*.dsp
+
+# Visual Studio 6 technical files
+*.ncb
+*.aps
+
+# Visual Studio LightSwitch build output
+**/*.HTMLClient/GeneratedArtifacts
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+_Pvt_Extensions
+
+# Paket dependency manager
+.paket/paket.exe
+paket-files/
+
+# FAKE - F# Make
+.fake/
+
+# CodeRush personal settings
+.cr/personal
+
+# Python Tools for Visual Studio (PTVS)
+__pycache__/
+*.pyc
+
+# Cake - Uncomment if you are using it
+# tools/**
+# !tools/packages.config
+
+# Tabs Studio
+*.tss
+
+# Telerik's JustMock configuration file
+*.jmconfig
+
+# BizTalk build output
+*.btp.cs
+*.btm.cs
+*.odx.cs
+*.xsd.cs
+
+# OpenCover UI analysis results
+OpenCover/
+
+# Azure Stream Analytics local run output
+ASALocalRun/
+
+# MSBuild Binary and Structured Log
+*.binlog
+
+# AWS SAM Build and Temporary Artifacts folder
+.aws-sam
+
+# NVidia Nsight GPU debugger configuration file
+*.nvuser
+
+# MFractors (Xamarin productivity tool) working folder
+.mfractor/
+
+# Local History for Visual Studio
+.localhistory/
+
+# Visual Studio History (VSHistory) files
+.vshistory/
+
+# BeatPulse healthcheck temp database
+healthchecksdb
+
+# Backup folder for Package Reference Convert tool in Visual Studio 2017
+MigrationBackup/
+
+# Ionide (cross platform F# VS Code tools) working folder
+.ionide/
+
+# Fody - auto-generated XML schema
+FodyWeavers.xsd
+
+# VS Code files for those working on multiple tools
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+
+# Local History for Visual Studio Code
+.history/
+
+# Windows Installer files from build outputs
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# JetBrains Rider
+*.sln.iml
@@ -0,0 +1,10 @@
+type: foundry_agent
+name: ResearchAnalyst
+description: Demo agent for DeepResearch workflow
+model:
+  id: ${AzureAI:ModelDeployment}
+tools:
+  - type: bing_grounding
+    options:
+      tool_connections:
+        - ${AzureAI:BingConnectionId}
@@ -0,0 +1,7 @@
+type: foundry_agent
+name: ResearchCoder
+description: Demo agent for DeepResearch workflow
+model:
+  id: ${AzureAI:ModelDeployment}
+tools:
+  - type: code_interpreter
@@ -0,0 +1,3 @@
+pushd ./CreateAgents
+dotnet run
+popd
@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <UserSecretsId>5ee045b0-aea3-4f08-8d31-32d1a6f8fed0</UserSecretsId>
+    <NoWarn>SKEXP0110</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.8" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="9.0.8" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="9.0.8" />
+    <PackageReference Include="Microsoft.SemanticKernel.Agents.AzureAI" Version="1.64.0-preview" />
+    <PackageReference Include="Microsoft.SemanticKernel.Agents.Yaml" Version="1.64.0-beta" />
+  </ItemGroup>
+
+</Project>
@@ -0,0 +1,15 @@
+<Solution>
+  <Folder Name="/Agents/">
+    <File Path="../AnalystAgent.yaml" />
+    <File Path="../CoderAgent.yaml" />
+    <File Path="../Create.ps1" />
+    <File Path="../ManagerAgent.yaml" />
+    <File Path="../QuestionAgent.yaml" />
+    <File Path="../README.md" />
+    <File Path="../StudentAgent.yaml" />
+    <File Path="../TeacherAgent.yaml" />
+    <File Path="../WeatherAgent.yaml" />
+    <File Path="../WebAgent.yaml" />
+  </Folder>
+  <Project Path="CreateAgents.csproj" />
+</Solution>
@@ -0,0 +1,68 @@
+using Azure.AI.Agents.Persistent;
+using Azure.AI.Projects;
+using Azure.Identity;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents;
+using Microsoft.SemanticKernel.Agents.AzureAI;
+using System.Reflection;
+using System.Text;
+
+// Define FOUNDRY_PROJECT_ENDPOINT as a user-secret or environment variable that
+// points to your Foundry project endpoint.
+
+IConfigurationRoot config =
+        new ConfigurationBuilder()
+            .AddUserSecrets(Assembly.GetExecutingAssembly())
+            .AddEnvironmentVariables()
+            .Build();
+
+string projectEndpoint = config["FOUNDRY_PROJECT_ENDPOINT"] ?? throw new InvalidOperationException("Undefined configuration: FOUNDRY_PROJECT_ENDPOINT");
+Console.WriteLine($"{Environment.NewLine}Foundry: {projectEndpoint}");
+
+StringBuilder scriptBuilder = new();
+StringBuilder secretBuilder = new();
+string[] files = args.Length > 0 ? args : Directory.GetFiles(@"..\", "*.yaml");
+foreach (string file in files)
+{
+    string agentText = await File.ReadAllTextAsync(file);
+
+    PersistentAgentsClient clientAgents = new(projectEndpoint, new AzureCliCredential());
+
+    AIProjectClient clientProject = new(new Uri(projectEndpoint), new AzureCliCredential());
+
+    IKernelBuilder kernelBuilder = Kernel.CreateBuilder();
+    kernelBuilder.Services.AddSingleton(clientAgents);
+    kernelBuilder.Services.AddSingleton(clientProject);
+    Kernel kernel = kernelBuilder.Build();
+
+    AzureAIAgentFactory factory = new();
+    Agent? agent = await factory.CreateAgentFromYamlAsync(agentText, new AgentCreationOptions() { Kernel = kernel }, config);
+    if (agent is null)
+    {
+        Console.WriteLine("Unexpected failure creating agent...");
+        continue;
+    }    
+
+    Console.WriteLine();
+    Console.WriteLine(Path.GetFileName(file));
+    Console.WriteLine($"  Id:   {agent?.Id ?? "???"}");
+    Console.WriteLine($"  Name: {agent?.Name ?? agent?.Id}");
+    Console.WriteLine($"  Note: {agent?.Description}");
+
+    scriptBuilder.AppendLine($"$env:FOUNDRY_AGENT_{agent?.Name?.ToUpperInvariant()} = '{agent?.Id}'");
+    secretBuilder.AppendLine($"dotnet user-secrets set FOUNDRY_AGENT_{agent?.Name?.ToUpperInvariant()} {agent?.Id}");
+}
+
+Console.WriteLine();
+Console.WriteLine();
+Console.WriteLine("To set these environment variables in your shell, run:");
+Console.WriteLine();
+Console.WriteLine(scriptBuilder);
+Console.WriteLine();
+Console.WriteLine();
+Console.WriteLine("To define user secrets, run:");
+Console.WriteLine();
+Console.WriteLine(secretBuilder);
+Console.WriteLine();
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
+  </packageSources>
+  <packageSourceMapping>
+    <packageSource key="nuget.org">
+      <package pattern="*" />
+    </packageSource>
+  </packageSourceMapping>
+</configuration>
@@ -0,0 +1,5 @@
+type: foundry_agent
+name: ResearchManager
+description: Demo agent for DeepResearch workflow
+model:
+  id: ${AzureAI:ModelDeployment}
@@ -0,0 +1,10 @@
+type: foundry_agent
+name: Answer
+description: Demo agent for Question workflow
+model:
+  id: ${AzureAI:ModelDeployment}
+tools:
+  - type: bing_grounding
+    options:
+      tool_connections:
+        - ${AzureAI:BingConnectionId}
@@ -0,0 +1,14 @@
+# Agent Definitions
+
+The sample workflows rely on agents defined in your Azure Foundry Project.
+
+These agent definitions are based on _Semantic Kernel_'s _Declarative Agent_ feature:
+
+- [Semantic Kernel Agents](https://github.com/microsoft/semantic-kernel/tree/main/dotnet/src/Agents)
+- [Declarative Agent Extensions](https://github.com/microsoft/semantic-kernel/tree/main/dotnet/src/Agents/Yaml)
+- [Sample](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/samples/GettingStartedWithAgents/AzureAIAgent/Step08_AzureAIAgent_Declarative.cs)
+
+To create agents, run the [`Create.ps1`](./Create.ps1) script.
+This will create the agents for the sample workflows in your Azure Foundry Project and format a script you can copy and use to configure your environment.
+
+> Note: `Create.ps1` relies upon the `FOUNDRY_PROJECT_ENDPOINT` setting.  See [README.md](../../dotnet/demos/DeclarativeWorkflow/README.md) from the demo for configuration details.
@@ -0,0 +1,10 @@
+type: foundry_agent
+name: Student
+description: Student agent for MathChat workflow
+instructions: |-
+  Your job is help a math teacher practice teaching by making intentional mistakes.
+  You Attempt to solve the given math problem, but with intentional mistakes so the teacher can help.
+  Always incorporate the teacher's advice to fix your next response.
+  You have the math-skills of a 6th grader.
+model:
+  id: ${AzureAI:ModelDeployment}
@@ -0,0 +1,10 @@
+type: foundry_agent
+name: Teacher
+description: Teacher agent for MathChat workflow
+instructions: |-
+  Review and coach the student's approach to solving the given math problem.
+  Don't repeat the solution or try and solve it.
+  If the student has demonstrated comprehension and responded to all of your feedback,
+  give the student your congraluations by using the word "congratulations".
+model:
+  id: ${AzureAI:ModelDeployment}
@@ -0,0 +1,62 @@
+type: foundry_agent
+name: ResearchWeather
+description: Demo agent for DeepResearch workflow
+model:
+  id: ${AzureAI:ModelDeployment}
+tools:
+  - type: openapi
+    id: GetCurrentWeather
+    description: Retrieves current weather data for a location based on wttr.in.
+    options:
+      specification: |
+        {
+          "openapi": "3.1.0",
+          "info": {
+            "title": "Get weather data",
+            "description": "Retrieves current weather data for a location based on wttr.in.",
+            "version": "v1.0.0"
+          },
+          "servers": [
+            {
+              "url": "https://wttr.in"
+            }
+          ],
+          "paths": {
+            "/{location}": {
+              "get": {
+                "description": "Get weather information for a specific location",
+                "operationId": "GetCurrentWeather",
+                "parameters": [
+                  {
+                    "name": "location",
+                    "in": "path",
+                    "description": "City or location to retrieve the weather for",
+                    "required": true,
+                    "schema": {
+                      "type": "string"
+                    }
+                  }
+                ],
+                "responses": {
+                  "200": {
+                    "description": "Successful response",
+                    "content": {
+                      "text/plain": {
+                        "schema": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  },
+                  "404": {
+                    "description": "Location not found"
+                  }
+                },
+                "deprecated": false
+              }
+            }
+          },
+          "components": {
+            "schemas": {}
+          }
+        }
@@ -0,0 +1,15 @@
+type: foundry_agent
+name: ResearchWeb
+description: Demo agent for DeepResearch workflow
+instructions: |-
+  Only provide requested information in a way that is throughfully organized and formatted.
+  Never include any analysis or code.
+  Never generate a file.
+  Avoid repeating yourself.
+model:
+  id: ${AzureAI:ModelDeployment}
+tools:
+  - type: bing_grounding
+    options:
+      tool_connections:
+        - ${AzureAI:BingConnectionId}
@@ -0,0 +1,51 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "Get weather data",
+    "description": "Retrieves current weather data for a location based on wttr.in.",
+    "version": "v1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://wttr.in"
+    }
+  ],
+  "paths": {
+    "/{location}": {
+      "get": {
+        "description": "Get weather information for a specific location",
+        "operationId": "GetCurrentWeather",
+        "parameters": [
+          {
+            "name": "location",
+            "in": "path",
+            "description": "City or location to retrieve the weather for",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Location not found"
+          }
+        },
+        "deprecated": false
+      }
+    }
+  },
+  "components": {
+    "schemas": {}
+  }
+}