/
search_orders

search_orders

Description

Searches for order IDs based on a natural-language description. Useful when the customer doesn’t know or doesn't remember their order number.

When to Use

  • Customer says: “I ordered white sneakers last week.”

  • Before calling get_order_details.

  • After setting customer_email via set_room_data.

Workflow

  1. Capture user description in one sentence.

  2. Ensure email is set in room data for scoping.

  3. Call tool.

  4. Present candidate order IDs.

Arguments

Field

Type

Required

Field

Type

Required

query

string

Yes

Input Schema

{ "query": "order with black jacket bought yesterday" }

Output

{ "result": ["order_123", "order_892"] }

Sample Prompts

  • “Find my order: I bought red trousers two days ago.”

  • “Search for an order containing white running shoes.”