> 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.

# Nadpisania

> **Warning**
>
> Chociaż nadpisania nadal pozwalają całkowicie zastąpić prompty systemowe lub pierwsze wiadomości,
> zalecamy używanie [zmiennych dynamicznych](/docs/pl/eleven-agents/customization/personalization/dynamic-variables) jako preferowanego
> sposobu dostosowywania odpowiedzi agenta i wstawiania danych w czasie rzeczywistym. Zmienne dynamiczne
> są łatwiejsze w utrzymaniu i oferują bardziej uporządkowane podejście do personalizacji.

**Nadpisania** pozwalają asystentowi dostosować działanie do każdej interakcji z użytkownikiem. Na początku każdej rozmowy możesz przekazać własne dane i ustawienia, aby asystent personalizował odpowiedzi i wiedzę na podstawie kontekstu w czasie rzeczywistym. Nadpisania całkowicie zastępują domyślne wartości agenta zdefiniowane w [panelu](https://elevenlabs.io/app/agents/agents) agenta.

## Omówienie

Nadpisania pozwalają zmieniać zachowanie agenta AI w czasie rzeczywistym bez tworzenia wielu agentów. Dzięki temu możesz personalizować odpowiedzi danymi konkretnego użytkownika.

Nadpisania można włączyć dla następujących pól w ustawieniach zabezpieczeń agenta:

* Prompt systemowy
* Pierwsza wiadomość
* Język
* ID głosu
* LLM (Large Language Model)
* Narzędzia
* Baza wiedzy
* Tryb tylko tekstowy
* Stabilność
* Szybkość
* Wzmocnienie podobieństwa
* Słowa kluczowe ASR

Gdy nadpisania są włączone dla pola, podanie nadpisania nadal jest opcjonalne. Jeśli go nie podasz, agent użyje domyślnych wartości zdefiniowanych w [panelu](https://elevenlabs.io/app/agents/agents) agenta. W przypadku większości pól wystąpi błąd, jeśli podasz nadpisanie dla pola, w którym nadpisania nie są włączone.

> **Warning**
>
> **Słowa kluczowe ASR** używają miękkiego blokowania: jeśli przełącznik Security jest wyłączony, a klient nadal wyśle
> `asr.keywords`, rozmowa będzie kontynuowana, a słowa kluczowe zostaną zignorowane (bez błędu). Włącz nadpisanie
> **słów kluczowych ASR** w ustawieniach Security, jeśli chcesz stosować wzmacnianie słów kluczowych dla każdej
> rozmowy. Jedna rozmowa obsługuje do 50 słów kluczowych.

Oto kilka przykładów, kiedy nadpisania mogą się przydać:

* **Witaj użytkowników** po imieniu
* **Uwzględniaj dane konkretnego konta** w odpowiedziach
* **Dostosuj język agenta** lub ton do preferencji użytkownika
* **Przekazuj dane w czasie rzeczywistym**, takie jak saldo konta lub status zamówienia
* **Wzmacniaj transkrypcję** nazw lub terminów dla konkretnego połączenia (na przykład nazw firm z CRM) przez słowa kluczowe ASR

> **Info**
>
> Nadpisania są szczególnie przydatne w aplikacjach wymagających spersonalizowanych interakcji lub obsługujących
> wrażliwe dane użytkowników, których nie należy przechowywać w podstawowej konfiguracji agenta.

## Przewodnik

### Wymagania wstępne

* [Konto ElevenLabs](https://elevenlabs.io)
* Skonfigurowany agent konwersacyjny ElevenLabs ([utwórz go tutaj](/docs/pl/eleven-agents/quickstart))

Ten przewodnik pokazuje, jak nadpisać domyślne ustawienia **promptu systemowego**, **pierwszej wiadomości**, **LLM**, **narzędzi**, **bazy wiedzy**, **TTS** i **słów kluczowych ASR**.

#### Włącz nadpisania

Ze względów bezpieczeństwa nadpisania są domyślnie wyłączone. Włącz pola, które chcesz pozwolić nadpisywać, na przykład `first_message`, `prompt.prompt`, `prompt.tool_ids`, `prompt.knowledge_base`, `language` lub `asr.keywords`.

#### Aktualizacja w panelu

Przejdź do ustawień agenta i wybierz kartę **Security**. Włącz `First message`, `System prompt`, `Tools`, `Knowledge base`, `ASR keywords` oraz inne potrzebne nadpisania, takie jak `LLM`.

![Włącz nadpisania](/docs/_fern-img/496f20380ffe29fc46275bbfe5c6eaabdb5e211c780188243a018b38715ea779.webp)

#### Aktualizacja przez CLI

#### Pobierz konfigurację agenta

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### Edytuj \`agent_configs/\<agent-name>.json\`

Ustaw pola w `platform_settings.overrides.conversation_config_override` na `true`, aby zezwolić na nadpisania w czasie działania dla danego pola:

```json
{
  "platform_settings": {
    "overrides": {
      "conversation_config_override": {
        "agent": {
          "first_message": true,
          "language": true,
          "prompt": {
            "prompt": true,
            "tool_ids": true,
            "knowledge_base": true
          }
        },
        "tts": { "voice_id": true },
        "asr": { "keywords": true }
      }
    }
  }
}
```

#### Wyślij zmiany

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Aktualizacja przez API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    platform_settings={
        "overrides": {
            "conversation_config_override": {
                "agent": {
                    "first_message": True,
                    "language": True,
                    "prompt": {
                        "prompt": True,
                        "tool_ids": True,
                        "knowledge_base": True,
                    },
                },
                "tts": {"voice_id": True},
                "asr": {"keywords": True},
            },
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  platformSettings: {
    overrides: {
      conversationConfigOverride: {
        agent: {
          firstMessage: true,
          language: true,
          prompt: {
            prompt: true,
            toolIds: true,
            knowledgeBase: true,
          },
        },
        tts: { voiceId: true },
        asr: { keywords: true },
      },
    },
  },
});
```

#### Nadpisz rozmowę

W kodzie, w miejscu rozpoczęcia rozmowy, przekaż nadpisania jako parametr. Nadpisania narzędzi i bazy wiedzy zastępują domyślne tablice dla tej rozmowy. Nadpisania słów kluczowych ASR zastępują domyślną listę słów kluczowych agenta dla tej rozmowy (maksymalnie 50 słów kluczowych).

**`Dane inicjujące rozmowę`**

```json title="Dane inicjujące rozmowę" focus={4-15}
{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "tool_ids": ["tool_7101k5zvyjhmfg983brhmhkd98n6"],
        "knowledge_base": [
          {
            "type": "file",
            "name": "Unladen Swallow Facts",
            "id": "5xM3yVvZQKV0EfqQpLrJ",
            "usage_mode": "auto"
          }
        ]
      }
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso", "Globex"]
    }
  }
}
```

> **Tip**
>
> Upewnij się, że masz zainstalowaną najnowszą wersję [SDK](/docs/pl/eleven-agents/libraries/python).

**`Python`**

```python title="Python" focus={3-28} maxLines=28
from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
...
conversation_override = {
    "agent": {
        "prompt": {
            "prompt": f"The customer's bank account balance is {customer_balance}. They are based in {customer_location}.", # Optional: override the system prompt.
            "llm": "gpt-4o", # Optional: override the LLM model.
            "tool_ids": [
                "tool_7101k5zvyjhmfg983brhmhkd98n6"
            ], # Optional: replace the tools available to the agent.
            "knowledge_base": [
                {
                    "type": "file",
                    "name": "Unladen Swallow Facts",
                    "id": "5xM3yVvZQKV0EfqQpLrJ",
                    "usage_mode": "auto",
                }
            ], # Optional: replace the knowledge base available to the agent.
        },
        "first_message": f"Hi {customer_name}, how can I help you today?", # Optional: override the first_message.
        "language": "en" # Optional: override the language.
    },
    "tts": {
        "voice_id": "custom_voice_id", # Optional: override the voice.
        "stability": 0.7, # Optional: override stability (0.0 to 1.0).
        "speed": 1.1, # Optional: override speed (0.7 to 1.2).
        "similarity_boost": 0.9 # Optional: override similarity boost (0.0 to 1.0).
    },
    "conversation": {
        "text_only": True # Optional: enable text-only mode (no audio).
    },
    "asr": {
        "keywords": ["Acme Corp", "Contoso"] # Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
    }
}

