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

# Szybki start

> Szybki start z Revol — od rejestracji do pierwszego agenta AI

## Rejestracja i logowanie

Revol obsługuje dwa sposoby tworzenia konta:

* **Google OAuth** — kliknij „Kontynuuj z Google" i autoryzuj się kontem Google. Najszybszy sposób.
* **Email + hasło** — wypełnij formularz: imię, nazwisko, email, hasło i potwierdzenie hasła. Musisz zaakceptować Regulamin i Politykę Prywatności.

Po rejestracji trafiasz na dashboard, gdzie pierwszym krokiem jest utworzenie firmy.

<Note>
  Jeśli masz już konto, skorzystaj ze strony logowania — te same opcje Google OAuth lub email/hasło. Dostępna jest funkcja „Zapamiętaj mnie" oraz odzyskiwanie hasła przez email.
</Note>

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/ISnj5RWDRs_CR9xg/images/register-light.png?fit=max&auto=format&n=ISnj5RWDRs_CR9xg&q=85&s=ed4cbc775d18df55ad61cff211483dcd" alt="Formularz rejestracji" width="2879" height="1542" data-path="images/register-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/eirPFVwD77vgQGj-/images/register-dark.png?fit=max&auto=format&n=eirPFVwD77vgQGj-&q=85&s=5e54d5a6ce98c92fa2350046794109b5" alt="Formularz rejestracji" width="2879" height="1542" data-path="images/register-dark.png" />
</Frame>

***

## Tworzenie firmy

Po zalogowaniu pierwszą rzeczą, którą musisz zrobić, jest **utworzenie firmy**. Firma to centralna jednostka w Revol, do której powiązane są wszystkie inne elementy: produkty, pliki, agenci, integracje, analityka.

Aby utworzyć firmę, wypełnij:

| Pole                   | Opis                                                    |
| ---------------------- | ------------------------------------------------------- |
| **Nazwa firmy**        | Marka lub nazwa działalności                            |
| **Strona internetowa** | URL Twojej strony (używany do walidacji domeny widgetu) |
| **Telefon**            | Numer kontaktowy firmy                                  |
| **Logo**               | Obraz wyświetlany w widgecie i na dashboardzie          |
| **Opis promocyjny**    | Krótki opis Twojej działalności                         |

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/company-setup-light.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=c6b0d8a623cce4859459c4a76a4efc60" alt="Konfiguracja firmy" width="2872" height="1557" data-path="images/company-setup-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/company-setup-dark.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=34bea6cc25ecbc2cafb44657a38059f0" alt="Konfiguracja firmy" width="2880" height="1559" data-path="images/company-setup-dark.png" />
</Frame>

### Dlaczego firma, a nie po prostu agent?

Większość platform chatbotów AI działa w prosty sposób: tworzysz agenta, przesyłasz pliki PDF, a on odpowiada na pytania na podstawie tych dokumentów. To działa dla prostych botów FAQ, ale szybko staje się ograniczeniem dla rzeczywistych firm.

Revol jest zbudowany inaczej. Używamy **strukturalnego modelu danych**: firma → produkty/usługi → parametry produktów. Oto dlaczego:

<AccordionGroup>
  <Accordion title="Strukturalne dane = dokładniejsze odpowiedzi">
    Gdy agent AI wie, że „iPhone 15 Pro" to konkretny produkt w cenie 999 \$, z 8 kolorami i statusem „dostępny", odpowiada **faktami**, zamiast interpretować tekst z PDF. Żadnych halucynacji o cenach, które się zmieniły, lub produktach, których nie ma na stanie.
  </Accordion>

  <Accordion title="Parametry to język Twojego biznesu">
    Każda firma ma swoje kluczowe cechy. Dla sklepu internetowego — rozmiar, kolor, materiał. Dla kliniki — czas trwania zabiegu, przeciwwskazania. Dla SaaS — limity planu, obsługiwane integracje. Parametry produktów pozwalają opisać te szczegóły w ustrukturyzowany sposób, a agent wykorzystuje je do precyzyjnych, kontekstowych odpowiedzi.
  </Accordion>

  <Accordion title="Jeden zestaw danych — wielu agentów">
    Wypełniasz katalog produktów raz, a potem tworzysz wielu agentów z różnymi rolami: jednego do sprzedaży, drugiego do supportu, trzeciego do wewnętrznych szkoleń. Każdy agent wybiera, których konkretnych produktów i plików używa. Bez duplikowania danych.
  </Accordion>

  <Accordion title="Skalowalność dla agencji">
    Jeśli zarządzasz wieloma firmami lub pracujesz jako agencja — każda firma ma izolowane dane, oddzielnych agentów i własną analitykę. Jedno konto Revol może obsługiwać dziesiątki firm.
  </Accordion>
