Quickstart

This guide walks you through creating your first agent so you can automate your first task in minutes. You'll learn the basics of how the platform works and how to use chat to build automations.

Creating Your First Agent

Agents are AI-powered automations that execute tasks for you. Each agent can run manually, via webhook, or on a schedule.

  1. Click New Agent in the app.
  2. Describe what you want the agent to do. For example: "Generate a weekly sales report from HubSpot" or "Monitor Intercom conversations for negative sentiment".
  3. We automatically generate the first version of your agent based on your description.
  4. You'll be taken to the agent's edit page where you can continue chatting to refine it.

Setting Up Connectors

If your agent needs to connect to external systems like HubSpot, Intercom, or Google Analytics, you'll need to set up a connector first.

  1. Go to Settings and open the Connectors tab.
  2. Click the + button to add a new connector.
  3. Enter a name for the connector (for example, "HubSpot" or "Google Analytics").
  4. Select the connector type: API Key for simple API credentials, OAuth for services requiring OAuth authentication, or Intercom for Intercom integration.
  5. Click Create Connector and configure the credentials on the next page.

When describing your agent in chat, mention which connector to use by name. We'll wire it in securely so your agent can access the external system.

Refining Your Agent Through Chat

Use the chat interface to refine your agent until it does exactly what you need.

The chat panel on the right side of the agent page lets you ask questions and request changes. You can ask things like "What does this do?" to understand how your agent works, or request specific changes like "Add error handling" or "Make the report include charts".

Start with the smallest version you can describe. For example, instead of "Analyze all customer feedback and create a comprehensive report with sentiment analysis, categorization, and trend detection", start with "Create a document listing the last 10 customer feedback messages from Intercom". Once that works, you can add complexity step by step.

Running Your Agent Manually

Test your agent before scheduling it to run automatically.

  1. Open the agent page.
  2. Click the Run button (play icon) in the header.
  3. You'll be taken to a log page where you can watch what's happening in real-time.

The log shows you step-by-step progress as your agent executes. When it completes, check the documents it created to see the output.

Setting a Schedule

If you want your agent to run automatically, configure when you want it to run.

  1. Open the agent page.
  2. Click the trigger button (shows "Run Manually" by default).
  3. Choose from several schedule options: every minute, every hour, every day at a time you specify, every weekday, specific days of the week, or the first or last day of each month.
  4. For schedules that include a time, select the time of day when you want the agent to run.

You can also set up a webhook to trigger your agent from external systems. When you select webhook mode, you'll see a unique URL that you can copy and use in other tools.

Monitoring Your Agent

After your agent runs, review the results to see what happened.

From the agent page, click the Logs button (list icon) in the header to see the execution history. Each log shows step-by-step execution details and any errors. Review the documents your agent created by clicking on them in the log or from the document list.

Iterating Through Chat

Keep chatting until the agent does exactly what you need.

Open the agent page to see the chat interface on the right side. Ask questions like "What does this code do?" to understand how your agent works, or request specific changes. Run the agent, review results, chat again to improve, and repeat until it's perfect.

If you want to start fresh with the chat conversation, click the New Chat button in the header. This clears the current chat history and starts a new conversation session.

Take one step at a time and make your agents more complex gradually. Each iteration builds on the previous one, making it easier to understand what changed and catch issues early.

Using the Workspace Chat

The Home page has a workspace chat where you can ask questions about your workspace. This is a quick way to find information without navigating through menus.

Try asking questions like these:

The workspace chat searches across your agents, logs, and documents to help you find what you need. Click New Chat in the header to start a fresh conversation.