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

  1. Sign in to Zams

  2. 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

  1. Enter a name for your agent.

    1. Example: Meeting Summarizer or Weekly 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:

  1. After creation, open the agent to configure tasks.

  2. Set a schedule using natural language.

    1. Example: Every Thursday at 10 AM PDT.

  3. Write instructions for the model to follow.

    1. Include app integrations and the exact routine.

    2. Example: Pull data from my CRM and email a weekly report.

  4. Run a test to confirm the agent works as expected and outputs are correct.

  5. Enable the agent by switching the toggle in the top-right corner to On.

    1. The agent will now run automatically at the scheduled times.