config = ConversationInitiationData(
    conversation_config_override=conversation_override
)
conversation = Conversation(
    ...
    config=config,
    ...
)
conversation.start_session()
```

**`JavaScript`**

```javascript title="JavaScript" focus={4-29} maxLines=29
...
const conversation = await Conversation.startSession({
  ...
  overrides: {
      agent: {
          prompt: {
              prompt: `The customer's bank account balance is ${customer_balance}. They are based in ${customer_location}.`, // Optional: override the system prompt.
              llm: "gpt-4o", // Optional: override the LLM model.
              toolIds: [
                  "tool_7101k5zvyjhmfg983brhmhkd98n6"
              ], // Optional: replace the tools available to the agent.
              knowledgeBase: [
                  {
                      type: "file",
                      name: "Unladen Swallow Facts",
                      id: "5xM3yVvZQKV0EfqQpLrJ",
                      usageMode: "auto",
                  }
              ], // Optional: replace the knowledge base available to the agent.
          },
          firstMessage: `Hi ${customer_name}, how can I help you today?`, // Optional: override the first message.
          language: "en" // Optional: override the language.
      },
      tts: {
          voiceId: "custom_voice_id", // Optional: override the voice.
          stability: 0.7, // Optional: override stability (0.0 to 1.0).
          speed: 1.1, // Optional: override speed (0.7 to 1.2).
          similarityBoost: 0.9 // Optional: override similarity boost (0.0 to 1.0).
      },
      conversation: {
          textOnly: true // Optional: enable text-only mode (no audio).
      },
      asr: {
          keywords: ["Acme Corp", "Contoso"] // Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
      }
  },
  ...
})
```

**`Swift`**

```swift title="Swift" focus={3-16} maxLines=16
import ElevenLabsSDK

