diff --git a/app/en/get-started/agent-frameworks/page.mdx b/app/en/get-started/agent-frameworks/page.mdx index 08ce38a4b..1ba60f8f1 100644 --- a/app/en/get-started/agent-frameworks/page.mdx +++ b/app/en/get-started/agent-frameworks/page.mdx @@ -4,8 +4,8 @@ import { AgentFrameworkTabs } from "@/app/_components/agent-framework-tabs"; Arcade integrates with agent frameworks and MCP clients to add tool-calling capabilities to your AI applications. -These guides are for developers building AI applications who need to connect Arcade tools to their agent frameworks or MCP clients. You'll learn how to authenticate with Arcade, load tools, and execute them within your chosen framework. Each guide provides code examples and configuration steps to get you started quickly with the most popular frameworks and programming languages. +These guides are for developers building AI applications who need to connect Arcade tools to their agent frameworks or MCP clients. You'll learn how to authenticate with Arcade, load tools, and execute them within your chosen framework. Each guide provides code examples and configuration steps to get you started with the most popular frameworks and programming languages. ## Agent Frameworks - + \ No newline at end of file diff --git a/app/en/get-started/quickstarts/call-tool-agent/page.mdx b/app/en/get-started/quickstarts/call-tool-agent/page.mdx index 8b85f65bd..000790d60 100644 --- a/app/en/get-started/quickstarts/call-tool-agent/page.mdx +++ b/app/en/get-started/quickstarts/call-tool-agent/page.mdx @@ -9,6 +9,8 @@ import { AgentFrameworkTabs } from "@/app/_components/agent-framework-tabs"; # Calling tools in your agent with Arcade +Learn how to install and use the Arcade client to call tools in your AI agent. + Arcade gives your AI agents the power to act. With Arcade-hosted tools, your AI-powered apps can send Gmail, update Notion, message in Slack, and more. @@ -82,7 +84,7 @@ bun install @arcadeai/arcadejs -### Setup the client +### Set up the client @@ -196,7 +198,7 @@ async function authorize_and_run_tool({ ### Implement the workflow -In this example workflow, we: +In this example workflow, the following actions are performed: - Get the latest news about MCP URL mode elicitation - Create a Google Doc with the news @@ -208,7 +210,7 @@ In this example workflow, we: ```python filename="main.py" # This tool does not require authorization, so it will return the results -# without prompting the user to authorize the tool call. +# without requiring the user to authorize the tool call. response_search = authorize_and_run_tool( tool_name="GoogleNews.SearchNewsStories", input={ @@ -227,7 +229,7 @@ for search_result in news: output += f"{search_result['link']}\n\n" # Create a Google Doc with the news results -# If the user has not previously authorized the Google Docs tool, they will be prompted to authorize the tool call. +# If the user has not previously authorized the Google Docs tool, they will need to authorize the tool call. response_create_doc = authorize_and_run_tool( tool_name="GoogleDocs.CreateDocumentFromText", input={ @@ -254,7 +256,7 @@ response_send_email = authorize_and_run_tool( ) # Print the response from the tool call -print(f"Success! Check your email at {user_id}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:") +print(f"Success Check your email at {user_id}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:") print(response_send_email.output.value) ``` @@ -264,7 +266,7 @@ print(response_send_email.output.value) ```typescript filename="example.ts" // This tool does not require authorization, so it will return the results -// without prompting the user to authorize the app. +// without requiring the user to authorize the app. const response_search = await authorize_and_run_tool({ tool_name: "GoogleNews.SearchNewsStories", input: { @@ -285,7 +287,7 @@ for (const search_result of news) { } // Create a Google Doc with the news results -// If the user has not previously authorized the Google Docs tool, they will be prompted to authorize the tool call. +// If the user has not previously authorized the Google Docs tool, they will need to authorize the tool call. const respose_create_doc = await authorize_and_run_tool({ tool_name: "GoogleDocs.CreateDocumentFromText", input: { @@ -300,7 +302,7 @@ const google_doc = respose_create_doc.output?.value; // Send an email with the link to the Google Doc const email_body = `You can find the news about MCP URL mode elicitation in the following Google Doc: ${google_doc.documentUrl}`; -// Here again, if the user has not previously authorized the Gmail tool, they will be prompted to authorize the tool call. +// Here again, if the user has not previously authorized the Gmail tool, they will need to authorize the tool call. const respose_send_email = await authorize_and_run_tool({ tool_name: "Gmail.SendEmail", input: { @@ -313,7 +315,7 @@ const respose_send_email = await authorize_and_run_tool({ // Print the response from the tool call console.log( - `Success! Check your email at ${userId}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:` + `Success Check your email at ${userId}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:` ); console.log(respose_send_email.output?.value); ``` @@ -333,7 +335,7 @@ console.log(respose_send_email.output?.value); ``` ```text - Success! Check your email at {arcade_user_id} + Success Check your email at {arcade_user_id} You just chained 3 tools together: 1. Searched Google News for stories about MCP URL mode elicitation @@ -352,7 +354,7 @@ console.log(respose_send_email.output?.value); ``` ```text - Success! Check your email at {arcade_user_id} + Success Check your email at {arcade_user_id} You just chained 3 tools together: 1. Searched Google News for stories about MCP URL mode elicitation @@ -373,13 +375,13 @@ console.log(respose_send_email.output?.value); -## Next Steps +## Next steps In this example, we call the tool methods directly. In your real applications and agents, you'll likely be letting the LLM decide which tools to call. Learn more about using Arcade with Frameworks in the [Frameworks](/get-started/agent-frameworks) section, or [how to build your own tools](/guides/create-tools/tool-basics/build-mcp-server). -## Full Example Code +## Full example code @@ -416,7 +418,7 @@ def authorize_and_run_tool(tool_name, input, user_id): return client.tools.execute(tool_name=tool_name, input=input, user_id=user_id) # This tool does not require authorization, so it will return the results -# without prompting the user to authorize the tool call. +# without requiring the user to authorize the tool call. response_search = authorize_and_run_tool( tool_name="GoogleNews.SearchNewsStories", input={ @@ -436,7 +438,7 @@ for search_result in news: output += f"{search_result['link']}\n" # Create a Google Doc with the news results -# If the user has not previously authorized the Google Docs tool, they will be prompted to authorize the tool call. +# If the user has not previously authorized the Google Docs tool, they will need to authorize the tool call. response_create_doc = authorize_and_run_tool( tool_name="GoogleDocs.CreateDocumentFromText", input={ @@ -463,7 +465,7 @@ response_send_email = authorize_and_run_tool( ) # Print the response from the tool call -print(f"Success! Check your email at {user_id}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:") +print(f"Success Check your email at {user_id}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:") print(response_send_email.output.value) ``` @@ -523,7 +525,7 @@ async function authorize_and_run_tool({ } // This tool does not require authorization, so it will return the results -// without prompting the user to authorize the app. +// without requiring the user to authorize the app. const response_search = await authorize_and_run_tool({ tool_name: "GoogleNews.SearchNewsStories", input: { @@ -544,7 +546,7 @@ for (const search_result of news) { } // Create a Google Doc with the news results -// If the user has not previously authorized the Google Docs tool, they will be prompted to authorize the tool call. +// If the user has not previously authorized the Google Docs tool, they will need to authorize the tool call. const respose_create_doc = await authorize_and_run_tool({ tool_name: "GoogleDocs.CreateDocumentFromText", input: { @@ -559,7 +561,7 @@ const google_doc = respose_create_doc.output?.value; // Send an email with the link to the Google Doc const email_body = `You can find the news about MCP URL mode elicitation in the following Google Doc: ${google_doc.documentUrl}`; -// Here again, if the user has not previously authorized the Gmail tool, they will be prompted to authorize the tool call. +// Here again, if the user has not previously authorized the Gmail tool, they will need to authorize the tool call. const respose_send_email = await authorize_and_run_tool({ tool_name: "Gmail.SendEmail", input: { @@ -572,11 +574,11 @@ const respose_send_email = await authorize_and_run_tool({ // Print the response from the tool call console.log( - `Success! Check your email at ${userId}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:` + `Success Check your email at ${userId}\n\nYou just chained 3 tools together:\n 1. Searched Google News for stories about MCP URL mode elicitation\n 2. Created a Google Doc with the results\n 3. Sent yourself an email with the document link\n\nEmail metadata:` ); console.log(respose_send_email.output?.value); ``` - + \ No newline at end of file