analyze_job_offer
ChatGPTUse this when the user provides a job post to tailor a resume to: analyzes it with the website's service (role, contract, weighted requirements) and returns an operationId to pass to tailor_resume as offerOperationId, so the job post is not analyzed twice. Pass the job post text; resolve a job URL to its text first. Do not use to judge a resume against a job; use analyze_resume_job.
analyze_resume_job
ChatGPTUse this when the user asks how well their resume matches a specific job post, without rewriting it. Pass the resume text (cvText), the job post text (offerText) and the guestToken. Returns an operationId and a coverage score from 0 to 100 with the requirements demonstrated, partly demonstrated, missing or unclear, each with its job post and resume evidence. The score is neither an ATS guarantee nor a hiring probability. Do not use to tailor the resume or produce a PDF; use tailor_resume. Identical retries reuse the operation.
audit_resume_rewrite
ChatGPTUse this when the user wants to check a rewritten resume against its original: compares both texts and reports which changes the original supports, which need confirmation and what was dropped, with the source lines. Does not rewrite the resume or produce a PDF. Identical retries reuse the operation.
create_guest_context
ChatGPTUse this when no Matchaa guestToken exists yet in this conversation: opens a private guest space, without an account. Reuse the returned guestToken for every later Matchaa call in the conversation, including edits, and keep it private. A limited number of complete adaptations is free in a guest space; edits, previews and downloads do not use them. Do not open another guest space to get around that limit.
create_tailored_resume
ChatGPTUse this when the user provides a resume or CV (attached PDF or pasted text) and a specific job posting, and wants a tailored resume as a finished PDF. One call does everything: reads the resume, analyzes the job post, rewords the experience with the posting's vocabulary without inventing skills, fits it on one page and returns the PDF with a preview card. Works for any job, internship or apprenticeship (alternance), in French or English. Pass the job post text; resolve a job URL to its text first. Optional: guestToken returned by an earlier Matchaa call, templateId when the user asked for a design, language to force the resume language. Do not use for cover letters, interview preparation or general career advice. For changes to a delivered resume, use update_resume or rewrite_resume_section with the returned operationId and guestToken.
finalize_resume
ChatGPTUse this when a reviewed revision is ready to deliver: requires the fresh previewReceipt of this exact revision and previewReviewed=true after you actually examined its image or PDF. Refuses a missing, expired or other revision's preview, overflowing text, or a PDF missing the name, summary, experience or education titles. These checks do not prove that facts are true. Freezes the revision, without another adaptation, and returns its private PDF link.
get_operation
ChatGPTUse this when a Matchaa call was interrupted or returned running: reports the status of an operation in this guest space. If it failed or its lease expired, call the original tool again with exactly the same arguments to resume it without another charge.
get_resume_document
ChatGPTUse this when a resume PDF link has expired or the user asks for the link again: renews the private signed link to the same PDF, valid up to one hour, without another adaptation or charge.
import_resume
ChatGPTUse this when the user provides a resume to tailor with Matchaa, as an attached PDF or pasted text: reads it with the website's reader, without adapting it. Pass the attached PDF as cvFile rather than transcribing it yourself. Returns the read profile for review and an operationId to pass to tailor_resume as sourceOperationId. Exact retries reuse the same reading. Do not use for a job post; use analyze_job_offer.
inspect_resume
ChatGPTUse this when you need to look at the current revision yourself before finalizing: returns the PNG pixels and the previewReceipt directly, without a card or a user click. Actually examine the image. If your client cannot read the pixels, use preview_resume instead. Same ownership and rendering checks. No AI call.
list_resume_templates
ChatGPTUse this when you need to pick or change the resume design: lists the 19 Matchaa templates, what each suits and the valid palette, font and spacing values, as text. Choose the template yourself from the profile, the amount of content and the preferences already stated; do not ask the user unless they want to choose. Photo templates need a photo the user already provided. Do not use to apply a design to a delivered resume; use update_resume with templateId.
preview_resume
ChatGPTUse this when you need to show or check the current revision and your client cannot read the images returned by inspect_resume: returns the exact PNG through a card, layout warnings and a private PDF link. Returns the previewReceipt required by finalize_resume; any change needs a new preview. No AI call. If the image cannot be used, say so and do not claim a visual review.
render_resume_template
ChatGPTUse this when the user wants the same tailored resume in another Matchaa template: renders a new private PDF from the latest revision with exactly the same content, without another adaptation or AI call. Pass the latest operationId. Identical retries reuse the export.
rewrite_resume_section
ChatGPTUse this when the user asks to reword or shorten the summary, or to reword one experience bullet: uses the Matchaa website's targeted rewriting from the latest revision and creates a new revision, keeping facts and qualifiers. userRequest quotes the user's request. Review the result. For wording the user supplied, use update_resume.
tailor_resume
ChatGPTUse this when the user wants their resume tailored to a specific job post: runs the same adapter as the Matchaa website (rewords the experience with the job post's vocabulary, never invents skills) and keeps a private draft PDF with a before/after report and source evidence. Prefer the operationIds returned by import_resume and analyze_job_offer; otherwise pass the attached PDF (cvFile) or the resume text, with the job post text. If interrupted, call it again with exactly the same arguments to resume. Do not use for wording or design changes to a tailored resume; use update_resume or rewrite_resume_section.
update_resume
ChatGPTUse this when the user asks to change a tailored resume: exact text edits, additions or removals based on what the user said, or the template, palette, font or density. Creates a new revision from the latest operationId, without AI or another adaptation; earlier revisions stay available to undo. For content edits, userRequest must quote the user's request; never add a fact the user did not state. Do not use to tailor the resume to another job; use tailor_resume.