</AccordionGroup>

***

## Produkty i usługi

Po utworzeniu firmy dodaj **produkty lub usługi** — to podstawowe jednostki, o których Twój agent AI będzie wiedział i opowiadał klientom.

Aby utworzyć produkt, podaj:

| Pole           | Opis                                                |
| -------------- | --------------------------------------------------- |
| **Nazwa**      | Nazwa usługi lub produktu                           |
| **Link**       | URL strony produktu na Twojej stronie (opcjonalnie) |
| **Dostępność** | Czy produkt jest dostępny do zamówienia             |

Po utworzeniu otwiera się panel boczny produktu, w którym możesz:

* Dodać **szczegółowy opis** (prompt) — rozszerzony tekst o produkcie, którego agent będzie używał w odpowiedziach
* Ustawić **cenę**
* Przesłać **zdjęcia** produktu
* Dodać **pliki** do bazy wiedzy produktu (dokumenty, linki, tekst, wideo)

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/ISnj5RWDRs_CR9xg/images/product-card-light.png?fit=max&auto=format&n=ISnj5RWDRs_CR9xg&q=85&s=020f0e4dce757b0caa68d9a425795ad7" alt="Karta produktu" width="2873" height="1551" data-path="images/product-card-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/ISnj5RWDRs_CR9xg/images/product-card-dark.png?fit=max&auto=format&n=ISnj5RWDRs_CR9xg&q=85&s=1f29902c2ad0ac623d81948a2729c589" alt="Karta produktu" width="2860" height="1546" data-path="images/product-card-dark.png" />
</Frame>

### Parametry produktu

Najpotężniejszą częścią modelu produktu są **parametry**. To ustrukturyzowane pary „nazwa — wartość", które opisują konkretne cechy produktu.

**Przykłady parametrów dla różnych branż:**

<Tabs>
  <Tab title="Sklep internetowy">
    | Parametr  | Wartość                  |
    | --------- | ------------------------ |
    | Rozmiar   | S, M, L, XL              |
    | Kolor     | Czarny, Biały, Niebieski |
    | Materiał  | 100% bawełna             |
    | Waga      | 250 g                    |
    | Gwarancja | 12 miesięcy              |
  </Tab>

  <Tab title="Klinika / Salon">
    | Parametr         | Wartość                            |
    | ---------------- | ---------------------------------- |
    | Czas trwania     | 60 minut                           |
    | Przeciwwskazania | Ciąża, alergia na lateks           |
    | Przygotowanie    | Nie jeść 2 godziny przed zabiegiem |
    | Rekonwalescencja | 3-5 dni                            |
  </Tab>

  <Tab title="SaaS / IT">
    | Parametr           | Wartość                                  |
    | ------------------ | ---------------------------------------- |
    | Użytkownicy        | Do 50                                    |
    | Przestrzeń dyskowa | 100 GB                                   |
    | Zapytania API      | 10 000 / miesiąc                         |
    | Wsparcie           | Email + czat, odpowiedź w ciągu 4 godzin |
    | Integracje         | Slack, Jira, GitHub                      |
  </Tab>
</Tabs>

**Po co to jest potrzebne?** Gdy klient pyta „Jakie rozmiary są dostępne?" lub „Ile trwa zabieg?" — agent bierze odpowiedź bezpośrednio z parametrów produktu, zamiast szukać tych informacji w długim tekście. To zapewnia:

* **Dokładność** — konkretne wartości zamiast ogólnikowych sformułowań
* **Aktualność** — zmień parametr w jednym miejscu, a agent natychmiast odpowiada zaktualizowanymi informacjami
* **Porównywanie** — agent może porównywać produkty według konkretnych parametrów

***

## Menedżer plików

**Menedżer plików** to scentralizowane repozytorium wszystkich plików Twojej firmy. Tutaj przesyłasz treści, które będą wykorzystywane do trenowania agentów AI.

