Automation
How to build an AI agent
AI Agent Builder turns a plain-language job description into a workflow that can run on demand, on a schedule or when a message arrives. Each step can use the result from the step before it.
This guide covers the regular-user workflow for creating and monitoring an agent. Workspace installation, provider credentials and plan controls are intentionally excluded.
When to use this
- A repeated task requires several decisions or tools, not one generated answer.
- You want the workflow to run on a schedule or react to incoming messages.
- You need a visible run history before trusting an automation.
Start from the Agent Builder
Open the agent dashboard
Open AI Agent Builder. Start with the plain-language description box, open the visual builder, or choose a featured starting point such as a daily report, weekly summary or morning briefing.

Choose a starting point for the workflow. Connect only the services the job needs
Open Manage Connectors, select Add Connector and link the account needed by this workflow. Keep access narrow: an email workflow needs its mailbox, while an unrelated service can remain disconnected.

Open the connector manager from the agent dashboard. Choose the relevant connector
Select the service the agent should use. The available actions shown for each connector make it clear whether the agent can read messages, create drafts, send mail, manage contacts or update a calendar.

Choose a connector by the actions your workflow requires.
Describe and refine the workflow
Describe the complete job
State what should happen, when it should run and where the result belongs. For example: every weekday morning, summarize yesterday’s messages and send the briefing to a chosen channel. Continue the conversation to refine the workflow.

Describe the goal, timing and destination in one clear brief. Choose when the agent starts
In the Visual Builder, select the Trigger node. Choose Schedule for a recurring job, using a preset or a custom schedule. Choose Channel Message when the workflow should react to an incoming message on a connected channel. Check that the trigger matches your brief before adding actions.
Add and connect the actions
Use + to open Add Step. Choose actions such as Ask Agent, Send Message, Generate Report, Gmail or Outlook according to the job. Put them in execution order and use the previous step’s output where needed. For an email briefing, read the messages first, summarize them next and send the final report last. Use a Path step when the next action depends on a condition.
Test, save and activate
For a Channel Message workflow, use Test Agent to send a sample message and inspect the result. Correct vague instructions or missing connections, then Save and set the agent Active. For scheduled work, review the first scheduled run in the agent’s history. Pause the agent while correcting an unexpected result.
Monitor agents and conversations
Review every agent from one list
Open Agents to compare statuses and last-run times. Use the options menu to edit, pause or remove a workflow, or start a conversation with an agent directly.

Check status and recent activity across all agents. Inspect messages and run details
Open Channel Messages and filter by channel to find a conversation. Read the full history, then use Details and Logs to check the configuration, incoming message, execution path and output. Reply directly when a conversation needs your attention. Review the first runs before expanding the agent’s responsibility.

Use the conversation history and logs to audit each run.
Ready to try it?
Try AI Agent Builder in AmmarAI