From b635c0862a443c253f401a5788e984b0867fec2a Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 8 Oct 2026 20:16:04 +0000 Subject: [PATCH 1/2] Link to the agent setup docs instead of describing the machine user UI Co-authored-by: Mathias Vagni --- example-aisdk-agent/.env.example | 6 +++--- example-aisdk-agent/README.md | 4 ++-- example-eve-agent/.env.example | 6 +++--- example-eve-agent/README.md | 4 ++-- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/example-aisdk-agent/.env.example b/example-aisdk-agent/.env.example index acfe4f3..f6337ca 100644 --- a/example-aisdk-agent/.env.example +++ b/example-aisdk-agent/.env.example @@ -1,6 +1,6 @@ -# Plain API key for the machine user this agent runs as. Needs the Connected agent type, plus -# threadDiscussion:read, threadDiscussion:edit, threadDiscussionMessage:create, -# threadDiscussionMessage:edit, thread:read and thread:reply. +# Plain API key for the machine user this agent runs as. Set it up as in +# https://www.plain.com/docs/agents, with threadDiscussion:read, threadDiscussion:edit, +# threadDiscussionMessage:create, threadDiscussionMessage:edit, thread:read and thread:reply. PLAIN_API_KEY= # Workspace webhook signing secret: Plain → Settings → Request Signing. diff --git a/example-aisdk-agent/README.md b/example-aisdk-agent/README.md index cbf58cc..c52a796 100644 --- a/example-aisdk-agent/README.md +++ b/example-aisdk-agent/README.md @@ -6,8 +6,8 @@ The protocol is documented [here](https://www.plain.com/docs/agents/internal-age ## Setting it up -1. Create a machine user under [Settings → Machine users](https://app.plain.com/~/settings/machine-users/) - and give it an API key. Set its **Type** to **Connected agent**. +1. Create a machine user for the agent and give it an API key, following + [Set up an agent](https://www.plain.com/docs/agents). Permissions: `threadDiscussion:read`, `threadDiscussion:edit`, `threadDiscussionMessage:create`, `threadDiscussionMessage:edit`, `thread:read` and diff --git a/example-eve-agent/.env.example b/example-eve-agent/.env.example index ad9393a..0b35ae1 100644 --- a/example-eve-agent/.env.example +++ b/example-eve-agent/.env.example @@ -1,6 +1,6 @@ -# Plain API key for the machine user this agent runs as. Needs the Connected agent type, plus -# threadDiscussion:read, threadDiscussion:edit, threadDiscussionMessage:create, -# threadDiscussionMessage:edit, thread:read and thread:reply. +# Plain API key for the machine user this agent runs as. Set it up as in +# https://www.plain.com/docs/agents, with threadDiscussion:read, threadDiscussion:edit, +# threadDiscussionMessage:create, threadDiscussionMessage:edit, thread:read and thread:reply. # # This file wins over an exported PLAIN_API_KEY in your shell. A stale one otherwise runs the agent # against a different workspace, which looks like an empty knowledge base. diff --git a/example-eve-agent/README.md b/example-eve-agent/README.md index fa5c756..fd77825 100644 --- a/example-eve-agent/README.md +++ b/example-eve-agent/README.md @@ -6,8 +6,8 @@ The protocol with the Plain API & webhooks is documented [here](https://www.plai ## Setting it up -1. Create a machine user under [Settings → Machine users](https://app.plain.com/~/settings/machine-users/) - and give it an API key. Set its **Type** to **Connected agent**. +1. Create a machine user for the agent and give it an API key, following + [Set up an agent](https://www.plain.com/docs/agents). Permissions: `threadDiscussion:read`, `threadDiscussion:edit`, `threadDiscussionMessage:create`, `threadDiscussionMessage:edit`, `thread:read` and From fe8120078772a863a3e9b15edbc8c49e10e55cf4 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 8 Oct 2026 20:24:57 +0000 Subject: [PATCH 2/2] Make the agent setup step read naturally Co-authored-by: Mathias Vagni --- example-aisdk-agent/.env.example | 6 +++--- example-aisdk-agent/README.md | 3 +-- example-eve-agent/.env.example | 6 +++--- example-eve-agent/README.md | 3 +-- 4 files changed, 8 insertions(+), 10 deletions(-) diff --git a/example-aisdk-agent/.env.example b/example-aisdk-agent/.env.example index f6337ca..06784a4 100644 --- a/example-aisdk-agent/.env.example +++ b/example-aisdk-agent/.env.example @@ -1,6 +1,6 @@ -# Plain API key for the machine user this agent runs as. Set it up as in -# https://www.plain.com/docs/agents, with threadDiscussion:read, threadDiscussion:edit, -# threadDiscussionMessage:create, threadDiscussionMessage:edit, thread:read and thread:reply. +# Plain API key for this agent's machine user (https://www.plain.com/docs/agents). Needs +# threadDiscussion:read, threadDiscussion:edit, threadDiscussionMessage:create, +# threadDiscussionMessage:edit, thread:read and thread:reply. PLAIN_API_KEY= # Workspace webhook signing secret: Plain → Settings → Request Signing. diff --git a/example-aisdk-agent/README.md b/example-aisdk-agent/README.md index c52a796..fcee8c4 100644 --- a/example-aisdk-agent/README.md +++ b/example-aisdk-agent/README.md @@ -6,8 +6,7 @@ The protocol is documented [here](https://www.plain.com/docs/agents/internal-age ## Setting it up -1. Create a machine user for the agent and give it an API key, following - [Set up an agent](https://www.plain.com/docs/agents). +1. [Create an agent machine user](https://www.plain.com/docs/agents) and give it an API key. Permissions: `threadDiscussion:read`, `threadDiscussion:edit`, `threadDiscussionMessage:create`, `threadDiscussionMessage:edit`, `thread:read` and diff --git a/example-eve-agent/.env.example b/example-eve-agent/.env.example index 0b35ae1..aa1382f 100644 --- a/example-eve-agent/.env.example +++ b/example-eve-agent/.env.example @@ -1,6 +1,6 @@ -# Plain API key for the machine user this agent runs as. Set it up as in -# https://www.plain.com/docs/agents, with threadDiscussion:read, threadDiscussion:edit, -# threadDiscussionMessage:create, threadDiscussionMessage:edit, thread:read and thread:reply. +# Plain API key for this agent's machine user (https://www.plain.com/docs/agents). Needs +# threadDiscussion:read, threadDiscussion:edit, threadDiscussionMessage:create, +# threadDiscussionMessage:edit, thread:read and thread:reply. # # This file wins over an exported PLAIN_API_KEY in your shell. A stale one otherwise runs the agent # against a different workspace, which looks like an empty knowledge base. diff --git a/example-eve-agent/README.md b/example-eve-agent/README.md index fd77825..117cefb 100644 --- a/example-eve-agent/README.md +++ b/example-eve-agent/README.md @@ -6,8 +6,7 @@ The protocol with the Plain API & webhooks is documented [here](https://www.plai ## Setting it up -1. Create a machine user for the agent and give it an API key, following - [Set up an agent](https://www.plain.com/docs/agents). +1. [Create an agent machine user](https://www.plain.com/docs/agents) and give it an API key. Permissions: `threadDiscussion:read`, `threadDiscussion:edit`, `threadDiscussionMessage:create`, `threadDiscussionMessage:edit`, `thread:read` and