> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kosmoy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build Your First Assistant

> A step-by-step guide to creating and deploying your first AI assistant using Kosmoy Studio.

# Build Your First Assistant

This quick start guide will walk you through the process of creating and deploying a "Personal Assistant" using the Kosmoy Studio, leveraging a pre-integrated OpenAI connection and the powerful GPT-4o model.

**Prerequisites:**

* A Kosmoy account with a configured tenant.
* You should be either the **Root User** or an **Admin User** or a **Studio User**.

**Steps:**

## 1. Integrate with OpenAI

1. **Navigate to Integrations:** From the Kosmoy Studio home page, click on the **"Integrations"** icon in the left-hand navigation bar.

2. **Add a New Integration:** Click the **"+ ADD"** button located in the upper right corner of the Integrations section.

3. **Select OpenAI:** In the "Add Integration" workflow, choose **"OpenAI"** from the provider dropdown menu.

4. **Provide your OpenAI API Key:** Enter your OpenAI API key in the designated field.

5. **Click "Next":** Proceed to the next step.

6. **Name and Describe the Integration:** Give your integration a unique name (e.g., "My OpenAI Integration") and an optional description.

7. **Click "Review":** Review the integration details.

8. **Click "Create":** Create the integration.

## 2. Register the GPT-4o Model

1. **Navigate to Models:** Click on the **"Models"** icon in the left-hand navigation bar.

2. **Add a New Model:** Click the **"+ ADD"** button located in the upper right corner of the Models section.

3. **Define Model Type:** Select **"LLM"** as the model type.

4. **Choose Provider and Integration:** Select **"OpenAI"** as the provider and then choose the OpenAI integration you just created from the integration dropdown.

5. **Select Model Version:** Select **"GPT-4o"** from the model version dropdown.

6. **Click "Next":** Proceed to the next step.

7. **Name and Describe the Model:** Give your model a unique name (e.g., "My GPT-4o Model") and an optional description.

8. **Click "Review":** Review the model details.

9. **Click "Create":** Create the model registration.

## 3. Create a Personal Assistant

1. **Navigate to Assistants:** Click on the **"Assistants"** icon in the left-hand navigation bar.

2. **Add a New Assistant:** Click the **"+ ADD"** button located in the upper right corner of the Assistants section.

3. **Configure Basic Details:**
   * **Avatar:** Select an avatar for your assistant.
   * **Name:** Give your assistant a name (e.g., "My First Assistant").
   * **Description:** Provide a brief description of your assistant.

4. **Select Template:** Choose the **"Personal Assistant"** template.

5. **Define Scope:** Select **"Private"** as the assistant's scope.

6. **Configure Language:** Keep the default value ("auto") for the language setting.

7. **Click "Next".**

8. **Skip Data Channel and Memory:** For this quick start, we'll skip configuring a Data Channel and leave the Memory settings at their defaults (1 day and 10 past interactions).

9. **Disable Guardrails:** For this quick start, we will keep the Guardrails turned off.

10. **Select Models:**
    * **Conversational Model:** Select the "My GPT-4o Model" (or the name you gave it) you registered earlier.
    * **Instructional Model:** Select the "My GPT-4o Model" (or the name you gave it) you registered earlier.

11. **Configure Assistant Prompt:**
    * **Role:** Define the role of your assistant.
      *Example:* `You are a helpful personal assistant.`
    * **Task:** Describe the assistant's task.
      *Example:* `Your task is to assist the user with scheduling meetings, answering general knowledge questions, and providing recommendations based on their preferences.`
    * **Operating Principles:** Establish the principles guiding the assistant's behavior.
      *Example:* `1. Always be polite and respectful. 2. Prioritize user safety and privacy. 3. Provide accurate and up-to-date information. 4. Ask clarifying questions when needed.`
    * **Attitude:** Define the attitude to be displayed by your assistant
      *Example:* `Professional and friendly`
    * **Welcoming Message:** Write a welcoming message for users.
      *Example:* `Hello! I'm your personal assistant. How can I help you today?`
    * **Goodbye Message:** Write a goodbye message for users.
      *Example:* `Goodbye! Have a great day.`

12. **Click "Review":** Review the assistant's configuration.

13. **Click "Create":** Create the assistant. You will be redirected to the Assistants collection page.

## 4. Deploy the Assistant

1. **Locate Your Assistant:** On the Assistants collection page, find the card for the assistant you just created.

2. **Initiate Deployment:** Click the **rocket icon** (without a shadow) located on the lower left side of the assistant's card.

3. **Review Assistant Details:** Review the assistant's details on the deployment page.

4. **Click "Next".**

5. **Select Users:** Select yourself from the list of users to grant access to this private assistant.

6. **Click "Review".**

7. **Click "Deploy":** Deploy the assistant.

## 5. Chat with Your Assistant

1. **Access Kosmoy Chat:** Navigate to your Kosmoy Chat instance at `[tenant_name].client.kosmoy.com`.
2. **Start Chatting:** You should now see your newly deployed "Personal Assistant" available in Kosmoy Chat. Start a conversation and test its capabilities!

**Congratulations!** You have successfully created and deployed your first AI assistant using Kosmoy Studio.

**Next Steps:**

* Explore the advanced features of Kosmoy Studio, including Data Channels, Routers, and Guardrails.
* Create more sophisticated assistants tailored to your specific needs.
* Refer to the detailed documentation sections for each Kosmoy Studio component to learn more.