XanoScript for AI Agents

Introduction

AI Agents in Xano allow you to define intelligent, autonomous workflows powered by models like Gemini, OpenAI, or Claude, directly in XanoScript.

Anatomy

Every XanoScript Agent follows a predictable structure. Here’s a quick visual overview of its main building blocks — from declaration at the top to tools at the bottom.

It’s a little different from other primitives, because the settings are defined in the llm block, instead of a separate settings block.

You can find more detail about each section by continuing below.

Section 1: Declaration

Every Agent starts with a declarative header that specifies its type, name, and description.

XanoScript

// This agent answers the user's question to the best of its ability.
agent "Answer a Question" {
  canonical = "Zwt3YW_3"
  tags = ["tag1", "tag2"]
}

Element	Required	Description
`agent`	✅	Declares an Agent primitive and its name.
`description`	no	A short summary of the agent. May also appear as a “//” comment above the block.
`canonical`	no	The canonical ID for this Agent.
`tags`	no	An array of strings used to categorize or filter Agents.

Section 2: LLM

The llm block defines how your Agent interacts with its underlying AI model. All standard model configuration options available in the UI are represented here. These are a little different from other primitives, because the settings available can change based on the model chosen.

XanoScript

llm = {
  type         : "google-genai"
  system_prompt: "You are a helpful AI Agent that tries to answer the user's query using the best possible information. You are also required to log each interaction using the logging tool."
  max_steps    : 5
  prompt       : "Here is the user's query: {{ $args.query }}"
  ...

Element	Required	Description
`type`	✅	The model host provider. Supported: `openai`, `anthropic`, `google-genai`, `xano-free`.
`system_prompt`	no	Core instructions defining the Agent’s role and behavior.
`max_steps`	no	How many steps (tool calls) the Agent can take before stopping.
`prompt`	no	Additional context or message prompt. Use `{{ $args.property }}` for dynamic data.
`api_key`	no	API key for the chosen model provider.
`model`	no	Specific model to use.

Xano Free Model (Gemini)

These settings are specific to the Xano Free Model (Gemini).

XanoScript

  temperature     : 1
  search_grounding: false
  thinking_tokens : 0
  include_thoughts: false

Element	Required	Description
`temperature`	no	Controls randomness of output. Lower = more deterministic.
`search_grounding`	no	For Gemini, whether to enable Google Search grounding.
`thinking_tokens`	no	For reasoning models, sets thinking budget.
`include_thoughts`	no	Whether to include reasoning traces in the response.

Anthropic (Claude)

XanoScript

  api_key      : "abc123"
  model        : "claude-4-sonnet-20250514"
  temperature  : 1
  reasoning    : true

Element	Required	Description
`api_key`	✅	API key for the chosen model provider.
`model`	✅	Specific model to use.
`temperature`	no	Controls randomness of output. Lower = more deterministic.
`reasoning`	no	Whether to include reasoning traces in the response.

Google Generative AI (Gemini)

XanoScript

  api_key         : "abc123"
  model           : "gemini-2.5-flash"
  temperature     : 1
  search_grounding: false
  thinking_tokens : 0
  include_thoughts: false

Element	Required	Description
`api_key`	✅	API key for the chosen model provider.
`model`	✅	Specific model to use.
`temperature`	no	Controls randomness of output. Lower = more deterministic.
`search_grounding`	no	For Gemini, whether to enable Google Search grounding.
`thinking_tokens`	no	For reasoning models, sets thinking budget.
`include_thoughts`	no	Whether to include reasoning traces in the response.

OpenAI

OpenAI settings are similar to the other models, but also includes some additional advanced settings.

OpenAI Settings

XanoScript

  api_key         : "abc123"
  model           : "gpt-5-mini"
  temperature     : 1
  reasoning_effort: ""

Element	Required	Description
`api_key`	✅	API key for the chosen model provider.
`model`	✅	Specific model to use.
`temperature`	no	Controls randomness of output. Lower = more deterministic.
`reasoning_effort`	no	For reasoning models, sets how much effort the model spends thinking during generation.

OpenAI Advanced Settings

XanoScript

  organization    : ""
  project         : ""
  compatibility   : "strict"

Element	Required	Description
`organization`	no	The organization to use.
`project`	no	The project to use.
`compatibility`	no	The compatibility level to use.

Section 3: Tools

The tools block defines the tools that an Agent can use. Tools are functions that an Agent can call as part of its steps to resolve the task at hand.

XanoScript

tools = [
  {name: "Get_User_Info"}
  {name: "Create_Support_Ticket"}
]

Element	Required	Description
`tools[]`	✅	The tools that the Agent can use.
`name`	✅	The name of the tool.

Full Example

Below is a more complete Agent definition that combines multiple settings:

XanoScript

// Handles customer inquiries and support requests automatically.
agent "Customer Support Agent" {
  canonical   = "SUPPORT_AGENT_001"
  tags        = ["support", "customer-service"]

  llm = {
    type            : "anthropic"
    system_prompt   : "You are a helpful Customer Support Agent that resolves issues efficiently..."
    max_steps       : 8
    prompt          : "Customer inquiry: {{ $args.customer_message }}"
    api_key         : "{{ $env.ANTHROPIC_KEY }}"
    model           : "claude-3-7-sonnet-latest"
    temperature     : 0.3
    send_reasoning  : true
    thinking        : {
      type          : "enabled",
      budget_tokens : 10000
    }
  }

  tools = [
    { name: "Get_User_Info" },
    { name: "Update_User_Info" },
    { name: "Create_Ticket" }
  ]
}

What’s Next

Now that you understand how to define Agents in XanoScript, here are a few great next steps:

Explore the function reference

Learn about the built-in functions available in the stack to start writing more complex logic.

Try it out in VS Code

Use the XanoScript VS Code extension with Copilot to write XanoScript in your favorite IDE.

Learn about AI Tools

AI Tools are used to define the actions that an Agent can take.

Start

AI

References

Introduction

Anatomy

Section 1: Declaration

Section 2: LLM

Xano Free Model (Gemini)

Anthropic (Claude)

Google Generative AI (Gemini)

OpenAI

OpenAI Settings

OpenAI Advanced Settings

Section 3: Tools

Full Example

What’s Next

Explore the function reference

Try it out in VS Code

Learn about AI Tools

​Introduction

​Anatomy

​Section 1: Declaration

​Section 2: LLM

​Xano Free Model (Gemini)

​Anthropic (Claude)

​Google Generative AI (Gemini)

​OpenAI

​OpenAI Settings

​OpenAI Advanced Settings

​Section 3: Tools

​Full Example

​What’s Next

Explore the function reference

Try it out in VS Code

Learn about AI Tools

Introduction

Anatomy

Section 1: Declaration

Section 2: LLM

Xano Free Model (Gemini)

Anthropic (Claude)

Google Generative AI (Gemini)

OpenAI

OpenAI Settings

OpenAI Advanced Settings

Section 3: Tools

Full Example

What’s Next