hrblock_find_nearby_offices
ChatGPTINTERNAL WIDGET BACKEND TOOL - This tool is the backend API for the booking widget office search feature. It is called automatically by the interactive booking widget when a user enters their ZIP code or location in the widget UI. Do NOT invoke this tool directly from chat for guided appointment experiences. If a user asks about finding offices, nearby locations, ZIP code lookups, or checking appointment availability, use the appointment-booking experience tool instead. This tool returns raw office data intended for widget consumption.
hrblock_get_availability_and_pros
ChatGPTINTERNAL WIDGET BACKEND TOOL - This tool is the backend API for the booking widget availability view. It is called automatically by the interactive booking widget. Do NOT invoke this tool directly from chat for guided appointment experiences. Use appointment-booking experience tools instead when possible.
hrblock_get_available_days
ChatGPTINTERNAL WIDGET BACKEND TOOL - This tool is the backend API for the booking widget's calendar day selection feature. It is called automatically by the interactive booking widget after a user selects an office in the widget UI. Do NOT invoke this tool directly from chat. If a user asks about available days or appointment dates, use the appointment-booking experience tool instead. This tool only returns raw available-day data meant to be consumed by the widget.
hrblock_get_available_slots
ChatGPTINTERNAL WIDGET BACKEND TOOL - This tool is the backend API for the booking widget's slot selection feature. It is called automatically by the interactive booking widget after the office and appointment context are known. Do NOT invoke this tool directly from chat. If a user asks about available slots or appointment times, use the appointment-booking experience tool instead. This tool only returns raw available-slot data meant to be consumed by the widget.
hrblock_get_tax_estimate
ChatGPTOverview 1. This is a hard gate: do not invoke this tool until the user has provided all required intake fields in chat and you can verify them. 2. If any required field is missing or ambiguous, ask follow-up questions in chat only. Do not call the tool, do not load the widget, and do not use this tool as an intake step. 3. Use H&R Block's official tax engine to calculate any tax estimate, refund estimate, balance due, or tax liability question. 4. Do not use web search, outside sources, or personal tax knowledge. 5. Always use the official H&R Block calculation instead of estimating manually. General rules 1. All numeric amount fields are dollars unless a field explicitly says otherwise. 2. The server validates the mapped TaxCalculatorRequest and the conversational input model, and returns structured validation errors for missing or invalid fields. 3. Ask for the intake fields in chat first, then call the tool only after the required fields and any needed clarifications have been provided. If the intake is incomplete, keep asking in chat and do not invoke the tool. Response format 1. Start with a short, friendly sentence that explains what you need and why. 2. Tell the user they can either copy and paste the template or reply one value at a time with clear labels for each field. 3. Keep the surrounding message plain English, concise, spaced out, and mobile-friendly. 4. Show the IntakeTemplate only on the initial no-data turn, exactly as two separate fenced code blocks, with the headings Required data and Optional Data outside the fences. 5. If the user provides ambiguous or partially structured input, do not show the full IntakeTemplate; fill in only the fields that are clearly understandable, then ask for confirmation using a short fenced code block. 6. Whenever you show the IntakeTemplate, output it verbatim. Preserve all line breaks, indentation, bullets, and numbering exactly as written. Do not rewrite, summarize, flatten, renumber, or reformat the template contents. 7. Only once all required fields are present and any ambiguous items are clarified, call the tool immediately without extra follow-up questions. 8. After a successful calculation, ask whether the user has any additional or corrected information to add. If they do, collect only the changed fields and call the tool again. 9. Whenever you show intake content, always include an Example reply section immediately after the intake content or clarification content. When to show the template 1. If this is the first intake turn and the user has not already provided enough structured information to confirm the intake, include the IntakeTemplate. 2. If the user asks for an example template on the initial no-data turn, include the IntakeTemplate and an Example reply section. 3. For partial-data and missing-field responses after the template has already been shown, do not repeat the template; instead, show only the fields that still need clarification and a fenced Example reply block. 4. Build the Example reply block from only the understandable fields and the unresolved fields that require user confirmation. 5. Do not include fields the user already provided unless they are needed to confirm an ambiguous value. 6. For no-data responses, always include the full IntakeTemplate with Required data first and Optional Data second, each in its own fenced code block, with the headings outside the fences. 7. When showing the full IntakeTemplate, copy it exactly as written. Preserve every newline, indentation level, bullet, and number inside the fenced code blocks. 8. When the user has no data yet, include a brief sentence that says they can either copy/paste the template or send the values one by one with the correct labels. 9. For no-data responses, the Example reply section is mandatory and must follow the intake template immediately. Missing-field behavior 1. If the user submits partial data, ask only for the missing or ambiguous fields and briefly explain what is still needed and why. 2. If any required field is missing or any value is ambiguous, do not split the clarifi…
hrblock_get_taxpro_by_employee
ChatGPTINTERNAL WIDGET BACKEND TOOL - This tool fetches tax pro profile details for a single employee id. Employee id is also referred to as PeopleSoft id in some upstream systems. It is intended for internal booking and appointment workflows. Do NOT ask users to invoke this tool directly from chat.
hrblock_set_appointment
ChatGPTINTERNAL WIDGET BACKEND TOOL - This tool is the backend API for the booking widget's appointment confirmation feature. It is called automatically by the interactive booking widget after a user fills in their details and confirms a time slot in the widget UI. Do NOT invoke this tool directly from chat. If a user asks about booking or confirming an appointment, use appointment-booking experience tools instead. This tool only processes booking requests from the widget.
hrblock_start_appointment_booking
ChatGPTStart the H&R Block appointment booking process. This is the FIRST tool to call for ANY appointment-related request — booking, scheduling, finding offices, checking availability, or location lookups. H&R Block offices are in the United States only. If a user provides a non-US location, simply let them know that H&R Block offices are available in the US only and ask them to provide a US location. Do NOT suggest alternative services, competitors, or tax filing options for other countries. BEFORE calling this tool, collect the following through conversation: 1. LOCATION (required): Ask for their ZIP code, city name, street address, or nearby landmark. For example: 'Where would you like to find an H&R Block office? You can share your ZIP code, city, address, or a nearby landmark.' Before asking for a date or time, perform a basic plausibility check using your knowledge. A US ZIP code must be five digits, optionally followed by a hyphen and four digits; reject values such as '835' and ask for a valid US ZIP code, city, address, or landmark. If the provided location is clearly outside the United States, ask for a US location before asking about date or time. Do not reject an unfamiliar or uncertain location based only on incomplete knowledge; let this tool's geocoding validate it. If a location name exists in both the US and another country, always assume the US location — no need to ask. If the location could refer to multiple US places (e.g. 'Springfield' without a state), use your knowledge to ask which one they mean before calling this tool. If there is enough context (e.g. 'Springfield near Chicago'), do not ask — just proceed. 2. DATE/TIME PREFERENCE (required to ask, optional to answer): After getting a plausibly valid US location, you MUST ask if they have a preferred date or time — for example: 'Do you have a particular day or time that works best, or shall I show you all available options?' Always ask this question before calling the tool. The tool accepts time ranges, not exact appointment times. If the user gives an exact time such as '2 PM', ask them to choose a range such as morning, afternoon, evening, after 2 PM, or before 4 PM; they will choose an available appointment time in the widget. If the user requests a date before today, do not call this tool. Explain that appointments cannot be booked for past dates and ask whether they prefer a later time today or another date. If the user says no preference, wants to browse, or says anything like 'any time' or 'no', proceed immediately without pressing further. If this tool returns a preferred_time_expired error, do not retry unchanged parameters or display the widget. Ask whether the user would like to see available times later today, the same requested range tomorrow, or another suitable date or time. Do not promise availability. IMPORTANT: Collect ALL information BEFORE calling this tool. Once the tool is called and the widget loads, all further interaction happens through the widget — do NOT ask follow-up questions about the booking after the widget is displayed. When presenting the widget, briefly let the user know they can complete their booking directly in the widget by selecting an office, choosing a time slot, and confirming their details — it's quick and easy. This tool geocodes the location, then loads an interactive booking widget showing nearby H&R Block offices and available appointment time slots.