# Use AI Assist

How to use AI Assist in the Hygraph content editor to create, improve, and translate content on individual fields.

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

| Task | Use when |
|---|---|
| **Create content** | Fields are empty and you need to generate content from a prompt. |
| **Improve existing content** | Fields have content you want to refine for clarity, tone, or readability. |
| **Translate content** | Fields 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](https://hygraph.com/docs/hygraph-ai/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](https://hygraph.com/docs/hygraph-ai/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](https://hygraph.com/docs/hygraph-ai/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](https://hygraph.com/docs/editor-guides/ai-tools/ai-tools-for-editors): Overview of all AI tools available to editors.
- [Trigger agents](https://hygraph.com/docs/editor-guides/ai-tools/trigger-agents-editors): Trigger agents on entries from the Content Table or Content Form.
- [Connect an AI assistant](https://hygraph.com/docs/editor-guides/ai-tools/connect-ai-assistants-editors): Connect Claude directly to your content with your own Hygraph login.
- [AI Guidelines](https://hygraph.com/docs/hygraph-ai/ai-guidelines): Understand what guidelines are and how to request changes from your admin.