Skip to content
Merged
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
2 changes: 1 addition & 1 deletion public/__redirects
Original file line number Diff line number Diff line change
Expand Up @@ -2449,7 +2449,7 @@
/workers/tutorials/store-data-with-fauna/ https://fauna.com/blog/the-future-of-fauna 301
/workers/tutorials/live-cursors-with-nextjs-rpc-do/ /resources/ 301
/workers/tutorials/automated-analytics-reporting/ /resources/ 301
/workers/ai/ /agent-lee/ 301
/workers/ai/ /workers-ai/ 301
/cloudflare-agent/ /agent-lee/ 301
/workers/development-testing/ /workers/local-development/ 301
/workers/development-testing/bindings-per-env/ /workers/local-development/bindings-per-env/ 301
Expand Down
62 changes: 56 additions & 6 deletions src/content/docs/agent-lee/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,18 +22,26 @@ An AI co-pilot built into the Cloudflare dashboard. Ask questions about your acc
</Description>

:::note[Beta]
Agent Lee is currently in beta and only available to accounts on a Free plan. Features and behaviors may change.
Agent Lee is currently in beta and available to accounts on a Free plan and to select Enterprise customers. Features and behaviors may change.

If you are on an Enterprise plan and would like access, contact your account team.
:::

With Agent Lee, you can:

- Ask questions about your account configuration and get answers based on your actual data.
- Make changes to DNS records, zone settings, and security rules, with your approval required before anything executes.
- Undo a change Agent Lee made earlier in the conversation.
- Run network diagnostics like DNS lookups and certificate checks.
- Generate inline charts and visualizations from your account analytics.
- Generate charts and visualizations from your account analytics.
- Find the right dashboard page for a task.
- Revisit your earlier conversations with Agent Lee.
- Open a Cloudflare Support case, if your account is eligible.

To get started, log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select **Ask AI** in the upper-right corner of any dashboard page.

Agent Lee was previously referred to as Cloudflare Agent.

---

