check_terminology
ChatGPTFind words in a text that the brand avoids (with the brand's suggested replacement) and approved brand terms it uses. Use for a quick check of a draft's wording, or when the user asks whether a text uses the brand's terms. Whole-word, case-insensitive matching against the brand's term lists only: it doesn't judge tone, clarity or meaning (score_text does). Instant and doesn't use AI credits.
create_brand
ChatGPTAdd a new brand to the CommScore workspace from its name, website, language and country, plus any voice-guide fields you already have (for example from brand guidelines the user pasted). Use when the user wants to set up a brand in CommScore that list_brands doesn't show. Refuses an exact duplicate (same name and website). Only CommScore admins and members can create brands. Free; follow with research_brand to draft the voice guide from the website.
get_brand_profile
ChatGPTGet a brand's voice and language guide: tone, core idea, values, style do's and don'ts, audiences, and terms to use or avoid. Use when the user asks you to write or edit a communication for the brand (read it before drafting), or asks how the brand should sound. Doesn't use AI credits.
get_score_history
ChatGPTList the user's own documents scored in the CommScore Office add-in (Word and Outlook, last 90 days), with first and latest overall score. Pass an id to get one document's rounds with pillar scores. Use when the user asks how a document they scored in Word or Outlook improved, or what they scored there recently. Scores made in this conversation aren't listed. Shows only the signed-in user's scores. Instant and doesn't use AI credits.
list_brands
ChatGPTList the brands set up in the connected CommScore workspace, with their brand_id, website, industry, language and country. Use when you need a brand_id for another CommScore tool, or when the user asks which brands they have in CommScore. Brand names are not unique: if several brands share a name, use website and updated_at to tell them apart and confirm with the user which one they mean.
replace_brand_fields
ChatGPTOverwrite fields of a brand's voice guide, including its name. A list you pass (audiences, approved_terms, avoid_terms) replaces the whole existing list. Use when the user has confirmed they want existing content replaced; to add without overwriting, use update_brand_profile. Only CommScore admins and members can change brands. Free.
research_brand
ChatGPTDraft a brand's voice guide from its public website and web presence: values, customer charter, tone, writing principles, style examples, audiences, and terms to use or avoid. Saves nothing; returns suggestions for the user to review. Use when the user wants a brand's voice guide drafted, usually right after create_brand, or to fill gaps in an existing brand's guide. Only the brand name, website and country are sent to the web search. Uses the workspace's monthly AI credits and takes about 30 seconds.
rewrite_text
ChatGPTRewrite a communication in the brand's voice, keeping its facts and purpose, and summarise what changed. Use when the user asks to improve, fix or rewrite a communication for the brand; after score_text, pass its suggested_focus as focus. Uses the workspace's monthly AI credits and takes up to about a minute. Not available when the workspace's subscription excludes rewriting.
score_text
ChatGPTScore a communication against the brand on five pillars (clarity, certainty, structure/style/grammar, brand alignment, customer experience) from 1 to 5, with an overall score, a reading level and the top three things to fix. Use when the user asks to check, review, grade or compare a customer communication (email, letter, text message, notice, web or app copy, policy wording), or to check a draft you wrote for the brand before handing it over. To score a revised version, pass the previous result's draft.state as draft_state and the result shows the change since the last round. Uses the workspace's monthly AI credits and takes up to about a minute.
update_brand_profile
ChatGPTFill empty fields of a brand's voice guide and add audiences or terms. Never overwrites: fields that already have content are skipped and reported, and terms or audiences that already exist are kept. Use when saving content the user approved (from research_brand or their own guidelines). Only CommScore admins and members can change brands. Free.
