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

# Getting started

> Build your first AI agent and oral assessment in under 5 minutes.

This guide walks you through a complete quickstart in Claire. We'll build a very simple agent, set up a basic oral assessment, and test it live. Within five minutes, you'll have a working agent that you can try out yourself.

<Tip>
  Download all files needed to recreate this agent on [https://links.clairelabs.ai/files](https://links.clairelabs.ai/files).
</Tip>

## 1. Build your agent

Let's create a basic "Critical Thinking" agent that asks the student two simple questions about a familiar topic: remote work.

<Steps>
  <Step title="Create the agent">
    Head to the <Badge>Agents</Badge> section via the sidebar and click <Badge color="blue">Create</Badge>.
  </Step>

  <Step title="Add instructions">
    Give the agent a name (e.g., "Critical Thinking Agent") and description, then select <Badge color="blue">Oral</Badge> as the learning scenario. Copy the prompt below and paste it into the instructions field.

    <Prompt description="Copy the prompt to your clipboard" icon="copy" actions={["copy"]}>
      You are an evaluator assessing a student's ability to analyze a familiar topic. Your topic is: The rise of remote work.

      Ask the student the following two questions, one at a time:

      1. In your opinion, what is the single biggest advantage of remote work for society? Please explain your reasoning.
      2. Conversely, what is one major drawback or challenge of remote work, and how could it be mitigated?

      Do not answer the questions for them. Wait for their response after each question. Conclude the interview once both questions have been answered.
    </Prompt>
  </Step>

  <Step title="Generate playbook and save">
    Click <Badge color="blue">Update playbook</Badge> to generate the agent's behavior script, then click <Badge color="blue">Save changes</Badge>.
  </Step>
</Steps>

## 2. Set up the assessment

Next, we'll connect your new agent to an <Tooltip tip="Claire does not limit you to assessments. You can use agents equally well in casual exercises." headline="Go beyond assessments" cta="Browse use cases" href="/tutorials/use-cases/reflection-exercise">assessment</Tooltip>.

<Steps>
  <Step title="Create assessment">
    Select a course from the sidebar (or click <Icon icon="plus" /> to create a new one). On the course page, click <Badge color="blue">New assessment</Badge> in the page header.
  </Step>

  <Step title="Assessment details">
    Give your assessment a title (e.g., "Remote Work Analysis"), select <Badge color="blue">Oral</Badge>, choose the "Critical Thinking Agent" you just created, and click <Badge color="blue">Continue</Badge>.
  </Step>

  <Step title="Upload documents">
    Upload your instructions and grading rubric. You can download [sample files here](https://links.clairelabs.ai/files).
  </Step>
</Steps>

## 3. Publish and test

Finally, let's make the assessment live so you can test it.

<Steps>
  <Step title="Publish assessment">
    In the assessments table, click the <Badge color="blue">Publish</Badge> button next to your new assessment.
  </Step>

  <Step title="Fill in the dialog">
    Add a start date and a deadline. Ensure that the AI feedback option is enabled, and confirm. This ensures that you'll receive instant feedback after you submit your transcript.
  </Step>

  <Step title="Access the portal">
    Go to the Student Portal section and click <Badge color="blue">Share course</Badge> in the top right of the page header to get the portal URL. Open it in a new tab.
  </Step>

  <Step title="Take the assessment">
    <Tooltip tip="You can connect Claire with most LMS via LTI. Contact us to learn more." headline="LMS integrations" cta="Read more" href="/reference/lti-support">Log in as a student</Tooltip> using your email address and an OTP code. You'll see your assessment listed. Click <Badge color="blue">Take assessment</Badge> and have a quick chat with your new agent!

    <Note>
      You must use a different email address from the one you signed up with on the platform. If you're using Gmail, append "+" and a number to your email prefix ("[you+01@email.com](mailto:you+01@email.com)").
    </Note>
  </Step>
</Steps>

***

**Looking for more details?**

* To add tools, whiteboards, or use advanced agent setups, learn [more about agents](/documentation/claire-ai/agents).
* If you'd like to explore the student portal in more detail, see [Student portal](/documentation/course/student-portal).
* Curious about other use cases? Take a look at the [tutorial ](/tutorials/use-cases/reflection-exercise)section.