updated README and added order_returns folder

Author: bachuv

samples-v2/openai_agents/function_app.py

@@ -10,8 +10,7 @@
 from openai import AsyncAzureOpenAI
 
 from agents import set_default_openai_client
-from order_return_orchestrators import register_order_return_orchestrators
-
+from order_returns.order_return_orchestrators import register_order_return_orchestrators
 
 #region Regular Azure OpenAI setup
 

samples-v2/openai_agents/ORDER_RETURNS.md …v2/openai_agents/order_returns/README.mdsamples-v2/openai_agents/ORDER_RETURNS.md renamed to samples-v2/openai_agents/order_returns/README.md samples-v2/openai_agents/ORDER_RETURNS.md renamed to samples-v2/openai_agents/order_returns/README.md

@@ -1,14 +1,23 @@
-# Order Return Processing System
+# Order Return Processing Sample
 
-An order return processing system built with Azure Functions and OpenAI Agents, demonstrating advanced orchestration patterns and multi-agent workflows.
+This sample demonstrates an order return processing system built with Azure Durable Functions and OpenAI Agents. The system automatically processes customer return requests using AI agents to validate return reasons, process refunds, and route edge cases to human review.
 
-## Overview
+## Running the Sample
 
-This system automatically processes customer return requests using AI agents to validate return reasons, process refunds, and route edge cases to human review. It showcases real-world business logic implementation with Azure Durable Functions.
+**For complete setup instructions, configuration details, and troubleshooting, see the [Getting Started Guide](/docs/openai_agents/getting-started.md).**
 
-## Quick Start
+### Step 1: Start the Azure Functions App
+
+From the OpenAI Agents samples root directory (`/samples-v2/openai_agents`), start the Azure Functions host:
+
+```bash
+func start
+```
+
+The function app will start and listen on `http://localhost:7071` by default.
+
+### Step 2: Submit a Return Request
 
-### Submit a Return Request
 ```bash
 curl -X POST http://localhost:7071/api/order_return_processor \
   -H "Content-Type: application/json" \
@@ -21,12 +30,39 @@ curl -X POST http://localhost:7071/api/order_return_processor \
   }'
 ```
 
-### Check Processing Status
+### Step 3: Check Processing Status
+
 ```bash
 # Use the statusQueryGetUri from the submission response
 curl http://localhost:7071/runtime/webhooks/durabletask/instances/{instance_id}
 ```
 
+## Testing
+
+### Test Valid Return (Auto-Approve)
+
+```bash
+curl -X POST http://localhost:7071/api/order_return_processor \
+  -H "Content-Type: application/json" \
+  -d '{"order_id":"TEST-001","customer_id":"CUST-001","product_category":"Electronics","purchase_date":"2024-10-01","return_reason":"arrived damaged"}'
+```
+
+### Test Invalid Return (Human Review)
+
+```bash
+curl -X POST http://localhost:7071/api/order_return_processor \
+  -H "Content-Type: application/json" \
+  -d '{"order_id":"TEST-002","customer_id":"CUST-002","product_category":"Clothing","purchase_date":"2024-09-15","return_reason":"changed my mind"}'
+```
+
+### Check Status
+
+Use the `statusQueryGetUri` from the response to check the orchestration status:
+
+```bash
+curl {statusQueryGetUri_from_response}
+```
+
 ## API Reference
 
 ### Endpoints
@@ -36,7 +72,6 @@ curl http://localhost:7071/runtime/webhooks/durabletask/instances/{instance_id}
 | `POST` | `/api/order_return_processor` | Submit a new return request |
 | `GET` | `/runtime/webhooks/durabletask/instances/{instance_id}` | Check processing status |
 
-
 ### Request Schema
 
 ```json
@@ -71,6 +106,7 @@ curl http://localhost:7071/runtime/webhooks/durabletask/instances/{instance_id}
 ## Example Responses
 
 ### Successful Auto-Approval
+
 ```json
 {
   "status": "approved_and_processed",
@@ -91,6 +127,7 @@ curl http://localhost:7071/runtime/webhooks/durabletask/instances/{instance_id}
 ```
 
 ### Human Review Required
+
 ```json
 {
   "status": "pending_human_review",
@@ -118,31 +155,9 @@ The system uses a multi-agent orchestration pattern:
 ## File Structure
 
 ```
-basic/
-├── order_return_validation.py    # Validation agent
-└── refund_processing.py          # Refund processing agent
-
-order_return_orchestrators.py     # Main orchestration logic
-test_order_return.py              # Testing examples and utilities
-```
-
-## Testing
-
-```bash
-# Start the function app
-func start
-
-# Test valid return (should auto-approve)
-curl -X POST http://localhost:7071/api/order_return_processor \
-  -H "Content-Type: application/json" \
-  -d '{"order_id":"TEST-001","customer_id":"CUST-001","product_category":"Electronics","purchase_date":"2024-10-01","return_reason":"arrived damaged"}'
-
-# Test invalid return (should require human review)
-curl -X POST http://localhost:7071/api/order_return_processor \
-  -H "Content-Type: application/json" \
-  -d '{"order_id":"TEST-002","customer_id":"CUST-002","product_category":"Clothing","purchase_date":"2024-09-15","return_reason":"changed my mind"}'
-
-# Check status using the response from above requests
-# Look for "statusQueryGetUri" in the response and use that URL
-curl {statusQueryGetUri_from_response}
+order_returns/
+├── order_return_orchestrators.py  # Main orchestration logic
+├── order_return_validation.py     # Validation agent
+├── refund_processing.py           # Refund processing agent
+└── README.md                      # This file
 ```

…nai_agents/order_return_orchestrators.py …er_returns/order_return_orchestrators.pysamples-v2/openai_agents/order_return_orchestrators.py renamed to samples-v2/openai_agents/order_returns/order_return_orchestrators.py samples-v2/openai_agents/order_return_orchestrators.py renamed to samples-v2/openai_agents/order_returns/order_return_orchestrators.py

@@ -73,17 +73,17 @@ def order_return_processor(context: df.DurableOrchestrationContext):
     @app.durable_openai_agent_orchestrator
     def order_return_validation(context):
         """Sub-orchestration that validates return reasons using AI agent"""
-        import basic.order_return_validation
+        import order_returns.order_return_validation
         return_request = context.get_input()
-        return basic.order_return_validation.main(return_request)
+        return order_returns.order_return_validation.main(return_request)
 
     @app.orchestration_trigger(context_name="context")
     @app.durable_openai_agent_orchestrator
     def refund_processor(context):
         """Sub-orchestration that processes refunds using AI agent"""
-        import basic.refund_processing
+        import order_returns.refund_processing
         validation_data = context.get_input()
-        return basic.refund_processing.main(validation_data)
+        return order_returns.refund_processing.main(validation_data)
 
     @app.activity_trigger(input_name="review_data")
     async def route_for_human_review(review_data: dict) -> dict: