While using PromptLayer, over time the number of logs will grow, making it difficult to find what you are looking for. Tags are a great way to help keep things organized. Tags can be used for whatever you want, but the top 2 ways are to:
  1. Keep track of which application you are working on
  2. If you are chaining prompts together, where you are in the pipeline
For example, if you are working on an email application that has three chained stages, it would be a good idea to tag all the requests in this application with email and the corresponding stage stage-x To add a tag, add the keyword argument pl_tags into your OpenAI request like so: 
openai.Completion.create(
  engine="gpt-3.5-turbo-instruct",
  prompt="My name is",
  pl_tags=["pipeline3", "world"] # 🍰 PromptLayer tags
)
Alternatively, use the REST API endpoint /log-request (read more). This will then show up on your PromptLayer dashboard: And can be filtered by clicking on the tags button by the search-bar:

​

Please note that tags are optimized for categorization based on a small number of predefined options. For request enrichments with n > 1000 options, please use metadata instead.