DEWA

Converts a location name, address, or place name to geographic coordinates (latitude and longitude). Use this when the user provides a location name like 'Dubai Marina', 'Downtown Dubai', or any address in UAE. The coordinates can then be used with get_happiness_centers or get_ev_chargers to find nearest locations.

geocode_location

Fetches the list of recent DEWA news. News will be extracted depending on query language: - If query is in english, language should be set as 'en'; - If query is in arabic, language should be set as 'ar'; - For any other cases, default language should be 'en

get_dewa_news

Returns a curated list of DEWA support options and a link to open each service.

get_dewa_support_options

Fetches the list of available DEWA EV charging locations and their details. If userLatitude and userLongitude are provided, chargers will be sorted by distance (nearest first) and distance information will be included. The content will be presented depending on query language: - If query is in english, language should be set as 'en'; - If query is in arabic, language should be set as 'ar'; - For any other cases, default language should be 'en'

get_ev_chargers

Fetches the list of DEWA customer happiness centers and their locations. IMPORTANT: Only ask for user location (userLatitude and userLongitude) when the user explicitly requests proximity-based information using phrases like 'near me', 'nearby', 'near current location', 'closest', or 'nearest'. For general queries like 'Find customer happiness centers' or 'Show happiness centers', call this tool WITHOUT location parameters to return all centers. When location parameters are provided, centers will be sorted by distance (nearest first) and distance information will be included. The content will be presented depending on query language: - If query is in english, language should be set as 'en'; - If query is in arabic, language should be set as 'ar'; - For any other cases, default language should be 'en'

get_happiness_centers

Fetches the outstanding balance for ONE DEWA account number at a time. CRITICAL CONSTRAINTS: - ONLY call this tool ONCE per conversation turn - NEVER call this tool in parallel with itself - Extract the account number VERBATIM from the user's LATEST message only - DO NOT infer, reformat, pad, truncate, or modify the account number in any way - DO NOT reuse account numbers from previous turns - DO NOT fabricate, estimate, or simulate any balance information - NEVER return a balance unless it comes directly from the tool response ANTI-HALLUCINATION RULES: - If the tool does not return a valid response, clearly inform the user that the balance could not be retrieved - Do NOT guess the outstanding amount under any circumstances - Do NOT generate example balances or placeholder values - Only present information explicitly returned by the tool - If required information is missing, ask the user instead of assuming BEHAVIOR RULES: 1. If NO account number is provided → Ask: 'Please provide your DEWA account number so I can check the outstanding balance.' 2. If MULTIPLE account numbers are provided → Ask: 'I can check the outstanding balance for one account at a time. Which account number would you like me to check first?' 3. If account number is incomplete, unclear, or ambiguous → Ask: 'Please provide the full DEWA account number so I can check the outstanding balance.' 4. If exactly ONE account number is provided → Call this tool with that exact number Always extract the account number strictly from the user's most recent message before calling the tool. Content balance will be presented depending on query language: - If query is in english, language should be set as 'en'; - If query is in arabic, language should be set as 'ar'; - For any other cases, default language should be 'en'

get_outstanding

This tool is a Helper tool for ID resolution only. It is used only to fetch all service ids and determine the correct service id. If the user is requesting all services, this tool must return an empty service id. It must NEVER be used to answer the user directly.

list_dewa_service_id

This tool must be called every time the user asks for any information about DEWA services (whether requesting one specific service or all services). It shows information about one specific service or lists all services. This is the only user-facing tool for services and the only tool whose output should be shown to the user. Detect which service id is given as input. In case none is detected or the user is requesting all services, keep the id input empty. The tool 'list_dewa_service_id' needs to be called first before this one.

get_dewa_services