--- title: Agents description: Storyblok Agents is an in-app chat assistant that reads, analyzes, and updates the content of a space. url: https://www.storyblok.com/docs/manuals/agents --- # Agents Storyblok Agents is an in-app assistant with a chat-based interface. It can read, modify, and analyze the space’s content. Agents are LLM-powered and use the space’s [AI customization](https://www.storyblok.com/docs/manuals/ai-assistance#ai-customization). > [!NOTE] > Agents is part of [Storyblok Labs](https://www.storyblok.com/docs/manuals/labs) and is still in beta. ## What can agents do Agents supports 17 actions, named **tools**: 12 read-only and 5 with write access: | Capability | Access | | --- | --- | | Browse and search stories | Read | | Read a story's full content | Read | | Browse blocks | Read | | Read a block's field schema | Read | | Browse datasources | Read | | Read a datasource's entries | Read | | Browse assets | Read | | List releases | Read | | | | | Create a story | Write | | Update a story's content | Write | | Update a story's metadata | Write | | Publish a story | Write | | Unpublish a story | Write | Read actions run without confirmation, but any action that writes content or changes configuration requires manual approval. Confirmation prompts appear inline in the chat. To confirm or deny, choose the option or press **1** or **2** on your keyboard. [![The Storyblok Agents chat shows an inline confirmation prompt with numbered Create story and Cancel buttons.](https://a.storyblok.com/f/212319/d0062b9323/agents-confirm-actions.png/m/720x0/)](https://a.storyblok.com/f/212319/d0062b9323/agents-confirm-actions.png) The agent requires manual confirmation Because an agent acts on your behalf and with your permissions, any change it makes is attributed to you. > [!NOTE] > Agents work within a single space and depend on the [role](/docs/manuals/roles) and permissions of the user who prompts it: > > - The default **Editor** role includes the **Use agents** permission that lets you chat and schedule an existing custom agent. > - The default **Admin** role includes the **Manage agents** permission that also lets you create and manage custom agents. Agents can only access a specific space's content, not other spaces or the web. ### Specialized tools Beyond the core tools, agents can run four checks on your content: - **Content health audit**: scans the space for stale published pages, missing SEO titles and descriptions, images without alt text, and broken internal links. - **SEO check**: reviews a story's meta title and description, heading structure, alt text, and [schema.org](http://schema.org) markup. - **Link graph**: shows which stories a story links to and which link back. - **Translation status**: reports translation coverage per language configured in the space. ## Start a chat To start a new chat, open **Labs** → **Agents** and select **\+ New Chat**. To use a predefined prompt, select **Agent Suggestions** or choose an option from the **Quick actions** menu (the **+** in the chat message box). Once you send a message, the agent streams its reply. Afterward, it may offer suggested follow-up actions as buttons. While the agent replies, the **Send** button changes into a **Stop** button that pauses the reply. > [!TIP] > Reference stories in your prompts with **@-mentions**. Agents consume AI Credits, and the usage appears in the sidebar. Storyblok hides the usage counter when the space uses a custom AI customization. ## Predefined system prompts Storyblok includes a collection of ready-made system prompts available under **Agent Suggestions** or **Quick actions**. ### Agent suggestions To browse the list of prompts, select **Agent Suggestions**, then choose a suggestion to load it into a new chat, where you can run or edit it. You can search or filter the list by category. [![The Agent Suggestions panel listing predefined prompts with a search field and category filters.](https://a.storyblok.com/f/212319/0a2d579bd3/agents-agent-suggestions.png/m/720x0/)](https://a.storyblok.com/f/212319/0a2d579bd3/agents-agent-suggestions.png) Agent Suggestions with a list of predefined prompts ### Quick actions Some suggestions are available as **Quick actions**. Select **+** in the chat box, choose an action from the list, and run it. [![The chat composer plus menu showing the Final check before publishing, Find missing translations, and Stale content report Quick Actions.](https://a.storyblok.com/f/212319/9230930198/agents-quick-actions.png/m/720x0/)](https://a.storyblok.com/f/212319/9230930198/agents-quick-actions.png) Access Quick Actions from the chat box ## Custom agents Create custom agents to save a reusable prompt with its own instructions so you can rerun, schedule, and share with space users. These instructions define the agent's **behavior** (how it works and the rules it follows) and apply to every run. [![The Create Custom Agent form with fields for name, description, icon, color, and behavior instructions.](https://a.storyblok.com/f/212319/fc90dd4cf4/agents-new-custom-agent.png/m/720x0/)](https://a.storyblok.com/f/212319/fc90dd4cf4/agents-new-custom-agent.png) Create custom prompts To create a custom agent, open **Custom Agents** and select **New Agent**. Input a **Name** and an optional **Description**, and choose an **Icon** and **Color**. Next, in **Define your agent's behavior**, write the instructions the agent should follow whenever it runs, and **Save**. The agent appears in the **Custom Agents** list, ready to run or schedule. ## Scheduled tasks Scheduled tasks run a custom agent automatically. For example, set a **Translator Agent** assigned to translate content while preserving its meaning, tone, and formatting to run every day with the prompt “Translate any new or updated event pages into German.” The behavior stays the same on every run; the prompt instructs the agent which stories to translate that day. To schedule an agent, follow these steps: 1. Open **Scheduled** and select **Schedule Agent**. 2. Choose the agent to run. 3. Name the task and add a **prompt**: the specific task the agent runs each time, applied to its custom behavior. 4. Set the frequency (**Daily**, **Weekly**, or **Interval**), **Time**, and **Time zone**. 5. Select **Active** to enable or disable the task. 6. Choose **Schedule Agent** to save. Each scheduled task shows its frequency, activation status, and latest run. ## Manage your chat history Find a list of your recent conversations in the sidebar. To delete a conversation, open its menu and select **Delete**. Storyblok automatically archives conversations after 30 days of inactivity, and you can't access an archived conversation. ## Pagination - [Previous: Account](/docs/manuals/account) - [Next: AI Assistance](/docs/manuals/ai-assistance)