Przejdź do **Menedżera plików** w menu bocznym. Zobaczysz listę firm — wybierz odpowiednią, aby otworzyć jej pliki.

### Typy treści

<Tabs>
  <Tab title="Dokumenty">
    Przesyłaj pliki w formatach **PDF**, **DOCX**, **TXT**. Revol automatycznie wyodrębni tekst, podzieli go na fragmenty i utworzy wektorowe embeddingi do wyszukiwania semantycznego.

    | Format | Maks. rozmiar | Co jest wyodrębniane      |
    | ------ | ------------- | ------------------------- |
    | PDF    | 10 MB         | Tekst ze wszystkich stron |
    | DOCX   | 10 MB         | Tekst z formatowaniem     |
    | TXT    | 5 MB          | Pełny tekst               |
  </Tab>

  <Tab title="Linki">
    Wklej URL dowolnej strony internetowej. Revol automatycznie pobierze zawartość strony, wyodrębni tekst i doda go do bazy wiedzy.

    To wygodne dla:

    * Stron z opisami usług
    * Sekcji FAQ
    * Postów na blogu i artykułów
    * Zasobów zewnętrznych
  </Tab>

  <Tab title="Tekst">
    Dodaj treść bezpośrednio jako blok tekstowy. Idealne dla:

    * Najczęściej zadawanych pytań (FAQ)
    * Regulaminów firmy
    * Skryptów agenta
    * Krótkich instrukcji
  </Tab>

  <Tab title="Wideo">
    Prześlij wideo — Revol automatycznie transkrybuje ścieżkę dźwiękową na tekst i doda go do bazy wiedzy. Obsługiwane formaty: **MP4**, **WebM**, **MOV**.
  </Tab>

  <Tab title="Zdjęcia">
    Prześlij obrazy z tekstem — Revol użyje OCR do wyodrębnienia tekstu. Przydatne dla zrzutów ekranu, zdjęć dokumentów, infografik.
  </Tab>
</Tabs>

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/file-manager-light.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=d24d28dd98f250a4b5a219a2e53e3164" alt="Menedżer plików" width="2878" height="1554" data-path="images/file-manager-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/file-manager-dark.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=f0c25374111eeb2902f371e38d934b9e" alt="Menedżer plików" width="2879" height="1556" data-path="images/file-manager-dark.png" />
</Frame>

<Note>
  Pliki można dodawać zarówno na poziomie firmy (dostępne dla wszystkich agentów), jak i na poziomie pojedynczego produktu (powiązane z konkretnym produktem/usługą).
</Note>

***

## Tworzenie agenta AI

Teraz, gdy masz firmę z produktami i plikami — czas utworzyć agenta AI.

Przejdź do **Agenci AI** w menu bocznym i kliknij **Utwórz agenta**.

### Podstawowe ustawienia

