Using Components in Prompts
You do not need to know component names to use Palpaca — the agent chooses appropriate components automatically. But if you want more control over the output, referencing specific components by name in your prompts helps the agent produce exactly what you have in mind.
How to Reference Components
Section titled “How to Reference Components”Mention the component name naturally in your prompt. The agent recognizes all 40 SDK component names:
- “Use a DescriptionList to show the contact’s properties”
- “Add a DonutChart showing the pipeline distribution”
- “Wrap the form fields in a Tile with a heading above”
- “Show a LoadingSpinner while data is being fetched”
Example Prompts by Component Type
Section titled “Example Prompts by Component Type”Layout and Structure
Section titled “Layout and Structure”“Create a card with a Flex row containing three Tile components, each showing a different metric with a StatisticsItem inside.”
“Use a vertical Flex layout with a Divider between the header section and the content.”
Data Display
Section titled “Data Display”“Build a card that uses a Table to show all associated contacts, with columns for name, email, and last activity date.”
“Show the deal amount as a StatisticsItem with the label ‘Total Value’ and a Tag next to it showing the deal stage.”
“Display the contact’s details in a DescriptionList with their name, email, phone, and lifecycle stage.”
Forms and Inputs
Section titled “Forms and Inputs”“Create a form with a Select dropdown for choosing the deal stage, a DateInput for the close date, a NumberInput for the amount, and a Button to save.”
“Add a Toggle for enabling notifications and a TextArea for notes, inside a Tile container.”
Feedback and Status
Section titled “Feedback and Status”“Show an Alert at the top of the card if the deal is overdue. Use a warning variant.”
“Display an EmptyState when there are no associated contacts, with a message and a Button to create one.”
“Add a ProgressBar showing how complete the contact’s profile is based on filled fields.”
Charts and Visualization
Section titled “Charts and Visualization”“Add a BarChart at the bottom of the card showing monthly revenue for the last 6 months.”
“Show a DonutChart breaking down deals by stage, with a legend below.”
“Create a LineChart tracking the number of activities per week for this contact.”
CRM-Specific
Section titled “CRM-Specific”“Use a CrmAssociationTable to display all deals associated with this company.”
“Add a CrmStageTracker at the top of the card showing the current deal pipeline progress.”
“Include a CrmActionButton that lets the user create a new task linked to this contact.”
- You can combine multiple component references in a single prompt — the agent will use all of them together
- If the agent chooses a different component than you specified, it may have found a better fit; send a follow-up prompt to correct it if needed
- Browse the Gallery tab to see visual previews of each component before referencing them