[chore] update Mastra example docs to better match the example repo (#444)

* [chore] update Mastra example docs to better match the example repo

* [docs] toolkit cli usage mention

* [fix] variable refactor missed updates

* [chore] update agent directive

Author: rsmets

pages/home/mastra/use-arcade-tools.mdx

@@ -84,10 +84,13 @@ import {
 // Initialize Arcade
 const arcade = new Arcade();
 
+// Get Gmail toolkit
+// Toolkit names can be found in the Arcade dashboard via Tools > view > Toolkit or via the CLI `arcade workers list`
+const gmailToolkit = await arcade.tools.list({ toolkit: "Gmail", limit: 30 });
+
 // Get Gmail tools
-const googleToolkit = await arcade.tools.list({ toolkit: "gmail", limit: 30 });
-export const googleTools = toZodToolSet({
-	tools: googleToolkit.items,
+export const gmailTools = toZodToolSet({
+	tools: gmailToolkit.items,
 	client: arcade,
 	userId: "<YOUR_USER_ID>", // Your app's internal ID for the user (an email, UUID, etc). It's used internally to identify your user in Arcade
 	executeFactory: executeOrAuthorizeZodTool, // Checks if tool is authorized and executes it, or returns authorization URL if needed
@@ -104,13 +107,19 @@ import { Agent } from "@mastra/core/agent";
 import { anthropic } from "@ai-sdk/anthropic";
 
 // Create the Mastra agent with Arcade tools
-export const googleAgent = new Agent({
-  name: "googleAgent",
-  instructions: `You are a Google assistant that helps users manage their Google services (Gmail, Calendar, Sheets, Drive, and Contacts).
-  If a tool requires authorization, you will receive an authorization URL.
-  When that happens, clearly present this URL to the user and ask them to visit it to grant permissions.`,
+export const gmailAgent = new Agent({
+  name: "gmailAgent",
+    instructions: `You are a Gmail assistant that helps users manage their inbox.
+
+When helping users:
+- Always verify their intent before performing actions
+- Keep responses clear and concise
+- Confirm important actions before executing them
+- Respect user privacy and data security
+
+Use the gmailTools to interact with various Gmail services and perform related tasks.`,
   model: anthropic("claude-3-7-sonnet-20250219"),
-  tools: googleTools,
+  tools: gmailTools,
 });
 ```
 
@@ -126,21 +135,21 @@ Start the Mastra development server:
 npm run dev
 ```
 
-This will launch a local development playground, typically accessible at `http://localhost:4111`. Open this URL in your browser, select the `googleAgent` from the list of available agents, and start chatting with it directly in the UI.
+This will launch a local development playground, typically accessible at `http://localhost:4111`. Open this URL in your browser, select the `gmailAgent` from the list of available agents, and start chatting with it directly in the UI.
 
 **2. Programmatically:**
 
 Alternatively, you can interact with the agent directly in your code:
 
 ```typescript
 // Generate a response from the agent
-const response = await googleAgent.generate(
+const response = await gmailAgent.generate(
   "Read my last email and summarize it in a few sentences",
 );
 console.log(response.text);
 
 // Or stream the response for a more interactive experience
-const stream = await googleAgent.stream("Send an email to [email protected] with the subject 'Hello from Mastra'");
+const stream = await gmailAgent.stream("Send an email to [email protected] with the subject 'Hello from Mastra'");
 
 for await (const chunk of stream.textStream) {
   process.stdout.write(chunk);