How to Build and Manage AI Agents in myCRMSIM
AI Agents can be used for different business purposes such as sales, customer support, appointment setting, product enquiries, franchise enquiries, lead follow-up, and automated conversation handling.
This guide explains how to use the AI Agents Dashboard, test an AI Agent, create a new AI Agent, configure each setup step, connect automations, and activate the agent properly.
AI Dashboard
The AI Agents Dashboard is the main page where you can view, create, test, activate, pause, edit, duplicate, export, and delete AI Agents.
This dashboard helps you manage your AI workforce from one place.

2. OpenAI API Key Required
When you click on Create New AI Agent, the system requires a valid API key to continue the AI agent setup. If the API key is not configured, the AI agent may not be created or may not work properly.
Please ensure the OpenAI API Key is set before starting the AI Agent creation process.

Each row represents one AI Agent.
The dashboard includes the following main columns:
This name helps you quickly identify which agent is being used for which purpose.

The role helps define how the AI Agent should behave during conversations.

This gives you a quick idea of how the AI Agent has been trained to speak, respond, and guide customers.

Tags are important for CRM tracking because they help organize contacts and trigger the correct automation workflows.

You can also change the model from the dropdown.
Available model options may include:
GPT-4o mini
GPT-4.1 mini
GPT-4.1
GPT-5 mini
GPT-5
GPT-5.1
Choose the model based on your required speed, cost, and response quality.

When the toggle is ON, the agent is active.
When the toggle is OFF, the agent is paused.
This is useful when you want to temporarily stop an agent without deleting it.

Available actions include:
Creates a copy of the selected AI Agent.



Before deleting an important agent, it is recommended to export a JSON backup.

At the top of the AI Agents Dashboard, you can use the filter dropdown and search bar to find agents quickly.
Example:
All
Use this option when you want to view all agents or narrow down the list.

This is useful when your workspace has multiple AI Agents and you want to find a specific one quickly.

This is a safe testing area where you can simulate a conversation with your selected AI Agent. The test session is isolated, which means it will not affect live leads, real contacts, or active customer conversations.
To open the simulator, click the Test AI button from the AI Agents Dashboard.

This panel is called:
Test AI Simulation
At the top, you will see a session ID. This identifies the current test session.
You may also see a message such as:
Please select an agent to begin simulation.
This means you need to select an AI Agent before starting the test conversation.

This section allows you to choose which AI Agent and contact should be used for the test.
After selecting the agent, the simulator uses that agent’s instructions, tone, model, conversation flow, configurations, and knowledge.
Examples:
Plant Seller

This helps test how the AI Agent behaves when speaking with a selected contact.
It is useful for testing contact-based behavior, personalization, and CRM-related flows.

Example:
Asia/Karachi
This is useful when testing execution windows, response timing, and business-hour behavior.

Use this option when you want to clear the previous test and begin again from the start.
This is helpful when testing multiple scenarios such as interested leads, not interested leads, booking requests, objections, or stop messages.

If no agent is selected, you may see:
Select an agent to see history
Once an agent is selected and tested, chat history can help you review previous test conversations.

Before selecting an agent, you may see:
Select an agent and start chatting
After selecting the agent and contact, you can type a test customer message and start the conversation.
The message box is available at the bottom of the simulator. Type your message and click Send or press Enter.
Example test message:
Hi, I am interested in your service.
The AI Agent will respond based on its setup.

+ Create New AI Agent
You can see it at the top right of the AI Agents Dashboard.
After clicking this button, a popup will appear titled:
Choose Your Path
This popup allows you to select how you want to create your AI Agent.
When creating a new AI Agent, you will see three options:
Use this option when you want to manually create the agent’s:
1. Instructions
2. Conversation flow
3. Configurations
4. Knowledge
5. Tasks
This is the best option when setting up a completely new AI Agent.