let promptOverride = ElevenLabsSDK.AgentPrompt(
    prompt: "The customer's bank account balance is \(customer_balance). They are based in \(customer_location).", // Optional: override the system prompt.
    llm: "gpt-4o" // Optional: override the LLM model.
)
let agentConfig = ElevenLabsSDK.AgentConfig(
    prompt: promptOverride, // Optional: override the system prompt.
    firstMessage: "Hi \(customer_name), how can I help you today?", // Optional: override the first message.
    language: .en // Optional: override the language.
)
let ttsConfig = ElevenLabsSDK.TTSConfig(
    voiceId: "custom_voice_id", // Optional: override the voice.
    stability: 0.7, // Optional: override stability (0.0 to 1.0).
    speed: 1.1, // Optional: override speed (0.7 to 1.2).
    similarityBoost: 0.9 // Optional: override similarity boost (0.0 to 1.0).
)
let conversationConfig = ElevenLabsSDK.ConversationConfig(
    textOnly: true // Optional: enable text-only mode (no audio).
)
let overrides = ElevenLabsSDK.ConversationConfigOverride(
    agent: agentConfig, // Optional: override agent settings.
    tts: ttsConfig, // Optional: override TTS settings.
    conversation: conversationConfig // Optional: override conversation settings.
)

let config = ElevenLabsSDK.SessionConfig(
    agentId: "",
    overrides: overrides
)

let conversation = try await ElevenLabsSDK.Conversation.startSession(
  config: config,
  callbacks: callbacks
)
```

**`Widget`**

```html title="Widget"
  <elevenlabs-convai
    agent-id="agent_7101k5zvyjhmfg983brhmhkd98n6"
    override-language="es"         <!-- Optional: override the language -->
    override-prompt="Custom system prompt for this user"  <!-- Optional: override the system prompt -->
    override-first-message="Hi! How can I help you today?"  <!-- Optional: override the first message -->
    override-voice-id="custom_voice_id"  <!-- Optional: override the voice -->
  ></elevenlabs-convai>
```

> **Note**
>
> Przy nadpisaniach pomijaj pola, których nie chcesz nadpisywać, zamiast ustawiać je na puste ciągi lub wartości null. Uwzględniaj tylko pola, które chcesz dostosować.

> **Tip**
>
> Aby znaleźć poprawny ciąg modelu LLM, sprawdź [dokumentację API agenta](/docs/pl/api-reference/agents/create#request.body.conversation_config.agent.prompt.llm), która zawiera wszystkie obsługiwane modele LLM i ich dokładne identyfikatory tekstowe.