search_house_plans
Search free house plans
Use this when the user wants ready-made house plans, floor plan ideas or downloadable plans (for example "3 bedroom ranch under 2,000 sq ft", "small ADU", "barndominium"). Searches a library of about 500 free house plans by AI Architectures, each with a floor plan image, room sizes and free PDF, DXF, IFC and GLB downloads. Returns plan cards with links to the plan page and to change the plan in the CAD studio. Filters are optional; leave out what the user did not ask for.
輸入參數limitquerygaragestoriesbedroomsmax_sqftmin_sqftbathrooms
get_house_plan
Get a house plan
Use this to show one house plan from search_house_plans in detail: description, every floor plan image and all free download links (PDF plan set, DXF per level, IFC, GLB).
輸入參數slug必填
prepare_cad_drawing_link
Prepare a CAD studio link
Use this when the user wants a floor plan drawn as CAD (DXF/DWG) but is not signed in to an AI Architectures account here, or prefers to continue on the website, or wants to attach a sketch there. Returns a link that opens the Plan Chat CAD studio with the request already typed in; nothing is drawn or charged until the user presses send on the site.
輸入參數brief必填
get_design_tool_link
Link to an AI Architectures design tool
Use this when the user wants something AI Architectures does on its website from a photo or image: a remodel preview on a photo of their own home, a photoreal render from a sketch or model view, a render from a description, virtual staging, a listing photo kit, a clean floor plan image from a sketch or scan, a CAD drawing from a sketch, or before/after examples. Returns the page that does it; the user uploads the photo there.
輸入參數task必填
start_cad_drawing
Start a CAD drawing
Use this when the user asks to draw or design a floor plan as a real CAD drawing and wants it made now. The AI drafter of the Plan Chat CAD studio draws a layered, dimensioned plan (walls, doors, windows, furniture, dimensions, room names and areas) from the description and, if attached, a sketch or photo of a plan. Needs the user's AI Architectures account and spends credits from it (usually 700 to 1,800 credits per drawing; get_credit_balance shows the balance). Drawing takes 1 to 5 minutes; then call get_cad_drawing with the returned drawing_id. Confirm the brief with the user before starting.
輸入參數brief必填unitssketchsketch_url
get_cad_drawing
Get a CAD drawing
Use this to check a drawing started with start_cad_drawing (or one of list_my_cad_drawings): status, what the drafter says, room names, a preview image, the studio link and, when the account allows, DXF, DWG and PDF download links (valid for 10 minutes; call again for fresh ones). While it is still drawing this waits up to wait_seconds for it to finish.
輸入參數drawing_id必填wait_seconds
change_cad_drawing
Change a CAD drawing
Use this when the user asks to change one of their CAD drawings in words ("make the kitchen 4.2 m wide", "move the garage to the left", "add a window to bedroom 2"). The drafter makes the change as a new version (earlier versions stay in the studio). Spends credits from the user's AI Architectures account (usually 60 to 600 per change). Then call get_cad_drawing.
輸入參數change必填drawing_id必填
list_my_cad_drawings
List my CAD drawings
Use this when the user asks about their own drawings in the Plan Chat CAD studio. Lists them newest first with id, title, number of versions and whether one is being drawn now.
輸入參數limit
get_credit_balance
Get credit balance
Use this when the user asks how many AI Architectures credits their account has left before starting or changing a drawing.
無需輸入參數。
Return the AI Architectures account behind this connection. The opaque id is the account id, unique and unchanged across token refresh, reconnection and changes to the email or name.
無需輸入參數。
