Use specific tools

Applies to:

• Calling tools with LLMs

When you use a language model with Arcade AI, you can specify what tool(s) it can use:

response = client.chat.completions.create(
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {
            "role": "user",
            "content": "Star the ArcadeAI/arcade-ai repo on GitHub",
        },
    ],
    model="gpt-4o",
    user=user_id,
    tools=[
        "GitHub.SetStarred",
        "GitHub.CountStargazers",
    ],
    tool_choice="generate",
)

The tools parameter accepts:

• An array of one or more tool names, like GitHub.SetStarred. The model will only have access to the specified tools.
• An empty array (or nothing) to include all tools. The model will have access to all tools available to the Arcade Engine.

Even the best AI models struggle to choose between too many tools. For most use cases, specifying a list of tools will maximize accuracy and reliability.

To control how the model selects from the available tools, see Control tool choice.