Adding Databases
Last updated: August 20, 2025
You can connect a database to your agent so it can access and use structured data. Zams supports MySQL, PostgreSQL, and SQL Server. This guide shows you how to add and configure a new database connection.
Prerequisites
Before you begin, ensure you have:
Access to your database (MySQL, PostgreSQL, or SQL Server).
Database credentials (host, username, password, database name, and port).
Whitelist the following IP addresses in your database’s firewall/security settings:
54.190.82.2544.224.213.12954.200.67.13454.200.67.134
Important: You must whitelist the IP addresses provided in the setup window. Otherwise, Zams cannot connect to your database.
Steps
Step 1: Open the Add Data Window
Inside your agent, go to the Data tab.
Click Add Data.
Step 2: Select Database Type
In the Type dropdown, select Database.
In the Database dropdown, choose your database type:
MySQL
PostgreSQL
SQL Server
Step 3: Whitelist IP Addresses
Copy the list of IP addresses displayed in the IP Addresses to Whitelist section.
54.190.82.2544.224.213.12954.200.67.13454.200.67.134Add these IPs to your database’s whitelist or firewall configuration.
Save the changes in your database security settings.
Note: Without whitelisting, the connection will fail.
Step 4: Enter Connection Details
In Display Name, enter a name you will use to identify this connection.
Fill in your database details:
Field | Description |
Host | The server address of your database |
Username | Your database login user |
Password | the password for your database user |
Database | the specific database name |
Port | the port number your database uses (commonly 3306 for MySQL, 5432 for PostgreSQL, 1433 for SQL Server) |
Step 5: Save and Test Connection
Click Connect.
If the connection is successful, your database will be linked to your agent.
Use tagging for referencing it on your prompts (e.g.
@Sales Database)