Supabase SQL Agent
With Composio’s managed authentication and tool calling, it’s easy to build
AI agents that interact with the real world while reducing boilerplate for
setup and authentication management. This guide will walk you through using
the Supabase CLI agent built with Composio
and LlamaIndex
.
Requirements
- Python 3.9+
- UV (recommended) or pip
- Composio API key
- OpenAI API key
- Understanding of building AI agents (Preferably with LlamaIndex)
Build an agent to perform Supabase tasks
This agent can convert your natural language queries to SQL queries and execute them on supabase for you. For you agent to be able to execute queries, you need to authenticate the agent for supabase.
Authenticating users
To authenticate your users with Composio you need an auth config for the given
app, In this case you need one for supabase. You can create and manage auth configs
from the dashboard.
Composio platform provides composio managed authentication for some apps to help
you fast-track your development, supabase
being one of them. You can use these
default auth configs for development, but for production you should always use
your own oauth app configuration.
Using dashboard is the preferred way of managing authentication configs, but if you want to do it manually you can follow the guide below
Click to expand
To create an authentication config for supabase
you need client_id
and client_secret
from your from your Google OAuth Console.
Once you have the required credentials you can use the following piece of
code to set up authentication for supabase
.
This will create an authentication config for supabase
which you can use to
authenticate your users for your app. Ideally you should just create one
authentication object per project, so check for an existing auth config
before you create a new one.
Once you have authentication management in place, we can start with connecting
your users to your supabase
app. Let’s implement a function to connect the users
to your supabase
app via composio.
Now, when creating tools for your agent always check if the user already has a connected account before creating a new one.
Create a chat loop
Using Composio for managed auth and tools
Composio reduces a lot of boilerplate for building AI agents with ability access
and use a wide variety of apps. For example in this cookbook, to build supabase
integration without composio you would have to write code to
- manage
supabase
oauth app - manage user connections
- tools for your agents to interact with
supabase
Using composio simplifies all of the above to a few lines of code as we’ve seen the cookbook.
Best practices
🔒 User Management:
- Use unique, consistent
user_id
values for each person - Each user maintains their own supabase connection
- User IDs can be email addresses, usernames, or any unique identifier
Troubleshooting
Connection Issues:
- Ensure your
.env
file has validCOMPOSIO_API_KEY
andOPENAI_API_KEY
- Check that the user has completed
supabase
authorization - Verify the user_id matches exactly between requests
API Errors:
- Check the server logs for detailed error messages
- Ensure request payloads match the expected format
- Visit
/docs
endpoint for API schema validation