Vanna 2.0 Explained for Business Users
The Simplest Explanation
Think of Vanna 2.0 as the difference between building a chatbot for yourself versus building one for your entire company.
When you build an AI agent for just yourself, you donât worry about:
- Who can see what data
- Who has permission to do what
- Tracking who did what and when
- How the AI sees data versus how users see it
But when you build an AI agent for your company, every single action needs to know which user is making the request so it can enforce the right permissions, show the right data, and keep an audit trail. And you need the AI to process data efficiently while giving users rich, interactive experiences.
Vanna 2.0 makes this automatic. Instead of spending months adding user permissions and building separate outputs for the AI versus the user interface, itâs built-in from day one.
What is Vanna 2.0?
Vanna 2.0 is a Python framework that solves the hardest problem in building production AI agents: making them work for multiple users safely.
The Problem
Most AI agent frameworks are built for demosâone user, no security concerns, no real data. When companies try to deploy these to real users, they hit a wall:
- Agent queries the database â But whose credentials should it use? What data can each user see?
- Agent reads files â But which workspace does this user have access to?
- Agent calls an API â But which userâs auth token should we use?
Companies end up spending 6+ months rewriting their entire agent to add user permissions, data isolation, and audit logging. Most never make it to production.
The Solution
Vanna 2.0 solves both problems:
1. User Identity Built-In
Every action an agent takes automatically knows:
- Who is making the request
- What permissions they have
- Which workspace theyâre in
This isnât something you configureâitâs impossible to build an agent in Vanna 2.0 without it.
2. Smart Display: The AI and Users See Different Things
When your agent queries a database and gets 10,000 rows:
- The AI sees: âQuery returned 10,000 rowsâ (just a summary)
- The user sees: A full interactive data table with sorting, filtering, and export
Why does this matter?
- Your AI processes faster and costs less (itâs not reading 10,000 rows)
- Your users get rich, interactive experiences (not just text summaries)
- You donât have to build this yourselfâit happens automatically
Real-World Example
Without Vanna 2.0:
User asks: "Show me customer revenue"
Agent queries database â Returns ALL customer data (security breach!)
Developer manually adds: Check user permissions
Developer manually adds: Filter query by user's allowed customers
Developer manually adds: Log who accessed what
Developer manually adds: Rate limit per userWith Vanna 2.0:
class DatabaseQueryTool(Tool):
    async def execute(self, args, context):
        # context.user automatically has identity & permissions
        connection = get_user_connection(context.user.id)
        results = connection.execute(args.sql)
        return resultsWho Is This For?
â You should use Vanna 2.0 if:
- Youâre building an AI agent that will have multiple users with different permissions
- You need database queries, file access, or API calls to respect user boundaries
- You want to go from prototype to production without rewriting everything
Key Benefits
- Multi-tenant from day one - Your prototype already handles 10,000 users safely
- Production-ready immediately - Permissions, audit logs, quotas built-in
- Token efficient + Rich UX - LLM sees summaries, users see full interactive results
The Bottom Line
Other frameworks make it easy to build a demo. Vanna 2.0 makes it easy to build something you can actually ship to customers.
If youâre building an AI agent for your company, your customers, or your usersânot just for yourselfâVanna 2.0 is built for you.
Next Steps
- Quick Start Guide - Get up and running in 5 minutes
- How It Works - Technical deep dive
- Why We Built This - Our journey and vision