# Tutorial: Demoing Your App

Share your pipeline with others and let them try it out. It may seem an easy topic, but there are a couple of things to consider here, for example, user expectations, to make your demo successful.

***

- **Level**: Intermediate
- **Time to complete**: 10 minutes
- **Prerequisites**: 
  - This tutorial assumes some basic knowledge of <ProductName/>. It also assumes that you have a created and deployed pipeline ready. If you don't, you can complete the [Tutorial: Building Your First Question Answering App](/docs/tutorials/learn-the-basics/tutorial-building-your-first-question-answering-app.mdx), [Tutorial: Building Your First Document Retrieval App](/docs/tutorials/learn-the-basics/tutorial-building-your-first-document-search-app.mdx), or [Tutorial: Building a Robust RAG System](/docs/tutorials/learn-the-basics/tutorial-building-a-robust-rag-system.mdx)
  - You must be an Admin to complete this tutorial.
- **Goal**: After completing this tutorial, you will have demonstrated your pipeline to other users and collected their feedback. 

***

## Prepare for Inviting Users

It's important to always get feedback from real users as it gives you an idea of your pipeline performance. Before other users can test your pipeline, you must make them aware of a couple of things:

- Ensure your users understand that if they ask for information about documents that don't exist in <ProductName/>, the system won't be able to find an answer.
- Ensure the users understand that the information they're looking for must exist in the text data stored in <ProductShortName/>. The application cannot make up answers by itself.
- Explain what queries work well (for example, natural language questions instead of simple keywords or copy-pasted error messages).
- Make your users aware of the data indexed in their <ProductShortName/> search application.

**Result**: The users know how to use your pipeline and what to expect. They're ready to run a search with your pipeline and provide feedback.

## Share Your Pipeline Prototype

Users don't need a <ProductShortName/> account to try your pipeline. You generate a link to the prototype of your pipeline. This link gives them access to the search page to run searches with your pipeline prototype. You can style the prototype with your brand logo and colors.

1. Log in to <a href="https://cloud.deepset.ai/" target="_blank"><ProductName/></a>.
2. Click **Pipelines**.
3. Find a deployed pipeline you want to share, and click **Share** next to it. The Share as Prototype window opens. 

   <ClickableImage
     src="/img/tutorials/share.png"
     alt="The Pipelines page with a pipeline in the Deployed section and the Share button next to the pipeline highlighted."
     size="standard"
   />
   
4. On the **Settings** tab:
   1. Select the link expiration date. When the link expires, people can no longer access the pipeline prototype.
   2. Add the pipeline description. This can be guidelines, things you want users to pay attention to, and so on. The description will be visible to the users on the Search page. 
   3. Choose if you want to enable login for this prototype. If you do that, only logged in users who belong to your <ProductShortName/> organization will be able to view the prototype. Otherwise, anyone with the link will be able to access it.
   4. If needed, enable the metadata filters.  
      When you enable this option, the metadata from your files are used as search filters. 
   5. Choose if you want users to be able to view the source documents. 
5. Open the **Style** tab to add your company logo and colors to the prototype.
6. Generate and copy the link.
7. Close the window.
8. Share the link with the people you think should test your pipeline.

**Result**: You have shared your pipeline prototype with real users. They can now run a search and give feedback in <ProductName/>.

## Ask Your Users to Run a Search and Give Feedback

Explain to your users the steps to run a search:

1. Open the link they got from you.  
   They land on the Search page without access to other pages in <ProductName/>.
2. Ask a question and click **Search**.
3. Click a thumbs icon below the answer to indicate if it's correct. You can add additional feedback to explain your choice in the text field that opens. You can also copy the answer or save it for later.

   <ClickableImage
     src="/img/tutorials/tutorial_feedback.png"
     alt="An answer to a question displayed on the Search page with the icons below it"
     size="large"
   />

:::info Save for later
If you have a <ProductShortName/> account, you can find answers you've saved for later in the pipeline's query history.  
To view them, click the pipeline name and scroll to the Detailed Feedback section. In the table, use the filter to show only items marked as Saved for later.
:::

**Result**: You have explained to your users how to run a search and evaluate the answers. They can now start giving you feedback.

## Analyze User Feedback

The feedback is displayed on the Pipeline Details page. You can also export it to a CSV file.

1. In <ProductName/>, go to **Pipelines** and click the name of the pipeline you shared. This opens the Pipeline Details page. The Overview tab shows the overall feedback and queries.
2. Go to **Search History** and customize the table to show feedback rating:
   1. Click **Manage table preferences**.

      <ClickableImage
        src="/img/tutorials/tutorial-manage-table-preferences.png"
        alt="The Manage table preferences window"
        size="standard"
      />
    
   2. Choose Feedback Rating and Feedback Notes columns and close the window.
   You can now see queries with their feedback rating and notes. You can also export the Search History table to a CSV file. 

**Result**: Congratulations! You have demonstrated your pipeline to real users and collected their feedback. You can now use it to tweak your pipeline and achieve the best performance.
