This guide walks you through using AI Assist in the Hygraph content editor. For an overview of what AI Assist can do, see AI Assist overview.

#Prerequisites

Before you begin, ensure you have:

#Permissions reference

AI Assist is enabled for all users with editor access. No additional configuration is required.

#Step 1 - Open AI Assist

1. In the Hygraph content editor, navigate to the entry you want to work on.
2. In the top bar, click AI Assist. A panel appears showing the tasks available for this entry.

#Step 2 - Choose a task

Under Available tasks, select the action that fits your requirement:

Proceed to the section below that matches your chosen task.

#Step 3 - Configure and run the task

#Create content

Use Create content to generate new content for one or more empty fields based on a short prompt. AI Assist analyzes the field type and entry context to produce relevant suggestions that fit your content model and structure. This is useful when creating new entries or filling multiple empty fields at once.

AI Assist - Create content

1. Under Available tasks, select Create content.
2. Under Fields, select the fields you want to generate content for. Only single line text, multi line text, markdown, and rich text fields are shown. You can select up to five fields.
3. Under Locale, choose the language for the generated content.
4. (Optional) Under Tone of voice, choose the tone that should apply to the generated content.
5. In the Prompt field, describe what you want AI Assist to generate. Be as specific as possible. Include keywords, tone guidance, or structural requirements to improve the output.
6. Click Generate. AI Assist processes your request and displays the generated suggestions.
7. Review each suggestion, make any necessary edits, and click Apply to update the content in your entry.

#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.

AI Assist - Improve existing content

1. Under Available tasks, select Improve existing content.
2. Under Fields, select the fields you want to improve. Only supported field types with existing content are shown. You can select up to five fields.
3. Under Locale, choose the language of the content you want to improve.
4. (Optional) Under Tone of voice, choose the tone that should apply to the improved content.
5. In the Prompt field, describe how you want the content improved. For example:
   • Simplify complex sentences
   • Fix grammar and flow
   • Make the tone more conversational
6. Click Generate. AI Assist processes your request and displays refined versions of your text.
7. Review each suggestion, make any necessary edits, and click Apply to update the content in your entry.

#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.

AI Assist - Translate content

1. Under Available tasks, select Translate content.
2. Under Fields, select the fields you want to translate. Only supported field types with existing content are shown. You can select up to five fields.
3. Under Source locale, choose the language of the original content.
4. Under Target locale, select the language to translate into. If your project supports multiple locales, you can select more than one.
5. (Optional) Under Tone of voice, choose the tone that should apply to the translated content.
6. (Optional) In the Prompt field, provide regional style guidance. For example:
   • Use a friendly tone suitable for a marketing audience
   • Adapt for British English spelling
7. Click Generate. AI Assist processes your request and displays translated versions of your text in the selected target locales.
8. Review each translation, make any necessary edits, and click Apply to update your entry.

#Review and apply suggestions

After generating output for any task, AI Assist presents suggestions in the panel for review before anything is written to the entry.

• Review each field suggestion and make any edits needed.
• Apply changes to insert the AI-generated content into the corresponding field.
• Reject any suggestion you do not want to use. Rejected output is not saved.

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

#Best practices

• Be specific in your prompts. Include keywords, desired structure, or tone guidance to get more accurate suggestions.
• For bulk operations, select multiple fields at once to reduce the number of AI Assist runs needed per entry.
• For translation tasks, add regional style guidance in the prompt field to handle locale-specific conventions such as spelling variants or formality levels.
• Check your AI token balance on the Billing page if tasks stop generating. You may have reached your plan's token limit for the billing period.

#Troubleshooting

#AI Assist panel does not appear

• Confirm you have editor access on the project.
• Verify the content model includes at least one supported field type: single line text, multi line text, markdown, or rich text.
• Refresh the page and try opening the panel again.

#No fields appear in the field selector

• For Create content, confirm the entry has at least one supported empty field.
• For Improve existing content and Translate content, confirm the entry has at least one supported field with existing content. Empty fields are not shown for these tasks.

#Generated content does not match expectations

• Revise your prompt to be more specific. Include the desired tone, length, structure, or keywords.
• Check the Tone of voice setting. If a tone is configured, it may be overriding your prompt guidance.
• Try selecting fewer fields per run to give AI Assist more focused context.

#Translation output is inaccurate or missing

• Confirm the target locale is enabled in your Hygraph project.
• Verify the source fields contain content before running the translation task.
• Add a prompt with regional style or formality guidance to improve accuracy for specific locales.

#AI Assist tasks are unavailable

• Check your AI token balance on the Billing page. Tasks are unavailable if your project has exhausted its token allowance for the billing period.
• Contact your project administrator to confirm AI Assist is enabled for your plan.

#Next steps

• Review AI token consumption on the Billing page.
• Explore AI Agents to automate content workflows without manual editor intervention.