more fixes for the README.md and tracing visuals

demos/use_cases/travel_agents/README.md

@@ -1,6 +1,6 @@
 # Travel Booking Agent Demo
 
-A multi-agent travel booking system demonstrating Plano's intelligent agent routing and orchestration. This demo showcases two specialized agents working together to help users plan trips with weather information and flight searches.
+A multi-agent travel booking system demonstrating Plano's intelligent agent routing and orchestration capabilities. This demo showcases two specialized agents working together to help users plan trips with weather information and flight searches. All agent interactions are fully traced with OpenTelemetry-compatible tracing for complete observability.
 
 ## Overview
 
@@ -9,7 +9,7 @@ This demo consists of two intelligent agents that work together seamlessly:
 - **Weather Agent** - Real-time weather conditions and multi-day forecasts for any city worldwide
 - **Flight Agent** - Live flight information between airports with real-time tracking
 
-All agents use Plano's agent router to intelligently route user requests to the appropriate specialized agent based on conversation context and user intent. Both agents run as Docker containers for easy deployment.
+All agents use Plano's agent orchestration LLM to intelligently route user requests to the appropriate specialized agent based on conversation context and user intent. Both agents run as Docker containers for easy deployment.
 
 ## Features
 
@@ -17,14 +17,17 @@ All agents use Plano's agent router to intelligently route user requests to the
 - **Conversation Context**: Agents understand follow-up questions and references
 - **Real-Time Data**: Live weather and flight data from public APIs
 - **Multi-Day Forecasts**: Weather agent supports up to 16-day forecasts
-- **LLM-Powered**: Uses GPT-4o-mini for extraction and GPT-4o for responses
+- **LLM-Powered**: Uses GPT-4o-mini for extraction and GPT-5.2 for responses
 - **Streaming Responses**: Real-time streaming for better user experience
 
 ## Prerequisites
 
 - Docker and Docker Compose
-- [Plano CLI](https://docs.planoai.dev) installed
-- OpenAI API key
+- [Plano CLI](https://docs.planoai.dev/get_started/quickstart.html#prerequisites) installed
+- [OpenAI API key](https://platform.openai.com/api-keys)
+- [FlightAware AeroAPI key](https://www.flightaware.com/aeroapi/portal)
+
+> **Note:** You'll need to obtain a FlightAware AeroAPI key for live flight data. Visit [https://www.flightaware.com/aeroapi/portal](https://www.flightaware.com/aeroapi/portal) to get your API key.
 
 ## Quick Start
 
@@ -32,10 +35,9 @@ All agents use Plano's agent router to intelligently route user requests to the
 
 Create a `.env` file or export environment variables:
 
-> **Note:** You'll need to obtain a FlightAware AeroAPI key for live flight data. Visit [https://www.flightaware.com/aeroapi/portal](https://www.flightaware.com/aeroapi/portal) to get your API key.
-
 ```bash
 export AEROAPI_KEY="your-flightaware-api-key"
+export OPENAI_API_KEY="your OpenAI api key"
 ```
 
 ### 2. Start All Agents & Plano with Docker
@@ -54,7 +56,7 @@ This starts:
 
 Use Open WebUI at http://localhost:8080
 
-> **Note:** The Open WebUI may take a few minutes to start up and be fully ready. Please wait for the container to finish initializing before accessing the interface. Once ready, make sure to select the **gpt-4o** model from the model dropdown menu in the UI.
+> **Note:** The Open WebUI may take a few minutes to start up and be fully ready. Please wait for the container to finish initializing before accessing the interface. Once ready, make sure to select the **gpt-5.2** model from the model dropdown menu in the UI.
 
 ## Example Conversations
 
@@ -93,12 +95,19 @@ Assistant: [Both weather_agent and flight_agent respond simultaneously]
  [Docker]    [Docker]
 ```
 
-```
-
 Each agent:
 1. Extracts intent using GPT-4o-mini (with OpenTelemetry tracing)
 2. Fetches real-time data from APIs
-3. Generates response using GPT-4o
+3. Generates response using GPT-5.2
 4. Streams response back to user
 
 Both agents run as Docker containers and communicate with Plano via `host.docker.internal`.
+
+## Observability
+
+This demo includes full OpenTelemetry (OTel) compatible distributed tracing to monitor and debug agent interactions:
+The tracing data provides complete visibility into the multi-agent system, making it easy to identify bottlenecks, debug issues, and optimize performance.
+
+For more details on setting up and using tracing, see the [Plano Observability documentation](https://docs.planoai.dev/guides/observability/tracing.html).
+
+![alt text](tracing.png)