Expert agents

Automate the routine work

Expert agents handle the repetitive, rules-based parts of content production so your team can focus on work that requires human judgment. Set up as many as you need – multiple agents can run simultaneously, each working on different content independently. Here are some things you can automate:

• Automatically translate content into your target languages when a new language variant is created.
• Fill in SEO and GEO metadata before content moves to marketing review.
• Check content against your brand or compliance guidelines.
• Populate content automatically whenever a new content item is created.

How to set up expert agents

Upon activation, go to Environment settings > Expert agents to create a new agent.

1. Describe your agent

Provide details to help your teammates identify and understand the agent’s purpose.

1. Agent name – identifies the agent in the list.
2. Purpose – a short summary of what the agent does, such as “Translates blog posts to French.” This purpose is for your team’s reference and doesn’t affect how the agent works.
3. Management API key – grants the agent permission to access your content. If you don’t have a Management API key,  you can generate one in Project settings > API keys.

If you can’t access project settings to get your Management API key, contact your project manager.

2. Write clear instructions

In Instructions, tell the agent exactly what to do. Because expert agents can’t ask follow-up questions, your instructions need to be complete and self-contained – describe the input, the steps to take, and the expected output. Your instructions can be as simple or as detailed as the task requires, including conditional logic, structured sections, and formatting to keep long instructions readable. If your instructions are too long, simplify them or split the work across multiple agents with more focused tasks.

3. Specify when to run

Under Automation, you can set various activities and filters to start the agent when a specific content change occurs. For events: 

• Content item language variant created – an event when you create a new item or other language variants of the default content item.
• Workflow step changed to – an event that occurs when your content moves to a specific workflow step.

For filters:

• Content type – specify which content type the agent will work on.
• Collection – select which collection the content will be under.
• Language – scopes the agent to content items in a specific language.

4. Monitor your agents’ work

To see an agent’s run history, click View run history in the list. Each run shows the content item it acted on, its status, and when it ran. Click a run to see a summary of what the agent did.

Example

Here’s an example of how you might set up an agent that helps translate blog post content to a specific language. You can adapt this example to your project.

Blog post translator

1. Write these details to describe your agent:
   • Agent name: Blog post translator
   • Purpose: Translates blog posts into [your target language] when the content item reaches the [your workflow step] step
2. Provide the Management API key.
3. Customize the automation to start the agent:
   1. For events: select Workflow step changed to
      • Set the workflow step to [your workflow step for translation-ready content]
   2. For filters, select the following:
      • Content type: your content type, for example, Blog post
      • Collection: your collection, for example, Marketing
      • Language: [your target language]
4. Copy and paste the following into Instructions and adjust what's in your project:

Considerations

When using expert agents, keep in mind the following:

• Only product managers can access and manage expert agents.
• There are no hard usage limits, but a safety measure activates if many complex agentic runs occur simultaneously and risk overloading the infrastructure.
• Not all instructions require the same processing time – many short parallel tasks are typically fine; many long, complex simultaneous tasks may trigger the safety measure.
• Test your agent instructions on a few items manually before enabling automation at scale.
• If the safety measure activates, you receive an error message. Contact Support to identify the cause before the restriction is lifted. 
• Expert agents consume AI credits.

These considerations are meant to keep things running smoothly, not to limit what you can automate.

Help shape what comes next

Your input helps us improve this feature. If you have any suggestions, questions, or feedback, we’d love to hear from you. Share your experience using the button in Kontent.ai or in the Learn portal.