> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Snabbstart

I den här guiden lär du dig hur du skapar din första konversationsagent. Den fungerar som en grund för att bygga konversationsflöden anpassade efter dina användningsfall.

> **Tip**
>
> Använd [ElevenLabs agent-skill](https://github.com/elevenlabs/skills/tree/main/agents) för att bygga och hantera röstassistenter från din AI-kodningsassistent:
>
> ```bash
> npx skills add elevenlabs/skills --skill agents
> ```
>
> Du kan också ansluta den [hostade MCP-servern](/docs/sv/eleven-agents/operate/hosted-mcp) till Claude eller någon annan MCP-klient för att skapa och hantera agenter med naturligt språk.

## Kom igång

ElevenLabs Agents hanteras antingen via [ElevenAgents-instrumentpanelen](https://elevenlabs.io/app/agents), [ElevenLabs API](/docs/sv/api-reference/introduction), [Agents CLI](/docs/sv/eleven-agents/operate/cli) eller den [hostade MCP-servern](/docs/sv/eleven-agents/operate/hosted-mcp).

![ElevenLabs Agents](/docs/_fern-img/62ad20de44cee44a439b138d56764c801c4eb939cf3b0f167f594d5c6a6895fb.webp)

## Skapa din första agent

I den här snabbstartsguiden börjar vi med att skapa en agent via API:et eller webbpanelen. Därefter testar vi agenten, antingen genom att bädda in den på din webbplats eller via ElevenLabs-instrumentpanelen.

#### Skapa en agent via webbpanelen

I den här guiden skapar vi en konversationsbaserad supportassistent som kan svara på frågor om din produkt, dokumentation eller tjänst. Assistenten kan bäddas in på din webbplats eller i din app för att ge dina kunder support i realtid.

![ElevenLabs Agents](/docs/_fern-img/62ad20de44cee44a439b138d56764c801c4eb939cf3b0f167f594d5c6a6895fb.webp)

#### Logga in på ElevenLabs

Gå till [elevenlabs.io](https://elevenlabs.io/app/sign-up) och logga in på eller skapa ditt konto.

#### Skapa en ny assistent

Skapa en ny assistent på **ElevenLabs-instrumentpanelen** genom att ange ett namn och välja alternativet `Blank template`.

![Instrumentpanel](/docs/_fern-files/elevenlabs.docs.buildwithfern.com/61b0e1df291ea587a8ff3e116579a47f66d48c74b24f44cfcd4804a568eb0a9d/assets/images/conversational-ai/assistant-create-flow.gif)

#### Konfigurera assistentens beteende

Gå till fliken **Agent** för att konfigurera assistentens beteende. Ställ in följande:

#### Första meddelande

Detta är det första meddelandet som assistenten säger högt när en användare startar en konversation.

**`Första meddelande`**

```plaintext Första meddelande
Hi, this is Alexis from <company name> support. How can I help you today?
```

#### Systemprompt

Den här prompten styr assistentens beteende, uppgifter och personlighet.

Anpassa följande exempel med information om ditt företag:

**`Systemprompt`**

```plaintext Systemprompt
You are a friendly and efficient virtual assistant for [Your Company Name]. Your role is to assist customers by answering questions about the company's products, services, and documentation. You should use the provided knowledge base to offer accurate and helpful responses.

Tasks:
- Answer Questions: Provide clear and concise answers based on the available information.
- Clarify Unclear Requests: Politely ask for more details if the customer's question is not clear.

Guidelines:
- Maintain a friendly and professional tone throughout the conversation.
- Be patient and attentive to the customer's needs.
- If unsure about any information, politely ask the customer to repeat or clarify.
- Avoid discussing topics unrelated to the company's products or services.
- Aim to provide concise answers. Limit responses to a couple of sentences and let the user guide you on where to provide more detail.
```

#### Lägg till en kunskapsbas

Gå till avsnittet **Knowledge Base** för att ge assistenten kontext om din verksamhet.

Här kan du ladda upp relevanta dokument och länkar till externa resurser:

* Inkludera dokumentation, vanliga frågor och andra resurser för att hjälpa assistenten att svara på kundfrågor.
* Håll kunskapsbasen uppdaterad så att assistenten ger korrekt och aktuell information.

Nu konfigurerar vi rösten för din assistent.

#### Välj en röst

På fliken **Voice** väljer du en röst från [röstbiblioteket](https://elevenlabs.io/voice-library) som passar din assistent bäst:

![Röstinställningar](/docs/_fern-img/14aad328f468daafa9ec95d3b7a55489a8cb1a34869368020e05b207c9b0360a.webp)

> **Note**
>
> Att använda röster, modeller och LLM:er av högre kvalitet kan öka svarstiden. För en optimal kundupplevelse bör du balansera kvalitet och latens utifrån assistentens förväntade användningsfall.

#### Testa din assistent

Tryck på knappen **Test AI agent** och prova att prata med din assistent.

Konfigurera utvärderingskriterier och datainsamling för att analysera konversationer och förbättra assistentens prestanda.

#### Konfigurera utvärderingskriterier

Gå till fliken **Analysis** i assistentens inställningar för att definiera anpassade kriterier för att utvärdera konversationer.

![Analysinställningar](/docs/_fern-img/fee8bc444d5436c71eae3829b9ec8d5cdb6a57c4d4efe6483d7bfed2b066e438.webp)

Varje konversationstranskription skickas till LLM:en för att kontrollera om specifika mål uppnåddes. Resultatet blir antingen `success`, `failure` eller `unknown`, tillsammans med en motivering som förklarar det valda resultatet.

Lägg till ett utvärderingskriterium med namnet `solved_user_inquiry`:

**`Prompt`**

```plaintext Prompt
The assistant was able to answer all of the queries or redirect them to a relevant support channel.

Success Criteria:
- All user queries were answered satisfactorily.
- The user was redirected to a relevant support channel if needed.
```

#### Konfigurera datainsamling

I avsnittet **Data collection** konfigurerar du information som ska extraheras från varje konversation.

Klicka på **Add item** och konfigurera följande:

1. **Datatyp:** Välj "string"
2. **Identifierare:** Ange en unik identifierare för denna datapunkt: `user_question`
3. **Beskrivning:** Ge LLM:en detaljerade instruktioner om hur den specifika informationen ska extraheras från transkriptionen:

**`Prompt`**

```plaintext Prompt
Extract the user's questions & inquiries from the conversation.
```

> **Tip**
>
> Testa din assistent genom att låtsas vara kund. Ställ frågor, utvärdera svaren och justera promptarna tills du är nöjd med resultatet.

#### Visa konversationshistorik

Visa utvärderingsresultat och insamlade data för varje konversation på fliken **Call history**.

![Konversationshistorik](/docs/_fern-img/fd517a080ba2c0d678c1ce34ea79afbd0dad764a19da43ca045a1c29b693ee48.webp)

> **Tip**
>
> Granska konversationshistoriken regelbundet för att identifiera vanliga problem och mönster.

Den nyskapade agenten kan testas på flera sätt, men det snabbaste är att använda [ElevenLabs-instrumentpanelen](https://elevenlabs.io/app/agents).

> **Info**
>
> Webbpanelen använder vårt [React SDK](/docs/sv/eleven-agents/libraries/react) i bakgrunden för att hantera konversationer i realtid.

Om du i stället snabbt vill testa agenten på din egen webbplats kan du använda Agent-widgeten. Klistra bara in följande HTML-kodavsnitt på din webbplats och ersätt `agent-id` med ID:t för din agent.

```html
<elevenlabs-convai agent-id="agent-id"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>
```

#### Skapa en agent via CLI

#### Installera CLI

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Arbetar du med en AI-kodningsassistent? Kör `elevenlabs generate-skills` i ditt projekt för att skapa en
> `SKILL.md` för varje kommandogrupp i `skills/`, så att assistenten känner till hela CLI:ts yta
> utan att du behöver klistra in dokumentation. Använd `--output-dir` för att lägga dem någon annanstans. Detta läser CLI:ts egen
> inbäddade API-definition, så det kräver ingen API-nyckel och fungerar offline — och det följer
> den version av CLI:t som du har installerad.

#### Initiera ett nytt projekt

```bash
elevenlabs agents init
```

Detta skapar projektstrukturen med konfigurationskataloger och registerfiler.

#### Autentisera med ElevenLabs

[Skapa en API-nyckel i instrumentpanelen här](https://elevenlabs.io/app/settings/api-keys), som du använder för att säkert [använda CLI](/docs/sv/api-reference/authentication).

Kör sedan följande kommando för att autentisera med ElevenLabs:

```bash
elevenlabs auth login
```

Detta öppnar ett webbläsarfönster där du autentiserar via OAuth. CLI:t verifierar autentiseringsuppgifterna och lagrar dem säkert.

#### Skapa agenten

Skapa din första agent med assistentmallen:

```bash
elevenlabs agents add "My Assistant" --template assistant
```

#### Skicka till ElevenLabs-plattformen

```bash
elevenlabs agents push
```

Detta laddar upp din lokala agentkonfiguration till ElevenLabs-plattformen.

#### Testa agenten

Den nyskapade agenten kan testas på flera sätt, men det snabbaste är att använda [ElevenLabs-instrumentpanelen](https://elevenlabs.io/app/agents). Välj din agent på instrumentpanelen och klicka på knappen **Test AI agent**.

> **Info**
>
> Webbpanelen använder vårt [React SDK](/docs/sv/eleven-agents/libraries/react) i bakgrunden för att hantera konversationer i realtid.

Om du i stället snabbt vill testa agenten på din egen webbplats kan du använda Agent-widgeten. Använd CLI:t för att generera HTML-kodavsnittet:

```bash
elevenlabs agents widget embed <agent_id>
```

Agent-ID:t sparas i `agents.json` när du skickar upp ändringarna, och `elevenlabs agents status` listar det. Detta ger dig HTML-kodavsnittet som du sedan kan klistra in direkt på din webbplats.

#### Skapa en agent via API:et

#### Skapa en API-nyckel

[Skapa en API-nyckel i kontrollpanelen här](https://elevenlabs.io/app/settings/api-keys), som du använder för att säkert [få åtkomst till API:et](/docs/sv/api-reference/authentication).

Spara nyckeln som en hanterad hemlighet och skicka den till SDK:erna antingen som en miljövariabel via en `.env`-fil eller direkt i appens konfiguration, beroende på vad du föredrar.

**`.env`**

```js title=".env"
ELEVENLABS_API_KEY=<your_api_key_here>
```

#### Installera SDK:t

#### SDK

Vi använder också biblioteket `dotenv` för att läsa in vår API-nyckel från en miljövariabel.

```python
pip install elevenlabs
pip install python-dotenv
```

```typescript
npm install @elevenlabs/elevenlabs-js
npm install dotenv
```

#### CLI

Installera ElevenLabs CLI. Homebrew (macOS) och Scoop (Windows) rekommenderas.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Arbetar du med en AI-kodningsassistent? Kör `elevenlabs generate-skills` i ditt projekt för att skapa en
> `SKILL.md` för varje kommandogrupp i `skills/`, så att assistenten känner till hela CLI:ts yta
> utan att du behöver klistra in dokumentation. Använd `--output-dir` för att lägga dem någon annanstans. Detta läser CLI:ts egen
> inbäddade API-definition, så det kräver ingen API-nyckel och fungerar offline — och det följer
> den version av CLI:t som du har installerad.

Autentisera sedan — detta öppnar webbläsaren så att du kan auktorisera CLI:t:

```bash
elevenlabs auth login
```

#### Skapa agenten

Skapa en ny fil med namnet `create_agent.py` eller `createAgent.mts`, beroende på vilket språk du väljer, och lägg till följande kod:

```python maxLines=0
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
import os
load_dotenv()

elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)

prompt = """
You are a friendly and efficient virtual assistant for [Your Company Name].
Your role is to assist customers by answering questions about the company's products, services,
and documentation. You should use the provided knowledge base to offer accurate and helpful responses.

Tasks:
- Answer Questions: Provide clear and concise answers based on the available information.
- Clarify Unclear Requests: Politely ask for more details if the customer's question is not clear.

Guidelines:
- Maintain a friendly and professional tone throughout the conversation.
- Be patient and attentive to the customer's needs.
- If unsure about any information, politely ask the customer to repeat or clarify.
- Avoid discussing topics unrelated to the company's products or services.
- Aim to provide concise answers. Limit responses to a couple of sentences and let the user guide you on where to provide more detail.
"""

response = elevenlabs.conversational_ai.agents.create(
    name="My voice agent",
    tags=["test"], # List of tags to help classify and filter the agent
    conversation_config={
        "tts": {
            "voice_id": "aMSt68OGf4xUZAnLpTU8",
            "model_id": "eleven_flash_v2"
        },
        "agent": {
            "first_message": "Hi, this is Rachel from [Your Company Name] support. How can I help you today?",
            "prompt": {
                "prompt": prompt,
            }
        }
    }
)

print("Agent created with ID:", response.agent_id)
```

```typescript maxLines=0
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();

const prompt = `
    You are a friendly and efficient virtual assistant for [Your Company Name].
    Your role is to assist customers by answering questions about the company's products, services,
    and documentation. You should use the provided knowledge base to offer accurate and helpful responses.

    Tasks:
    - Answer Questions: Provide clear and concise answers based on the available information.
    - Clarify Unclear Requests: Politely ask for more details if the customer's question is not clear.

    Guidelines:
    - Maintain a friendly and professional tone throughout the conversation.
    - Be patient and attentive to the customer's needs.
    - If unsure about any information, politely ask the customer to repeat or clarify.
    - Avoid discussing topics unrelated to the company's products or services.
    - Aim to provide concise answers. Limit responses to a couple of sentences and let the user guide you on where to provide more detail.
`;

const agent = await elevenlabs.conversationalAi.agents.create({
    name: "My voice agent",
    tags: ["test"], // List of tags to help classify and filter the agent
    conversationConfig: {
        tts: {
            voiceId: "aMSt68OGf4xUZAnLpTU8",
            modelId: "eleven_flash_v2",
        },
        agent: {
            firstMessage: "Hi, this is Rachel from [Your Company Name] support. How can I help you today?",
            prompt: {
                prompt,
            }
        },
    },
});

console.log(`Agent created with ID: ${agent.agentId}`);
```

> **Note**
>
> Agenten som skapas ovan får taggen `"test"`, vilket är användbart för att klassificera och filtrera agenten. Till exempel för att skilja mellan testagenter och produktionsagenter.

#### Kör koden

```python
python create_agent.py
```

```typescript
npx tsx createAgent.mts
```

Koden ovan skapar en agent med några grundinställningar och skriver ut agentens ID i konsolen. Vi anpassar agenten i ett senare steg.

#### Testa agenten

Den nyskapade agenten kan testas på flera sätt, men det snabbaste är att använda [ElevenLabs-instrumentpanelen](https://elevenlabs.io/app/agents). Välj din agent på instrumentpanelen och klicka på knappen **Test AI agent**.

> **Info**
>
> Webbpanelen använder vårt [React SDK](/docs/sv/eleven-agents/libraries/react) i bakgrunden för att hantera konversationer i realtid.

Om du i stället snabbt vill testa agenten på din egen webbplats kan du använda Agent-widgeten. Klistra bara in följande HTML-kodavsnitt på din webbplats och ersätt `agent-id` med ID:t för din agent.

```html
<elevenlabs-convai agent-id="agent-id"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>
```

Se fliken SDK:er för att lära dig hur du bäddar in agenten på din webbplats eller i din app med de medföljande SDK:erna.

## Nästa steg

Efter den här snabbstartsguiden kan du göra agenten mer effektiv genom att integrera:

* [Kunskapsbaser](/docs/sv/eleven-agents/customization/knowledge-base) för att ge den domänspecifik information.
* [Verktyg](/docs/sv/eleven-agents/customization/tools) så att den kan utföra uppgifter åt dig.
* [Autentisering](/docs/sv/eleven-agents/customization/authentication) för att begränsa åtkomsten till vissa konversationer.
* [Utvärdering av framgång](/docs/sv/eleven-agents/customization/agent-analysis/success-evaluation) för att analysera konversationer och förbättra prestandan.
* [Datainsamling](/docs/sv/eleven-agents/customization/agent-analysis/data-collection) för att samla in data om konversationer och förbättra prestandan.
* [Lagring av konversationer](/docs/sv/eleven-agents/customization/privacy/retention) för att visa konversationshistorik och förbättra prestandan.