Skip to content

Commit 5b230f6

Browse files
committed
Split and rename multiple toolkits
1 parent 08fc524 commit 5b230f6

164 files changed

Lines changed: 2196 additions & 1479 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

examples/code/guides/agentauth/auth_with_google.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ import { google } from "googleapis";
55
* In this example, we will use Arcade to authenticate with Google and
66
* retrieve Gmail messages.
77
*
8-
* Consider using the Arcade Google toolkit, which simplifies the process for
8+
* Consider using the Arcade Gmail toolkit, which simplifies the process for
99
* retrieving email messages even further!
1010
*
1111
* Below we are just showing how to use Arcade as an auth provider, if you need to directly get a token to use with Google.

examples/code/guides/agentauth/auth_with_google.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
In this example, we will use Arcade to authenticate with Google and
99
retrieve Gmail messages.
1010
11-
Consider using the Arcade Google toolkit, which simplifies the process for
11+
Consider using the Arcade Gmail toolkit, which simplifies the process for
1212
retrieving email messages even further!
1313
1414
Below we are just showing how to use Arcade as an auth provider, if you need to directly get a token to use with Google.

examples/code/home/crewai/custom_auth_flow.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ def tool_manager_callback(tool_manager: ArcadeToolManager, tool_name: str, **too
5050

5151
manager = ArcadeToolManager(executor=tool_manager_callback)
5252

53-
tools = manager.get_tools(tools=["Google.ListEmails"], toolkits=["Slack"])
53+
tools = manager.get_tools(tools=["Gmail.ListEmails"], toolkits=["Slack"])
5454

5555
crew_agent = Agent(
5656
role="Main Agent",

examples/code/home/crewai/use_arcade_tools.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
manager = ArcadeToolManager(default_user_id="user@example.com")
66

7-
tools = manager.get_tools(tools=["Google.ListEmails"])
7+
tools = manager.get_tools(tools=["Gmail.ListEmails"])
88

99

1010
crew_agent = Agent(

examples/code/home/mcp/streamable-http/typescript-client.ts.fake

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ try {
6666
const callToolRequest: CallToolRequest = {
6767
method: "tools/call",
6868
params: {
69-
name: "Google_ListEmails",
69+
name: "Gmail_ListEmails",
7070
arguments: {
7171
n_emails: 5,
7272
},

pages/home/auth-providers/google.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ The Google auth provider enables tools and agents to call Google/Google Workspac
66

77
<Tip>
88
Want to quickly get started with Google services in your agent or AI app? The
9-
pre-built [Arcade Google toolkit](/toolkits/productivity/google/gmail) is what
9+
pre-built [Arcade Gmail toolkit](/toolkits/productivity/gmail) is what
1010
you want!
1111
</Tip>
1212

@@ -16,7 +16,7 @@ This page describes how to use and configure Google auth with Arcade.
1616

1717
This auth provider is used by:
1818

19-
- The [Arcade Google toolkit](/toolkits/productivity/google/gmail), which provides pre-built tools for interacting with Google services
19+
- The [Arcade Gmail toolkit](/toolkits/productivity/gmail), which provides pre-built tools for interacting with Google services
2020
- Your [app code](#using-google-auth-in-app-code) that needs to call Google APIs
2121
- Or, your [custom tools](#using-google-auth-in-custom-tools) that need to call Google APIs
2222

@@ -149,9 +149,9 @@ Use `client.auth.start()` to get a user token for Google APIs:
149149

150150
## Using Google auth in custom tools
151151

152-
You can use the pre-built [Arcade Google toolkit](/toolkits/productivity/google/gmail) to quickly build agents and AI apps that interact with Google services like Gmail, Calendar, Drive, and more.
152+
You can use the pre-built Arcade Google toolkits, like [Arcade Gmail toolkit](/toolkits/productivity/gmail), to quickly build agents and AI apps that interact with Google services like Gmail, Calendar, Drive, and more.
153153

154-
If the pre-built tools in the Google toolkit don't meet your needs, you can author your own [custom tools](/home/build-tools/create-a-toolkit) that interact with Google APIs.
154+
If the pre-built tools in the Google toolkits don't meet your needs, you can author your own [custom tools](/home/build-tools/create-a-toolkit) that interact with Google APIs.
155155

156156
Use the `Google()` auth class to specify that a tool requires authorization with Google. The `context.authorization.token` field will be automatically populated with the user's Google token:
157157

pages/home/auth-providers/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ You can create multiple auth providers of the same type, for example, you can ha
157157

158158
However, Arcade's tools are configured to select an auth provider by the type. This means that if you have multiple auth providers of the same type, Arcade will not know which one to use and authorizing the tool will fail.
159159

160-
To work around this, you can fork Arcade's tools and modify them to specify your own auth provider by the unique ID that you give each of them. For example, if you have two Google auth providers, `acme-google-calendar` and `acme-google-email`, you can modify Arcade's Google.ListEmails tool like this:
160+
To work around this, you can fork Arcade's tools and modify them to specify your own auth provider by the unique ID that you give each of them. For example, if you have two Google auth providers, `acme-google-calendar` and `acme-google-email`, you can modify Arcade's Gmail.ListEmails tool like this:
161161

162162
```python
163163
@tool(

pages/home/auth/auth-tool-calling.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ const client = new Arcade(); // Automatically finds the `ARCADE_API_KEY` env var
4343

4444
### Authorize a tool directly
4545

46-
Many tools require authorization. For example, the `Google.ListEmails` tool requires authorization with Google.
46+
Many tools require authorization. For example, the `Gmail.ListEmails` tool requires authorization with Google.
4747

4848
This authorization must be approved by the user. By approving, the user allows your agent or app to access only the data they've approved.
4949

@@ -57,7 +57,7 @@ USER_ID = "you@example.com"
5757

5858
# Request access to the user's Gmail account
5959
auth_response = client.tools.authorize(
60-
tool_name="Google.ListEmails",
60+
tool_name="Gmail.ListEmails",
6161
user_id=USER_ID,
6262
)
6363

@@ -74,7 +74,7 @@ const userId = "you@example.com";
7474

7575
// Request access to the user's Gmail account
7676
const authResponse = await client.tools.authorize({
77-
tool_name: "Google.ListEmails",
77+
tool_name: "Gmail.ListEmails",
7878
user_id: userId,
7979
});
8080

@@ -117,7 +117,7 @@ Once the user has approved the action, you can run the tool. You only need to pa
117117

118118
```python
119119
emails_response = client.tools.execute(
120-
tool_name="Google.ListEmails",
120+
tool_name="Gmail.ListEmails",
121121
user_id=USER_ID,
122122
)
123123
print(emails_response)
@@ -128,7 +128,7 @@ print(emails_response)
128128

129129
```js
130130
const emailsResponse = await client.tools.execute({
131-
tool_name: "Google.ListEmails",
131+
tool_name: "Gmail.ListEmails",
132132
user_id: userId,
133133
});
134134

pages/home/auth/call-third-party-apis-directly.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,7 @@ For each item in the list/array, you could use the [`users.messages.get`](https:
168168
</Steps>
169169

170170
<Note>
171-
Consider using the [Arcade Google toolkit](/toolkits/productivity/google/gmail), which simplifies the process for retrieving email messages even further! The pattern described here is useful if you need to directly get a token to use with Google in other parts of your codebase.
171+
Consider using the [Arcade Gmail toolkit](/toolkits/productivity/gmail), which simplifies the process for retrieving email messages even further! The pattern described here is useful if you need to directly get a token to use with Google in other parts of your codebase.
172172
</Note>
173173

174174
### How it works

pages/home/auth/how-arcade-helps.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ With Arcade, developers can now create agents that can _act as the end users of
2828

2929
### Auth permissions and scopes
3030

31-
Each tool in Arcade's toolkits has a set of required permissions - or, more commonly referred to in OAuth2, **scopes**. For example, the [`Google.SendEmail`](/toolkits/productivity/google/gmail#sendemail) tool requires the [`https://www.googleapis.com/auth/gmail.send`](https://developers.google.com/identity/protocols/oauth2/scopes#gmail) scope.
31+
Each tool in Arcade's toolkits has a set of required permissions - or, more commonly referred to in OAuth2, **scopes**. For example, the [`Gmail.SendEmail`](/toolkits/productivity/gmail#gmailsendemail) tool requires the [`https://www.googleapis.com/auth/gmail.send`](https://developers.google.com/identity/protocols/oauth2/scopes#gmail) scope.
3232

3333
A scope is what the user has authorized someone else (in this case, the AI agent) to do on their behalf. In any OAuth2-compatible service, each kind of action requires a different set of permissions. This gives the user fine-grained control over what data third-party services can access and what actions can be executed in their accounts.
3434

@@ -41,7 +41,7 @@ To learn how Arcade allows for actions (tools) to be authorized through OAuth2 a
4141

4242
### Tools that don't require authorization
4343

44-
Some tools, like [`Search.SearchGoogle`](/toolkits/search/google_search#searchgoogle), allow AI agents to retrieve information or perform actions without needing user-specific authorization.
44+
Some tools, like [`GoogleSearch.Search`](/toolkits/search/google_search#googlesearchsearch), allow AI agents to retrieve information or perform actions without needing user-specific authorization.
4545

4646
<Tabs items={["Python", "JavaScript"]} storageKey="preferredLanguage">
4747
<Tabs.Tab>
@@ -50,9 +50,9 @@ from arcadepy import Arcade
5050

5151
client = Arcade(api_key="arcade_api_key") # or set the ARCADE_API_KEY env var
5252

53-
# Use the Search.SearchGoogle tool to perform a web search
53+
# Use the GoogleSearch.Searchtool to perform a web search
5454
response = await client.tools.execute(
55-
tool_name="Search.SearchGoogle",
55+
tool_name="GoogleSearch.Search",
5656
input={"query": "Latest AI advancements"},
5757
)
5858
print(response.output.value)
@@ -64,9 +64,9 @@ import { Arcade } from "@arcadeai/arcadejs";
6464

6565
const client = new Arcade(api_key="arcade_api_key"); // or set the ARCADE_API_KEY env var
6666

67-
// Use the Search.SearchGoogle tool to perform a web search
67+
// Use the GoogleSearch.Search tool to perform a web search
6868
const response = await client.tools.execute({
69-
tool_name: "Search.SearchGoogle",
69+
tool_name: "GoogleSearch.Search",
7070
input: { query: "Latest AI advancements" },
7171
});
7272
console.log(response.output.value);

0 commit comments

Comments
 (0)