assess_readiness
ChatGPTProvide explicitly requested native forms or a legacy illustrated welcome payload. For a new illustrated assessment, call render_assessment directly with {view:{screen:"welcome"}} as the first and only tool in the turn; this tool is not a prerequisite. Set presentation to native only when the user explicitly requests ChatGPT-native forms; unsupported native hosts receive the illustrated welcome view. To resume existing answers, use get_assessment and render the prepared partial assessment. Guests receive complete results without saving. Use optional context only after the user confirms the minimal professional summary. Never export memories or infer scored answers. Never automatically save or change account settings.
delete_account
ChatGPTApp-only account deletion after the user types delete in the confirmation box. Permanently removes saved assessments, preferences and the AI Ireland sign-in profile; invalidates sessions and revokes connections. Pending provider cleanup is retried. Minimal revocation markers and recovery history have separate retention. Never report pending as complete.
delete_assessment
ChatGPTPermanently delete a specified saved assessment after the user requests deletion. Safe to retry. After success, render_assessment can show an assessment_deleted receipt.
delete_guest_assessments
ChatGPTPermanently delete results owned by the private guest recovery key, after typing delete in the component. Does not delete linked account records.
evaluate_assessment
ChatGPTCalculate a directional readiness stage and three practical actions from explicit user answers. Unknown and skipped answers are missing evidence. Does not save answers. For a visual result, pass this result with its assessment and questionnaire to render_assessment.
export_account_data
ChatGPTApp-only complete account data export for the signed-in owner. Return the private payload only to the app for a user-requested JSON file download. No tokens or credentials. Do not send the export to model context.
export_guest_assessments
ChatGPTExport only results owned by the private guest recovery key. App-only; never ask the model to handle recovery keys.
get_assessment
ChatGPTGet six readiness questions for a personal or company assessment. For interactive UI, pass these questions and the explicit answers collected so far to render_assessment. Text-only clients can ask one question at a time. Optional confirmed professional context customises question wording, examples and followUp prompts without changing answer anchors. Keep the same context in assessment.context when rendering/evaluating. Use followUp only when needed, never to fill answers yourself. Confidence (1–5) and pain point are optional.
get_preferences
ChatGPTRead the signed-in user’s assessment preferences and native settings form schema. Does not save answers or change settings. Requires assessments:read.
get_privacy_information
ChatGPTAnswer questions about GDPR rights, retained data, memory, downloading all stored AI Ireland data and permanent account deletion. Use these factual answers and sources. For interactive controls, render the returned view using render_assessment. Text-only clients can use the authenticated accountUrl to download data or type delete in the website confirmation box. Do not promise deletion of host conversations, external provider accounts, security markers or immediate backup erasure. Contact support for rights requests beyond the self-service data download.
get_saved_assessment
ChatGPTRetrieve one of the signed-in user’s assessments and its original versioned result. For a visual saved plan, pass this record to render_assessment with screen saved.
list_assessments
ChatGPTList the signed-in user’s most recent 100 saved assessments, without full answers. For a visual history, pass this list to render_assessment with screen history.
record_event
ChatGPTRecord anonymous assessment event categories only. No answers, free text, account IDs, or conversation content are accepted.
render_assessment
ChatGPTsave_assessment
ChatGPTSave full answers, confirmed professional context and the recalculated result. The illustrated component calls this on completion after disclosing automatic saving. Conversation-only callers must obtain an explicit save request. Guests require the private component recovery key; OAuth links the current result to the account. Requires consent true. Reuse the same idempotencyKey when retrying. After success, render_assessment can show a saved receipt.
update_preferences
ChatGPTChange only explicitly selected assessment preferences on the signed-in account. Omitted fields remain unchanged. Does not save assessment answers. Requires assessments:write.