Skip to main content

Deploying and Configuring Agents on the Zeta Alpha Platform

In this tutorial, we will guide you through the process of deploying your agents on the Zeta Alpha platform. By the end of this tutorial, you will have your agent uploaded in the Zeta Alpha platform and ready to be configured in your tenant.

Prerequisites​

Before you begin, make sure you have completed the following tutorials:

Also make sure you have the following:

  • A Zeta Alpha API Key with admin access to the platform
  • The Zeta Alpha API base URL and the name of the tenant you want to deploy the agent to

Configuring your environment​

In order to upload the agent to the platform, you need to configure your environment with the following command:

rag_agents config set

This command will prompt you to enter:

  1. the Zeta Alpha API base URL: fill in the base URL of the Zeta Alpha API.
  2. the tenant name: fill in the name of the tenant you want to deploy the agent to
  3. the Zeta Alpha API Key: fill in the API key with admin access to the tenant

The output of this command creates a env/zav_config.json file with the configuration needed to connect to the platform and upload your agents.

Uploading the agent to the platform​

After configuring your environment, you can now upload the agents of your <agents project> to the platform. For example, from the tutorial for Building and Running Your First RAG Agent, the agent my_rag_agent will be uploaded.

info

Each uploaded agent becomes available under a specific project of the tenant. By default, this project is named after the <agents project> directory name of your local project. However, you can specify a custom project name by using the --project-name parameter in the upload command.

To upload the agent, run the following command from the root of the <agents project> directory:

rag_agents upload [--project-name <custom_project_name>]

This command will display the project's agents that are ready to be uploaded. For example, for a project named test-agents which contains the my_rag_agent agent, the command will display:

🚀 Preparing to upload the following agents:
  • test-agents:my_rag_agent
These agents will be uploaded to tenant `<tenant name>` at `<Zeta Alpha API base URL>`
Do you want to continue? [Y/n]:

If everything is correct, type Y and press enter. This will upload the project's agent to the platform.

Listing the uploaded agents​

You can also list the uploaded agents of the project by running the following command:

rag_agents list-remote

Once the <agents project> is uploaded, you will be shown the list of agent names that have been uploaded in your project. These names are expected to have the following format: <agents project>:<your-agent-name>.

This is the uploaded remote agent name that you will reference in your tenant settings (example: test-agents:my_rag_agent). Follow the next tutorial (Configuring agents) to configure and use your agent in a tenant.