get_booking_link
ChatGPTUse this when the user is ready to book or wants a direct link to a property page on uhomes.com. Validates the property exists and returns a tracked booking URL.
Travel
Overview
Find and compare student housing with uhomes.com. Search near a university, city, neighborhood, or transit stop; filter by budget, room type, commute time, and property brand; view photos, prices, ratings, facilities, and room options; then open uhomes.com when you are ready to continue booking.
Tools
get_property_detail
ChatGPTUse this when the user asks about a specific property's details, amenities, room types, prices, policies, photos, or reviews. Requires a house_id from a previous resolve_entities or recommend_properties call.
recommend_properties
ChatGPTSearch and recommend rental properties based on user preferences. Supports filtering by city, school, budget, room type, supplier, commute time, and sorting by distance/popularity/rating. Uses smart ranking with fallback logic. Use resolve_entities first to resolve names to IDs. Use round=2+ or exclude_house_ids for 'show me more' requests. Each result carries sub_type_id identifying the property category: 1=Student Apartment (purpose-built student housing, PBSA), 2=Social Apartment (non-student rental for general public), 3=On-campus Dormitory, 4=Whole Unit Rental, 5=Room Rental, 6=Roommate-Finding, 16=Serviced Apartment. property_type is the localized label of the same value.
resolve_entities
ChatGPTUse this when the user mentions cities, schools, universities, neighborhoods, suppliers, or specific properties by name. Resolves keywords to structured entity IDs using knowledge base + Elasticsearch. Pass keywords as a comma-separated string (e.g. 'UCL, London'). Returns grouped entities (location/supplier/house) with IDs. Pass returned IDs to recommend_properties: use city_id for cities, school_id for schools, location_type+location_id for neighborhood/subway/landmark, supplier_id for suppliers. The 'types' parameter filters which groups to return (comma-separated): location (includes city, school, neighborhood, subway, landmark, postal_code), supplier (or brand), house (or property). If omitted, all groups are searched.
search_locations
ChatGPTUse this when the user mentions a city, school, university, neighborhood, or subway station by name and you need to resolve it to a structured ID. Returns matching locations with IDs for use in recommend_properties. Pass the returned id as city_id (when type=city) or school_id (when type=school) or location_id + location_type (for neighborhood/subway) to recommend_properties.
search_suppliers
ChatGPTUse this when the user asks about a specific property management company, brand, or supplier by name. Returns supplier IDs for use in recommend_properties to filter by supplier.
