Share a Pipeline Prototype
When you have a deployed pipeline, you can generate a link to it and send it to anyone you think should try your pipeline. By letting real users test your pipeline, you can get an idea of how it performs.
About this Task
When you have a pipeline created, it's useful to let others try it out and gather their feedback. You can easily share your pipeline prototype with everyone by simply generating a link you can send to the people you want to get feedback from.
What Am I Sharing?
Anyone with the link can view and run a search on the prototype, but they can't edit or change anything in deepset Cloud. They gain read-only access to the Search page that uses your pipeline and to the following assets:
- File metadata from the search if you enable metadata filters.
- Documents returned from the search.
- Document metadata from the search.
- The name of the pipeline you shared.
- Any metadata for your pipeline in the document store if you enable the metadata filters for the prototype.
If a user without a deepset Cloud account or not logged in to deepset Cloud opens a shared pipeline link, they only see that specific pipeline. But, if a logged-in deepset Cloud user opens the same link, they see all the deployed pipelines in the workspace they have access to.
You can stop sharing the prototype anytime by simply deleting the generated link.
Here's what a customized prototype where users can view source documents may look like:
Do the Users Need a deepset Cloud Account?
When a person opens the link from you, they can use the pipeline right away. They don't need to create or have a deepset Cloud account.
Collecting Feedback
When testing your pipeline, users can provide feedback on the answers the pipeline returns. You can then view this feedback on the pipeline details page or export it to a file. Feedback can show you how to optimize your pipeline for better performance.
Updating a Shared Pipeline
If you find you want to change the pipeline you already shared, you can edit it at any time. You'll need to undeploy the pipeline, change it, and then deploy it again. The sharing link stays the same, so all you need to do is let your users know the pipeline may not work until it's deployed again.
Prerequisites
- Your pipeline must be deployed and active so that users can run queries with it and test it out.
- Set the right expectations for your users. For tips on doing this, see Guidelines for Onboarding Your Users.
Share Your Prototype
- In deepset Cloud, click Pipelines.
- Find the pipeline you want to share, and click Share next to it. A window with prototype settings opens.
- On the Settings tab:
- Set the link expiration time.
- Add any notes to your users.
These can be guidelines on how to use the prototype, things they should pay attention to, and so on. These notes are shown on the prototype page the users open with your link. - Decide if you want to enable metadata filters.
These are the metadata in your documents. They act as search filters. - Choose if you want the users to be able to see the source documents.
- Optionally, on the Style tab, upload your logo and choose your brand colors. Your logo shows in the bottom left corner of the shared prototype, and your color is used to highlight the generated answer.
- Generate and copy the link. You can now send it to anyone you like.
Stop Sharing a Prototype
You can revoke access to your prototype by simply deleting the link. To do this:
- In deepset Cloud, click Pipelines.
- Find the pipeline you want to stop sharing, click the more actions menu next to it, and choose Share.
- Click Delete link.
When you delete the link, nobody can access the prototype anymore. You need to generate a new link to share the prototype again.
Updated 3 months ago