# Create and publish your agent in Instfy Agent

<p class="lead">Step by step to create an agent in the Studio, add knowledge, customize it, install it on your website, test it and follow conversations and leads.</p>

This guide takes you from your first login to the agent running on your website. Follow the tasks in order: an agent with a good knowledge base answers better from day one.

!image[Instfy Agent Studio with the Builder, Knowledge, Analytics, Conversations, CRM and Install tabs]

## Before you start

- **Studio access:** access is granted by the Instfy team. There is no open sign-up. If you do not have a login yet, write to relationship@instfy.com.
- **Company content:** gather your website address, the main pages (products, services, published prices, policies) and the questions customers ask most.
- **Website access:** you will need to paste a code snippet into your website or ask whoever manages it to do so.
- **Business WhatsApp (optional):** the number the agent can direct visitors to.

## Log in to the Studio

**Path:** `ai.instfy.com/studio/login`

<ol class="steps">
<li>Open the <strong>Log in to the dashboard</strong> screen.</li>
<li>Fill in the <strong>Email</strong> and <strong>Password</strong> you received from the Instfy team.</li>
<li>Click <strong>Log in</strong>. The Studio opens on the <strong>Dashboard</strong>.</li>
</ol>

:::tip
Change the temporary password on your first login and do not share your login. To give someone else access, add a member under *Settings > Team*.
:::

## Create the agent

**Menu path:** *Agents > + New agent*

<ol class="steps">
<li>In the sidebar, click <strong>Agents</strong>.</li>
<li>Click <strong>+ New agent</strong>.</li>
<li>In the <strong>Agent name</strong> field, type the name the visitor will see.</li>
<li>Click <strong>Create and open</strong>. The system creates the agent's address from the name and opens the <strong>Builder</strong> tab.</li>
</ol>

## Add knowledge

Knowledge is what the agent uses to answer. Start with your website and complete it with texts.

**Menu path:** *Agents > (your agent) > Knowledge*

<ol class="steps">
<li>Open the <strong>Knowledge</strong> tab and go to <strong>Add knowledge</strong>.</li>
<li>In the <strong>Website</strong> option, enter the main address, adjust the <strong>Maximum pages</strong> (up to 120) and click <strong>Crawl website</strong>.</li>
<li>Use <strong>Page</strong> and <strong>Fetch and index</strong> to include an important URL that was not picked up by the crawl.</li>
<li>Use <strong>File</strong> and <strong>Upload and index</strong> for TXT, MD, CSV, TSV, JSON, HTML or XML files up to 5 MB.</li>
<li>Use <strong>Text</strong>, choose the Text or FAQ type and click <strong>Index text</strong> for answers that are not on the website.</li>
<li>Check under <strong>Indexed knowledge</strong> that each source has reached the indexed status.</li>
</ol>

:::note
PDF and DOCX uploads are **Coming soon**. In the meantime, convert to TXT or paste the content as Text.
:::

## Customize in the Builder

**Menu path:** *Agents > (your agent) > Builder*

<ol class="steps">
<li>Fill in <strong>Name</strong> and <strong>Description</strong>, and leave the <strong>Status</strong> as Active.</li>
<li>Write the <strong>Welcome message</strong> and the <strong>Input placeholder</strong> (the sample text in the typing box).</li>
<li>Set the <strong>Tone of voice</strong> and the <strong>Language</strong>.</li>
<li>Enter the <strong>WhatsApp</strong> number using digits only, if you want the agent to direct visitors to it.</li>
<li>Choose the <strong>Primary color</strong>, <strong>Theme</strong>, <strong>Widget position</strong>, the bar colors and the avatar.</li>
<li>Under <strong>Suggested questions</strong>, write one question per line.</li>
<li>Under <strong>Sharing (WhatsApp and social media)</strong>, set the title, description and image of the public link. The Studio can suggest a title and description based on the knowledge.</li>
<li>Changes save automatically. Use <strong>Save now</strong> if you want to be sure.</li>
</ol>

## Test before publishing

<ol class="steps">
<li>Click <strong>View public page</strong> at the top of the agent.</li>
<li>Ask the questions your customers ask most and check the sources shown.</li>
<li>Ask something that is not in the knowledge base and confirm the agent says it does not have the information.</li>
<li>Fill in what was missing with Text or FAQ and test again.</li>
</ol>

## Install on your website

**Menu path:** *Agents > (your agent) > Install*

<ol class="steps">
<li>Open the <strong>Install</strong> tab.</li>
<li>Choose the method: <strong>Script (HTML)</strong>, <strong>Google Tag Manager</strong>, <strong>WordPress</strong>, <strong>Shopify</strong>, <strong>React/Next</strong>, <strong>Page/iframe</strong> or <strong>API (cURL)</strong>.</li>
<li>Copy the snippet shown. In the Script method, it is a single <code>&lt;script&gt;</code> tag that loads the widget and identifies your agent.</li>
<li>Paste the snippet into your website, before the closing <code>&lt;/body&gt;</code> tag or in the place indicated for the chosen method.</li>
<li>Use the <strong>Live preview</strong> to check the appearance.</li>
<li>Open your website and confirm the widget appears in the chosen position.</li>
</ol>

You can also share the **public page link** in your bio, on WhatsApp or in a QR code, without touching your website.

## Follow conversations and leads

- **Conversations:** read each conversation and see the source channel (Widget, Public page, Test, Voice, POS and others).
- **Analytics:** track volume, knowledge gaps and most asked topics.
- **CRM:** add contacts with buying intent and move the cards through the funnel.

See the full routine in [Management and automation agents](#/ai-agents).

## Frequently asked questions

### How do I get access to the Instfy Agent Studio?

Access is granted by the Instfy team. Write to relationship@instfy.com to request your login. There is no open sign-up for the Studio.

### How many website pages can the agent read?

The website crawl reads up to 120 pages per source, with a default of 30. You can add other pages individually with the Page option.

### Does the widget affect how my website looks?

No. The widget is loaded by a single script and runs isolated from the rest of the page, with its own styling, without changing your website's layout.

### Do I need to republish the code when I change the color or the message?

No. Changes made in the Builder apply to the widget already installed, without changing the code on your website.

### How do I update the agent when my website changes?

In the Knowledge tab, click Refresh on the URL source that changed. The content is fetched again and reindexed.

## Next steps

With the agent published, organize your management routine.

:::related
ai-agents, instfy-ai, contact-support
:::
