Engineering Prompts
Sometimes, you need to iterate on your prompts to get the best results. deepset Cloud offers Prompt Studio, where you can test your prompts and compare how they perform. It comes with a library of ready-to-use prompts where you can also save your own prompts.
About This Task
Prompt Studio is a sandbox environment where you can:
- Test different versions of your prompts before bringing them to production.
- Modify your prompts.
- Compare the same prompt across up to three pipelines.
- Update your pipelines with refined prompts.
- Browse through and use curated prompt templates from a library.
- Save custom prompts to the library and reuse them later.
Accessing Prompt Studio
Prompt Studio is only available for deployed pipelines that use at least one PromptNode.
In the navigation, click Prompt Studio:
Testing and Modifying Prompts
Use the Prompt Editor within the Prompt Studio to modify your prompts and observe how they affect the results. You can experiment with different versions of prompts for the same query and review the history of your results.
Prompt Studio supports Markdown formatting of prompts.
Using the expanding list at the top, you can select a pipeline. Only deployed pipelines using at least one PromptNode are available for selection. Once you choose a pipeline, its prompt immediately shows in the Prompt Editor at the bottom. If there are multiple PromptNodes in the pipeline, you can choose the one you want to work with.
You can use the Editor to modify your prompt and run queries. To check the history of your queries, click the clock icon next to the query (it's only available if you select a single pipeline).
Using Prompt Templates
Choose a prompt from a library and test it in Prompt Studio. The prompt you choose shows in Prompt Editor where you can further modify it if needed.
In Prompt Editor, click Templates. The Custom tab lists the prompts you saved, and the deepset tab lists prompts curated and tested by deepset.
Saving Your Custom Prompts
Save your prompts in the library so you can use them in the future.
- In Prompt Studio, click Templates.
- On the Custom tab, click Create Custom Prompt.
- Name your prompt, type the prompt text, and save your prompt. Use curly brackets to insert a variable that will be filled in at search time. For example
{documents}
.
Updating the Prompt in the Pipeline
Once you've tested the new prompt and decided you want to use it in your pipeline, click the Update button to replace the prompt in the pipeline with the one you've just tested in Prompt Studio.
Comparing Pipelines
You can compare up to three pipelines. This is useful if you have pipelines using different models to understand how they perform. You pass the same query to all the pipelines you're comparing, but you can modify the prompts for each pipeline.
To add a pipeline to comparison, click Add Pipeline at the top of the Playground.
You can then add or remove pipelines using the plus (+) and minus (-) icons:
Each pipeline receives the same query, but you can change the prompt for each pipeline.
Updated 8 months ago