This option allows you to upload a .json file and recreate an existing strategy.
Use this option for importing a backup, reusing a previous strategy, moving an agent setup from another workspace, or restoring a saved configuration.

you build your agent conversationaly.
1. Click + Create New AI Agent.
2. Select Create with Simi and click Next.
3. Click the Start with Simi button.
4. A chat interface will open where you can describe what you want the agent to do.
For example, you can ask, “how can i create an agent?” and Simi will guide you through the required parameters

The builder includes five main steps:
Step 1: Instructions
Step 2: Conversation
Step 3: Configurations
Step 4: Knowledge
Step 5: Tasks
Each step controls a different part of how the AI Agent works.
This is one of the most important steps because it defines the identity and behavior of the agent.
Use a clear name that explains the purpose of the agent.


Tags are important because they help organize contacts inside your CRM.
Example tags:
qualified_sales_lead
plant_lead
Using the correct tag helps you filter contacts, trigger workflows, and track lead status properly.

Choose a tone that matches your business and the type of conversation.

Common tone options include:
Different models may vary in quality, speed, reasoning ability, and cost.
Available model options may include:
Choose the model based on the quality, speed, and cost requirements of your agent.

Prompt Builder
The Prompt Builder feature in myCRMSIM is designed to help you construct a detailed, structured prompt for your AI agent quickly and easily. By breaking the prompt down into specific sections—Role, Objective, Context, and Rules—you can ensure your AI behaves exactly as you need it to.
Navigate to the Strategy Builder page within your myCRMSIM dashboard. On the right side of the screen, look for the panel that says "No prompt yet" and click the Build My Prompt button to open the builder.
1.Define the AI's Role
2.Set the Objective
3.Provide Context
4. Establish Conversation Rules
5. Add Example Conversations (Optional)
6. Save and Compile
The Prompt Builder will close, and you will be returned to the Strategy Builder page. Your newly created, fully structured prompt will now be displayed in the Prompt Editor panel, ready to be used by your AI agent! You can always click "Edit Instructions" if you need to make changes later.

Click on Advanced Settings to expand this section. Inside this section, you can configure the following options:

Options may include:
Instant
30 seconds – 1 minute
1 – 5 minutes
5 – 15 minutes
15 – 30 minutes
You can also set custom minimum and maximum delay values.
This makes the AI feel more natural instead of responding instantly every time.

Options may include:
Instant
5 – 15 seconds
15 – 30 seconds
30 – 60 seconds
1 – 2 minutes
A small response delay can make the conversation feel more human and realistic.

The behavior may be adjusted between:
Passive
Persuasive
Confident
Assertive
For sales agents, a persuasive or confident style is usually helpful.
For support agents, a calm and supportive style is usually better.

The behavior may be adjusted between:
Light
Balanced
Strict
Use Light when you want the AI to keep the conversation going and avoid being too strict.
Use Balanced for normal lead qualification.
Use Strict when only serious and qualified leads should continue.

The behavior may be adjusted between:
Scripted
Adaptive
Freeform
Use Scripted when you want the AI to stay close to the prompt.
Use Adaptive when you want natural but controlled replies.
Use Freeform when you want the AI to respond more flexibly and creatively.

This step helps the AI guide the customer in a structured way and qualify the lead properly.

The flow starts from:
Conversation Start
Then moves to:
Initial Message
After that, the flow continues through questions, follow-ups, and conditions.
You can use the canvas to review how the AI conversation will move from one step to another.

This message should be short, clear, and relevant to the customer.
Example:
A good initial message should quickly explain what the AI can help with and encourage the customer to reply.

You can add up to 5 variations, and the AI will rotate between them for new leads.
This helps the AI sound more natural and prevents every customer from receiving the exact same message.
Example variations:

When qualification is enabled, you can add questions that help the AI understand the customer’s interest, need, budget, or intent.
This is useful for sales, appointment booking, and lead filtering.

