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

# Asystent osobisty

> Agent, który dzwoni do Ciebie o wyznaczonej godzinie z odprawą: nowe maile, kalendarz na dziś i sprawy w toku - i pamięta to, co mu powiesz.

## Po co to jest

Wszystkie pozostałe szablony obsługują Twoich klientów. Ten obsługuje
**Ciebie**. Agent dzwoni raz dziennie o godzinie, którą wybierzesz, i
przechodzi przez trzy rzeczy:

1. **nowe wiadomości** - kto napisał i w jakiej sprawie (nadawcy i tematy,
   nie treść),
2. **kalendarz na dziś** - po kolei, z godzinami,
3. **sprawy w toku** - to, o czym prosiłeś pamiętać w poprzednich rozmowach.

Na koniec pyta, czy coś zanotować. To, co powiesz, zapisuje się w bazie i
wraca w kolejnych rozmowach - stąd "prawa ręka", a nie czytnik wiadomości.

<Note>
  **To działa na planach płatnych (Start i wyżej).** Odprawa to **jedno połączenie wychodzące
  dziennie na jeden numer** - Twój - a nie kampania. Kampanie (dzwonienie po
  liście kontaktów) zaczynają się od planu Business i tutaj nie są używane.
</Note>

## Czego potrzebujesz

| Element | Wymagane | Uwagi |
| - | - | - |
| Plan Start (lub wyższy) | tak | Plan Free nie ma telefonii w ogóle |
| Numer telefonu przypisany do agenta | tak | Strona **Telefonia** w menu bocznym - z tego numeru agent dzwoni |
| Twój numer telefonu | tak | Na ten numer agent dzwoni z odprawą |
| Dostęp IMAP do skrzynki | nie | Bez tego odprawa pomija sekcję poczty |
| Prywatny adres iCal kalendarza | nie | Bez tego odprawa pomija sekcję kalendarza |

## Konfiguracja

### 1. Utwórz agenta

**Utwórz agenta → Asystent osobisty**. W formularzu podajesz swoje imię (tak
agent będzie się do Ciebie zwracał), czym się zajmujesz i co jest teraz
najważniejsze. To ostatnie pole ma znaczenie: agent używa go, żeby
wyróżnić w odprawie to, na czym Ci zależy.

### 2. Włącz odprawę

W sekcji **Co agent potrafi** włącz **"Dzwoń do mnie codziennie z odprawą"**
i ustaw:

* **Twój numer telefonu** w formacie międzynarodowym (`+48...`),
* **godzinę** w Twoim czasie lokalnym (`07:30`),
* **strefę czasową** (`Europe/Warsaw`),
* **dni** - dni robocze albo codziennie.

Te same ustawienia zmienisz później w edytorze agenta, w zakładce
**Integracje** → **Codzienna odprawa**. Przeniesienie odprawy o pół godziny
nie wymaga tworzenia agenta od nowa.

### 3. Podłącz skrzynkę (opcjonalnie)

Odprawa czyta pocztę przez **IMAP**, nie przez OAuth - działa więc z Gmailem,
Microsoft 365, home.pl, OVH i każdym innym serwerem, za który już płacisz.

Dla Gmaila: włącz weryfikację dwuetapową, wygeneruj **hasło aplikacji** i
wpisz `imap.gmail.com`, port `993`, swój adres i to hasło. Agent czyta
**tylko nagłówki** wiadomości nieprzeczytanych z ostatnich 24 godzin -
nadawcę, temat i datę. Treści maili nie pobiera.

### 4. Podłącz kalendarz (opcjonalnie)

Kalendarz czytany jest z **prywatnego adresu iCal**, czyli linku tylko do
odczytu, który wystawia sam kalendarz:

* **Google Calendar**: Ustawienia kalendarza → *Tajny adres w formacie iCal*,
* **Outlook / Microsoft 365**: Ustawienia → Udostępnianie → publikuj kalendarz
  → link ICS,
* **Apple iCloud**: udostępnij kalendarz publicznie i skopiuj link.

Wydarzenia całodniowe i cykliczne (`RRULE`) są rozwijane poprawnie, odwołane

* pomijane.

### 5. Przypisz numer

Agent musi mieć własny numer, przypisany na stronie **Telefonia** w menu
bocznym - z niego wychodzi połączenie. Bez tego odprawa jest pomijana, a powód
trafia do logów.

## Pamięć

Przy włączonej opcji **"Pamiętaj to, co Ci powiem"** agent ma w trakcie
rozmowy trzy narzędzia:

| Narzędzie | Kiedy używa |
| - | - |
| `remember_this` | Mówisz coś wartego zapamiętania albo prosisz o przypomnienie |
| `recall_memory` | Pytasz, co wie na dany temat, albo odwołujesz się do wcześniejszej rozmowy |
| `complete_task` | Mówisz, że sprawa jest załatwiona |

Zapisy są trzech rodzajów: **fakt** (trwały), **zadanie** (do zrobienia) i
**przypomnienie** (zadanie z datą). Otwarte zadania wracają w każdej
odprawie, dopóki nie powiesz, że są zrobione. Pamięć jest przypisana do
agenta, nie do numeru dzwoniącego - to asystent jednej osoby.

## Jak to działa pod spodem

Co minutę przelatuje zadanie w tle, które sprawdza, którzy agenci mają
odprawę na teraz - w **ich** strefie czasowej. Dla każdego takiego agenta:

1. rezerwuje dzień w Redisie (żeby dwa procesy nie zadzwoniły dwa razy),
2. sprawdza plan, saldo i czy agent ma numer,
3. **pobiera pocztę, kalendarz i otwarte sprawy**, zanim wybierze numer,
4. dzwoni, przekazując zebrane dane jako kontekst rozmowy.

Punkt 3 jest przed telefonem celowo: odbierasz w trzy sekundy, a odpytywanie
IMAP-a w tym czasie to cisza w słuchawce.

<Warning>
  Odprawa spóźniona o więcej niż **15 minut** jest pomijana, a nie dzwoniona.
  Jeśli worker był przez godzinę zajęty, telefon o 8:45 z odprawą na 7:30
  jest gorszy niż jego brak - kalendarz, który agent by przeczytał, jest już
  nieaktualny.
</Warning>

Jeśli któreś źródło zawiedzie - skrzynka odrzuci hasło, kalendarz nie
odpowie - agent mówi o tym jednym zdaniem i idzie dalej. Odprawa bez poczty
wciąż jest warta telefonu.

## Prywatność

* Hasło do skrzynki i adres kalendarza są zapisane w konfiguracji agenta i
  **nie trafiają do promptu** ani do transkrypcji.
* Do odprawy pobierane są wyłącznie nagłówki wiadomości - nadawca, temat,
  data.
* Zapamiętane notatki są przypisane do agenta i widoczne dla osób z dostępem
  do niego w Twojej organizacji.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.