> For the complete documentation index, see [llms.txt](https://ultrasafe.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ultrasafe.gitbook.io/docs/workspaces.md).

# Workspaces

On The Platform, a workspace encompasses a set of accounts with defined permissions and roles. Creating a workspace for your team provides the ability to:

1. **Administer access controls and manage associated costs**
2. **Facilitate the sharing of fine-tuned models among team members**

### Important

Creating an API key within your organization’s workspace and using it to develop a fine-tuned model grants access to this model for all team members with the appropriate permissions. This approach ensures that the model is readily available and usable by authorized users across your team.

### Set up a workspace.

Upon first joining The Platform, you have the option to either create a new workspace or join an existing one. To establish a new workspace, click on “Create workspace” and follow the setup instructions.

<div align="left"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeJ_lFIhof7avu5caM7YAnnyzBIJ9jA3mbntXXpTxZ9LUauN9PUNQ3wRNLyovkjIelgLnZie-2-Xs0ULjfVc2kY517o3zQSS2O3NA9ns0E4lZExqjUi6roq_E5xzCdI7chntd9-fI7O15scG2BGnboEMTI?key=rJldTYnqSOCJnhAWBD4HIg" alt=""><figcaption></figcaption></figure></div>

If you are already logged into The Platform, you can create or join a workspace by clicking on your name in the bottom left corner and then selecting “Create or join workspace.

<div align="left"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcQ8EGVQzX2qAMLq6lBPm6AjBBfjPMwpDSGsa83-ZWE0aiLkS8Pb6ADBo30f1Ya5v7-2wRjaE_eooWki6MwDikVsF4FpMm_kSGBCOTXyBfLdOr2NpQtx7TVs6lnNWA2CTN3x0OQ5_J874DGbaxmwn5d4GU?key=rJldTYnqSOCJnhAWBD4HIg" alt=""><figcaption></figcaption></figure></div>

Whether for personal use or your organization, you can set up a workspace.

<div align="left"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfXCNpuiXbkrzN0RaAagxFCyPUrAPnNZ2ysi6FML4avH3TFjcyl6mfYQhIB7HcshqedejIM2lXYepjspdZuoQe8d0wA8PWRgdXCXeEqxADehB6r-JOiozjO_JHlV3npLe4EPAfRhgbVHhLZfbf-d5JyOMUo?key=rJldTYnqSOCJnhAWBD4HIg" alt=""><figcaption></figcaption></figure></div>

### Switch Workspaces

You can toggle between your personal workspace and your organization’s workspace.

<div align="left"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXftBEIFTsurMBWVGJStXQc6lpGC9LxbaQW_ynT5E32YMEQJNHDgQars0FWdPp5OWOGGaOnOJklNZFD61Vf7J4VK8oDsfqDpT0nYXxJnix0DTjl0zU6pgKZgSfpztrfD8mu6bXJzPLSzyBTOAWChle-EHNN3?key=rJldTYnqSOCJnhAWBD4HIg" alt=""><figcaption></figcaption></figure></div>

### Add Members to Your Organization

To invite members, go to “Workspace - Members” and select “Invite a new member.”

<div align="left"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe5gxACcqqLYacNnd3AdmKjMMk9uZweoAfDGJigxDCWQQFx9o1veYtVm_LEb2GCOwcfJ6Ogkz1dzO558hQg8r22jl5L7SfgOz0maz_OKgq4a1FDC9TfcBwWVHKXjZ9yjQx3072sFrzCXeEUJtzGuUF9MRt0?key=rJldTYnqSOCJnhAWBD4HIg" alt=""><figcaption></figcaption></figure></div>

### Prompting Capabilities

Creating prompts will be the first step on your journey to using Ultrasafe AI models. It is crucial to create well-crafted prompts to ensure optimal responses from Ultrasafe models. You will learn how to prompt using four different methods in this guide:

* Classification
* Summarization
* Personalization
* Evaluation

### Classification[​](https://docs.mistral.ai/guides/prompting_capabilities/#classification)

Ultrasafe AI models can easily categorize text into distinct classes. Imagine a virtual assistant for an e-commerce platform: we can set up predefined categories within the prompt and then guide Ultrasafe AI models to classify the customer’s inquiry into the correct category.

In the following example, when presented with the customer inquiry, Ultrasafe AI models correctly categorizes it as "country support":

| User      | I am inquiring about the availability of your cards in the EU, as I am a resident of France and am interested in using your cards. |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Assistant | country support                                                                                                                    |

Prompt (Arrow dropdown) :&#x20;

| <p>You are a bank customer service bot. Your task is to assess customer intent and categorize customer inquiry after <<<>>> into one of the following predefined categories:</p><p></p><p>card arrival</p><p>change pin</p><p>exchange rate</p><p>country support</p><p>cancel transfer</p><p>charge dispute</p><p></p><p>If the text doesn't fit into any of the above categories, classify it as:</p><p>customer service</p><p></p><p>You will only respond with the category. Do not include the word "Category". Do not provide explanations or notes.</p><p></p><p>####</p><p>Here are some examples:</p><p></p><p>Inquiry: How do I know if I will get my card, or if it is lost? I am concerned about the delivery process and would like to ensure that I will receive my card as expected. Could you please provide information about the tracking process for my card, or confirm if there are any indicators to identify if the card has been lost during delivery?</p><p>Category: card arrival</p><p>Inquiry: I am planning an international trip to Paris and would like to inquire about the current exchange rates for Euros as well as any associated fees for foreign transactions.</p><p>Category: exchange rate</p><p>Inquiry: What countries are getting support? I will be traveling and living abroad for an extended period of time, specifically in France and Germany, and would appreciate any information regarding compatibility and functionality in these regions.</p><p>Category: country support</p><p>Inquiry: Can I get help starting my computer? I am having difficulty starting my computer,and would appreciate your expertise in helping me troubleshoot the issue.</p><p>Category: customer service</p><p>###</p><p></p><p><<<</p><p>Inquiry: {insert inquiry text here}</p><p>>>></p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **Strategies we used**

* Few-shot learning: This method involves giving a few examples in the prompts, and the LLM can produce corresponding outputs based on the examples. few-shot learning improves model performance, especially when the task is difficult or we wish to have the model respond in a particular way.
* Delimiter: Different sections of the text are separated by delimiters like  ###, <<< >>>. Our example used ### for examples and <<<>>> for customer inquiries.
* Role playing: When the LLM receives a role (e.g., "You are an e-commerce customer service bot"), it provides personal context and often enhances performance.

### Summarization[​](https://docs.mistral.ai/guides/prompting_capabilities/#summarization)

The ability of LLMs to understand and generate natural language means that summarizing is a common task for them. As an example, here is a prompt for generating interesting questions and summarizing an essay.

Prompt (Arrow dropdown) :&#x20;

| <p>You are a commentator. Your task is to write a report on an essay.</p><p>When presented with the essay, come up with interesting questions to ask, and answer each question.</p><p>Afterward, combine all the information and write a report in the markdown format.</p><p></p><p># Essay:</p><p>{essay}</p><p></p><p># Instructions:</p><p>## Summarize:</p><p>In clear and concise language, summarize the key points and themes presented in the essay.</p><p></p><p>## Interesting Questions:</p><p>Generate three distinct and thought-provoking questions that can be asked about the content of the essay. For each question:</p><p>- After "Q: ", describe the problem</p><p>- After "A: ", provide a detailed explanation of the problem addressed in the question.</p><p>- Enclose the ultimate answer in <>.</p><p></p><p>## Write a report</p><p>Using the essay summary and the answers to the interesting questions, create a comprehensive report in Markdown format.</p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **Strategies we used:**[**​**](https://docs.mistral.ai/guides/prompting_capabilities/#strategies-we-used-1)

* Step-by-step instructions: As a result of using chain-of-thought prompting, LLMs are able to approach complex problems by using intermediate reasoning steps. By breaking complex problems down into simpler and smaller steps, it is often easier for us to solve them as well as debug and inspect the behavior of our models. The task is broken down into three steps: summarize, generate interesting questions, and write the report. By doing so, the language is able to think through each step of the report and generate a comprehensive report at the end.
* Example generation: The LLMs can generate examples with explanations and steps that automatically guide reasoning and understanding. To illustrate this point, we ask the LLM to come up with three questions and to provide detailed explanations for each of them.
* Output formatting: If we wish to request that LLM output in a particular format, we can specifically request "write a report in the Markdown format".

### Personalization[​](https://docs.mistral.ai/guides/prompting_capabilities/#personalization)

&#x20;LLMS can provide content tailored to individual users, which makes them excellent at personalization tasks. Our example illustrates how personalized email responses can be created to address questions from customers.

| User      | <p>Dear mortgage lender,</p><p><br></p><p>What's your 30-year fixed-rate APR, how is it compared to the 15-year fixed rate?</p><p><br></p><p>Regards,</p><p>Anna</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Assistant | <p>Dear Anna,<br><br>Thank you for your inquiry regarding our fixed-rate mortgage options. Our current 30-year fixed-rate interest rate is 6.403% with an Annual Percentage Rate (APR) of 6.484%. In comparison, our 15-year fixed-rate interest rate is 5.705% with an APR of 5.848%.<br><br>As you can see, the 15-year fixed-rate option has a lower interest rate and APR compared to the 30-year fixed-rate option. This means that you would pay less in interest over the life of the loan if you choose the 15-year option. However, the monthly payments would be higher due to the shorter loan term.<br><br>Please let us know if you have any other questions or if we can assist you further in choosing the best mortgage option for your needs.<br><br>Best regards,<br>Lender Customer Support</p> |

Prompt (Arrow dropdown) :&#x20;

| <p>You are a mortgage lender customer service bot, and your task is to create personalized email responses to address customer questions. Answer the customer's inquiry using the provided facts below. Ensure that your response is clear, concise, and directly addresses the customer's question. Address the customer in a friendly and professional manner. Sign the email with "Lender Customer Support."</p><p></p><p># Facts</p><p>30-year fixed-rate: interest rate 6.403%, APR 6.484%</p><p>20-year fixed-rate: interest rate 6.329%, APR 6.429%</p><p>15-year fixed-rate: interest rate 5.705%, APR 5.848%</p><p>10-year fixed-rate: interest rate 5.500%, APR 5.720%</p><p>7-year ARM: interest rate 7.011%, APR 7.660%</p><p>5-year ARM: interest rate 6.880%, APR 7.754%</p><p>3-year ARM: interest rate 6.125%, APR 7.204%</p><p>30-year fixed-rate FHA: interest rate 5.527%, APR 6.316%</p><p>30-year fixed-rate VA: interest rate 5.684%, APR 6.062%</p><p></p><p># Email</p><p>{insert customer email here}</p> |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **Strategies we used:**[**​**](https://docs.mistral.ai/guides/prompting_capabilities/#strategies-we-used-2)

* Providing facts: In order to create customer support bots that can provide helpful information, facts should be incorporated into prompts. To present these facts clearly, you should use clear and concise language. By doing so, the LLM can answer customer's questions accurately and quickly.

### Evaluation[​](https://docs.mistral.ai/guides/prompting_capabilities/#evaluation)

LLM outputs can be evaluated in a variety of ways. As a recommendation, here are three approaches: incorporate a confidence score, introduce an evaluation step, or utilize another LLM for the evaluation.

#### Include a confidence score[​](https://docs.mistral.ai/guides/prompting_capabilities/#include-a-confidence-score)

As part of the generated output, a confidence score can be included.

<table data-header-hidden><thead><tr><th width="188"></th><th></th></tr></thead><tbody><tr><td>Assistant</td><td><p>{</p><p> "Summaries": [</p><p>   {</p><p>     "Summary": "The author discusses their early experiences with programming and writing, starting with writing short stories and programming on an IBM 1401 in 9th grade. They then moved on to working with microcomputers, building their own from a Heathkit, and eventually convincing their father to buy a TRS-80 in 1980. They wrote simple games, a program to predict rocket flight trajectories, and a word processor.",</p><p>     "Confidence": 0.9</p><p>   },</p><p>   {</p><p>     "Summary": "The author began college as a philosophy major, but found it to be unfulfilling and switched to AI. They were inspired by a novel and a PBS documentary, as well as the potential for AI to create intelligent machines like those in the novel. Despite this excitement, they eventually realized that the traditional approach to AI was flawed and shifted their focus to Lisp.",</p><p>     "Confidence": 0.85</p><p>   },</p><p>   {</p><p>     "Summary": "The author briefly worked at Interleaf, where they found that their Lisp skills were highly valued. They eventually left Interleaf to return to RISD, but continued to work as a freelance Lisp hacker. While at RISD, they started painting still lives in their bedroom at night, which led to them applying to art schools and eventually attending the Accademia di Belli Arti in Florence.",</p><p>     "Confidence": 0.9</p><p>   }</p><p> ]</p><p>}</p></td></tr></tbody></table>

Prompt (Arrow dropdown) :&#x20;

| <p>You are a summarization system that can provide summaries with associated confidence scores.</p><p>In clear and concise language, provide three short summaries of the following essay, along with their confidence scores.</p><p>You will only respond with a JSON object with the key Summary and Confidence. Do not provide explanations.</p><p></p><p># Essay:</p><p>{insert essay text here}</p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### S**trategies we used:**[**​**](https://docs.mistral.ai/guides/prompting_capabilities/#strategies-we-used-3)

* JSON output:Most downstream tasks are facilitated by producing JSON format output. It is possible to enable the JSON mode by setting the response\_format to {"type": "json\_object"} and specifying the prompt, "You will only submit a JSON object with the key Summary and Confidence." Specifying these keys within the JSON object is beneficial for clarity and consistency.
* Higher Temperature:  In the above example, by increasing the temperature score, the model is encouraged to be more creative and generate three summaries that differ from each other.

#### Introduce an evaluation step[​](https://docs.mistral.ai/guides/prompting_capabilities/#introduce-an-evaluation-step)

In the prompt for evaluation, we can also include a second step. The LLM is asked to prepare three summaries, and to evaluate these three summaries.

<table data-header-hidden><thead><tr><th width="178"></th><th></th></tr></thead><tbody><tr><td>Assistant</td><td><p>Summary 1: The essay discusses the author's experiences with writing and programming before college, his initial struggles with learning Fortran on an IBM 1401, and the shift towards microcomputers that led to his interest in AI. He also touches on his decision to pursue a degree in AI and the disillusionment he felt when he realized that AI as practiced at the time was a hoax.</p><p><br></p><p>Summary 2: The author tells the story of his journey into programming, starting with writing short stories before discovering the world of computers. He describes his early experiences with an IBM 1401 and how it was like a mini Bond villain's lair. He also talks about his fascination with microcomputers and how it led him to learn Lisp and become interested in AI. However, he eventually became disillusioned with AI and decided to focus on Lisp instead.</p><p><br></p><p>Summary 3: The essay recounts the author's experiences with writing and programming before college, including his early attempts at writing short stories and his struggles with learning to program on an IBM 1401. He discusses how the arrival of microcomputers changed everything and sparked his interest in AI. However, he eventually realized that AI, as practiced at the time, was a hoax, and he turned his attention to Lisp. He also touches on his decision to pursue a degree in AI despite his disillusionment with the field.</p><p><br></p><p>Evaluation: I believe that Summary 1 is the best summary because it provides a clear and concise overview of the author's experiences with writing and programming before college, the shift towards microcomputers, and his eventual disillusionment with AI. It covers the key points of the essay without getting bogged down in unnecessary details. Summary 2 is also good, but it focuses more on the author's early experiences with computers and less on his later experiences with AI. Summary 3 is the weakest summary because it does not capture the full scope of the author's experiences and does not mention his decision to pursue a degree in AI despite his disillusionment with the field.</p></td></tr></tbody></table>

Prompt (Arrow dropdown) :&#x20;

| <p>You are given an essay text and need to provide summaries and evaluate them.</p><p></p><p># Essay:</p><p>{insert essay text here}</p><p></p><p>Step 1: In this step, provide three short summaries of the given essay. Each summary should be clear, concise, and capture the key points of the speech. Aim for around 2-3 sentences for each summary.</p><p>Step 2: Evaluate the three summaries from Step 1 and rate which one you believe is the best. Explain your choice by pointing out specific reasons such as clarity, completeness, and relevance to the speech content.</p> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### Employ another LLM for evaluation[​](https://docs.mistral.ai/guides/prompting_capabilities/#employ-another-llm-for-evaluation)

The evaluation step is typically conducted by another LLM in production systems, so that it can be separated from the process of generating summaries.

* Step 1: Using the first LLM, prepare three summaries

<table data-header-hidden><thead><tr><th width="186"></th><th></th></tr></thead><tbody><tr><td>Assistant</td><td><p>Summary 1: The author writes about their experiences with programming and writing before college. They started programming using Fortran on an IBM 1401 and wrote short stories. They later got into AI, but became disillusioned with it while in graduate school. The author then turned their focus to Lisp, eventually writing a book about it called "On Lisp". They also tried pursuing art, but found it difficult to make a living from it.</p><p><br></p><p>Summary 2: The author describes their experiences with programming in college and later in the workforce. They learned Lisp while in college, which expanded their concept of what a program could do. After graduation, the author worked at Interleaf, a company that made document creation software. They also did some consulting and writing on the side, eventually writing a book called "On Lisp". The author enjoyed working at Interleaf, but found that the Lisp they used was just a thin layer on top of a larger C cake.</p><p><br></p><p>Summary 3: The author tells the story of their early experiences with programming and writing. They started writing short stories before college, but they were not very good. The first programs they wrote were on an IBM 1401 using Fortran. In college, they got into AI, but found it disappointing. The author then turned their focus to Lisp, which they found to be more interesting. They also tried pursuing art, but found it difficult to make a living from it. The author eventually wrote a book called "On Lisp" and worked at Interleaf, a company that made document creation software. They enjoyed their time at Interleaf, but found that the Lisp they used was just a thin layer on top of a larger C cake.</p></td></tr></tbody></table>

Prompt (Arrow dropdown) :&#x20;

| <p>Provide three short summaries of the given essay. Each summary should be clear, concise, and capture the key points of the essay.</p><p>Aim for around 2-3 sentences for each summary.</p><p></p><p># essay:</p><p>{insert essay text here}</p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

* Step 2: A second LLM should be used to rate the summaries generated

<table data-header-hidden><thead><tr><th width="177"></th><th></th></tr></thead><tbody><tr><td>Assistant</td><td>Summary 3 provides the most complete and accurate summary of the essay. It covers the author's experiences with writing and programming before college, their disappointment with AI in college, and their eventual focus on Lisp and work at Interleaf. Summary 1 is missing some key details, such as the author's work at Interleaf and their writing of "On Lisp". Summary 2 focuses too much on the author's time at Interleaf and neglects their early experiences with writing and programming before college. Overall, Summary 3 is the best choice as it is the most complete and accurate summary of the essay.</td></tr></tbody></table>

Prompt (Arrow dropdown) :&#x20;

| <p>You are given an essay and three summaries of the essay. Evaluate the three summaries and rate which one you believe is the best.</p><p>Explain your choice by pointing out specific reasons such as clarity, completeness, and relevance to the essay content.</p><p></p><p># Essay:</p><p>{insert essay text here}</p><p></p><p># Summaries</p><p>{insert the previous output}</p> |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **Strategies we used:**[**​**](https://docs.mistral.ai/guides/prompting_capabilities/#strategies-we-used-4)

LLM chaining: In this example, we chain two LLMs in a sequence, where the output from the first LLM serves as the input for the second LLM. The method of chaining LLMs can be adapted to suit your specific use cases. For instance, you might choose to employ three LLMs in a chain, where the output of two LLMs is funneled into the third LLM. Even though LLM chaining offers flexibility, it is important to keep in mind that it may result in additional API calls and could potentially increase costs as a result.
