User parameters allow you to directly input specific values into your tools without relying on AI generation. This feature gives you more control over your tools while reducing costs and improving efficiency. Instead of asking the AI to generate values you already know, you can simply provide these values yourself when using the tool.
✅ Benefits of Using User Parameters
By implementing user parameters in your tools, you'll experience:
Lower Costs: Reduced token usage means lower bills
Faster Processing: Less AI generation time means quicker results
More Reliability: Removing AI variability for known values increases consistency
Greater Control: Direct input gives you precise control over tool behavior
⚙️ Setting Up User Parameters in Your Tools
Setting up user parameters is straightforward:
Access Tool Settings: Navigate to the settings section of your tool
Modify Parameter Settings: For any parameter, change the default option from "AI model sets value during generation" to "User sets value when assigning tool"
Save Your Changes: Confirm your selections to enable these parameters as variables
Once configured, these parameters will be available wherever the tool is used within Promptitude.
✏️ Using Your User Parameters
When creating or editing prompts. The process is similar when configuring assistants.
Select Your Tool: Include the tool in your configuration
Configure Parameters: Expand the tool details to access user parameters
Edit Variables: You'll see a form where you can input values for your user parameters
Save: Confirm your inputs
📌 Use Cases
Authentication Tokens: One of the most common applications is for authentication. If your tool needs to access an API that requires an authentication token that changes frequently (every 15-20 minutes), user parameters are ideal. Instead of hardcoding a token that will expire, you can create a user parameter called "access_token" and insert it when needed.
Dynamic Content: User parameters are perfect for any content that changes regularly:
Customer IDs
Session information
Date-specific data
User preferences
API keys
💻 Usage via API
When making an API request to generate a prompt that uses tools, you'll include a special property called toolsParameters.
This property allows you to:
Send multiple parameter values for a single tool
Configure different values for multiple tools in one request
Only pass parameters that are set to "User sets value when assigning tool"
When sending your API request, include the toolsParameters array with objects for each tool:
Each object needs an id (the Tool ID)
Each object needs an inputs property containing parameter names and values
Important Things to Remember:
Only send user-filled parameters - Values for AI-filled parameters will be ignored
Include only active tools - Only send parameters that are actually used in the tools added in the prompt.
Multiple tools - You can include multiple tool objects in the toolsParameters array
Parameter names - Make sure parameter names in your request match exactly what's in Promptitude
Now that you understand how to send user-filled parameters through the API, you can create more dynamic and flexible prompt experiences.
User parameters represent a powerful way to optimize your Promptitude workflow, giving you the perfect balance between AI assistance and manual control. Start implementing them today to make your tools more efficient and cost-effective.