🏨 Perplexity Agent API Integration

// No SDK required — uses standard fetch API
const PERPLEXITY_API_KEY = "YOUR_PERPLEXITY_API_KEY";
const BH_API_KEY         = "test-live-hotel-rates2025";
const MODEL              = "sonar-pro";

const tools = [{
    type: "function",
    name: "get_live_hotel_rates",
    description: "Get live hotel rates with all-in pricing and booking URL",
    parameters: {
        type: "object",
        properties: {
            hotelName:    { type: "string",  description: "Hotel name with city and country" },
            checkinDate:  { type: "string",  format: "date" },
            checkoutDate: { type: "string",  format: "date" },
            adults:       { type: "integer", default: 2 },
            currency:     { type: "string",  default: "USD" }
        },
        required: ["hotelName", "checkinDate", "checkoutDate"]
    }
}];

async function getLiveHotelRates(params: Record<string, unknown>) {
    const res = await fetch(
        "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates",
        { method: "POST", headers: { "Content-Type": "application/json", "X-API-KEY": BH_API_KEY }, body: JSON.stringify(params) }
    );
    return res.json();
}

async function pplxChat(messages: object[], withTools = false) {
    const body: Record<string, unknown> = { model: MODEL, messages };
    if (withTools) { body.tools = tools; body.tool_choice = "auto"; }
    const res = await fetch("https://api.perplexity.ai/chat/completions", {
        method: "POST",
        headers: { "Authorization": `Bearer ${PERPLEXITY_API_KEY}`, "Content-Type": "application/json" },
        body: JSON.stringify(body)
    });
    return res.json();
}

async function askHotelAgent(userQuery: string): Promise<string> {
    const messages: any[] = [{ role: "user", content: userQuery }];

    // Step 1: Ask Perplexity (with tools enabled)
    const r1     = await pplxChat(messages, true);
    const choice = r1.choices[0];
    messages.push(choice.message);

    // Step 2: Execute tool call if triggered
    if (choice.finish_reason === "tool_calls") {
        for (const tc of choice.message.tool_calls) {
            const args   = JSON.parse(tc.function.arguments);
            const result = await getLiveHotelRates(args);

            // Guard against low-confidence matches
            if ((result.best_match_score ?? 1) < 0.85) {
                return `Low confidence (${result.best_match_score}). Suggestions: ${(result.suggestions ?? []).join(', ')}`;
            }

            messages.push({ role: "tool", tool_call_id: tc.id, content: JSON.stringify(result) });
        }

        // Step 3: Return final answer
        const r2 = await pplxChat(messages);
        return r2.choices[0].message.content;
    }

    return choice.message.content;
}

// Example
askHotelAgent("Find rates for Marriott Marquis NYC, March 15-17 2026").then(console.log);

#!/bin/bash
# Full end-to-end integration — paste and run after setting your key

PPLX_KEY="YOUR_PERPLEXITY_API_KEY"
BH_KEY="test-live-hotel-rates2025"
MODEL="sonar-pro"
USER_QUERY="Get rates for Four Seasons Boston, April 10-12 2026"

# ── Step 1: Send query to Perplexity with tool definition ──────
RESPONSE=$(curl -s -X POST "https://api.perplexity.ai/chat/completions" \
  -H "Authorization: Bearer $PPLX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$MODEL"'",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "name": "get_live_hotel_rates",
      "description": "Get live hotel rates with taxes and booking URL",
      "parameters": {
        "type": "object",
        "properties": {
          "hotelName":    {"type": "string"},
          "checkinDate":  {"type": "string"},
          "checkoutDate": {"type": "string"},
          "adults":       {"type": "integer", "default": 2},
          "currency":     {"type": "string",  "default": "USD"}
        },
        "required": ["hotelName", "checkinDate", "checkoutDate"]
      }
    }],
    "messages": [{"role": "user", "content": "'"$USER_QUERY"'"}]
  }')

# ── Step 2: Check if tool was called ──────────────────────────
FINISH=$(echo "$RESPONSE" | jq -r '.choices[0].finish_reason')

if [ "$FINISH" != "tool_calls" ]; then
  echo "Direct answer (no tool call needed):"
  echo "$RESPONSE" | jq -r '.choices[0].message.content'
  exit 0
fi

# ── Step 3: Extract arguments from tool call ──────────────────
TC_JSON=$(echo  "$RESPONSE"  | jq -r '.choices[0].message.tool_calls[0]')
ARGS=$(echo     "$TC_JSON"   | jq -r '.function.arguments')
CALL_ID=$(echo  "$TC_JSON"   | jq -r '.id')
HOTEL=$(echo    "$ARGS"      | jq -r '.hotelName')
CHECKIN=$(echo  "$ARGS"      | jq -r '.checkinDate')
CHECKOUT=$(echo "$ARGS"      | jq -r '.checkoutDate')
ADULTS=$(echo   "$ARGS"      | jq -r '.adults // 2')
CURRENCY=$(echo "$ARGS"      | jq -r '.currency // "USD"')

# ── Step 4: Call BusinessHotels MCP API ──────────────────────
RATES=$(curl -s -X POST \
  "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BH_KEY" \
  -d "{
    \"hotelName\":    \"$HOTEL\",
    \"checkinDate\":  \"$CHECKIN\",
    \"checkoutDate\": \"$CHECKOUT\",
    \"adults\":        $ADULTS,
    \"currency\":     \"$CURRENCY\"
  }")

# Check match confidence
SCORE=$(echo "$RATES" | jq -r '.best_match_score // 1')
if (( $(echo "$SCORE < 0.85" | bc -l) )); then
  echo "⚠️  Low confidence match ($SCORE). Suggestions:"
  echo "$RATES" | jq -r '.suggestions[]?'
  exit 1
fi

# ── Step 5: Send tool result back to Perplexity ───────────────
ASSISTANT_MSG=$(echo "$RESPONSE" | jq -c '.choices[0].message')

FINAL=$(curl -s -X POST "https://api.perplexity.ai/chat/completions" \
  -H "Authorization: Bearer $PPLX_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$MODEL\",
    \"messages\": [
      {\"role\": \"user\", \"content\": \"$USER_QUERY\"},
      $ASSISTANT_MSG,
      {\"role\": \"tool\", \"tool_call_id\": \"$CALL_ID\", \"content\": $(echo \"$RATES\" | jq -Rs .)}
    ]
  }")

echo "$FINAL" | jq -r '.choices[0].message.content'