Each question appears as a separate node in the flow.
Example questions:
Are you currently running any marketing campaigns?
What does your ideal customer look like?
On the right-side panel, you can edit the question text, move the question up or down, delete the question, or enable/disable qualification for that question.

For example:
If the customer answers no, the AI can send a different message or continue with another question.
Use Add Condition to define these rules.
Conditional logic helps make the conversation smarter and more relevant to the customer’s reply.

Follow-ups are useful when the customer does not reply or when you want to remind them after some time.
You can set the follow-up message and delay time using:
Days
Hours
Minutes
Example:

This helps the AI avoid sending the same follow-up every time.
It makes follow-up messages feel more natural and less repetitive./

Templates help save time and keep your messaging consistent.

Examples of message templates may include:
Intro message
Value teaser message
Booking message
Select a template and add it to the conversation flow.

This is useful when you want to add standard follow-ups such as:
Checking in
Reminder message
Offer reminder
Booking reminder
Templates make it easier to build the conversation flow faster.

Use the edit option to update the text.
Use the delete option if the step is no longer needed.
This allows you to improve the conversation flow at any time.

This step is important because it helps the AI Agent follow your business rules.
When this option is turned ON, the AI may send a longer response as multiple shorter messages.
This can make conversations easier to read and more natural for the customer.
When this option is turned OFF, the AI will usually send replies as a single message.

This tells the AI what it should guide the customer toward.
Available goal types may include:
Call to Action
Book Appointment
Send Booking Link

For example, the AI can ask the customer to book a session, visit a link, reply with confirmation, speak with a team member, or complete the next step.
After selecting this option, enter the Call to Action Message.
Example:

After selecting this option, choose the calendar provider and select the connected calendar.
Example:
Select Calendar: Your connected calendar account

After selecting this option, choose the calendar provider, select the calendar, and add the booking link text.
Example:
Select Calendar: Your calendar
Booking Link Text: Here is our booking link to schedule a call.
This option is useful when you want the customer to choose a suitable time by themselves.

If the customer sends any of these words or phrases, the AI can understand that the lead should not continue in the normal sales flow.

This is useful if you only want the AI to send messages during business hours.

Example:
Choosing the correct timezone is important because all start and end times follow this timezone.

Example:
End: 05:00 PM
This means the AI Agent will only send messages during this selected time window.

This is useful for businesses that operate from Monday to Friday.

Example:
Do not Send
If this option is selected, messages will wait and send when the next allowed time window starts.This helps avoid sending messages too early, too late, or outside business hours.

If this option is turned ON, the AI will only reply during the selected business hours.
If this option is turned OFF, some replies may still be sent outside the selected window depending on the setup.
For strict business-hour control, this option should be enabled.

This helps the AI understand your company, products, services, pricing, policies, and common customer questions.
The better the knowledge you provide, the better and more accurate the AI responses will be.

You can add information such as what your company does, what products or services you offer, your value proposition, target customers, pricing details, business location, delivery or service areas, and important policies.
Example:

Click Add FAQ to add a new FAQ.
Each FAQ includes:

For example
What is your price?
The AI should know the correct pricing.
If a customer asks:
Do you deliver to my area?
The AI should know the delivery details.
If a customer asks:
Can I book an appointment?
The AI should know the booking process.
Clear knowledge helps the AI answer faster, more accurately, and more professionally.
This step is used to define what should happen after the AI reaches its goal or when a specific action is required.
However, for AI Agents, advanced workflow actions should be created from the main Automations page.

After creating the AI Agent, go to:
Automations → Add Workflow
From there, you can build automation flows connected with your AI Agent.
The AI Agent handles the conversation.
The Automations page handles the backend workflow actions.

- Create contact
- Add tag
- Move contact to pipeline
- Send follow-up message
- Notify team member
- Trigger appointment workflow
- Mark lead as qualified
- Handle disqualified leads
- Pause AI for a contact
- Continue AI after a condition
- Send internal notification

