Install from Snowflake Marketplace
Sema4.ai Team Edition is available only to selected organizations. Contact your Sema4.ai representative to get access to the preview. Once your request is approved, you will be able to install the app from the Snowflake Marketplace under the Data Products -> Apps view.
Once installed, the app will be available in your Snowflake environment. The first time installation will take you through a setup process to configure the app. Follow the steps below to configure the app for your organization's use.
Grant Account Privileges
During the installation process, you'll be asked to grant the application the necessary permissions to access the objects it needs to use. You will see the following screen where you are expected to review the permissions and grant them by clicking the Grant button. Each permission is described in the user interface explaining what it is for and why it is needed.
Allow Connections
On the same screen with the account privileges, you'll be asked to grant the application the necessary External Access Integrations to access the endpoints it needs to use. Click the Review button to view the details of the allowed connections. Then click Connect to allow the application to access the endpoints it needs.
The application by default requires access to following endpoints:
| Endpoint | Purpose |
|---|---|
cdn.sema4.ai:443 | To fetch the prebuilt action packages when users build agents with additional tools |
pypi.org:443 | Primary repository for python dependencies |
files.pythonhosted.org:443 | Package storage for python dependencies |
conda.anaconda.org:443 | Main repository for conda dependencies |
cdn.anaconda.org:443 | Content delivery for conda dependencies |
Each agent, new LLM configuration, Oauth client etc will typically require new external access integrations to be added. Please refer to the EAI guide for more details on managing the external access integrations.
Activate the application
All necessary permissions and external access integrations are granted, you are ready to click the Activate button, and then click the Launch app button to get to the actual application!
Wait for a few moments while the Streamlit admin view of the Sema4.ai Team Edition application is being activated.
Create services
Sema4.ai Team Edition application consists of three main components:
- Admin view - use this Streamlit view to configure the service and manage it's state like suspending and resuming the service
- Control Room - this is what the operator uses to deploy and manage agents and configurations
- Work Room - this is what the business uers use to get work done with agents
When landing the Admin view for the first time, you'll need to create the services, which starts the Control Room, Work Room and all necessary services in Snowpark Container Service. Click the Create button to start the process, and wait for the service to be created. You may refresh the page to see the status of the service.
The service creation process will take several minutes to complete. Patience, young grasshopper!
After a few minutes, try hitting the Refresh button to see the status of the service.
Grant access to application
For your users to be able to use the application, you need to map an account role to an application role. Sema4.ai application has three roles:
SEMA4_APP_ADMIN- allows the role to manage the native application, including starting and stopping the service, managing users and their access, and configuring the application in the Streamlit Admin view.SEMA4_APP_OPERATOR- allows the role to access the Control Room application via the service URL, by logging in with their own Snowflake credentials, where users can publish and deploy agents as well as to maintain configurations such as secrets, OAuth and LLMs. This role also allows publishing agents from Sema4.ai Studio to Snowflake.SEMA4_APP_WORK_ROOM- allows the role to access the Work Room application via the service URL, by logging in with their own Snowflake credentials and using the deployed agents.
In order to have an account role that can link Studio to Snowflake to publish agents, deploy them in Control Room and use them in Work Room we'll create a new account role and grant it the necessary application roles.
You can use your existing account roles, just replace them in the SQL statements below.
USE ROLE SECURITYADMIN;
CREATE ROLE AGENT_OPERATOR;
USE ROLE ACCOUNTADMIN;
-- If you changed the application name, replace it with your own
USE DATABASE ENTERPRISE_AI_AGENTS_TEAM_EDITION_PRPR;
GRANT APPLICATION ROLE SEMA4_APP_OPERATOR TO ROLE AGENT_OPERATOR;
GRANT APPLICATION ROLE SEMA4_APP_WORK_ROOM TO ROLE AGENT_OPERATOR;
-- Replace warehouse and user name with your own values
GRANT USAGE ON WAREHOUSE <your_warehouse> TO ROLE AGENT_OPERATOR;
GRANT OPERATE ON WAREHOUSE <your_warehouse> TO ROLE AGENT_OPERATOR;
GRANT ROLE AGENT_OPERATOR TO USER <your_user_name>;Test application
Once the role is granted head back to the Streamlit admin view and you should see the statuses turn to "Running", and you'll see the service endpoints in the Admin view.
Now it's time to test the application! Copy the Control Room URL provided in the Admin view to access the Team Edition application's Control Room, and open a new tab with this URL. You should see the Sema4.ai Control Room , and showing you a home screen with tips to get started. 🎉
End users in your organization should bookmark the direct URLs to the Control Room and Work Room applications. This will make it easier for them to access the application they need!
Download Sema4.ai Studio
Download Sema4.ai Studio installer to make sure you have what you need for the next section!
Sharing application access with your team
Your team will access the application via the service URLs, which are shown in the Admin view. We recommend that you share the URLs with your team, so that they can access the application directly without the need to go through the Admin view.
Users will log in to the application using their own Snowflake credentials - as set in your Snowflake environment.
Common admin tasks
Dig deeper to some of the key administration tasks for the Sema4.ai Team Edition application using the links below!