Pamięć badań o firmach dla agentów AI

Agenci połączeni z serwerem MCP Kit mogą zapisywać wyniki badań o firmach i odczytywać je przy kolejnych zadaniach. Dzięki temu nie muszą za każdym razem szukać tych samych informacji od początku.

Co przechowuje pamięć

Dla każdej domeny firmy Kit przechowuje jeden zestaw notatek w obrębie konta. [email protected], https://www.acme.dev/careers i acme.dev wskazują tę samą domenę acme.dev.

Każda notatka zawiera:

• treść markdown zaszyfrowaną w spoczynku;
• co najmniej jeden źródłowy adres URL;
• observed_at, czyli datę, kiedy informacja była prawdziwa;
• opcjonalny krótki tytuł, również zaszyfrowany, np. Funding albo Hiring signals;
• autorstwo: członka zespołu oraz klienta OAuth, jeśli notatka przyszła przez MCP.

Kit wysyła do modelu Google gemini-embedding-001 pierwsze 6 KB tekstu złożonego z tytułu i treści każdej notatki. Zwrócony wektor służy do wykrywania podobnych notatek i porządkowania wyników odczytu. Dzieje się tak na każdym koncie, niezależnie od skonfigurowanego dostawcy AI.

Pamięć obejmuje całe konto, a nie pojedynczą kampanię. Jeśli kontaktujesz się z tą samą firmą w trzech kampaniach, ma ona jedno dossier, nie trzy. Notatka zapisana podczas kampanii rekrutacyjnej będzie dostępna, gdy sześć tygodni później kampania sprzedażowa trafi na tę samą domenę.

Notatki z observed_at starszym niż 30 dni dostają flagę stale. Odpowiedź narzędzia odczytu zawiera również flagę stale całego dossier. Ma wartość true, gdy najnowsza notatka ma ponad 30 dni albo nie ma żadnej notatki. Nie oznacza to wyrzucenia dossier, lecz konieczność ponownego sprawdzenia informacji przed użyciem w szkicu.

Cykl pracy

Cztery narzędzia. Pełne parametry i formaty odpowiedzi opisuje Dokumentacja narzędzi MCP.

1. outreach_recall_prospect_context: pierwsze wywołanie każdego przebiegu, jeszcze przed wyszukiwaniem w sieci. Zwraca zapisane notatki i dotychczasową relację konta z firmą: kampanie zawierające potencjalnego klienta, liczbę wysłanych wiadomości, ostatnią odpowiedź wraz z nastawieniem oraz informację o wykluczeniu adresu lub domeny.
2. outreach_save_prospect_research: jedno wywołanie na każde osobne ustalenie, nie jedno na przebieg. Wymagany jest co najmniej jeden źródłowy adres URL; bez niego narzędzie odrzuci notatkę.
3. Odczytaj data.overlap w odpowiedzi zapisu. Wynik wskazuje podobne notatki i wspólne źródła dla tej domeny.
4. outreach_compact_prospect_context: scala notatki w jedno dossier. Używaj tylko na wyraźne polecenie.

outreach_get_writing_guide zwraca przewodnik Kit, który pomaga usuwać z tekstu ślady AI dla języków en, de, fr, es i pl. Agent powinien przeczytać go przed pisaniem szkicu, nie po fakcie.

Przerwij pracę nad firmą, jeśli relationship.suppressed ma wartość true lub relationship.last_reply.sentiment ma wartość negative albo bounce. Nie dodawaj wtedy leada i nie twórz szkicu.

Prompt zadania cyklicznego

Wklej poniższy tekst do cyklicznego zadania Claude Cowork i zastąp <CAMPAIGN NAME> nazwą kampanii. Prompt trafia do kontekstu przy każdym przebiegu, dlatego działa lepiej niż liczenie na pamięć agenta.

Run today's outreach research pass for the <CAMPAIGN NAME> campaign.

For every company on the list, in this order:

1. Call outreach_recall_prospect_context with the company domain FIRST, before any
   web search. Read data.known, data.stale, and data.relationship.
2. If data.relationship.suppressed is true, or data.relationship.last_reply.sentiment
   is "negative" or "bounce": skip the company entirely. Do not add a prospect, do not
   draft. Add it to a "skipped" list in your summary with the reason.
3. If data.known is true and data.stale is false, do NOT re-research. Use the stored
   notes.
4. Otherwise research the company, then call outreach_save_prospect_research once per
   distinct finding, each with at least one source URL and the observed_at date the
   fact was true.
5. Read data.overlap on every save response. Report any near_duplicates you created
   and any shared_sources that show you re-read a page already cited.
6. Before drafting anything, call outreach_get_writing_guide for the campaign's
   language and follow it.
7. Do NOT call outreach_compact_prospect_context. If data.compaction_suggested is true
   for a company, list that company under "compaction suggested" in your summary and
   stop there.

Finish with a summary containing four lists: researched, reused-from-memory, skipped
(with reasons), and compaction suggested.

Najważniejsza liczba w tym podsumowaniu to reused-from-memory. Jeśli agent zbadał wszystko od nowa, sprawdź, czy wcześniej odczytał pamięć i czy zapisane informacje były aktualne.

Co agent wie o nakładaniu się treści

Każda odpowiedź zapisu zawiera trzy grupy. Notatki są porównywane na podstawie odległości cosinusowej między embeddingami.

