add_contact
ChatGPTUse this when the user gives a new number to save, or wants AiR to call a business or person that is not saved yet. Saves a new contact in the user's AiR contacts. Needs a name and at least one of: phone number, email or relationship. Returns the saved contact. Saved contacts are the people AiR can call.
ask_me
ChatGPTUse this when the work needs the user's answer and they are away from the screen: "text me before you deploy and wait for my yes". Texts the account owner's own phone a short question with optional choices (such as yes or no) and waits up to wait_seconds (at most 50) for the reply sent from that phone. Returns the reply when it arrives, else a question_id that get_reply checks until the question expires (at most 30 minutes). Only for when the user asked to be asked by text; not for a question to the user in this conversation, for asking anyone else, or for one-time codes or passwords.
cancel_reminder
ChatGPTUse this when the user wants to cancel or stop one of their reminders, wake-up calls or scheduled calls. Cancels it by its id, so it no longer fires; a repeating one stops for good. The id comes from list_reminders.
check_number
ChatGPTUse this when the user asks whether a call or text is a scam, or who a number is: "is this USPS text real?", "who keeps calling me from this number?". Checks the number's line type, carrier and caller-ID name, what AiR's call screening has seen of it (counts across users only) and, when the user pastes the message, its warning signs: look-alike links, requests for codes or payment, pressure to act. Returns a cautious verdict (high_risk, caution or no_warning_signs) with reasons and advice. Not proof either way, and not for blocking a number.
check_schedule
ChatGPTUse this when the user asks whether they are free on a day, or before booking or moving an appointment by phone. Lists the user's calendar events, reminders and task deadlines on one date.
create_reminder
ChatGPTUse this when the user wants a reminder at a set time by text or phone call: "call me at 7 to remind me", wake-up calls, "remind me to call the dentist tomorrow". At that time AiR texts the user, or phones them when how is "call". It contacts only the user; schedule_call is for calling someone else later. Not for countdown timers or alarms, which run on the user's own phone, or for location-based reminders. Give the time as ISO 8601 with offset (when) or as a delay (in_minutes). Returns the reminder id and its time.
find_business_number
ChatGPTUse this when the user wants AiR to call a business that is not in their contacts and names it with its town: "call Joe's Barbershop in Austin", "book a cleaning at Bright Smile Dental in Chicago". Looks the business up on Google Maps and checks each listed number's line type. Returns up to 3 places with name, address, phone number, Maps link and whether AiR can call that number (callable). Not for a number the user only wants to see or dial themselves, opening hours, reviews or other facts about a business, finding a person, or the user's own contacts (find_contact).
find_contact
ChatGPTUse this to look up someone the user names, by name, relationship or business ("my mom", "my wife", "the mechanic", "my dentist", "the pizza place"), in the user's saved AiR contacts, for example before AiR calls or texts them. Searches by name, relationship, phone number or email. Returns matching contacts with their name, phone number, email and relationship. Not needed when the user only wants help writing a message, or to message someone through another app.
get_call_result
ChatGPTUse this when the user asks how a call AiR placed went, what was said, or whether a hold call connected. Returns the call's status (dialing, in progress, completed, no answer, busy, failed; for a hold call, whether the user was connected) and the summary once the call has ended.
get_my_line_usage
ChatGPTUse this when the user asks about their AiR phone line: data used or left this period, hotspot left, plan name or whether the line is active. Shows each AiR line on the user's account: the number, its name, plan name, status, and data used and left with the period the figure covers, the day the counters reset, the next renewal date and travel data left. Not for plan advice, shopping for a plan or comparing carriers; it covers only the lines already on this account. Changing the plan or adding a number is not available through connected apps; that happens in the AiR app at useair.net/app.
get_reply
ChatGPTUse this after ask_me returned waiting, to see whether the user has replied. Waits up to wait_seconds (at most 50) and returns the state (answered, waiting or expired), the reply text and which choice it matches. Only the account owner's own phone can answer a question.
get_trip_readiness
ChatGPTUse this when the user is about to travel and asks whether their AiR phone will work there: "I'm going to Spain next week, will my phone work?", "will I have data in Mexico?". Checks each AiR line on the account (active or not, data and travel data left) and the user's last phone compatibility check, and returns steps for the trip. Coverage and costs in other countries are not part of it. Not for booking travel or for other carriers.
hold_and_connect
ChatGPTUse this when the user wants a person at a company's or agency's customer service without waiting on hold: "wait on hold for me", "get me a live person", "call me when someone picks up". AiR calls the published support number (toll-free or landline in the US or Canada; mobile numbers are refused), works the phone menu, holds up to 45 minutes, then rings the user's phone and connects them; the user does the talking. Connected call minutes count toward the user's plan. The reason only steers the menu ("speak to an agent" if none given). Not for 911 or 988. AiR texts progress. Returns a call_id.
list_recent_calls
ChatGPTUse this when the user asks who called, about missed or screened calls, or what happened on calls AiR made for them. Lists recent calls on the user's account, newest first: calls AiR placed for the user (who, when, status, duration, summary) and calls AiR answered while screening the user's forwarded number (caller, reason, outcome). Calls the user answered directly on their own phone are not included. It covers only the user's own calls and does not identify outside numbers.
list_reminders
ChatGPTUse this when the user asks what reminders, wake-up calls or scheduled calls they have. Lists the user's reminders and to-dos with their id, title, next time, repeat rule and how they are delivered. Shows open ones unless status says otherwise.
make_call
ChatGPTUse this when the user wants AiR to phone a business or person and do the talking: book, move or cancel an appointment, ask if something is in stock or ready, ask what something costs, or pass on a message. AiR calls a US or Canadian number from its own line and says it is an AI assistant calling for the user. Calls go to saved contacts, AiR lines and verified business numbers (find_business_number finds one); others return not_a_saved_contact. Not for waiting on hold (hold_and_connect), later calls (schedule_call), or 911 and 988. Returns a call_id. Calls last up to 10 minutes.
notify_me
ChatGPTUse this when the user asks AiR to text or call them now, or when something is done: "call me and say the report is ready", "text me when the build finishes". Sends the user's own phone a text from AiR, labelled as coming from the user's AI app, or with how "call" AiR phones the user and reads the message. It reaches only the account owner's own number, within a small hourly and daily limit. Not for texting or calling anyone else (send_sms, make_call) or for a reminder at a set time (create_reminder).
read_messages
ChatGPTUse this when the user asks whether someone replied to a text AiR sent, or what a contact texted AiR's number. Shows the recent texts and call notes between AiR and one phone number on this account, oldest first, with direction (in = from them, out = sent by AiR for the user), time and text. kind is text, call (said on a call), or call_goal (what AiR was asked to do on a call; not said aloud). One-time codes and PINs in the texts are shown as [code hidden]. It does not read the user's own phone's messages.
schedule_call
ChatGPTUse this when the user wants AiR to phone one of their saved contacts at a later time or on a repeating schedule ("call my grandma every Sunday at 11 to check in") and work toward a goal. The contact is found by name; phone_number picks the number when the contact has several. Not for reminders that phone the user themself (create_reminder). After each call the user gets a text saying how it went. Returns the scheduled call id, which cancel_reminder can cancel.
send_sms
ChatGPTUse this when the user asks to text someone now ("text Sam that I'm running late"). Sends the exact words in message from AiR's number (not the user's own phone) to one US or Canadian number. AiR adds its AI label ("AI assistant on behalf of" the user) unless the text already says an AI assistant wrote it. Not for drafting a message the user will send, for other messaging apps or email, or for reminders to the user (create_reminder). Returns whether the carrier accepted it.