Add comments, improve human_in_the_loop sample

Author: AnatoliB

samples-v2/openai_agents/function_app.py

@@ -3,23 +3,24 @@
 from durable_decorators import durable_openai_agent_orchestrator
 from model_activity import create_invoke_model_activity
 
-import basic.hello_world
-
 app = func.FunctionApp(http_auth_level=func.AuthLevel.FUNCTION)
 
 
+# Regular HTTP trigger
 @app.route(route="orchestrators/{functionName}")
 @app.durable_client_input(client_name="client")
 async def orchestration_starter(req: func.HttpRequest, client):
     function_name = req.route_params.get('functionName')
+    # Starting a new orchestration instance in the most regular way
     instance_id = await client.start_new(function_name)
     response = client.create_check_status_response(req, instance_id)
     return response
 
 
-@app.orchestration_trigger(context_name="context")
-@durable_openai_agent_orchestrator
+@app.orchestration_trigger(context_name="context")  # Regular orchestrator function
+@durable_openai_agent_orchestrator  # This is what turns the magic on!
 def haiku(context):
+    # Regular OpenAI Agent code, straight from the most basic sample
     agent = Agent(
         name="Assistant",
         instructions="You only respond in haikus.",
@@ -51,12 +52,13 @@ def haiku_judge(context):
 
 @app.orchestration_trigger(context_name="context")
 @durable_openai_agent_orchestrator
-def hello_cities(context):
+def human_in_the_loop(context):
     writer = Agent(
         name="Writer",
         instructions="You only respond in haikus.",
     )
 
+    # You can invoke Durable Functions activities, like you normally would
     topic = yield context.call_activity("hello", "Seattle")
 
     haiku = Runner.run_sync(writer, f"Tell me about '{topic}'")
@@ -68,39 +70,20 @@ def hello_cities(context):
 
     evaluation = Runner.run_sync(judge, f"Is this a good haiku? {haiku.final_output}")
 
-    return [haiku.final_output, "\n\n" + evaluation.final_output]
-
-
-@app.activity_trigger(input_name="name")
-async def hello(name: str):
-    return f"Hello {name}!"
-
-
-
-@app.orchestration_trigger(context_name="context")
-@durable_openai_agent_orchestrator
-def human_in_the_loop(context):
-    writer = Agent(
-        name="Writer",
-        instructions="You only respond in haikus.",
-    )
-
-    haiku = Runner.run_sync(writer, "Tell me about recursion in programming.")
-
-    judge = Agent(
-        name="Judge",
-        instructions="You judge haikus.",
-    )
-
-    evaluation = Runner.run_sync(judge, f"Is this a good haiku? {haiku.final_output}")
-
+    # You can set custom orchestration status, like you normally would
     context.set_custom_status(f"Haiku:\n{haiku.final_output}\n\nEvaluation:\n{evaluation.final_output}\n\nWaiting for approval...")
+
+    # You can wait for external events, like you normally would
     event_data = yield context.wait_for_external_event("Approve")
-    context.set_custom_status("")
 
     reaction = Runner.run_sync(writer, f"Your haiku is considered {event_data}. React emotionally.")
 
-    return reaction.final_output 
+    return reaction.final_output
+
+
+@app.activity_trigger(input_name="name")
+async def hello(name: str):
+    return f"Hello {name}!"
 
 
 #region Implementation details