#AI tools for editors
Hygraph provides AI tools that editors can use directly in the content editor: AI Agents and AI Assist. Both produce output for you to review. Neither tool can publish entries or make changes without your approval.
#AI Agents
Agents run tasks, such as translation, summarization, and SEO analysis, on content entries. An admin configures which agents are available and which models they apply to. As an editor, you trigger agents manually from the content table or content entry form, or they run automatically when an entry moves through a workflow step.
When an agent runs, it writes its output directly to the entry. The entry becomes read-only until you complete the review. Every field the agent changed is shown in a side-by-side diff so you can approve or revert changes field by field.
Hygraph provides three agent types:
| Agent | What it does |
|---|---|
| SEO Expert | Reviews your entry and posts a structured SEO report as a comment, covering content optimization, heading structure, and metadata gaps. |
| Translator agent | Translates content fields into one or more target locales. |
| Content summarizer | Generates a concise summary from one or more fields and writes it to a target field. |
See Trigger agents for the full task steps.
#AI Assist
AI Assist is an on-demand writing tool built into the content editor. You open it on any entry and run one of three tasks on individual fields:
- Create content: Generates new content for empty fields based on a prompt.
- Improve existing content: Refines existing text for clarity, tone, and readability.
- Translate content: Translates existing text into one or more target locales.
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. All suggestions appear in a review panel before anything is applied to the entry.
See Use AI Assist for the full task steps.
#Comparison
| AI Agents | AI Assist | |
|---|---|---|
| Triggered by | You (manually) or a workflow step (automatically) | You, on demand |
| Scope | One or more entries at a time | Individual fields within a single entry |
| Tasks | Translation, summarization, SEO analysis | Create, improve, translate |
| Review | Side-by-side diff per field, approve or revert | Suggestion panel, apply or reject |
| Configured by | Admin | Available to all editors out of the box |
#AI Guidelines
Guidelines are project-level instructions that give AI tools context about your brand, audience, and terminology. When guidelines are assigned to an agent or applied to an AI Assist task, the output reflects your specific requirements — not just generic AI output.
As an editor, you can read existing guidelines but cannot create or edit them. If agent output doesn't reflect your brand voice, uses the wrong terminology, or ignores compliance requirements, ask your admin to add or update the relevant guideline. See AI Guidelines for what each category covers.
#What's next
- Trigger agents: Trigger agents on entries from the Content Table or Content Form.
- Use AI Assist: Run AI Assist tasks on individual fields within an entry.
- AI Guidelines: Understand what guidelines are and how to request changes from your admin.