For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by adding .md to their URLs.

Create Bots

Last updated: November, 2026

Bots are AI-powered assistants that work behind the scenes to help you get more done in your Circle. They can run on a schedule or be triggered when something specific occurs. While workflows follow a single predefined path, bots use AI to think and reason before taking an action.

Availabilty

Bots are available to communities on the Business plan and higher. There is no limit on the number of bots you can create.

Billing

Bots consume AI credits based on the tokens used to generate their responses and perform their actions, similar to Circle AI conversations. The number of credits each run consumes depends on the complexity of the output; for example, sending a message to a member will consume fewer credits than compiling a daily analytics brief.

If you run out of credits during a run, the bot will pause all activity, and runs will appear as failed or paused in the history. After purchasing a credit top-up, or when your monthly credit allowance renews, admins can individually retry runs. This prevents a backlog of tasks from burning through your available credits when they become available.

Set up bots

To start setting up a bot:

  1. Select Bots in the left sidebar under Agents.

  2. Click New Bot in the top-right corner.

There are a few ways to configure a bot:

Start from scratch

If you’re unsure where to start, click the Start from scratch button at the top of the Create bot page. This starts a chat with Circle AI to help you set up a bot based on what you want it to handle. Circle AI will prompt you with questions on what you’d like to achieve, and set up the bot with instructions and triggers, which you can then update through the bot settings.

Through Circle AI

On the Create a bot page, use the chat box to describe what you’d like the bot to do in plain language (for example, “Give me a daily brief of key member subscription analytics in my community”). Circle AI will respond and prompt you with a few questions to get an understanding of what you’d like the bot to achieve.

Once you answer, it will configure the bot with this goal in mind, select its triggers, draft its instructions, determine when it should request confirmation, and define any relevant connections.

You can then review the bot's settings, make any necessary changes, and activate it.

Use a predefined prompt

You can also start a chat using one of the three predefined prompts located below the chat box. Select one of these prompts, such as "Bring me a weekly pulse" or "Bring quiet members back," to load a predefined prompt into the chat window, and click Enter.

Build bots based on team roles

You can build a bot based on roles such as Chief of Staff, Member Success Manager, Events Coordinator, and more. Each role sets up a bot based on one team member’s function.

To set up a bot based on a role:

  1. Select a role card under Build your team.

  2. Click Add bot.

  3. Review the default settings, instructions, and make any necessary changes.

  4. Click Save.

Update bot settings

Once you set up a bot using any of the methods above, you can access its settings to further dial in how it works. To access the bot settings, click Settings in the top right corner.

From here, you can update the following settings:

Triggers

Similar to workflows, a trigger lets the bot know when to act. To add a trigger:

  1. Click Add trigger.

  2. Select a trigger and configure the required Filter conditions and Inputs (when available).

  3. Click Add trigger.

You can enable or disable triggers you add to the bot at any time by toggling them on or off. To edit a trigger, click it to show its settings and update the filter conditions, inputs, or schedule.

Instructions

Describe the bot’s job in plain language. The bot follows the instructions you provide here; we recommend using clear instructions to give you more predictable results.

Tips on writing instructions:

  • Start with the bot’s role: Use one or two sentences to say what the bot is responsible for.

  • Say when it runs: Describe the moment or schedule, and match it to the triggers above.

  • List what it should look at: Name the information the bot should use, such as new members, cancellations, or unanswered questions.

  • Describe the bot’s output: State what the bot should do, and in what order.

  • Describe what it should not do: If the bot shouldn’t contact members, write that in the instructions.

  • Keep each instruction short: Write one instruction per line, in direct sentences.

💡Tip: You can ask the bot to update its own instructions based on what you’d like to change. To do this, use the chat box on bot page and input the changed you’d like to make.

Confirmation

Toggle on Sensitive actions to ensure that the bot always asks you before taking action on things that involve payments, platform settings, or anything that affects your members.

Access your bot runs and history

Every time your bot acts, each run is logged as a separate entry in the bot's history. Depending on the bot's role, the history lets you review this output.

To access the bot history, click Bots in the left sidebar and select History.

Clicking into a specific run shows a description of what happened, including why it failed or needs review if it didn't complete the task. You can also use Circle AI to ask the bot for more information from this screen.