Use Save Draft when the agent is not ready to go live yet.
This is useful when you are still writing the conversation flow, need to add more knowledge, want to review the setup later, are waiting for approval before activation, or want to continue editing later.
Saving your progress regularly helps prevent losing changes.

- Go to AI Dashboard.
- Find the agent you want to update.
- Click the Edit icon.
- Update the required sections.
- Save the changes.
- Test the agent again.
Common updates include changing the tone, updating the AI model, adding new FAQs, changing the booking goal, updating disqualification triggers, improving conversation messages, or changing the contact tag.

For example
Franchise Leads
Product Enquiries
Customer Support
Plant Sales
Appointment Booking
After duplicating the agent, update the important details such as strategy name, agent role, contact tag, tone, conversation flow, knowledge, and automation workflow.
This saves time and keeps your setup consistent.

This is useful for keeping a backup, sharing a strategy, reusing an agent setup, restoring a previous version, or moving the setup to another workspace.
If import is available, you can upload a JSON file to recreate an agent without building it manually again.

When the toggle is ON, the AI Agent is active.
When the toggle is OFF, the AI Agent is paused.
Turn the agent OFF when you are editing the agent, the campaign is paused, the agent needs review, you want human-only replies, or the agent should not respond temporarily.
This gives you full control over when the AI Agent should operate.

Use a clear and meaningful Strategy Name so the agent can be easily identified from the dashboard.
Choose the correct Agent Role based on the purpose of the agent, such as Sales Development Representative, Appointment Setter, Customer Support Agent, or Product Advisor.
Select a Tone that matches your business communication style. For sales agents, a persuasive or energetic tone can work well. For support agents, a calm and helpful tone is usually better.
Choose the right AI Model based on your needs. Use lighter models for simple conversations and stronger models for complex or premium workflows.
Keep the first message short, clear, and friendly so the customer understands what the AI can help with.
Use multiple message variations where possible so the AI does not send the same message to every customer.
Add clear and accurate company information in the Knowledge step so the AI can answer customer questions correctly.
Add FAQs for common questions, objections, pricing, delivery, booking, and service details.
Set proper Disqualification Triggers so the AI can understand when a lead is not interested or not qualified.
Configure the Execution Window correctly so the AI only messages contacts during the allowed business hours.
Use the correct End Goal based on your objective. Select Call to Action, Book Appointment, or Send Booking Link depending on what you want the customer to do.
For CRM tracking, always use Add Tag properly. Tags help organize contacts, identify lead status, and trigger the right automation.
Create AI Agent workflows from the main Automations page when advanced actions are needed, such as applying tags, moving leads, sending follow-ups, notifying team members, or managing qualified and disqualified leads.
Always test the AI Agent before turning it ON. Test different customer scenarios, including interested leads, not interested leads, price questions, booking requests, objections, and incomplete replies.
Review the agent after it goes live to make sure replies, tags, automations, and booking actions are working correctly.
Avoid choosing a role that is too generic.
Avoid writing a very long first message.
Avoid activating the agent without testing it.
Avoid adding incomplete or vague knowledge.
Avoid missing the correct contact tag.
Avoid forgetting to create automation workflows from the Automations page.
Avoid using the wrong end goal for the agent.
Avoid sending messages outside business hours if your business does not support it.
Avoid deleting an important agent without exporting a backup first.
To create an AI Agent, start from the AI Dashboard, click Create New AI Agent, and complete each setup step:
Instructions
Conversation
Configurations
Knowledge
Tasks
The AI Agent should manage the customer conversation, while the Automations page should manage workflow actions such as applying tags, moving leads, sending follow-ups, and notifying team members.
For CRM tracking, the most important action is Add Tag. Tags help organize contacts, identify lead status, and trigger the correct automation.
Before turning the agent ON, always test the conversation, review the knowledge, confirm the end goal, check the execution window, and make sure the correct automation workflow is connected.
