---
description: How to create an Agent on Mosaia
---

# Create a new agent

## Requirements

You must be logged into your account. If you do not have an account, you can create one in the steps outline in the link below

{% content-ref url="../getting-started/quickstart" %}
[quickstart](../getting-started/quickstart)
{% endcontent-ref %}

## Navigate to My Agents

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2F4oUNMluGGcHT0ZnWkx8r%2Fclick-agents.png?alt=media&#x26;token=8b1e31fe-11e2-4b86-bb5e-6a4a087c7229" alt="" width="316"><figcaption></figcaption></figure>

## Click 'New'

To create a new single agent

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2FWVDDZbPWkWxu3p141Rco%2Fclick-new-agent.png?alt=media&#x26;token=5b8b95b6-eb7f-4f6c-ab96-ca8964e2bd97" alt=""><figcaption></figcaption></figure>

## Set agent details&#x20;

Set the required "name" and "description'"of the agent. A "readme.md" file can be uploaded to explain the purpose of the agent or check the "create a readme for me" box to automatically generate a readme based on the provided description

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2Fk9aJ9GlOTNrgyHII2uha%2FScreenshot%202024-10-30%20at%204.08.52%E2%80%AFPM.png?alt=media&#x26;token=13ccea68-aedc-4d9c-988f-722d457839a2" alt=""><figcaption></figcaption></figure>

### Advanced capabilities (Optional)

For advanced capabilities, click "Show Advanced Options" and fill additional information

"Keywords": are used to power public search \
"Tags": are arbitrary strings used as identifiers\
"Extensors": Are key-value pairs that can be used as identifiers for external integrations\
"External ID": Is a single primary unique identifier for 3rd party integrations

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2FPFKMuRnK1aq4DEsuYUtH%2FScreenshot%202024-10-30%20at%204.09.04%E2%80%AFPM.png?alt=media&#x26;token=02962d50-82c0-4ed3-9e71-adf861912511" alt=""><figcaption></figcaption></figure>

When done, click create

## Set system prompt on agent

After clicking create, agent parameters page will load up. Click the edit button next to "system prompt"

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2Fi5obHaaJf4DkccqZ2oTL%2Fclick-agent-system-prompt.png?alt=media&#x26;token=2f27eb29-2ace-4608-a4f5-88feb69aa103" alt=""><figcaption></figcaption></figure>

Type out the system prompt in the editor or upload a .md file of the system prompt. Then click "Save"

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2F8m1Xt7IKk0ChCE7A2B7U%2FScreenshot%202024-10-30%20at%204.27.13%E2%80%AFPM.png?alt=media&#x26;token=b4e44b0b-87d3-46d5-af9b-05f98a51b18e" alt=""><figcaption></figcaption></figure>

### Select model to use (Optional)

A default model will be selected but can be changed by clicking the edit button next to Agent Model to show a modal with a model selector

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2FqMlE7NyGq7xkNtwYEexH%2Fclick-agent-model.png?alt=media&#x26;token=476811c8-6918-45a3-a5fa-ea4303eeffcb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1701639389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvkwfDA7H5j0aek0WgahK%2Fuploads%2FxkjGe9LaNe6oOujUd8rR%2FScreenshot%202024-10-30%20at%204.29.43%E2%80%AFPM.png?alt=media&#x26;token=faed7daf-0d17-4cdc-a07f-d5317cada566" alt=""><figcaption></figcaption></figure>

## Chat with your agent

{% content-ref url="../quick-start/interact-with-an-agent-or-team" %}
[interact-with-an-agent-or-team](../quick-start/interact-with-an-agent-or-team)
{% endcontent-ref %}
