Running your Agent on a Schedule
You can execute your Agent on a scheduled cadence. To do this, select Run on a schedule in the Triggers modal.
The current supported options for scheduling an Agent are:
Hourly - Runs once per a user-determined number of hours within a configured timeframe (typically work hours)
Daily - Runs once per day at a configured time
Weekly - Runs once per a user-determined number of weeks on a configured day and time
Monthly - Runs once per month on a configured day and time
Listening for Slack messages
You can configure your Agent to execute in response to a specific Slack message. To do this, select Slack message from the Triggers modal and follow these steps:
Select the Channel you want the agent to monitor
Select User(s) for your Agent to listen for messages from (optional if text string provided)
Indicate a text string for your Agent to look for specifically (optional)
Note: Ensure the Coworker Slack app is installed in your workspace and has been added to the target channel. If not, invite it with /invite @Coworker
Following up on Meetings
You can set up your Agent to run when a specific meeting ends. To do this, select Meeting Event in the Triggers modal.
Select which meeting you want your Agent to run after.
Triggering based on a Custom Event
You have the option to trigger your Agent based on when a custom event takes place. To do this, select Custom Event in the Triggers modal.
The Condition field is a natural language or structured expression that tells the agent when to act. When an event payload arrives at the trigger endpoint, a decider evaluates the condition against the payload to determine whether the agent should run.
Examples of conditions you might write:
A new Stripe invoice has been createdAn inbound HubSpot lead has been submitted with a company size greater than 50A meeting has ended and the transcript is available
Note: we recommend you keep conditions specific and unambiguous. The more precise your condition, the more reliably the agent will fire only when intended.
Configuring the API Trigger
If you want to trigger your agent from an external system or workflow automation tool (e.g., Zapier, Make), you can use Coworker's API trigger.
API Endpoint: https://api.coworker.ai/agents/trigger
Accepted fields for API calls:
question- The input or prompt to send to the agentagentId- The unique ID of the agent to triggerconversationId- (Optional) To continue an existing conversation threadchatType- The type of chat contextuserTimezone- The timezone for the triggering useridempotencyKey- A unique key to prevent duplicate triggers
To find your API key, navigate to Settings > API Keys in your Coworker workspace.