Grupa	Warunek	Co powinien zrobić agent
near_duplicates	odległość ≤ 0,10: notatka prawie powtarza istniejącą. W odpowiedzi wraca pełna treść starszej notatki.	Porównaj obie. Jeśli nowa niczego nie wnosi, usuń ją i zachowaj starszą. Jeśli aktualizuje informację, oznacz ją do kompaktowania.
overlaps	0,10 < odległość ≤ 0,30: podobny temat, możliwe inne szczegóły. W odpowiedzi wraca fragment o długości 300 znaków.	Zachowaj obie. Zanotuj je do następnego kompaktowania.
shared_sources	Jedna z zapisanych notatek zawiera ten sam źródłowy adres URL.	Sprawdź, czy agent ponownie czytał stronę i czy zawierała nowe informacje.

Trzy puste grupy oznaczają, że nie wykryto podobieństwa ani wspólnych źródeł. Nie dowodzą, że treść jest nowa: porównanie semantyczne pomija notatki bez embeddingów.

Osobno data.compaction_suggested przyjmuje wartość true, gdy domena ma ponad 8 notatek. Pole pojawia się zarówno przy odczycie, jak i zapisie. To informacja, nie polecenie: agent ma ją zgłosić i pozostawić decyzję o scaleniu tobie.

Odczyt zwraca również overlap_pairs, czyli pary zapisanych notatek, których odległość cosinusowa nie przekracza 0,30. Wynik jest liczony dla 20 najnowszych notatek. Na tej liście należy oprzeć żądanie kompaktowania.

Kompaktowanie

outreach_compact_prospect_context zapisuje jedno scalone dossier i zastępuje nim wskazane notatki. Zachowana notatka dziedziczy sumę wszystkich źródłowych adresów URL oraz najwcześniejszą wartość observed_at swoich źródeł.

Zastąpione notatki są archiwizowane, nie usuwane. Każda zachowuje wskaźnik do notatki, która ją zastąpiła, więc nieudane scalenie można odwrócić.

Narzędzie przyjmuje expected_note_count, czyli note_count z odpowiedzi narzędzia odczytu, na której oparto scalenie. Jeśli w międzyczasie ktoś zapisze nową notatkę, liczba przestaje się zgadzać i scalenie zostaje przerwane, żeby nie zastąpić nowej treści.

Limity

Limit	Wartość
Treść notatki	10 KB. Większa zostanie odrzucona.
Tytuł notatki	Sprowadzany do jednego wiersza i skracany do 120 znaków.
Źródłowe adresy URL	Co najmniej jeden, najwyżej 20. Każdy musi być adresem http lub https krótszym niż 2 KB.
observed_at	Wymagane przez narzędzie zapisu i nigdy nieuzupełniane automatycznie. Ustaw datę, kiedy informacja była prawdziwa, bo na jej podstawie Kit ocenia aktualność notatki.
Notatki zapisywane dziennie	200 na konto. Po przekroczeniu limitu narzędzie zwraca błąd do następnego dnia.
Notatki na domenę	50. Kolejne zapisy są odrzucane; kompaktowanie nadal działa i pozwala zejść poniżej limitu.
Oznaczenie jako nieaktualna	Po 30 dniach
Sugerowane kompaktowanie	Powyżej 8 notatek dla jednej domeny
Dane odpowiedzi przy odczycie	100 KB. Po przekroczeniu notatki są porządkowane semantycznie zamiast zwracane w całości, a truncated ma wartość true.

Odczyt pamięci wymaga zakresu outreach_read. Zapisywanie i kompaktowanie wymagają outreach_write oraz uprawnień administratora modułu Outreach. Wszystkie operacje wymagają dodatku Outreach i aktywnej subskrypcji.

Gdzie notatki widać w Kit

Strona potencjalnego klienta pokazuje trzy najnowsze notatki dla firmy według daty obserwacji oraz link Pokaż wszystkie do pełnej listy.

Listę można przeglądać i usuwać z niej wpisy. Usunięta notatka znika z dossier i wszystkich przyszłych wyników odczytu. W przeglądarce nie da się zapisać ani edytować notatki; jedyną ścieżką zapisu są narzędzia.

Czym ta pamięć nie jest

• Nie jest systemem CRM. Przechowuje badania o firmie, nie kontakty, transakcje ani pipeline.
• Nie jest ogólną pamięcią agenta. Kluczem jest domena firmy, a dostęp prowadzi wyłącznie przez cztery narzędzia Outreach. Nie przechowuje dowolnych notatek, stanu zadania ani historii rozmów.
• Nie jest współdzielona między kontami. Każde zapytanie jest ograniczone do połączonego konta. Notatki nie przekraczają granic klientów, a dane nie są łączone ani agregowane między klientami.
• Nie służy do wysyłania. Żadna operacja z tej strony nie wysyła e-maila. Ostatnie słowo nadal należy do człowieka w zwykłym procesie oceny wiadomości.

Co dalej

• Badania AI i baza wiedzy: jak własny agent Kit bada firmy i tworzy szkice
• Dokumentacja narzędzi MCP: parametry i zwracane dane wszystkich czterech narzędzi pamięci
• Zdalne serwery MCP w kampaniach: udostępnianie agentowi Kit narzędzi z zewnętrznych serwerów