Skip to content

Conversation

@torresmateo
Copy link
Collaborator

@torresmateo torresmateo commented Dec 7, 2025

Preview here

This PR reworks the main quickstart to move from 3 disconnected tool calls to a more useful workflow that features

  • 1 tool call with secrets (no auth required)
  • 2 tool calls with auth (same provider, but scope elevations required for the second tool call)

The workflow itself:

  • Fetches the latest news using Google News (secret-based tool)
  • Creates a Google Doc with the titles of the news
  • Sends a link to the Google Docs to the user using Gmail

Since there is a helper function now, the structure of the code went from a single piece of code, to 3 sections of code to make it easier and faster to digest.


Note

Reworks the quickstart into an end-to-end agent tool-calling workflow with auth, updates nav titles, and bumps @next/third-parties to 16.0.7.

  • Docs
    • Quickstart overhaul: Rewrite app/en/home/quickstart/page.mdx to a workflow-based guide:
      • Adds client setup for Python/JS, a reusable auth+execute helper, and a 3-step workflow using GoogleNews.SearchNewsStories, GoogleDocs.CreateDocumentFromText, and Gmail.SendEmail.
      • Updates prerequisites, outcomes, and next steps; adds full example code tabs for both languages.
    • Navigation: Rename quickstart title in app/en/home/_meta.tsx to "Calling tools in your agent".
  • Dependencies
    • Bump @next/third-parties from 16.0.1 to 16.0.7 (lockfile updated).

Written by Cursor Bugbot for commit ccffeca. This will update automatically on new commits. Configure here.

@vercel
Copy link

vercel bot commented Dec 7, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Dec 11, 2025 7:05pm

@torresmateo
Copy link
Collaborator Author

Converted this back to draft because Vercel builds are failing

@torresmateo torresmateo marked this pull request as ready for review December 7, 2025 01:39
Copy link
Contributor

@vfanelle vfanelle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a few points of feedback:

  • Updated apps to agents in the title
  • Asked to put 'from arcadepy import Arcade' in Step 2 code snippet
  • I got stuck completing the QuickStart and left a screenshot of the last output I got.

Create a new script called `example.py`:

```python filename="example.py"
from arcadepy import Arcade
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add the import of Arcade to the top of the "setup the client" code snippet?

from arcadepy import Arcade

// You can also set the `ARCADE_API_KEY` environment variable instead of passing it as a parameter.
const client = new Arcade(
apiKey: "{arcade_api_key}",
);
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: JavaScript syntax error in Arcade constructor

The JavaScript example code in the "Example Code" section has invalid syntax. The new Arcade() constructor call is missing the opening curly brace for the object literal. It reads new Arcade( apiKey: ...) but it needs to be new Arcade({ apiKey: ... }). Compare this with the correctly formatted version earlier in the document (lines 94-96). Users copying this code will get a syntax error.

Fix in Cursor Fix in Web

tool_name: string,
input: any,
user_id: string,
}) {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: TypeScript syntax in JavaScript .mjs file examples

The authorize_and_run_tool function uses TypeScript type annotations (: { tool_name: string, input: any, user_id: string }) but the file is named example.mjs (JavaScript module). TypeScript syntax won't run in a plain JavaScript file. Users copying this code will get a syntax error when running it with node example.mjs.

Additional Locations (1)

Fix in Cursor Fix in Web

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants