diff --git a/.gitignore b/.gitignore
index b7faf40..8fdba02 100644
--- a/.gitignore
+++ b/.gitignore
@@ -205,3 +205,5 @@ cython_debug/
marimo/_static/
marimo/_lsp/
__marimo__/
+
+endorsements.txt
diff --git a/demo/demo_template 1.pptx b/demo/demo_template 1.pptx
index b6c2514..867f8ee 100644
Binary files a/demo/demo_template 1.pptx and b/demo/demo_template 1.pptx differ
diff --git a/src/agent/attractions.ipynb b/src/agent/attractions.ipynb
index 7d7a7de..7dfbfd7 100644
--- a/src/agent/attractions.ipynb
+++ b/src/agent/attractions.ipynb
@@ -1,20 +1,27 @@
{
"cells": [
+ {
+ "cell_type": "markdown",
+ "id": "88a28606",
+ "metadata": {},
+ "source": [
+ "# Packing list agent"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4c8b4285",
+ "metadata": {},
+ "source": [
+ "## Setup"
+ ]
+ },
{
"cell_type": "code",
- "execution_count": 3,
+ "execution_count": null,
"id": "4a8c1aa1",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "python: c:\\WorkSpace\\Hackathon\\Hackathon-2025\\.venv\\Scripts\\python.exe\n",
- "uv: c:\\WorkSpace\\Hackathon\\Hackathon-2025\\.venv\\Scripts\\uv.EXE\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# Step to ensure that the venv is being used for the project not local copies, should point at .venv in project.\n",
"import sys, shutil\n",
@@ -24,27 +31,18 @@
},
{
"cell_type": "code",
- "execution_count": 4,
+ "execution_count": null,
+ "id": "c4532448",
+ "metadata": {},
+ "outputs": [],
+ "source": []
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
"id": "7c3a1676",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Requirement already satisfied: uv in c:\\workspace\\hackathon\\hackathon-2025\\.venv\\lib\\site-packages (0.8.20)\n",
- "Note: you may need to restart the kernel to use updated packages.\n"
- ]
- },
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "\u001b[2mUsing Python 3.13.3 environment at: c:\\WorkSpace\\Hackathon\\Hackathon-2025\\.venv\u001b[0m\n",
- "\u001b[2mAudited \u001b[1m13 packages\u001b[0m \u001b[2min 19ms\u001b[0m\u001b[0m\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# installs into the current Jupyter kernel environment\n",
"%pip install -U uv \n",
@@ -52,20 +50,20 @@
"!uv pip install -r requirements.txt"
]
},
+ {
+ "cell_type": "markdown",
+ "id": "32118a83",
+ "metadata": {},
+ "source": [
+ "## Defining functions"
+ ]
+ },
{
"cell_type": "code",
- "execution_count": 5,
+ "execution_count": null,
"id": "f6fdf3d8",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "✅ Updated imports with official MCP adapter loaded successfully!\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# LangChain + MCP Setup for Attractions Booking (HTTP-based for Jupyter)\n",
"import os\n",
@@ -94,18 +92,10 @@
},
{
"cell_type": "code",
- "execution_count": 6,
+ "execution_count": null,
"id": "f9bc6177",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "🔗 MCP HTTP adapter setup ready!\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# MCP Client Setup using Official Adapter with HTTP Transport\n",
"import subprocess\n",
@@ -128,6 +118,18 @@
" \"weather\": {\n",
" \"transport\": \"streamable_http\",\n",
" \"url\": os.getenv(\"WEATHER_MCP_URL\")\n",
+ " },\n",
+ " \"packing_list\": {\n",
+ " \"transport\": \"streamable_http\",\n",
+ " \"url\": os.getenv(\"PACKING_LIST_MCP_URL\")\n",
+ " },\n",
+ " \"endorsements\": {\n",
+ " \"transport\": \"streamable_http\",\n",
+ " \"url\": os.getenv(\"ENDORSEMENTS_MCP_URL\")\n",
+ " },\n",
+ " \"persist_packing_list\": {\n",
+ " \"transport\": \"streamable_http\",\n",
+ " \"url\": os.getenv(\"PERSIST_PACKING_LIST_MCP_URL\")\n",
" }\n",
" })\n",
" \n",
@@ -145,18 +147,10 @@
},
{
"cell_type": "code",
- "execution_count": 7,
+ "execution_count": null,
"id": "5deceb6f",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "🛠️ Ready to load MCP tools via official adapter!\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# Load MCP Tools using Official Adapter\n",
"# The tools will be loaded dynamically when setting up the agent\n",
@@ -166,18 +160,10 @@
},
{
"cell_type": "code",
- "execution_count": 8,
+ "execution_count": null,
"id": "ab1bb59a",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "🤖 Agent setup function ready! Run the next cell to initialize.\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"async def setup_agent():\n",
" \"\"\"Setup LangChain agent with MCP tools using official adapter\"\"\"\n",
@@ -214,7 +200,15 @@
" - And more...\n",
" \n",
" When users ask about travel plans, use these tools to provide comprehensive information.\n",
- " Always be helpful and provide practical advice.\"\"\"\n",
+ " Always be helpful and provide practical advice.\n",
+ " \n",
+ " You are also able to generate packing lists based on a given activity. When asked to create a packing list, you\n",
+ " should also ask the user about the location of their trip, and then check the weather there in order to generate\n",
+ " a better-tailored list.\n",
+ "\n",
+ " You are also able to accept endorsements from users for this service. You should prompt users\n",
+ " to give endorsements after you have spoken to them. You should give the users the list of endorsers if you ask for it.\n",
+ " \"\"\"\n",
" \n",
" # Create prompt template\n",
" prompt = ChatPromptTemplate.from_messages([\n",
@@ -242,29 +236,10 @@
},
{
"cell_type": "code",
- "execution_count": 9,
+ "execution_count": null,
"id": "881d1451",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Initializing agent with MCP tools...\n",
- "Loaded 7 MCP tools: ['get_attraction_details', 'search_attractions', 'get_random_attraction', 'book_attraction', 'search_and_format_attractions', 'get_current_weather', 'get_weather_forecast']\n",
- "Loaded 7 MCP tools: ['get_attraction_details', 'search_attractions', 'get_random_attraction', 'book_attraction', 'search_and_format_attractions', 'get_current_weather', 'get_weather_forecast']\n",
- "LangChain agent with MCP tools ready!\n"
- ]
- },
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "C:\\Users\\JayGregory\\AppData\\Local\\Temp\\ipykernel_51000\\3851623357.py:50: LangChainDeprecationWarning: Please see the migration guide at: https://python.langchain.com/docs/versions/migrating_memory/\n",
- " memory = ConversationBufferMemory(memory_key=\"chat_history\", return_messages=True)\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# Initialize the agent with MCP tools\n",
"async def initialize_agent():\n",
@@ -281,20 +256,20 @@
"await initialize_agent()\n"
]
},
+ {
+ "cell_type": "markdown",
+ "id": "1cd93eaf",
+ "metadata": {},
+ "source": [
+ "## Running"
+ ]
+ },
{
"cell_type": "code",
- "execution_count": 10,
+ "execution_count": null,
"id": "ba56fc7e",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "💬 User input handler ready!\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# User Input Handler + logged agent steps\n",
"async def process_user_input(user_input: str) -> str:\n",
@@ -347,87 +322,10 @@
},
{
"cell_type": "code",
- "execution_count": 11,
+ "execution_count": null,
"id": "4d4447a3",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Loaded 7 MCP tools: ['get_attraction_details', 'search_attractions', 'get_random_attraction', 'book_attraction', 'search_and_format_attractions', 'get_current_weather', 'get_weather_forecast']\n",
- "MCP HTTP server connected successfully!\n",
- "Available tools: ['get_attraction_details', 'search_attractions', 'get_random_attraction', 'book_attraction', 'search_and_format_attractions', 'get_current_weather', 'get_weather_forecast']\n",
- " - get_attraction_details: Get detailed information about a specific tourist attraction\n",
- "\n",
- "Args:\n",
- " attraction_id: Unique ID of the attraction\n",
- " \n",
- "Returns:\n",
- " AttractionDetails object as dictionary with attraction info, facilities, and visiting tips\n",
- "\n",
- " - search_attractions: Search for tourist attractions with optional filters\n",
- "\n",
- "Args:\n",
- " location: Location to search in (e.g., \"Paris\", \"India\", \"Italy\")\n",
- " category: Category filter - \"historical\", \"natural\", \"cultural\", \"religious\", \"modern\", \"museums\", \"parks\", \"beaches\", \"mountains\", \"architecture\", \"entertainment\", \"adventure\"\n",
- " limit: Maximum number of results (1-100, default: 20)\n",
- " \n",
- "Returns:\n",
- " AttractionsList object as dictionary with matching attractions\n",
- "\n",
- " - get_random_attraction: Get a random tourist attraction for inspiration\n",
- "\n",
- "Args:\n",
- " region: Region type - \"famous\" for world famous attractions, \"india\" for Indian attractions\n",
- " \n",
- "Returns:\n",
- " Attraction object as dictionary with random attraction details\n",
- "\n",
- " - book_attraction: Book a visit to a tourist attraction\n",
- "\n",
- "Args:\n",
- " attraction_id: ID of the attraction to book\n",
- " visitor_name: Name of the primary visitor\n",
- " email: Email address for booking confirmation\n",
- " visit_date: Visit date in YYYY-MM-DD format\n",
- " num_visitors: Number of visitors (1-50, default: 1)\n",
- " phone: Optional phone number\n",
- " special_requirements: Optional special requirements or requests\n",
- " \n",
- "Returns:\n",
- " BookingResponse object as dictionary with booking confirmation details\n",
- "\n",
- " - search_and_format_attractions: Search for attractions and return formatted results for easy reading\n",
- "\n",
- "Args:\n",
- " location: Location to search in (e.g., \"Paris\", \"India\", \"Italy\") \n",
- " category: Category filter (e.g., \"historical\", \"natural\", \"cultural\")\n",
- " limit: Maximum number of results (1-20, default: 10)\n",
- " \n",
- "Returns:\n",
- " Formatted string with attraction search results\n",
- "\n",
- " - get_current_weather: Get current weather information for a specific location\n",
- "\n",
- "Args:\n",
- " location: City name or place name (e.g., \"London\", \"New York\", \"Tokyo\")\n",
- " \n",
- "Returns:\n",
- " CurrentWeather object as dictionary or error dict\n",
- "\n",
- " - get_weather_forecast: Get weather forecast for a specific location\n",
- "\n",
- "Args:\n",
- " location: City name or place name (e.g., \"London\", \"New York\", \"Tokyo\")\n",
- " days: Number of days for forecast (1-16, default is 7)\n",
- " \n",
- "Returns:\n",
- " WeatherForecast object as dictionary or error dict\n",
- "\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# Test MCP server connectivity and tools\n",
"async def test_mcp_connection():\n",
@@ -447,115 +345,10 @@
},
{
"cell_type": "code",
- "execution_count": 12,
+ "execution_count": null,
"id": "57dcf6ff",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "🧳 User: What are some popular attractions in Paris? and what is the weather?\n",
- "🤖 Assistant:\n",
- "\n",
- "\n",
- "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
- "\u001b[32;1m\u001b[1;3m\n",
- "Invoking: `search_and_format_attractions` with `{'location': 'Paris', 'limit': 10}`\n",
- "\n",
- "\n",
- "\u001b[0m\u001b[32;1m\u001b[1;3m\n",
- "Invoking: `get_current_weather` with `{'location': 'Paris'}`\n",
- "\n",
- "\n",
- "\u001b[0m\u001b[36;1m\u001b[1;3m🎯 Found 2 attractions in Paris:\n",
- "\n",
- "1. 🏛️ **Eiffel Tower**\n",
- " 📍 Paris, France\n",
- " 🏷️ Architecture\n",
- " ⭐ 4.6/5.0\n",
- " 💰 €29.40 - €73.30\n",
- "\n",
- "2. 🏛️ **Louvre Museum**\n",
- " 📍 Paris, France\n",
- " 🏷️ Museums\n",
- " ⭐ 4.4/5.0\n",
- " 💰 €17\n",
- "\n",
- "\u001b[0m\u001b[33;1m\u001b[1;3m{\n",
- " \"location\": \"Paris, Île-de-France, France\",\n",
- " \"coordinates\": {\n",
- " \"lat\": 48.85341,\n",
- " \"lon\": 2.3488\n",
- " },\n",
- " \"temperature\": {\n",
- " \"current\": 12.0,\n",
- " \"feels_like\": 10.2,\n",
- " \"min\": null,\n",
- " \"max\": null,\n",
- " \"unit\": \"°C\"\n",
- " },\n",
- " \"weather\": {\n",
- " \"description\": \"Slight rain\",\n",
- " \"code\": 61\n",
- " },\n",
- " \"wind\": {\n",
- " \"speed\": 16.1,\n",
- " \"direction\": 20,\n",
- " \"unit\": \"km/h\",\n",
- " \"max_gusts\": null\n",
- " },\n",
- " \"humidity\": 64,\n",
- " \"pressure\": 1018.1,\n",
- " \"precipitation\": 0.6,\n",
- " \"timezone\": \"Europe/Paris\",\n",
- " \"timestamp\": \"2025-09-23T11:45\"\n",
- "}\u001b[0m\u001b[32;1m\u001b[1;3mHere are a few quick highlights and the current weather for Paris.\n",
- "\n",
- "Popular attractions (quick overview)\n",
- "- Eiffel Tower — Architecture — Rating ~4.6/5 — Typical ticket range €29–€73\n",
- " - Tip: Book a timed ticket in advance to avoid long queues; allow 1–2 hours; great at sunset.\n",
- "- Louvre Museum — Museums — Rating ~4.4/5 — Typical ticket ~€17\n",
- " - Tip: Closed on Tuesdays; get a timed-entry ticket and plan 2–4 hours (Mona Lisa area is busiest).\n",
- "\n",
- "Current weather in Paris (Île‑de‑France) — as of 2025-09-23 11:45 (local)\n",
- "- Temperature: 12.0°C (feels like 10.2°C)\n",
- "- Conditions: Slight rain\n",
- "- Precipitation: ~0.6 mm\n",
- "- Wind: ~16 km/h from ~20° (NNE)\n",
- "- Humidity: 64% · Pressure: ~1018 hPa\n",
- "\n",
- "Practical suggestions\n",
- "- Pack a compact umbrella or a waterproof jacket and wear layers — cool and light rain.\n",
- "- For outdoor sights (Eiffel Tower, Seine strolls) prioritize mornings or late afternoons to avoid peak crowds.\n",
- "- Want me to: find more attractions by neighborhood or category, get detailed info (hours, accessibility), or book tickets for the Eiffel Tower or Louvre? If you want booking, tell me the visit date, number of visitors, and the name/email to use.\u001b[0m\n",
- "\n",
- "\u001b[1m> Finished chain.\u001b[0m\n",
- "Here are a few quick highlights and the current weather for Paris.\n",
- "\n",
- "Popular attractions (quick overview)\n",
- "- Eiffel Tower — Architecture — Rating ~4.6/5 — Typical ticket range €29–€73\n",
- " - Tip: Book a timed ticket in advance to avoid long queues; allow 1–2 hours; great at sunset.\n",
- "- Louvre Museum — Museums — Rating ~4.4/5 — Typical ticket ~€17\n",
- " - Tip: Closed on Tuesdays; get a timed-entry ticket and plan 2–4 hours (Mona Lisa area is busiest).\n",
- "\n",
- "Current weather in Paris (Île‑de‑France) — as of 2025-09-23 11:45 (local)\n",
- "- Temperature: 12.0°C (feels like 10.2°C)\n",
- "- Conditions: Slight rain\n",
- "- Precipitation: ~0.6 mm\n",
- "- Wind: ~16 km/h from ~20° (NNE)\n",
- "- Humidity: 64% · Pressure: ~1018 hPa\n",
- "\n",
- "Practical suggestions\n",
- "- Pack a compact umbrella or a waterproof jacket and wear layers — cool and light rain.\n",
- "- For outdoor sights (Eiffel Tower, Seine strolls) prioritize mornings or late afternoons to avoid peak crowds.\n",
- "- Want me to: find more attractions by neighborhood or category, get detailed info (hours, accessibility), or book tickets for the Eiffel Tower or Louvre? If you want booking, tell me the visit date, number of visitors, and the name/email to use.\n",
- "\n",
- "==================================================\n",
- "\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# 🚀 EXAMPLE USAGE - Run this cell after setting up your API key!\n",
"\n",
@@ -570,295 +363,10 @@
},
{
"cell_type": "code",
- "execution_count": 13,
+ "execution_count": null,
"id": "bd0841c0",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Type 'exit' to quit. Press Enter on an empty line to skip.\n",
- "🧳 User: give me a random attraction\n",
- "🤖 Assistant:\n",
- "\n",
- "\n",
- "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
- "\u001b[32;1m\u001b[1;3m\n",
- "Invoking: `get_random_attraction` with `{'region': 'famous'}`\n",
- "\n",
- "\n",
- "\u001b[0m\u001b[38;5;200m\u001b[1;3m{\n",
- " \"id\": 10,\n",
- " \"name\": \"Petra\",\n",
- " \"description\": \"Archaeological city famous for rock-cut architecture and water conduit system\",\n",
- " \"category\": \"historical\",\n",
- " \"location\": {\n",
- " \"city\": \"Ma'an\",\n",
- " \"country\": \"Jordan\",\n",
- " \"region\": \"Ma'an\",\n",
- " \"coordinates\": null\n",
- " },\n",
- " \"rating\": 4.7,\n",
- " \"image_url\": \"https://example.com/petra.jpg\",\n",
- " \"website\": \"https://www.visitpetra.jo\",\n",
- " \"opening_hours\": \"6:00 AM - 6:00 PM\",\n",
- " \"entry_fee\": \"70 JOD (1 day), 55 JOD (2 days)\"\n",
- "}\u001b[0m\u001b[32;1m\u001b[1;3mGreat choice — here’s a random pick:\n",
- "\n",
- "Petra (Jordan)\n",
- "- What it is: Ancient archaeological city famous for its rock-cut architecture (like the Treasury) and ancient water conduit system.\n",
- "- Location: Ma'an Governorate, Jordan.\n",
- "- Category: Historical.\n",
- "- Rating: 4.7.\n",
- "- Opening hours: 6:00 AM – 6:00 PM.\n",
- "- Entry fee: 70 JOD (1 day), 55 JOD (2 days).\n",
- "- Website: https://www.visitpetra.jo\n",
- "- Recommended visit length: 4–6 hours (longer if you plan hikes to the Monastery or Al-Khubtha).\n",
- "- Best time to visit: Spring or autumn for milder weather; arrive early to avoid crowds and heat.\n",
- "- Practical tips: wear sturdy walking shoes, bring plenty of water and sun protection, consider a guided tour to learn the history, and note some trails can be steep. Petra by Night is a special evening experience on some nights — check schedules in advance.\n",
- "\n",
- "Would you like more details (hours, accessibility, guided tours), help booking a ticket or tour, or another random attraction?\u001b[0m\n",
- "\n",
- "\u001b[1m> Finished chain.\u001b[0m\n",
- "Great choice — here’s a random pick:\n",
- "\n",
- "Petra (Jordan)\n",
- "- What it is: Ancient archaeological city famous for its rock-cut architecture (like the Treasury) and ancient water conduit system.\n",
- "- Location: Ma'an Governorate, Jordan.\n",
- "- Category: Historical.\n",
- "- Rating: 4.7.\n",
- "- Opening hours: 6:00 AM – 6:00 PM.\n",
- "- Entry fee: 70 JOD (1 day), 55 JOD (2 days).\n",
- "- Website: https://www.visitpetra.jo\n",
- "- Recommended visit length: 4–6 hours (longer if you plan hikes to the Monastery or Al-Khubtha).\n",
- "- Best time to visit: Spring or autumn for milder weather; arrive early to avoid crowds and heat.\n",
- "- Practical tips: wear sturdy walking shoes, bring plenty of water and sun protection, consider a guided tour to learn the history, and note some trails can be steep. Petra by Night is a special evening experience on some nights — check schedules in advance.\n",
- "\n",
- "Would you like more details (hours, accessibility, guided tours), help booking a ticket or tour, or another random attraction?\n",
- "🧳 User: what about attractions in paris\n",
- "🤖 Assistant:\n",
- "\n",
- "\n",
- "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
- "\u001b[32;1m\u001b[1;3m\n",
- "Invoking: `search_and_format_attractions` with `{'location': 'Paris', 'category': None, 'limit': 10}`\n",
- "\n",
- "\n",
- "\u001b[0m\u001b[36;1m\u001b[1;3m🎯 Found 2 attractions in Paris:\n",
- "\n",
- "1. 🏛️ **Eiffel Tower**\n",
- " 📍 Paris, France\n",
- " 🏷️ Architecture\n",
- " ⭐ 4.6/5.0\n",
- " 💰 €29.40 - €73.30\n",
- "\n",
- "2. 🏛️ **Louvre Museum**\n",
- " 📍 Paris, France\n",
- " 🏷️ Museums\n",
- " ⭐ 4.4/5.0\n",
- " 💰 €17\n",
- "\n",
- "\u001b[0m\u001b[32;1m\u001b[1;3m\n",
- "Invoking: `search_attractions` with `{'location': 'Paris', 'category': None, 'limit': 10}`\n",
- "\n",
- "\n",
- "\u001b[0m\u001b[33;1m\u001b[1;3m{\n",
- " \"category\": \"All Categories\",\n",
- " \"location\": \"Paris\",\n",
- " \"total_count\": 2,\n",
- " \"attractions\": [\n",
- " {\n",
- " \"id\": 1,\n",
- " \"name\": \"Eiffel Tower\",\n",
- " \"description\": \"Iconic iron lattice tower located on the Champ de Mars in Paris, France\",\n",
- " \"category\": \"architecture\",\n",
- " \"location\": {\n",
- " \"city\": \"Paris\",\n",
- " \"country\": \"France\",\n",
- " \"region\": \"Île-de-France\",\n",
- " \"coordinates\": null\n",
- " },\n",
- " \"rating\": 4.6,\n",
- " \"image_url\": \"https://example.com/eiffel-tower.jpg\",\n",
- " \"website\": \"https://www.toureiffel.paris\",\n",
- " \"opening_hours\": \"9:30 AM - 11:45 PM\",\n",
- " \"entry_fee\": \"€29.40 - €73.30\"\n",
- " },\n",
- " {\n",
- " \"id\": 5,\n",
- " \"name\": \"Louvre Museum\",\n",
- " \"description\": \"World's largest art museum and historic monument in Paris\",\n",
- " \"category\": \"museums\",\n",
- " \"location\": {\n",
- " \"city\": \"Paris\",\n",
- " \"country\": \"France\",\n",
- " \"region\": \"Île-de-France\",\n",
- " \"coordinates\": null\n",
- " },\n",
- " \"rating\": 4.4,\n",
- " \"image_url\": \"https://example.com/louvre.jpg\",\n",
- " \"website\": \"https://www.louvre.fr\",\n",
- " \"opening_hours\": \"9:00 AM - 6:00 PM\",\n",
- " \"entry_fee\": \"€17\"\n",
- " }\n",
- " ]\n",
- "}\u001b[0m\u001b[32;1m\u001b[1;3mGreat — here are popular Paris attractions with quick notes and tips. Tell me which ones you want more details or to book.\n",
- "\n",
- "- Eiffel Tower (architecture) — Iconic iron tower on the Champ de Mars. Opening hours: ~9:30 AM–11:45 PM. Tickets range ~€29–€73 depending on access/age. Tip: book a timed-entry or summit ticket in advance; sunset or night views are spectacular.\n",
- "\n",
- "- Louvre Museum (museums) — World’s largest art museum (home of the Mona Lisa). Opening hours: ~9:00 AM–6:00 PM; entry ~€17. Tip: closed some weekdays (check before you go), use a timed-entry ticket and allow 2–4 hours (or more).\n",
- "\n",
- "Other top picks to consider:\n",
- "- Notre‑Dame Cathedral (historic landmark) — note: restoration work continues after the 2019 fire; access may be limited.\n",
- "- Musée d’Orsay — Impressionist and post‑Impressionist masterpieces in a former railway station.\n",
- "- Sacré‑Cœur and Montmartre — hilltop basilica with great city views and a bohemian neighborhood to explore.\n",
- "- Arc de Triomphe & Champs‑Élysées — climb the Arc for views; stroll the avenue for shopping and cafés.\n",
- "- Sainte‑Chapelle — stunning medieval stained-glass chapel on Île de la Cité.\n",
- "- Seine river cruise (Bateaux Mouches or similar) — relaxing way to see many riverside monuments.\n",
- "- Luxembourg Gardens — peaceful park for a stroll or picnic.\n",
- "- Palace of Versailles (day trip) — lavish palace and gardens just outside Paris; allow a full day.\n",
- "\n",
- "Would you like:\n",
- "- Details for any specific attraction (hours, accessibility, guided tours)?\n",
- "- Help booking tickets (tell me date, number of visitors, name/email)?\n",
- "- Current weather for Paris right now or a forecast for your travel dates?\u001b[0m\n",
- "\n",
- "\u001b[1m> Finished chain.\u001b[0m\n",
- "Great — here are popular Paris attractions with quick notes and tips. Tell me which ones you want more details or to book.\n",
- "\n",
- "- Eiffel Tower (architecture) — Iconic iron tower on the Champ de Mars. Opening hours: ~9:30 AM–11:45 PM. Tickets range ~€29–€73 depending on access/age. Tip: book a timed-entry or summit ticket in advance; sunset or night views are spectacular.\n",
- "\n",
- "- Louvre Museum (museums) — World’s largest art museum (home of the Mona Lisa). Opening hours: ~9:00 AM–6:00 PM; entry ~€17. Tip: closed some weekdays (check before you go), use a timed-entry ticket and allow 2–4 hours (or more).\n",
- "\n",
- "Other top picks to consider:\n",
- "- Notre‑Dame Cathedral (historic landmark) — note: restoration work continues after the 2019 fire; access may be limited.\n",
- "- Musée d’Orsay — Impressionist and post‑Impressionist masterpieces in a former railway station.\n",
- "- Sacré‑Cœur and Montmartre — hilltop basilica with great city views and a bohemian neighborhood to explore.\n",
- "- Arc de Triomphe & Champs‑Élysées — climb the Arc for views; stroll the avenue for shopping and cafés.\n",
- "- Sainte‑Chapelle — stunning medieval stained-glass chapel on Île de la Cité.\n",
- "- Seine river cruise (Bateaux Mouches or similar) — relaxing way to see many riverside monuments.\n",
- "- Luxembourg Gardens — peaceful park for a stroll or picnic.\n",
- "- Palace of Versailles (day trip) — lavish palace and gardens just outside Paris; allow a full day.\n",
- "\n",
- "Would you like:\n",
- "- Details for any specific attraction (hours, accessibility, guided tours)?\n",
- "- Help booking tickets (tell me date, number of visitors, name/email)?\n",
- "- Current weather for Paris right now or a forecast for your travel dates?\n",
- "🧳 User: book eiffel tower\n",
- "🤖 Assistant:\n",
- "\n",
- "\n",
- "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
- "\u001b[32;1m\u001b[1;3m\n",
- "Invoking: `search_attractions` with `{'location': 'Paris', 'category': 'architecture', 'limit': 20}`\n",
- "\n",
- "\n",
- "\u001b[0m\u001b[33;1m\u001b[1;3m{\n",
- " \"category\": \"Architecture\",\n",
- " \"location\": \"Paris\",\n",
- " \"total_count\": 1,\n",
- " \"attractions\": [\n",
- " {\n",
- " \"id\": 1,\n",
- " \"name\": \"Eiffel Tower\",\n",
- " \"description\": \"Iconic iron lattice tower located on the Champ de Mars in Paris, France\",\n",
- " \"category\": \"architecture\",\n",
- " \"location\": {\n",
- " \"city\": \"Paris\",\n",
- " \"country\": \"France\",\n",
- " \"region\": \"Île-de-France\",\n",
- " \"coordinates\": null\n",
- " },\n",
- " \"rating\": 4.6,\n",
- " \"image_url\": \"https://example.com/eiffel-tower.jpg\",\n",
- " \"website\": \"https://www.toureiffel.paris\",\n",
- " \"opening_hours\": \"9:30 AM - 11:45 PM\",\n",
- " \"entry_fee\": \"€29.40 - €73.30\"\n",
- " }\n",
- " ]\n",
- "}\u001b[0m\u001b[32;1m\u001b[1;3mI can book the Eiffel Tower for you — I just need a few details first:\n",
- "\n",
- "1) Visit date (YYYY-MM-DD) \n",
- "2) Number of visitors (1–50) \n",
- "3) Primary visitor name (for the booking) \n",
- "4) Email for confirmation \n",
- "5) Phone number (optional) \n",
- "6) Any special requests or ticket preference (e.g., summit access vs 2nd floor only, stairs vs elevator, preferred time window like morning/afternoon/evening)\n",
- "\n",
- "Tell me those and I’ll proceed to check availability and make the booking. Would you also like me to include current weather for Paris on your visit date?\u001b[0m\n",
- "\n",
- "\u001b[1m> Finished chain.\u001b[0m\n",
- "I can book the Eiffel Tower for you — I just need a few details first:\n",
- "\n",
- "1) Visit date (YYYY-MM-DD) \n",
- "2) Number of visitors (1–50) \n",
- "3) Primary visitor name (for the booking) \n",
- "4) Email for confirmation \n",
- "5) Phone number (optional) \n",
- "6) Any special requests or ticket preference (e.g., summit access vs 2nd floor only, stairs vs elevator, preferred time window like morning/afternoon/evening)\n",
- "\n",
- "Tell me those and I’ll proceed to check availability and make the booking. Would you also like me to include current weather for Paris on your visit date?\n",
- "🧳 User: 1992-04-2992\n",
- "🤖 Assistant:\n",
- "\n",
- "\n",
- "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
- "\u001b[32;1m\u001b[1;3mThe date you sent looks invalid: \"1992-04-2992\" — it has extra characters and/or is in the past. I can’t book a past date. Could you please confirm the booking details using this form?\n",
- "\n",
- "1) Visit date (YYYY-MM-DD) — must be a future date \n",
- "2) Number of visitors (1–50) \n",
- "3) Primary visitor name \n",
- "4) Email for confirmation \n",
- "5) Phone (optional) \n",
- "6) Ticket preference / special requests (e.g., summit access vs 2nd floor only; stairs vs elevator; preferred time of day)\n",
- "\n",
- "If you want, type everything in one line (for example):\n",
- "2025-10-15, 2, Alex Martin, alex@example.com, +33-6-12-34-56-78, summit ticket, evening\n",
- "\n",
- "Tell me the corrected details and I’ll check availability and proceed. Would you also like the weather forecast for your visit date?\u001b[0m\n",
- "\n",
- "\u001b[1m> Finished chain.\u001b[0m\n",
- "The date you sent looks invalid: \"1992-04-2992\" — it has extra characters and/or is in the past. I can’t book a past date. Could you please confirm the booking details using this form?\n",
- "\n",
- "1) Visit date (YYYY-MM-DD) — must be a future date \n",
- "2) Number of visitors (1–50) \n",
- "3) Primary visitor name \n",
- "4) Email for confirmation \n",
- "5) Phone (optional) \n",
- "6) Ticket preference / special requests (e.g., summit access vs 2nd floor only; stairs vs elevator; preferred time of day)\n",
- "\n",
- "If you want, type everything in one line (for example):\n",
- "2025-10-15, 2, Alex Martin, alex@example.com, +33-6-12-34-56-78, summit ticket, evening\n",
- "\n",
- "Tell me the corrected details and I’ll check availability and proceed. Would you also like the weather forecast for your visit date?\n",
- "🧳 User: escape\n",
- "🤖 Assistant:\n",
- "\n",
- "\n",
- "\u001b[1m> Entering new AgentExecutor chain...\u001b[0m\n",
- "\u001b[32;1m\u001b[1;3mDo you mean one of the following?\n",
- "\n",
- "1) Cancel/stop the Eiffel Tower booking process (I’ll drop it and we won’t book). \n",
- "2) “Escape rooms” in Paris (I can find and book an escape-room experience). \n",
- "3) A short getaway/day‑trip from Paris (ideas like Versailles, Giverny, Fontainebleau). \n",
- "4) Something else — please tell me what you mean.\n",
- "\n",
- "Reply with the option number (or explain) and I’ll proceed.\u001b[0m\n",
- "\n",
- "\u001b[1m> Finished chain.\u001b[0m\n",
- "Do you mean one of the following?\n",
- "\n",
- "1) Cancel/stop the Eiffel Tower booking process (I’ll drop it and we won’t book). \n",
- "2) “Escape rooms” in Paris (I can find and book an escape-room experience). \n",
- "3) A short getaway/day‑trip from Paris (ideas like Versailles, Giverny, Fontainebleau). \n",
- "4) Something else — please tell me what you mean.\n",
- "\n",
- "Reply with the option number (or explain) and I’ll proceed.\n",
- "Goodbye!\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# Interactive chat loop — keep asking questions until you exit\n",
"\n",
@@ -890,18 +398,10 @@
},
{
"cell_type": "code",
- "execution_count": 14,
+ "execution_count": null,
"id": "968731b7",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "🧹 Cleanup function ready!\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"# Cleanup function for HTTP MCP client\n",
"async def cleanup_mcp():\n",
@@ -921,7 +421,7 @@
],
"metadata": {
"kernelspec": {
- "display_name": ".venv",
+ "display_name": ".venv (3.13.7)",
"language": "python",
"name": "python3"
},
@@ -935,7 +435,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
- "version": "3.13.3"
+ "version": "3.13.7"
}
},
"nbformat": 4,
diff --git a/src/agent/attractions.py b/src/agent/attractions.py
new file mode 100644
index 0000000..072924d
--- /dev/null
+++ b/src/agent/attractions.py
@@ -0,0 +1,255 @@
+# Step to ensure that the venv is being used for the project not local copies, should point at .venv in project.
+import sys, shutil
+print("python:", sys.executable)
+print("uv:", shutil.which("uv"))
+
+# LangChain + MCP Setup for Attractions Booking (HTTP-based for Jupyter)
+import os
+from dotenv import load_dotenv
+import asyncio
+import json
+import requests
+from typing import Dict, Any, List
+
+# LangChain imports
+from langchain_openai import ChatOpenAI, AzureChatOpenAI
+from langchain_core.messages import HumanMessage, SystemMessage
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+from langchain.memory import ConversationBufferMemory
+
+# Official MCP adapter imports for HTTP transport
+from langchain_mcp_adapters.client import MultiServerMCPClient
+from langchain_mcp_adapters.tools import load_mcp_tools
+
+# Load environment variables
+load_dotenv()
+
+print("✅ Updated imports with official MCP adapter loaded successfully!")
+
+# MCP Client Setup using Official Adapter with HTTP Transport
+import subprocess
+import time
+
+# Global MCP client for HTTP
+mcp_client = None
+
+async def create_mcp_tools():
+ """Create MCP tools using the official LangChain MCP adapter with HTTP transport"""
+ global mcp_client
+
+ try:
+ # Create MultiServerMCPClient with streamable_http transport
+ mcp_client = MultiServerMCPClient({
+ "attractions": {
+ "transport": "streamable_http",
+ "url": os.getenv("ATTRACTIONS_MCP_URL")
+ },
+ "weather": {
+ "transport": "streamable_http",
+ "url": os.getenv("WEATHER_MCP_URL")
+ },
+ "packing_list": {
+ "transport": "streamable_http",
+ "url": os.getenv("PACKING_LIST_MCP_URL")
+ },
+ "endorsements": {
+ "transport": "streamable_http",
+ "url": os.getenv("ENDORSEMENTS_MCP_URL")
+ },
+ "persist": {
+ "transport": "streamable_http",
+ "url": os.getenv("PERSIST_PACKING_LIST_MCP_URL")
+ }
+ })
+
+ # Get tools from the MCP server
+ tools = await mcp_client.get_tools()
+ print(f"Loaded {len(tools)} MCP tools: {[tool.name for tool in tools]}")
+ return tools
+
+ except Exception as e:
+ print(f"Error connecting to MCP HTTP server: {e}")
+ return []
+
+print("🔗 MCP HTTP adapter setup ready!")
+
+# Load MCP Tools using Official Adapter
+# The tools will be loaded dynamically when setting up the agent
+# No need to manually create tool wrappers - the adapter handles this automatically
+print("🛠️ Ready to load MCP tools via official adapter!")
+
+async def setup_agent():
+ """Setup LangChain agent with MCP tools using official adapter"""
+
+ # Initialize LLM for Azure OpenAI
+ # can get this from Azure Open Ai service -> Azure Ai Foundary Portal
+ from langchain_openai import AzureChatOpenAI
+
+ llm = AzureChatOpenAI(
+ deployment_name=os.getenv("DEPLOYMENT_NAME"), # Your Azure deployment name
+ api_key=os.getenv("AZURE_OPENAI_API_KEY"),
+ azure_endpoint=os.getenv("AZURE_OPENAI_ENDPOINT"),
+ api_version=os.getenv("AZURE_API_VERSION"),
+ temperature=1
+ )
+
+ # Load MCP tools using official adapter
+ tools = await create_mcp_tools()
+
+ if not tools:
+ print("No MCP tools loaded. Make sure the MCP server is accessible.")
+ return None
+
+ print(f"Loaded {len(tools)} MCP tools: {[tool.name for tool in tools]}")
+
+ # Create system prompt
+ system_prompt = """You are a helpful travel assistant that can help users find and book attractions including weather.
+
+ You have access to multiple MCP tools for tourist attractions, including:
+ - Searching for attractions by location and category
+ - Getting detailed attraction information
+ - Booking attractions for visitors
+ - Getting random attraction suggestions
+ - And more...
+
+ When users ask about travel plans, use these tools to provide comprehensive information.
+ Always be helpful and provide practical advice.
+
+ You are also able to generate packing lists based on a given activity. When asked to create a packing list, you
+ should also ask the user about the location of their trip, and then check the weather there in order to generate
+ a better-tailored list.
+
+ You are also able to accept endorsements from users for this service. You should prompt users
+ to give endorsements after you have spoken to them. You should give the users the list of endorsers if you ask for it.
+ """
+
+ # Create prompt template
+ prompt = ChatPromptTemplate.from_messages([
+ ("system", system_prompt),
+ MessagesPlaceholder(variable_name="chat_history"),
+ ("human", "{input}"),
+ MessagesPlaceholder(variable_name="agent_scratchpad"),
+ ])
+
+ # Create agent
+ agent = create_tool_calling_agent(llm, tools, prompt)
+
+ # memory
+ memory = ConversationBufferMemory(memory_key="chat_history", return_messages=True)
+
+ # Create agent executor with tool logging callback and verbose output
+ agent_executor = AgentExecutor(agent=agent, tools=tools, memory=memory, verbose=True)
+
+ return agent_executor
+
+# Initialize the agent (now async)
+agent_executor = None
+print("🤖 Agent setup function ready! Run the next cell to initialize.")
+
+# Initialize the agent with MCP tools
+async def initialize_agent():
+ """Initialize the agent with MCP tools"""
+ global agent_executor
+ print("Initializing agent with MCP tools...")
+ agent_executor = await setup_agent()
+ if agent_executor:
+ print("LangChain agent with MCP tools ready!")
+ else:
+ print("Failed to initialize agent. Check MCP server connection.")
+
+# User Input Handler + logged agent steps
+async def process_user_input(user_input: str) -> str:
+ """Process user input and return LLM response using MCP tools"""
+ if not agent_executor:
+ return "Agent not initialized. Please run the initialization cell first."
+
+ try:
+ # Use the agent to process the input and get intermediate steps
+ result = await agent_executor.ainvoke({"input": user_input})
+ output = result.get("output") or result.get("final_output") or ""
+
+ # Print intermediate steps if present
+ steps = result.get("intermediate_steps") or []
+ for step in steps:
+ action = None
+ observation = None
+ if isinstance(step, tuple) and len(step) == 2:
+ action, observation = step
+ elif isinstance(step, dict) and "action" in step:
+ action = step.get("action")
+ observation = step.get("observation")
+ else:
+ continue
+
+ tool_name = getattr(action, "tool", getattr(action, "tool_name", "unknown"))
+ tool_args = getattr(action, "tool_input", getattr(action, "input", None))
+ print(f"\n--- Tool: {tool_name}")
+ print(f"args: {tool_args}")
+ if observation is not None:
+ print(f"result: {observation}")
+ print("---\n")
+
+ return output
+ except Exception as e:
+ return f"Error processing request: {str(e)}"
+
+# Interactive function for easy testing
+async def ask_assistant(question: str):
+ """Easy-to-use function for asking the travel assistant"""
+ print(f"🧳 User: {question}")
+ print("🤖 Assistant:")
+
+ response = await process_user_input(question)
+ print(response)
+ return response
+
+print("💬 User input handler ready!")
+
+# Test MCP server connectivity and tools
+async def test_mcp_connection():
+ """Test MCP server connection and list available tools"""
+ tools = await create_mcp_tools()
+ if tools:
+ print(f"MCP HTTP server connected successfully!")
+ print(f"Available tools: {[tool.name for tool in tools]}")
+ for tool in tools:
+ print(f" - {tool.name}: {tool.description}")
+ else:
+ print("Failed to connect to MCP HTTP server")
+
+# Test MCP HTTP connection
+
+async def chat_loop():
+ print("Type 'exit' to quit. Press Enter on an empty line to skip.")
+ while True:
+ try:
+ question = input("You: ").strip()
+ except (EOFError, KeyboardInterrupt):
+ print("\nExiting.")
+ break
+ if not question:
+ continue
+ if question.lower() in ("exit", "quit", "q"):
+ print("Goodbye!")
+ break
+ await ask_assistant(question)
+
+async def main():
+ # Run the initialization
+ await initialize_agent()
+ await test_mcp_connection()
+ # 🚀 EXAMPLE USAGE - Run this cell after setting up your API key!
+
+ # Interactive chat loop — keep asking questions until you exit
+
+# try -
+# give me a random attraction
+# what about attractions in paris
+# more details on eiffel tower
+# book eiffel tower
+
+if __name__ == '__main__':
+ loop = asyncio.get_event_loop()
+ loop.run_until_complete(main())
+ loop.run_until_complete(chat_loop())
\ No newline at end of file
diff --git a/src/agent/chat.html b/src/agent/chat.html
new file mode 100644
index 0000000..2b2239a
--- /dev/null
+++ b/src/agent/chat.html
@@ -0,0 +1,492 @@
+
+
+
+
+
+ Travel Legend
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
🥓 Travel Legend
+
+
+
+
+
+ 👋 Hello! I'm your Travel Legend. How can I help you today?
+