> ## 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.
# Kluczowe pojęcia
> Kluczowe pojęcia i terminologia w Revol
## Firmy
**Firma** to centralna jednostka w Revol. Wszystko — produkty, pliki, agenci, integracje i analityka — należy do firmy.
Każda firma posiada:
* **Produkty i usługi** — ustrukturyzowany katalog z opisami, cenami, zdjęciami i parametrami
* **Menedżer plików** — dokumenty, linki, tekst, wideo i zdjęcia do baz wiedzy
* **Agenci AI** — jeden lub więcej inteligentnych asystentów wytrenowanych na danych firmy
* **Integracje** — podłączone kanały (widget, VoIP, komunikatory, reklamy, CRM)
* **Analityka** — śledzenie odwiedzających, dane sesji i historia rozmów
Jedno konto Revol może zarządzać wieloma firmami z w pełni izolowanymi danymi — idealne dla agencji lub firm wielomarkowych.
***
## Produkty i usługi
**Produkty** to ustrukturyzowane modele danych opisujące, co oferuje Twoja firma. W przeciwieństwie do surowych dokumentów tekstowych, produkty dostarczają agentom AI precyzyjne, łatwo przeszukiwalne informacje.
Każdy produkt zawiera:
| Pole | Przeznaczenie |
| -------------- | ----------------------------------------------------------------------- |
| **Nazwa** | Nazwa produktu lub usługi |
| **Opis** | Szczegółowy tekst, którego agent używa w odpowiedziach |
| **Cena** | Informacja o cenie |
| **URL** | Link do strony produktu na Twojej stronie |
| **Dostępność** | Czy produkt jest aktualnie dostępny |
| **Zdjęcia** | Zdjęcia produktu, które agent może udostępniać |
| **Parametry** | Ustrukturyzowane pary klucz-wartość (rozmiar, kolor, czas trwania itp.) |
**Parametry** to najpotężniejsza część — ustrukturyzowane cechy, które pozwalają agentom dawać dokładne odpowiedzi zamiast interpretować nieustrukturyzowany tekst. Zobacz [Szybki start → Parametry produktu](/quickstart#product-parameters), aby zobaczyć przykłady.
***
## Baza wiedzy
**Baza wiedzy** to treści, z których uczą się Twoi agenci AI. Wykorzystuje **RAG (Retrieval-Augmented Generation)** — dokumenty są dzielone na fragmenty, konwertowane na wektorowe embeddingi i przeszukiwane semantycznie podczas rozmów.
### Typy treści
| Typ | Formaty | Jak to działa |
| ------------- | ----------------------- | -------------------------------------------- |
| **Dokumenty** | PDF, DOCX, TXT | Tekst wyodrębniony i podzielony na fragmenty |
| **Linki** | Dowolny URL | Treść strony pobierana i indeksowana |
| **Tekst** | Tekst w dowolnej formie | Dodawany bezpośrednio jako fragmenty wiedzy |
| **Wideo** | MP4, WebM, MOV | Audio transkrybowane na tekst przez STT |
| **Zdjęcia** | JPG, PNG | Tekst wyodrębniony przez OCR |
### Dwa poziomy wiedzy
* **Pliki na poziomie firmy** — dostępne dla wszystkich agentów w firmie
* **Pliki na poziomie produktu** — dołączone do konkretnego produktu, używane gdy agent omawia ten produkt
***
## Agenci AI
**Agent AI** to inteligentny asystent konfigurowany niezależnie z własną osobowością, wiedzą i zachowaniem. Agenci mogą działać w trzech trybach:
| Tryb | Opis |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aktywny** | AI w pełni obsługuje komunikację z klientem — odpowiada na wiadomości, wywołuje narzędzia, realizuje workflow |
| **Pasywny** | Twój zespół obsługuje całą komunikację. Agent działa w tle — monitoruje rozmowy, audytuje zgodność ze standardami komunikacji i dostarcza analizy |
| **Hybrydowy** | Kombinacja: AI automatycznie obsługuje rutynowe interakcje, a Twój zespół przejmuje skomplikowane przypadki. Agent nieustannie analizuje wszystkie rozmowy niezależnie od tego, kto odpowiada |
Tryb pasywny jest idealny dla zespołów, które chcą kontroli jakości opartej na AI bez zastępowania ludzkich operatorów. Agent monitoruje każdą rozmowę, sprawdza przestrzeganie skryptów i standardów oraz dostarcza wnioski — bez bezpośredniego odpowiadania klientom.
### Komponenty agenta
Główny zestaw instrukcji — definiuje rolę agenta, ton, język i ograniczenia. Im bardziej szczegółowy prompt, tym lepiej agent działa.
Wybierz, z których produktów i plików agent ma się uczyć. Po wyborze kliknij **Trenuj**, aby wygenerować wektorowe embeddingi do wyszukiwania semantycznego.
Wizualny edytor węzłowy logiki rozmów. Każdy agent otrzymuje [domyślny workflow](/quickstart#default-workflow), który obsługuje większość przypadków użycia od razu po utworzeniu.
Funkcje, które agent może wywoływać podczas rozmów — wyszukiwanie produktów, sprawdzanie dostępności, pobieranie zdjęć, wyszukiwanie dokumentów, pobieranie informacji o firmie.
Personalizuj wygląd widgetu czatu — kolory, etykiety, pozycja, wiadomości powitalne, regulamin.
Podłącz agenta do kanałów komunikacji — widget na stronie, Telegram, WhatsApp, Instagram, Facebook Messenger, VoIP.
### Dostawcy LLM
Każdy agent (lub pojedynczy węzeł workflow) może używać innego modelu AI:
| Dostawca | Modele standardowe | Modele premium |
| ------------- | ------------------ | ----------------- |
| **OpenAI** | GPT-4o-mini | GPT-4o |
| **Anthropic** | Claude 3.5 Haiku | Claude 3.5 Sonnet |
| **Google** | Gemini 2.0 Flash | Gemini 2.5 Pro |
| **Groq** | Llama 3.1 8B | Llama 3.3 70B |
Modele standardowe są szybsze i zużywają tokeny standardowe. Modele premium oferują wyższą jakość i zużywają tokeny premium.
***
## Workflow
**Workflow** to wizualny edytor węzłowy definiujący sposób, w jaki agent przetwarza rozmowy. Węzły są połączone krawędziami, które określają przepływ danych.
### Typy węzłów
| Węzeł | Opis |
| ----------------------- | ----------------------------------------------------------------------------- |
| **Start** | Punkt wejścia — odbiera wiadomość użytkownika |
| **LLM** | Wysyła kontekst do modelu AI i otrzymuje odpowiedź |
| **Warunek** | Rozgałęzia przepływ na podstawie reguł (słowa kluczowe, intencja, zmienne) |
| **Wywołanie narzędzia** | Wykonuje zewnętrzną funkcję (wyszukiwanie produktów, sprawdzanie dostępności) |
| **Voice Input (STT)** | Konwertuje mowę na tekst dla interakcji głosowych |
| **Voice Output (TTS)** | Konwertuje odpowiedź tekstową na mowę |
| **Response Formatter** | Łączy wyniki z wielu węzłów w jedną odpowiedź |
### Domyślny workflow
Każdy nowy agent zawiera wbudowany workflow:
```
Start → Product Agent ─┐
├→ Media Agent ─┤→ Response Formatter
└→ Company Agent ─┘
```
Trzech wyspecjalizowanych agentów pracuje **równolegle** — każdy obsługuje swoją domenę (produkty, media, informacje o firmie), a Formatter łączy ich wyniki. To pokrywa większość przypadków użycia bez żadnej konfiguracji.
Dla złożonych scenariuszy — warunkowe rozgałęzienia, niestandardowe wywołania narzędzi, wieloetapowe przepływy — użyj [Edytora workflow](/agents/workflow).
***
## Rozmowy
**Rozmowa** to sesja czatu między odwiedzającym a agentem AI. Wszystkie rozmowy są przechowywane i dostępne na stronie **Rozmowy**.
### Kanały
Rozmowy mogą odbywać się przez:
* **Widget na stronie** — osadzony czat na Twojej stronie
* **VoIP** — rozmowy telefoniczne przez Twilio, Ringostat lub Binotel
* **Komunikatory** — Telegram, WhatsApp Business, Instagram DM, Facebook Messenger
* **API** — dostęp programistyczny
### Funkcje
* **Wspólna skrzynka odbiorcza** — wszystkie rozmowy ze wszystkich agentów i kanałów w jednym miejscu
* **Filtry** — według agenta, statusu, daty, kanału
* **Transkrypcje** — pełna historia wiadomości ze znacznikami czasu
* **Odtwarzanie audio** — słuchanie nagrań rozmów głosowych
* **Oceny** — wyniki satysfakcji klientów na rozmowę
***
## Śledzenie
**Tracker** jest wbudowany w ten sam skrypt widgetu i automatycznie monitoruje aktywność odwiedzających na Twojej stronie.
### Co jest śledzone
| Dane | Opis |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| **Sesje** | Sesje przeglądania odwiedzających — urządzenie, przeglądarka, system operacyjny, lokalizacja, źródło ruchu |
| **Odsłony** | Pojedyncze odwiedziny stron w ramach sesji |
| **Zdarzenia** | Niestandardowe zdarzenia — kliknięcia, wysłanie formularzy, połączenia telefoniczne |
| **Kampanie** | Grupowanie na podstawie UTM (source, medium, campaign, term, content) |
### Automatyzacja
* **Triggery** — automatyczne akcje na podstawie zachowania odwiedzających (czas na stronie, głębokość przewijania, dopasowanie UTM, typ urządzenia). Mogą wyświetlać nakładki czatu lub niestandardowe wiadomości.
* **Podmiana numerów** — dynamiczna podmiana numerów telefonów do śledzenia i atrybucji połączeń.
***
## Integracje
**Integracje** łączą Twoich agentów AI z zewnętrznymi usługami i kanałami komunikacji.
| Kategoria | Dostawcy | Do czego służy |
| -------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------ |
| **VoIP** | Twilio, Ringostat, Binotel | Rozmowy telefoniczne — agent odbiera połączenia przychodzące |
| **Komunikatory** | Telegram, WhatsApp, Instagram, Facebook Messenger | Czat przez aplikacje do przesyłania wiadomości |
| **Google Workspace** | Gmail, Docs, Sheets, Drive, Calendar, Meet | Odczytywanie i interakcja z usługami Google |
| **Reklamy** | Google Ads, Facebook Ads | Przeglądanie wyników kampanii i zarządzanie reklamami |
| **Webhook** | Dowolny endpoint HTTP | Wysyłanie danych o leadach, zdarzeń lub powiadomień do CRM lub innych systemów |
Każda integracja jest konfigurowana na firmę i może być podłączona do jednego lub wielu agentów.
***
## Billing i plany
Revol wykorzystuje **model rozliczania tokenowego**. Każda interakcja z AI zużywa tokeny — tokeny wejściowe (Twoja wiadomość + kontekst) i tokeny wyjściowe (odpowiedź agenta).
### Plany
**0 \$/miesiąc** — wypróbuj Revol z podstawowymi limitami
| Zasób | Limit |
| ------------------ | --------------- |
| Firmy | 1 |
| Agenci AI | 1 |
| Tokeny standardowe | 20 tys. / dzień |
| Tokeny premium | — |
| Głos | — |
| Przestrzeń dyskowa | 100 MB |
| Dokumenty wiedzy | 10 |
| Rozmowy | 100 |
| Retencja śledzenia | 30 dni |
| Integracje | — |
| Branding widgetu | Branding Revol |
**29 \$/miesiąc** — dla rozwijających się firm
| Zasób | Limit |
| ------------------ | ------------------ |
| Firmy | 3 |
| Agenci AI | 5 |
| Tokeny standardowe | 5 mln / miesiąc |
| Tokeny premium | 1 mln / miesiąc |
| Głos (STT) | 60 min |
| Głos (TTS) | 200 tys. znaków |
| Przestrzeń dyskowa | 5 GB |
| Dokumenty wiedzy | 100 |
| Rozmowy | 5 000 |
| Retencja śledzenia | 180 dni |
| Integracje | VoIP, Komunikatory |
| Branding widgetu | Własny branding |
**79 \$/miesiąc** — dla agencji i korporacji
| Zasób | Limit |
| ------------------ | --------------------------------------- |
| Firmy | 10 |
| Agenci AI | Bez limitu |
| Tokeny standardowe | 25 mln / miesiąc |
| Tokeny premium | 2 mln / miesiąc |
| Głos (STT) | 300 min |
| Głos (TTS) | 500 tys. znaków |
| Przestrzeń dyskowa | 50 GB |
| Dokumenty wiedzy | 1 000 |
| Rozmowy | 50 000 |
| Retencja śledzenia | 730 dni (2 lata) |
| Integracje | Wszystkie (w tym Google Workspace, Ads) |
| Branding widgetu | White Label |
### Co liczy się jako token
Każda interakcja z AI ma dwie części:
* **Tokeny wejściowe** — Twoja wiadomość + prompt systemowy + pobrane fragmenty bazy wiedzy + historia rozmowy
* **Tokeny wyjściowe** — odpowiedź agenta
Różne modele zużywają różne typy tokenów:
| Typ tokena | Modele | Plany |
| --------------- | ------------------------------------------------------------- | --------------- |
| **Standardowy** | GPT-4o-mini, Claude 3.5 Haiku, Gemini 2.0 Flash, Llama 3.1 8B | Wszystkie plany |
| **Premium** | GPT-4o, Claude 3.5 Sonnet, Gemini 2.5 Pro, Llama 3.3 70B | Premium+ |
### Pakiety dodatkowe
Potrzebujesz więcej zasobów? Kup pakiety dodatkowe bez zmiany planu:
| Pakiet | Co otrzymujesz | Cena |
| ---------------------- | -------------------------------- | ----- |
| Pakiet tokenów S | 5 mln tokenów standardowych | 4 \$ |
| Pakiet tokenów M | 20 mln tokenów standardowych | 15 \$ |
| Pakiet tokenów L | 50 mln tokenów standardowych | 35 \$ |
| Pakiet tokenów premium | 2 mln tokenów premium | 20 \$ |
| Pakiet głosowy | 60 min STT + 100 tys. znaków TTS | 3 \$ |
| Pakiet przestrzeni | 10 GB przestrzeni dyskowej | 1 \$ |
Pakiety dodatkowe wygasają **3 miesiące** po zakupie. Niewykorzystane tokeny nie przechodzą między okresami rozliczeniowymi.
### Co się dzieje po osiągnięciu limitu
| Zasób | Zachowanie |
| ---------------------------- | ---------------------------------------------------------------------------------- |
| Tokeny standardowe / premium | Agent przestaje odpowiadać do następnego okresu rozliczeniowego lub zakupu pakietu |
| Przestrzeń dyskowa | Nie można przesyłać nowych plików |
| Głos | Funkcje głosowe wyłączone |
| Rozmowy | Nowe rozmowy zablokowane |
Revol wysyła powiadomienia przy **80%** (ostrzeżenie) i **90%** (krytyczne) wykorzystania, abyś mógł zareagować przed osiągnięciem limitu.
***
## Następne kroki
Skonfiguruj firmę i pierwszego agenta w kilka minut
Szczegółowe omówienie konfiguracji i możliwości agentów
Zainstaluj widget czatu na swojej stronie
Integruj Revol programistycznie