Additional Aissistant Building Tips
To create high-performing Aissistants, developers should follow best practices across smart action design, prompt instruction, and instruction-following behavior. This guide outlines key principles and recommended workflows to ensure your Aissistant performs reliably and as intended.
Smart Actions
Well-structured smart actions are essential for enabling meaningful automation. Follow these guidelines:
Clear Naming: Name each smart action clearly and concisely to reflect its purpose.
Detailed Descriptions: In the "description" field, provide a clear and specific explanation of what the action does and when it should be triggered.
Parameter Quality: Name each parameter with clarity and provide descriptive guidance to ensure correct and consistent usage by the model.
A good description helps Aissist determine the appropriate time to invoke the smart action during a conversation. The clearer your metadata, the more effective the assistant will be.
Instructions
When writing instructions for your Aissistant, consider the mix of external (provided) and internal (model's own) knowledge needed.
Two Recommended Modes:
External-Only Knowledge Mode:
Hybrid Knowledge Mode (Default):
Sub Agents
When defining sub-agent behaviors, you may need to write more granular instructions. Use the following recommended workflow:
Start Broad:
Create a "Response Rules" or "Instructions" section.
Use bullet points to outline high-level behavioral goals.
Add Specifics:
Create sections for specific categories like
# Sample Phrases
or# Workflow Steps
.
Include Ordered Steps When Needed:
If your desired behavior involves a multi-step process, write clear numbered instructions.
Debugging Tips:
Check for conflicting, vague, or inaccurate instructions.
Avoid shouting (ALL CAPS) or artificial incentives (e.g., “please do this for a tip”). These may make the model overly rigid, only use these when needed.
By iterating on your instructions and carefully observing behavior, you can build an Aissistant that follows your intentions accurately and reliably.
Last updated