Creating your Agent
Last updated: August 20, 2025
Building an Agent in Zams
This tutorial explains how to create an agent in Zams and configure it as either a command agent or an ambient agent. Each type has a different purpose and setup process.
Prerequisites
A Zams account with access to the Dashboard.
Step 1: Start the Agent Builder
Sign in to Zams
On the Dashboard, click Build an Agent.
Step 2: Choose the Agent Type
You must select one of the following types:
Command Agent
Used for giving direct commands within the app interface.
Requires a description.
Example use case: Summarize text when I paste it into the app.
Ambient Agent
Functions as a scheduler that runs tasks automatically.
Does not require a description.
Example use case: Send a daily report at 9 AM.
Note
Choose Command Agent for on-demand interaction.
Choose Ambient Agent for background, recurring tasks.
Step 3: Name Your Agent
Enter a name for your agent.
Example:
Meeting SummarizerorWeekly Report Sender.
Step 4a: Configure a Command Agent
If you chose Command Agent:
1. Enter a description that defines what the agent does.
Example:
This agent will be an email summarizer.
2. The description acts as background context (a system prompt).
3. You can edit the description later in the Config tab.
Your agent is now ready for direct use inside the Zams app.
Step 4b: Configure an Ambient Agent
If you chose Ambient Agent:
After creation, open the agent to configure tasks.
Set a schedule using natural language.
Example:
Every Thursday at 10 AM PDT.
Write instructions for the model to follow.
Include app integrations and the exact routine.
Example:
Pull data from my CRM and email a weekly report.
Run a test to confirm the agent works as expected and outputs are correct.
Enable the agent by switching the toggle in the top-right corner to On.
The agent will now run automatically at the scheduled times.