Skip to main content
Викликайте retrieve_memory через JSON-RPC tools/call на POST /v1/mcp/memory.
Інструмент лише для читання. Отримує контекст пам’яті компанії — не записує в історію чату і не змінює workspace PAM.

Коли викликати

Передавайте prompt, коли задача може залежати від контексту компанії. Краще retrieval, ніж здогадки, щодо:
  • Людей, команд і відповідальних
  • Проєктів, рішень і пріоритетів
  • Процесів, клієнтів і внутрішньої термінології
  • Документів, зустрічей і історичного контексту

Параметри

string
обов'язково
Текстовий опис контексту, який потрібен агенту.Максимальна довжина: 8 000 символів.
string
Необов’язковий стабільний ID розмови. Можна не передавати — сервер використовує Mcp-Session-Id із MCP handshake (один на акаунт, TTL 30 днів). Коли session ID визначено (явно або через fallback), сервер зберігає останні 5 prompt у Redis (TTL 30 днів) і може додати останні 3 prompt лише на етап triage, якщо triage увімкнено на сервері. Не переносить попередні результати retrieval і не зберігає пам’ять розмови на стороні агента.
Приймаються лише prompt і session_id. Будь-який інший аргумент повертає invalid_arguments.

Поля відповіді

При успіху інструмент повертає HTTP 200 з content (текст для агента) і structuredContent (машиночитані метадані).

content

structuredContent

Ключові поля всередині retrieval: При помилці structuredContent містить:

Приклади

Аргументи інструменту

Повний JSON-RPC запит

Успішна відповідь (скорочено)

Поле content[].text — markdown-звіт, який агент читає напряму. Уривки документів у production можуть бути довгими; тут вони скорочені.
Великі відповіді можуть тривати десятки секунд і займати тисячі токенів. Спочатку використовуйте summary і top-ranked facts; звертайтеся до documents лише коли агенту потрібен source-level detail.

Поведінка session_id

session_id необов’язковий. Більшості клієнтів достатньо передавати лише prompt. Для будь-якого session ID:
Пам’ять розмови на стороні агента залишається відповідальністю вашого MCP-клієнта. Передавайте стабільний session_id на thread лише якщо потрібна окрема Redis-історія prompt, відмінна від стандартного MCP session — наприклад, кілька паралельних чатів під одним акаунтом.

Таймаути

Retrieval має завершитися протягом 120 секунд. Перевищення ліміту повертає retrieval_timeout.

Історія запитів

Кожен врахований виклик зберігає повний prompt і відповідь для перегляду в Request Log у застосунку PAM або через GET /v1/dev/mcp-requests.