AI Profile
Setup the personality and the workflow reference of AI Agent to meet the requirements of customized brand services
Choose the role
Create an AI Agent, choose the role you want the AI Agent to be.


Quick start
We have already pre-set all the basic configurations. You can directly associate your brand information below, then have a conversation with AI in the preview interface on the right to view the results. If you need to adjust the AI configuration, you can click the "Edit" button in the upper right corner to enter the configuration editing interface.

How to Write Good Prompts for AI Agent
A good prompt can significantly improve the efficiency and accuracy of your AI Agents. This guide covers how to write good prompts for AI Agents on YCloud.First, you need to know how Instructions, Actions and other Capabilities work:
Instructions
Guide the AI Agent's overall behavior with a step-by-step work procedure and other general principles such as fall back handling and boundaries.
Actions
Guides AI on when and how to trigger actions independently. Actions can interrupt instructions.E.g. You can write "when the user expresses satisfaction and has no more questions" for the action "close conversations". In that way, the AI Agent will close the conversation as long as the user shows such intent.
Flows, Knowledge Base and Actionbooks
They exist as the skill library of AI agents, which can be invoked on demand by agents when answering user questions. Among them, Flows has the highest priority and will be triggered first.
Writing Instructions
We recommend breaking down instructions into several parts:
Component
What's it for
Example
Work procedure
Tell the AI Agent step by step how to guide user's interaction
Human-like greetings, welcome users politely and warmly
Understand Needs
ask for their needs, such as “What are you looking for?”
Acknowledge their reply briefly (e.g., “Got it 👍”)
Keep it natural. No rapid-fire questions.
Provide Quick Value
Based on their answer, highlight one key benefit that matches their need. Keep it short (1–2 sentences max).
Collect Contact (Soft Transition)
After some value exchange, say: If you'd like, I can send you more details.
Ask for user info, {{Email}}, {{Nickname}}
ensure that you have asked for all the required information and do not ask for information beyond what is required
Make it natural and only ask one question a time
Example: For E-mail, you can ask "What's the best email to reach you?"
Handle Interest
If they show strong interest, ask "Would you like to book a demo or talk to a specialist?"
If yes → Escalate to human agent
If not ready → Stay helpful without pressure
Closing
Before ending: Is there anything else I can help you with?
If no, politely thank the visitor such as "Thanks for stopping by, {{nick_name}}! 😊"
Context
Provide context for the AI agent by describing who it is interacting with and the main purpose of the conversation.
You're speaking to someone exploring our products or services.
Your goal is to get the customer's information
Role & Communication style
Explain the role the AI agent should play, the tone it should use, and how it should communicate.
You're a warm, helpful, and relaxed sales guide—never pushy.
Ask one question at a time. Keep replies short, clear, and encouraging.
Keep replies short and conversational, two sentences max.
Follow up handling
Tell the AI Agent what to do to follow up in the conversation, such as how long to wait and what's the next action if the user doesn't reply.
If there's no reply after 5 minutes, send: "Hi, just checking if you're still there?". And if still no reply after 5 minutes, send: "I'll close the chat for now, but feel free to ask anytime!" and close the conversation.Note:The current timer measures time in minutes, with a maximum duration of no more than 60 minutes
Fall back handling
Tell the AI Agent how to react when user input is unclear, incomplete, or outside its capabilities
If you don't understand the user's intent, first try to confirm it in a friendly manner. If you still cannot understand, escalate to human agents.
Boundaries
Defines what AI Agent should not attempt (e.g. legal advice, medical diagnosis, financial advice, stock checking, etc.)
Never invent facts, processes, prices, or policies that are not covered in the instructions here.
Do not share personal, financial, or sensitive information unless explicitly instructed to.
Stay within your role, do not act or advise beyond it.
Never share assumptions, opinions, or promises.
Writing actions prompts
For each action, describe:
When it should happen (the condition)
What the Agent should do
Action
What you can write for prompts
Example
Close conversations
Tell the Agent under what circumstances the conversations can be closed, and whether a notification message needs to be sent to the user when closing the conversation.
The Contact confirms their issue is resolved and no further help is required.
Escalate to human agents
Instruct the AI to transfer to the corresponding agent or agent team in different scenarios.
If the user indicates a desire to be served by a human agent, hand off to agent: John
If the user wants advice on the refund request, hand off to team: support team
Add contact tags
Describe in which scenarios what corresponding labels should be added to users.
If the user shows a strong purchase intention, add the contact "purchase intention"
If the user shows strong interest in Product A, add the contact "Product A"
Update contact attributes
Tell the AI Agent when to update contact attributes. Also, it can restrict the AI Agent to update only certain attributes.
Update {{Contact.Email}}, {{Contact.Order_address}} when users mention them.
Actions can only be triggered independently when they are enabled. If you disable a specific action, it will still be usable within Instructions, but it will not be able to trigger independently outside of Instructions. This means that while the action remains available for use in predefined instructions or actionbooks, it cannot be activated in other contexts until it is re-enabled.
Using variables, hand off and contact tags
Variables
What are variables?
Variables allow you to reference specific contact information within your AI prompts. Think of them as placeholders that automatically fill in with real customer data.
How do they work?
Simply add variables to your prompts whenever you need to refer to contact details like name, email, purchase history, or any custom field you've created. The AI Agent intelligently understands when to:
Read the field value (e.g., "Hello {{contact.name}}")
Update the field based on conversation context (e.g., capturing a phone number during chat)
Example: "Collect the customer's {{contact.phone_number}} during the conversation."
Hand off
What is hand off?
Hand off allows you to escalate conversations from the AI Agent to human agents when needed. Available options:
Assign to specific agent - Route to a particular team member
Assign to team - Route to any available member of a specific team
Assign to owner - Route to the contact's designated account owner
Assign to last handler - Route to the agent who previously assisted this contact and is now available to serve
When to use: Configure hand off rules for complex inquiries, sensitive issues, or when the AI cannot resolve the request.
Add contact tags
What are contact tags?
Tags are labels you can automatically apply to contacts based on their behavior or conversation content.
How to use: Select specific tags to apply when certain conditions are met during the conversation. Common use cases:
Interest tracking: If a user asks about "Product A", automatically tag them with "interested-product-a"
Issue categorization: Tag contacts with "billing-question" or "technical-support"
Lead qualification: Tag potential customers with "hot-lead" or "needs-follow-up"
Benefits: Tags help you segment contacts, trigger automated workflows, and provide better personalized service in future interactions.
Last updated
Was this helpful?