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

AI Assist - Create content

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

AI Assist - Improve existing content

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

AI Assist - Translate content

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

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

#What's next

• AI Agents: Explore AI Agents to automate content tasks through manual runs or workflow steps.
• MCP server: Explore the MCP server for direct AI assistant integration with your Hygraph project.