Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions fern/products/docs/pages/ai/fern-agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,50 @@ Fern Agent is an expansion of Fern Writer. Fern Writer opened documentation pull
What Fern Agent adds is context on your organization and more places to work from. Alongside editing, it answers questions about your traffic, reader questions, deployments, and site configuration, and the same capabilities are now available in the Fern Dashboard and in your coding agent over MCP rather than in Slack alone.
</Note>

## Automations

Create an automation on the **Automations** page of the [Fern Dashboard](https://dashboard.buildwithfern.com/), or describe the recurring work in the chat panel or Slack and Fern Agent sets it up. Each run starts a fresh conversation from the prompt, works it in a single turn, and reports back on what it did, found, or skipped. An automation only changes the docs when the prompt explicitly requests it.

### Setup

<Steps>
<Step title="Write the prompt">
Open **Automations**, select **New automation**, and describe what each run should look at and produce. Every run has your organization's docs, analytics, reader feedback, Ask Fern conversations, and search queries available to it. A prompt holds up to 2,000 characters.
</Step>

<Step title="Authorize Fern">
Select **Authorize** and complete the browser prompt. A run acts with the Fern permissions of whoever created the automation, so an unattended run needs that person's authorization first. One authorization covers all your automations.
</Step>

<Step title="Set the schedule">
Choose daily or a day of the week, a time of day, and the timezone that time is read in, then turn the automation on. A schedule fires at most once every 20 hours.
</Step>

<Step title="Check what a run produces">
Select **Run now** instead of waiting for the schedule, since running by hand leaves the next scheduled run where it was. Runs take a few minutes, and **Past runs** lists each one with a link to its conversation, where the report and any pull request are.
Comment thread
devin-ai-integration[bot] marked this conversation as resolved.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] <FernStyles.Current> reported by reviewdog 🐶
Avoid time-relative terms like 'now' that become outdated

</Step>

<Step title="Get told when a run finishes">
With Fern Agent [connected to Slack](#setup), every finished run is reported in Slack: the automation's name, whether the run finished or failed, and a link to its conversation. The report is a direct message to whoever created the automation, which requires their Slack account to be linked to `@Fern`.

Set **Slack notifications** on the automation to name a channel that receives the report instead when it isn't.
</Step>
</Steps>

Everyone in your organization sees every automation, and only its creator can change, delete, or run one. Turning an automation off keeps its prompt and history, while deleting it discards both — pull requests its runs opened are unaffected. An organization can keep up to 10 automations, and run history covers the last 30 days.

### Examples

<Prompt title="Fix what readers complained about">
Review the feedback readers left on our docs pages and fix the pages they said were missing information, wrong, or unclear. Make the changes and open a pull request. Ignore feedback about the product rather than the docs.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.We> reported by reviewdog 🐶
Try to avoid using first-person plural like 'our'.

</Prompt>

<br />

<Prompt title="Report on how the docs are doing">
Report on how our docs are doing: the pages readers spend the most time on, where they drop off, the searches that return nothing, and what changed since last week.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.We> reported by reviewdog 🐶
Try to avoid using first-person plural like 'our'.

</Prompt>

## Privacy and data handling

Fern Agent acts with your own Fern permissions on every surface, so it reads and edits only the sites, analytics, and organization data your account can already see. Requests are scoped to a single session: the prompt, any Slack message or thread you tag it in, and attached files are stored to complete the task and aren't retained afterward.
Expand Down
2 changes: 1 addition & 1 deletion fern/products/docs/pages/ai/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Your users can ask a question instead of searching for one. Ask Fern answers wit

## Build your docs with AI

You can hand your docs to an agent. [Fern Agent](/learn/docs/ai-features/fern-agent) writes them from inside Fern, opening a pull request with the change you describe. The coding agent you already use writes them too, once Fern's skill and MCP server teach it how Fern Docs sites are built. Fern also generates realistic API examples from your spec.
You can hand your docs to an agent. [Fern Agent](/learn/docs/ai-features/fern-agent) writes them from inside Fern, opening a pull request with the change you describe, either on request or on a [schedule you set](/learn/docs/ai-features/fern-agent#automations). The coding agent you already use writes them too, once Fern's skill and MCP server teach it how Fern Docs sites are built. Fern also generates realistic API examples from your spec.

<CardGroup cols={2}>
<Card title="Fern Agent" icon="robot" href="/learn/docs/ai-features/fern-agent" />
Expand Down
8 changes: 8 additions & 0 deletions fern/products/docs/pages/changelog/2026-08-31.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,11 @@
## Fern Agent automations
Comment thread
devin-ai-integration[bot] marked this conversation as resolved.

<ChangelogTags>ai</ChangelogTags>

You can now put Fern Agent on a schedule. Create an automation on the **Automations** page in the [Fern Dashboard](https://dashboard.buildwithfern.com/). You can also describe the recurring work in the chat panel or in Slack and Fern Agent will set up an automation. Each run reviews your reader feedback, unanswered Ask Fern questions, search queries, or analytics, reports back what it found, and opens a pull request when the prompt asks for a change.

<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/ai-features/fern-agent#automations">Read the docs</Button>

## GraphQL types in API References

<ChangelogTags>api-reference</ChangelogTags>
Expand Down
Loading