## Capabilities
Expand All @@ -42,16 +50,24 @@ To get started, log in to the [Cloudflare dashboard](https://dash.cloudflare.com

Agent Lee answers based on your actual account data, not just documentation. When you ask a question, it fetches your zone configuration, DNS records, and security settings before responding.

It can also tell you whether your account is entitled to a particular Cloudflare feature, and which plan tier you are on, so you know whether something is available to you before you try to configure it.

### Write operations

You can ask Agent Lee to create, update, or delete resources across your account using natural language. Every write operation requires your explicit approval before it executes, Agent Lee shows you exactly what it plans to do and waits for confirmation.

If you would rather Agent Lee never change anything, you can grant it [read-only access](/agent-lee/manage-access/), which leaves questions and diagnostics available.

Example requests:

- "Add an A record for blog.example.com pointing to 192.0.2.10."
- "Enable Always Use HTTPS on my zone."
- "Set the SSL mode for example.com to Full (strict)."

### Undo a change

If Agent Lee made a change earlier in the conversation and you want to reverse it, ask it to undo the change. Agent Lee works out the inverse operation and presents it to you as a proposed write, which you approve in the same way as any other change. Undo is not automatic, and it cannot reverse changes made outside of Agent Lee.

### Network diagnostics

Run diagnostic commands to troubleshoot connectivity and configuration issues:
Expand All @@ -62,12 +78,43 @@ Run diagnostic commands to troubleshoot connectivity and configuration issues:

### Generative UI

Agent Lee renders inline charts and data visualizations directly in the chat panel based on your account analytics.
Agent Lee builds charts, tables, and metric summaries from your account analytics. Most visualizations appear in the chat panel as a card that you select to open the full-screen view.

Example requests:

- "Show me a chart of my traffic over the last 7 days."
- "What does my error rate look like for the past 24 hours?"

### Dashboard navigation

Agent Lee searches the dashboard's page index rather than guessing at URLs, so it can point you to the exact page for a task. Links open on the account you currently have selected.

Example requests:

- "Where do I configure page rules for example.com?"
- "Take me to my R2 bucket settings."

### Conversation history

Agent Lee can list, search, and summarize your previous conversations, so you can pick up where you left off without repeating context.

Example requests:

- "What did we decide about the SSL settings last week?"
- "Summarize my last conversation."

Agent Lee treats past conversation context as supplemental. It re-reads your live account data before answering rather than relying on what was true in an earlier session.

### Support case handoff

If Agent Lee cannot resolve your issue and your account is eligible for ticket-based support, it can prepare a Cloudflare Support case for you. Agent Lee always shows you the case and waits for your confirmation before filing anything — it never opens a case silently.

Eligibility depends on your support entitlement rather than your plan name alone. Accounts on a Free plan can file billing disputes, such as a duplicate charge or a charge after cancelling. Agent Lee limits how many cases you can open per account within a 24-hour period.

### Product knowledge

Agent Lee has built-in guidance for individual Cloudflare products — including DNS, SSL/TLS, R2, Workers, Cloudflare Tunnel, Gateway, Access, and WARP — and searches the Cloudflare developer documentation and changelog when it needs more detail. Grounding answers in the published changelog means Agent Lee will tell you when a product you asked about does not exist, rather than inventing one.

---

## Data access and privacy
Expand All @@ -90,7 +137,9 @@ Agent Lee fetches this data on demand when your question requires it.

### Conversation storage

Conversations are stored per user using [Durable Objects](/durable-objects/), isolated to your account. Conversation data is retained for one year in accordance with Cloudflare's data retention policy. Agent Lee does not currently reference previous conversation context when responding.
Conversations are stored per user using [Durable Objects](/durable-objects/). Conversation data is retained for one year in accordance with Cloudflare's data retention policy, measured from the last time you sent a message, so an actively used conversation is not purged while you are still working in it.

Agent Lee can list, search, and summarize conversations you have had with it. It cannot read another user's conversations.

### Data usage

Expand All @@ -103,10 +152,9 @@ Agent Lee does not currently use your conversations, prompts, or account data to
Agent Lee cannot:

- Deploy applications on your behalf or run code for you (it can generate small starter projects and [export the source](/agent-lee/take-home-code/) for you to clone)
- Replace [Cloudflare Support](https://support.cloudflare.com) for billing issues, account recovery, or outages
- Replace [Cloudflare Support](https://support.cloudflare.com) for account recovery or outages (it can prepare a support case for you, but only if your account is eligible and you confirm it)
- Access payment methods, billing history, or API tokens
- Operate across multiple accounts: sessions are scoped to your authenticated account
- Remember previous conversations: each session starts fresh
- Query raw log data or Logpush datasets
- Execute write operations without your explicit approval

Expand All @@ -123,13 +171,15 @@ Agent Lee is built on Cloudflare's own developer platform using the same primiti
| [Agents SDK](/agents/) | Agent lifecycle, state management, and scheduling |
| [Durable Objects](/durable-objects/) | Per-user conversation storage and write approval gate |
| [Workers AI](/workers-ai/) | LLM inference |
| [AI Gateway](/ai-gateway/) | Model request routing, logging, and analytics |
| [Cloudflare MCP server](/agents/model-context-protocol/apis/agent-api/) | Tool definitions for Cloudflare API operations |

---

## Related resources

- [Export generated code](/agent-lee/take-home-code/)
- [Manage access and permissions](/agent-lee/manage-access/)
- [Agents SDK](/agents/)
- [Human in the Loop](/agents/concepts/agentic-patterns/human-in-the-loop/)
- [Workers AI](/workers-ai/)
Expand Down
127 changes: 127 additions & 0 deletions src/content/docs/agent-lee/manage-access.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
---
title: Manage access and permissions
description: Control whether Agent Lee appears in the dashboard, choose what it is allowed to read and change, and review the API tokens it holds.
pcx_content_type: how-to
tags:
- AI
sidebar:
order: 3
head:
- tag: title
content: Manage access and permissions
products:
- agent-lee
---

import { Description, Steps } from "~/components";

<Description>

Control whether Agent Lee appears in the dashboard, choose what it is allowed to read and change, and review the API tokens it holds.

</Description>

:::note[Beta]
Agent Lee is currently in beta. The controls described here may change, and not every control is available to every account yet.
:::

Agent Lee acts on your account using an API token that it creates on your behalf, scoped to the permissions you grant. You decide whether the assistant appears at all, what it can read, and whether it can make changes.

## Open or hide Agent Lee

Select **Ask AI** in the upper-right corner of any dashboard page, or use a keyboard shortcut:

- `Cmd` + `/` on macOS, or `Ctrl` + `/` on Windows and Linux.
- Press `t` then `a` to toggle the sidebar.

### Turn Agent Lee off

If you do not want to use Agent Lee, you can hide it from the dashboard entirely.

<Steps>

1. In the Cloudflare dashboard, go to **Configurations** > **Preferences** for your account.

2. Find the **Cloudflare Agent** card and turn the setting off.

</Steps>

:::note
The dashboard has not finished adopting the Agent Lee name. This preference is still labelled **Cloudflare Agent**.
:::

Turning the setting off hides the **Ask AI** sidebar and disables the keyboard shortcuts, and the assistant loses its stored copy of your API token, so it can no longer reach your account. The dashboard also attempts to delete the underlying API token for you. To confirm the token is gone — or to remove it yourself — see [Review the tokens Agent Lee holds](#review-the-tokens-agent-lee-holds).

Turning the setting back on does not restore access automatically. You are asked to grant permissions again the next time you open the assistant.

Turning Agent Lee off does not delete your conversation history.

## Choose what Agent Lee can access

When you first grant access, you choose how much of your account the assistant can use. Depending on your account, you may see the following permission templates:

| Template | What it allows |
| --- | --- |
| **Full access** | Read your resources, and propose changes. Every write still requires your approval before it executes. |
| **Read only** | Read and inspect your resources. Agent Lee cannot change anything. |
| **Custom** | Choose individual permissions yourself. |

**Full access** does not mean unattended access. Agent Lee shows you exactly what it intends to do and waits for your confirmation before any change is made.

### Custom permissions

**Custom** opens a curated list of permissions grouped into categories such as Developer Platform, DNS and Zones, App Security, AI, Cloudflare One, Analytics and Logs, and Account. Each entry has independent read and write toggles, and you choose which accounts the grant applies to.

This list is a subset of everything a Cloudflare API token can express — it covers the products Agent Lee knows how to work with, not the entire API surface.

### What Agent Lee can never change

Some permissions are withheld no matter which template you pick or what you select under **Custom**. Agent Lee cannot write to:

- Account settings
- Account membership
- Billing
- API tokens

## When permission changes take effect

Changing permissions issues a new API token with the updated scope and replaces the one the assistant was using. The previous token is then deleted. Because the new token is created before the old one is removed, both may exist briefly.

Permission changes apply to your next message. Actions the assistant has already completed are not affected, and you do not need to start a new conversation for a change to take effect.

## Write access disabled by an administrator

An account administrator can prevent Agent Lee from making changes on your behalf. When this applies to you, the assistant shows a **Write off** indicator with a lock icon near the message box, and the tooltip reads:

> Write access has been disabled for your account by an administrator. You can still read and inspect resources.

In this state Agent Lee can still answer questions, run diagnostics, and inspect your configuration, but it cannot create, update, or delete anything. You cannot lift the restriction yourself — contact your account administrator.

The restriction applies only to the account where it was set. Your permissions on other accounts are unchanged.

## Review the tokens Agent Lee holds

Agent Lee's tokens appear alongside your own. To audit or remove them:

<Steps>

1. Go to **My Profile** > **API Tokens** in the Cloudflare dashboard.

2. Look for tokens named `Cloudflare Agent Token -` followed by a date.

3. Delete any token you no longer want. Deleting the token the assistant is currently using revokes its access immediately; you are asked to grant permissions again the next time you open it.

</Steps>

Reviewing this list is the reliable way to confirm that access has been removed after you turn Agent Lee off or narrow its permissions.

## Availability

Agent Lee is not available in the Cloudflare FedRAMP environment.

Availability is still rolling out, so the assistant and the controls on this page may not appear on every account yet.

## Related resources

- [Agent Lee overview](/agent-lee/)
- [Cloudflare API tokens](/fundamentals/api/get-started/create-token/)
6 changes: 3 additions & 3 deletions src/content/docs/ai/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -75,9 +75,9 @@ Explore all AI models available through Cloudflare, including hosted models on W
</RelatedProduct>

<RelatedProduct
header="Cloudflare Agent"
href="/cloudflare-agent/"
product="cloudflare-agent"
header="Agent Lee"
href="/agent-lee/"
product="agent-lee"
>
An AI-powered assistant that helps you navigate, configure, and manage
Cloudflare.
Expand Down
9 changes: 9 additions & 0 deletions src/content/docs/ai/related-products/agent-lee.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: Agent Lee
description: Use Agent Lee as an AI-powered assistant to navigate, configure, and manage Cloudflare.
sidebar:
order: 8
external_link: /agent-lee/
products:
- ai
---
10 changes: 0 additions & 10 deletions src/content/docs/ai/related-products/cloudflare-agent.mdx

This file was deleted.

6 changes: 3 additions & 3 deletions src/content/docs/ai/related-products/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,9 +52,9 @@ import { RelatedProduct } from "~/components";
</RelatedProduct>

<RelatedProduct
header="Cloudflare Agent"
href="/cloudflare-agent/"
product="cloudflare-agent"
header="Agent Lee"
href="/agent-lee/"
product="agent-lee"
>
An AI-powered assistant that helps you navigate, configure, and manage
Cloudflare.
Expand Down
1 change: 0 additions & 1 deletion src/icons/cloudflare-agent.svg

This file was deleted.

Loading