| Pole                 | Opis                                                                           |
| -------------------- | ------------------------------------------------------------------------------ |
| **Nazwa**            | Nazwa agenta (np. „Konsultant sprzedaży")                                      |
| **Firma**            | Do której firmy agent należy                                                   |
| **Przypadek użycia** | Rola agenta: Sprzedaż, Support, Generowanie leadów, Rezerwacje, Niestandardowy |
| **Dostawca LLM**     | Dostawca modelu AI                                                             |
| **Model**            | Konkretny model do użycia                                                      |

### Dostępni dostawcy LLM

<CardGroup cols={2}>
  <Card title="OpenAI" icon="bolt">
    GPT-4o, GPT-4o-mini — najpopularniejszy wybór do większości zadań
  </Card>

  <Card title="Anthropic" icon="brain">
    Claude Sonnet, Claude Haiku — doskonała jakość odpowiedzi i bezpieczeństwo
  </Card>

  <Card title="Google" icon="google">
    Gemini 2.0 Flash, Gemini 2.5 Pro — szybkie i wydajne modele
  </Card>

  <Card title="Groq" icon="microchip">
    Llama 3.1 8B, Llama 3.3 70B — najszybsze wnioskowanie, modele open-source
  </Card>
</CardGroup>

### Prompt systemowy

Po utworzeniu agenta otwiera się pełnoekranowy panel ustawień. Pierwszym krokiem jest napisanie **promptu systemowego** — głównej instrukcji definiującej zachowanie agenta.

```text theme={null}
You are a sales consultant for [Company Name].
Your goal is to help customers choose the right product.

Rules:
- Always be polite and professional
- If you don't know the answer — honestly say so
- Do not discuss competitors' products
- Suggest relevant products from the knowledge base
- Respond in the customer's language
```

<Tip>
  Im bardziej szczegółowy prompt systemowy, tym dokładniejsze odpowiedzi agenta. Określ rolę, ton komunikacji, ograniczenia i przykłady odpowiedzi.
</Tip>

***

## Baza wiedzy agenta

Przejdź do zakładki **Wiedza** w panelu agenta. Tutaj wybierasz, jakich konkretnych danych agent będzie używał do odpowiedzi.

### Źródła wiedzy

Agent może uczyć się z dwóch typów źródeł:

<AccordionGroup>
  <Accordion title="Produkty firmy">
    Wybierz konkretne produkty lub usługi, o których agent powinien wiedzieć. Agent uzyska dostęp do nazw, opisów, cen, parametrów i zdjęć wybranych produktów.
  </Accordion>

  <Accordion title="Pliki bazy wiedzy">
    Wybierz dokumenty, linki, teksty i wideo z Menedżera plików. Możesz wybierać pliki zarówno na poziomie firmy, jak i powiązane z konkretnymi produktami.
  </Accordion>
</AccordionGroup>

### Trenowanie

Po wybraniu źródeł kliknij **Trenuj**. Revol:

1. Wyodrębni całą treść tekstową z wybranych źródeł
2. Podzieli ją na optymalne fragmenty
3. Utworzy wektorowe embeddingi za pomocą OpenAI text-embedding-3-small
4. Zapisze je w PostgreSQL z pgvector do wyszukiwania semantycznego

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/Eqyg_VGeDQWA95PL/images/agents-knowledge-base-light.png?fit=max&auto=format&n=Eqyg_VGeDQWA95PL&q=85&s=54073d8431563eaf5efba937d70552db" alt="Baza wiedzy agenta" width="2867" height="1551" data-path="images/agents-knowledge-base-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/Eqyg_VGeDQWA95PL/images/agents-knowledge-base-dark.png?fit=max&auto=format&n=Eqyg_VGeDQWA95PL&q=85&s=089b1492ccb3a7c45341fc8993327da4" alt="Baza wiedzy agenta" width="2874" height="1555" data-path="images/agents-knowledge-base-dark.png" />
</Frame>

<Warning>
  Po zmianie plików lub produktów musisz ponownie kliknąć **Trenuj**, aby agent otrzymał zaktualizowane dane.
</Warning>

***

## Testowanie agenta

Przed opublikowaniem przetestuj agenta bezpośrednio w dashboardzie. Kliknij przycisk **Podgląd** w górnym panelu agenta — otworzy się wbudowane okno czatu.

### Podstawowy workflow

Każdy nowy agent zawiera **gotowy workflow**, który pokrywa podstawowe potrzeby bez dodatkowej konfiguracji. Jego struktura:

```
Voice Input (STT) → Start → Product Agent  ─┐
                         ├→ Media Agent    ─┤→ Response Formatter → Voice Output (TTS)
                         └→ Company Agent  ─┘
```

| Węzeł                    | Co robi                                                             | Narzędzia                                                                           |
| ------------------------ | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Start**                | Punkt wejścia — odbiera wiadomość użytkownika                       | —                                                                                   |
| **Product Agent**        | Wyszukuje produkty, szczegóły, dostępność, parametry                | `get_products`, `get_product_details`, `check_availability`, `search_by_parameters` |
| **Media Agent**          | Znajduje zdjęcia, wideo i dokumenty z bazy wiedzy                   | `get_photos`, `get_videos`, `get_documents`, `search_documents`                     |
| **Company Agent**        | Odpowiada na ogólne pytania o firmie                                | `get_company_info`                                                                  |
| **Response Formatter**   | Zbiera odpowiedzi od wszystkich agentów i formuje końcową wiadomość | —                                                                                   |
| **Voice Input / Output** | STT i TTS dla trybu głosowego (domyślnie wyłączone)                 | —                                                                                   |

Trzech wyspecjalizowanych agentów pracuje **równolegle** — Start rozdziela zapytanie między nich, każdy szuka odpowiednich informacji w swoim obszarze, a Formatter łączy wyniki w jedną spójną odpowiedź.

<Tip>
  Podstawowy workflow jest wystarczający dla większości scenariuszy: konsultacje produktowe, odpowiedzi na FAQ, wyszukiwanie w bazie wiedzy. Dla bardziej złożonych scenariuszy (warunki, rozgałęzienia, niestandardowe wywołania narzędzi) użyj [Edytora workflow](/agents/workflow).
</Tip>

### Co sprawdzić

<Steps>
  <Step title="Podstawowe odpowiedzi">
    Zapytaj o swoje produkty i usługi. Upewnij się, że agent odpowiada dokładnie i korzysta z danych z bazy wiedzy.
  </Step>

  <Step title="Granice wiedzy">
    Zapytaj o coś, czego nie ma w bazie wiedzy. Agent powinien uczciwie powiedzieć, że nie posiada takich informacji, zamiast wymyślać odpowiedź.
  </Step>

  <Step title="Ton i styl">
    Sprawdź, czy ton komunikacji odpowiada Twojemu promptowi systemowemu — uprzejmość, język, formalność.
  </Step>

  <Step title="Obsługa wielojęzyczna">
    Pisz w różnych językach — agent powinien odpowiadać w języku klienta.
  </Step>
</Steps>

<Tip>
  Użyj zakładki **Analiza**, aby przeglądać historię rozmów, oceny i statystyki agenta.
</Tip>

***

## Instalacja widgetu

Gdy agent jest gotowy — zainstaluj widget na swojej stronie. Kliknij przycisk **Osadź** w górnym panelu agenta.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/8tD14ZAg_eb7XGXC/images/embed-code-light.png?fit=max&auto=format&n=8tD14ZAg_eb7XGXC&q=85&s=367902b87e32b43dd9d152868c35a636" alt="Modal z kodem osadzenia" width="2425" height="1276" data-path="images/embed-code-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/8tD14ZAg_eb7XGXC/images/embed-code-dark.png?fit=max&auto=format&n=8tD14ZAg_eb7XGXC&q=85&s=4d33a3f9339ea0cfa5daaf925fa50cd1" alt="Modal z kodem osadzenia" width="2424" height="1319" data-path="images/embed-code-dark.png" />
</Frame>

### Pobieranie kodu

1. Kliknij **Wygeneruj klucz API** (jeśli klucz nie został jeszcze utworzony)
2. Skopiuj kod HTML widgetu

### Dodawanie na stronę

Dodaj ten kod przed zamykającym tagiem `</head>` na swojej stronie:

```html theme={null}
<script src="https://revol-ai.app/tracker.js"
        data-api-key="YOUR_API_KEY"
        data-company-id="YOUR_COMPANY_ID"
        async>
</script>
```

Jeden skrypt zapewnia:

* **Widget czatu** — przycisk w rogu strony do komunikacji z agentem
* **Śledzenie odwiedzających** — sesje, strony, zdarzenia, tagi UTM
* **Komunikację głosową** — jeśli włączona dla agenta

<Note>
  Widget renderuje się w **Shadow DOM** — jego style są w pełni odizolowane od Twojej strony i odwrotnie. Bez konfliktów CSS.
</Note>

### Sprawdzanie połączenia

Po zainstalowaniu skryptu wróć do modala z kodem osadzenia i kliknij **Sprawdź połączenie**. Revol zweryfikuje, czy widget jest prawidłowo podłączony do Twojej strony.

***

## Następne kroki

<CardGroup cols={2}>
  <Card title="Edytor workflow" icon="diagram-project" href="/agents/workflow">
    Twórz złożone scenariusze rozmów z warunkami, rozgałęzieniami i wywołaniami narzędzi
  </Card>

  <Card title="Integracje" icon="plug" href="/integrations/overview">
    Połącz Telegram, WhatsApp, telefonię i inne kanały
  </Card>

  <Card title="Personalizacja widgetu" icon="palette" href="/widget/customization">
    Zmień kolory, teksty, pozycję i wygląd widgetu
  </Card>

  <Card title="Analityka i śledzenie" icon="chart-line" href="/widget/tracker">
    Śledź sesje odwiedzających, zdarzenia i konwersje
  </Card>
</CardGroup>