Abilities

Abilities are modular capabilities you attach to workflows or tasks. They extend what your AI agent can do during conversations — from searching the web to booking appointments to using custom tools you've built.

Without abilities, your agent can converse, collect form data, and follow workflow prompts. With abilities, it becomes a fully capable agent.

How Abilities Work

1. Add an ability to a workflow or task
2. The AI gains that capability during conversations in that context
3. The AI decides when to use the ability based on the conversation

Abilities can also have conditions (CEL expressions) that control when they activate — like only during business hours or only for VIP members.

Adding Abilities

Workflow-Level Abilities

Apply to all tasks in the workflow:

1. Open your workflow
2. Go to the Abilities tab
3. Click Add Ability
4. Configure and save

Task-Level Abilities

Apply only to a specific task:

1. Open the task in the workflow editor
2. Go to the Abilities tab
3. Click Add Ability

Task abilities override workflow abilities of the same type. Use this when a specific step needs different tool access than the rest of the workflow.

Built-in Abilities

Web Search

Let your AI search the internet for current information. No configuration needed — just enable it and the AI decides when to search.

Great for: looking up business hours, verifying facts, checking recent events, answering questions outside your knowledge base.

Calendar Booking

Give your AI access to check availability and book appointments on connected calendars.

• Select which calendar and event type to use
• Optionally allow editing existing bookings
• Requires a connected Google Calendar or native Gravity Rail calendar

File Access

Let your AI read, write, and search files and folders in your workspace.

• Choose specific files or folders to grant access to
• Fine-grained permissions: read, write, search, and create
• Works with folder indexing for semantic search

Data Access

Give your AI access to read or create form records beyond the current conversation.

• Select which form (data type) to access
• Configure read, create, and update permissions independently
• Add multiple Data Access abilities for different forms

Custom Toolkits

Attach tools you've built (or MCP server integrations) to give your AI entirely new capabilities.

• Select which toolkits to include
• Extend AI with your own integrations and business logic
• See the Toolkits developer guide for building tools

Phone Call Tools

Give AI control over voice calls.

• Hang Up: End calls gracefully (enabled by default)
• Forward: Transfer calls to other numbers or agents
• Pair with conditions for business-hours-only forwarding

Supervisor

Route complex requests to a supervisor AI for review. Creates a two-tier system where the primary AI escalates uncertain or sensitive requests.

• Optionally include conversation history for full context
• Useful for quality assurance, compliance review, and complex decision-making

Conditional Abilities

Make abilities activate only in certain situations using CEL expressions:

cel

Add conditions in the ability's Conditions field. The ability is only available to the AI when the condition evaluates to true.

Ability Order

When multiple abilities are attached, they execute in order. Drag to reorder in the abilities list.

Tips

• Start minimal — Add only the abilities your workflow actually needs. More abilities means more choices for the AI to make.
• Use conditions — Limit powerful abilities to appropriate contexts. Don't give every workflow access to everything.
• Test thoroughly — After adding abilities, run test conversations to make sure the AI uses them correctly and doesn't over-rely on them.
• Combine workflow and task levels — Add common abilities (like web search) at the workflow level, and specialized ones (like a specific calendar) at the task level.

Related

• Workflows — Build the conversation flows that abilities extend
• CEL Expressions — Write conditions to control when abilities activate
• Custom Toolkits — Build your own tools for AI to use