diff --git a/example-aisdk-agent/.env.example b/example-aisdk-agent/.env.example
index acfe4f3..06784a4 100644
--- a/example-aisdk-agent/.env.example
+++ b/example-aisdk-agent/.env.example
@@ -1,4 +1,4 @@
-# Plain API key for the machine user this agent runs as. Needs the Connected agent type, plus
+# 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=
diff --git a/example-aisdk-agent/README.md b/example-aisdk-agent/README.md
index cbf58cc..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 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 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 ad9393a..aa1382f 100644
--- a/example-eve-agent/.env.example
+++ b/example-eve-agent/.env.example
@@ -1,4 +1,4 @@
-# Plain API key for the machine user this agent runs as. Needs the Connected agent type, plus
+# 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.
 #
diff --git a/example-eve-agent/README.md b/example-eve-agent/README.md
index fa5c756..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 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 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