refinements

Author: jhaaaa

docs/pages/agents/build-agents/create-a-client.mdx

@@ -1,8 +1,6 @@
-# Create a client
+# Create an XMTP agent
 
-Create an XMTP client that connects your agent to the XMTP network. The client handles authentication, encryption, and message delivery. Your agent's logic (brain) is separate. The client just gives it the ability to send and receive messages.
-
-A [signer](/chat-apps/core-messaging/create-a-signer) links the client to an EOA or SCW wallet, which serves as your agent's identity on the network.
+Create an XMTP agent that can use the signing capabilities provided by the [signer](/chat-apps/core-messaging/create-a-signer). This signer links the agent to the appropriate EOA or SCW.
 
 ## Create an EOA signer
 
@@ -35,7 +33,7 @@ The XMTP Agent SDK allows you to use environment variables (`process.env`) for e
 | `XMTP_ENV`               | XMTP network environment (`local`, `dev`, or `production`)     | `XMTP_ENV=dev` or `XMTP_ENV=production` |
 | `XMTP_DB_ENCRYPTION_KEY` | Database encryption key for the local database (32 bytes, hex) | `XMTP_DB_ENCRYPTION_KEY=0xabcd...1234`  |
 
-Using environment variables, you can connect your agent to XMTP in just a few lines of code:
+Using the environment variables, you can set up your agent in just a few lines of code:
 
 ## Generate random keys
 
@@ -64,7 +62,7 @@ yarn gen:keys
 // Load variables from .env file
 process.loadEnvFile('.env');
 
-// Connect to XMTP using environment variables
+// Create agent using environment variables
 const agent = await Agent.createFromEnv();
 ```
 
@@ -142,7 +140,7 @@ loggingLevel?: LogLevel;
 
 ## Create a smart contract wallet (SCW) signer
 
-When working with smart contract wallets, you can connect your agent to XMTP using the wallet's seed or private key:
+When working with smart contract wallets, you can create an XMTP agent using the wallet's seed or private key:
 
 ```tsx [Node]
 import { Agent, createSigner, createUser } from '@xmtp/agent-sdk';
@@ -152,8 +150,8 @@ const walletData = await initializeWallet('wallet.json');
 const user = createUser(walletData.seed as `0x${string}`);
 const signer = createSigner(user);
 
-// Connect to XMTP with SCW signer
+// Create agent with SCW signer
 const agent = await Agent.create(signer);
 
 /* Add your own business logic here */
-```
+```

docs/pages/agents/get-started/build-an-agent.mdx

@@ -1,6 +1,6 @@
 import { KeyGenerator } from '../../../components/KeyGenerator';
 
-# Quickstart: Build an agent with XMTP
+# Build XMTP agents
 
 Use the [XMTP Agent SDK](https://www.npmjs.com/package/@xmtp/agent-sdk) to build agents that interact with the XMTP network.