Editorial improvements for #743

app/en/get-started/agent-frameworks/openai-agents/setup-python/page.mdx

@@ -7,7 +7,9 @@ import { Steps, Callout } from "nextra/components";
 
 # Setup Arcade with OpenAI Agents (Python)
 
-The [OpenAI Agents SDK](https://openai.github.io/openai-agents-python/) is a Python library for building AI agents. It provides an interface for defining agents with tools, system prompts, and model configurations.
+This guide shows you how to build a CLI agent with Arcade tools using the OpenAI Agents SDK for Python.
+
+The [OpenAI Agents SDK](https://openai.github.io/openai-agents-python/) is a Python library for building AI agents. It provides an interface for defining agents with tools, system prompts, and model configurations. You'll learn how to integrate Arcade's tools with OpenAI Agents to build functional agents that can work with services like Gmail and Slack through OAuth-protected APIs.
 
 <GuideOverview>
 <GuideOverview.Outcomes>
@@ -90,7 +92,7 @@ load_dotenv()
 
 ### Configure the agent
 
-Define which tools and MCP servers your agent can access:
+Define which tools and MCP servers your agent can access. You specify MCP servers by name:
 
 ```python filename="main.py"
 # Configuration
@@ -264,4 +266,4 @@ if __name__ == "__main__":
 
 - Add more tools by modifying `MCP_SERVERS` and `TOOLS`
 - Build a web interface instead of CLI using frameworks like FastAPI or Flask
-- Explore [creating custom tools](/guides/create-tools/tool-basics/build-mcp-server) with the Arcade Tool SDK
+- Explore [creating custom tools](/guides/create-tools/tool-basics/build-mcp-server) with the Arcade Tool SDK

app/en/get-started/agent-frameworks/openai-agents/setup-typescript/page.mdx

@@ -7,6 +7,8 @@ import { Steps, Tabs, Callout } from "nextra/components";
 
 # Setup Arcade with OpenAI Agents (TypeScript)
 
+Build an agent that uses Arcade tools to help users with Gmail and Slack.
+
 The [OpenAI Agents SDK for JavaScript](https://openai.github.io/openai-agents-js/) provides a framework for building AI agents in TypeScript and JavaScript. Arcade's `@arcadeai/arcadejs` library converts Arcade tools to the format OpenAI Agents expects.
 
 <GuideOverview>
@@ -174,7 +176,7 @@ async function main() {
     output: process.stdout,
   });
 
-  console.log("Hello! I'm your helpful OpenAI Agent! I use Arcade Tools to access your Gmail and Slack. Try asking me to summarize your recent emails or DM you on Slack!\n\nType 'exit' to quit.\n");
+  console.log("Hello I'm your helpful OpenAI Agent I use Arcade Tools to access your Gmail and Slack. Try asking me to summarize your recent emails or DM you on Slack!\n\nType 'exit' to quit.\n");
 
   // Track conversation history for multi-turn context
   let conversationHistory: any[] = [];
@@ -360,7 +362,7 @@ async function main() {
     output: process.stdout,
   });
 
-  console.log("Hello! I'm your helpful OpenAI Agent! I use Arcade Tools to access your Gmail and Slack. Try asking me to summarize your recent emails or DM you on Slack!\n\nType 'exit' to quit.\n");
+  console.log("Hello I'm your helpful OpenAI Agent I use Arcade Tools to access your Gmail and Slack. Try asking me to summarize your recent emails or DM you on Slack!\n\nType 'exit' to quit.\n");
 
   // Track conversation history for multi-turn context
   let conversationHistory: any[] = [];
@@ -396,4 +398,4 @@ main().catch(console.error);
 - Add more tools by modifying `MCP_SERVERS` and `INDIVIDUAL_TOOLS`
 - Build a web interface using frameworks like Next.js or Express
 - See the [Vercel AI SDK tutorial](/get-started/agent-frameworks/vercelai) for a complete web chatbot example
-- Explore [creating custom tools](/guides/create-tools/tool-basics/build-mcp-server) with the Arcade Tool SDK
+- Explore [creating custom tools](/guides/create-tools/tool-basics/build-mcp-server) with the Arcade Tool SDK