Разделы документации

Начало

Контекст

Объясните агенту цели, ограничения и правила работы с данными без передачи секретов.

На этой странице

Контекст — это текстовые инструкции и пояснения, которые пользователь сохраняет в Atlas MCP, чтобы агент правильно интерпретировал данные. Контекст не заменяет данные источника и не хранит секреты.

Что такое контекст

  • Главные цели и KPI проекта.
  • Кампании, воронки, регионы или продукты, которые важнее остальных.
  • Правила качества лидов, сделок, звонков и заявок.
  • Ограничения: что агенту нельзя предлагать или менять без согласования.
  • Соглашения по атрибуции, часовому поясу, периодам и исключениям.

Контекст аккаунта

Контекст аккаунта привязан к конкретному аккаунту источника: Direct-логину, счётчику Метрики, порталу Bitrix24, аккаунту amoCRM, проекту Calltouch, проекту Roistat или подключению ClickHouse. В UI поле называется «Контекст аккаунта» и принимает до 8000 символов или файл .txt/.md.

Основная цель — заявки на консультацию.
Ключевые кампании: бренд, поиск, ретаргетинг.
Не учитывать тестовые кампании и кампании с пометкой draft.
CPA выше 2500 руб. считать проблемным.

Контекст проекта

Контекст проекта привязан не к одному источнику, а к проекту. Проект может объединять Direct, Metrica, Bitrix24, amoCRM, Calltouch, Roistat и ClickHouse. В UI можно ввести до 50000 символов markdown или загрузить .txt/.md.

Агент видит компактный список проектов в session.context, а полный markdown проекта или контекст аккаунта читает через project_context.

Проект: интернет-магазин мебели.

Главная бизнес-цель — продажи кухонь и шкафов на заказ.
Основной KPI — стоимость квалифицированной заявки.
Важнее качество заявок, чем их количество.
Регионы: Москва и Московская область.
Не предлагать отключать брендовые кампании без отдельного согласования.

Какой контекст куда писать

Что описатьКуда писать
Общие бизнес-цели клиента и KPIКонтекст проекта
Ограничения по офферам, регионам, продуктамКонтекст проекта
Особенности конкретного Direct-аккаунтаКонтекст аккаунта Direct
Главные цели и исключения счётчика МетрикиКонтекст аккаунта Metrica
CRM-воронки, стадии и поля квалификацииКонтекст аккаунта CRM
Модель атрибуции Calltouch или RoistatКонтекст аккаунта
Токены, пароли, API key, webhook URLНикуда не писать в контекст

Что нельзя писать в контекст

  • Пароли, OAuth-токены, API key и webhook URL с секретами.
  • Приватные ключи и одноразовые коды входа.
  • Персональные данные клиентов без необходимости.
  • Данные банковских карт и платёжные реквизиты.
  • Любые секреты, которые должны храниться только в защищённых полях интеграции.

Если секрет случайно попал в чат агента или в контекст, перевыпустите токен или webhook и удалите старое значение.