Hygraph
Docs

#Use AI Assist

AI Assist is an on-demand writing tool built into the content editor. Open it on any entry to generate new content, improve existing text, or translate fields into other locales, without leaving the editor. All suggestions appear in a review panel before anything is applied to the entry.

AI Assist works on single line text, multi line text, Markdown, and rich text fields. You can run a task on up to five fields at once.

#Open AI Assist

  1. Open an entry in the content editor.
  2. In the top bar, click AI Assist. A panel opens showing the available tasks for this entry.

#Choose a task

TaskUse when
Create contentFields are empty and you need to generate content from a prompt.
Improve existing contentFields have content you want to refine for clarity, tone, or readability.
Translate contentFields have content you want to convert into another locale.

#AI Assist tasks

#Create content

Use Create content to generate new content for one or more empty fields based on a short prompt. AI Assist produces suggestions based on your prompt and the fields you select. This is useful when creating new entries or filling multiple empty fields at once.

  1. Under Available tasks, select Create content.
  2. Under Fields, select the fields you want to generate content for. Up to five fields can be selected. Only single line text, multi line text, Markdown, and rich text fields are shown.
  3. Under Locale, choose the language for the generated content.
  4. Under Guidelines to apply, select the guidelines you want to apply to the task. If no guidelines appear in the list, none have been set up for your project yet. Ask your admin to add them. See AI Guidelines for what each category covers.
  5. Optionally, under Tone of voice, choose a tone.
  6. In the Prompt field, describe what you want AI Assist to generate. Include keywords, desired structure, or tone guidance to improve the output.
  7. Click Generate.
  8. Review each suggestion in the panel, and either click Apply to write the content to the field, or click Reject to discard the suggestion.

#Improve existing content

Use Improve existing content to refine text for clarity, tone, and readability. AI Assist analyzes the selected fields and suggests enhanced versions while preserving the original meaning. This is useful when reviewing drafts, maintaining consistency across locales, or polishing your content before publishing.

  1. Under Available tasks, select Improve existing content.
  2. Under Fields, select the fields you want to improve. Only fields with existing content are shown. Up to five fields can be selected.
  3. Under Locale, choose the language of the content.
  4. Under Guidelines to apply, select the guidelines you want to apply to the task. If no guidelines appear in the list, none have been set up for your project yet. Ask your admin to add them. See AI Guidelines for what each category covers.
  5. Optionally, under Tone of voice, choose a tone.
  6. In the Prompt field, describe how you want the content improved. For example: Simplify complex sentences or Make the tone more conversational.
  7. Click Generate.
  8. Review each suggestion in the panel, and either click Apply to write the content to the field, or click Reject to discard the suggestion.

#Translate content

Use Translate content to automatically translate existing text into another locale while preserving tone, structure, and meaning. AI Assist recognizes your project's locale setup and streamlines translations directly in the editor. This is useful to maintain consistent messaging across multiple languages.

  1. Under Available tasks, select Translate content.
  2. Under Fields, select the fields you want to translate. Only fields with existing content are shown. Up to five fields can be selected.
  3. Under Source locale, choose the language of the original content.
  4. Under Target locale, select the language to translate into. You can select more than one locale if your project supports multiple.
  5. Under Guidelines to apply, select the guidelines you want to apply to the task. If no guidelines appear in the list, none have been set up for your project yet. Ask your admin to add them. See AI Guidelines for what each category covers.
    • If your project has a Glossary guideline assigned, you can use it here to ensure consistent terminology across locales.
  6. Optionally, under Tone of voice, choose a tone.
  7. Optionally, in the Prompt field, add regional style guidance. For example: Adapt for British English spelling or Use formal register.
  8. Click Generate.
  9. Review each translation in the panel, and either click Apply to write the content to the field, or click Reject to discard the suggestion.
    • If translated output uses the wrong term for a product name or technical concept, ask your admin to add it to the Glossary guideline.

#Review suggestions

After generating output for any task, AI Assist displays suggestions in the panel before writing anything to the entry.

Review each suggestion in the panel, and either click Apply to write the content to the field, or click Reject to discard the suggestion.

Once applied, AI Assist edits are saved like any manual update and can be edited at any time.

#Troubleshooting

#No fields appear in the field selector

For Create content, the entry needs at least one empty supported field. For Improve existing content and Translate content, the entry needs at least one supported field with existing content.

#Generated content does not match expectations

Revise your prompt to be more specific. Check the Tone of voice setting. Try selecting fewer fields per run to give AI Assist more focused context. If the output consistently misses your brand voice or terminology, ask your admin to set up guidelines.

#Translation output is inaccurate

Confirm the target locale is enabled in your project. Add regional style guidance in the prompt field. If specific terms are consistently wrong, ask your admin to add them to a Glossary guideline.

#AI Assist tasks are unavailable

Your project may have reached its AI token limit for the billing period. Check with your admin.

#What's next

  • AI tools for editors: Overview of all AI tools available to editors.
  • Trigger agents: Trigger agents on entries from the Content Table or Content Form.
  • AI Guidelines: Understand what guidelines are and how to request changes from your admin.