> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Интерпретация монитора > Предварительный просмотр монитора перед его созданием — превратите запрос на естественном языке (на любом языке) в проверенную **черновую** конфигурацию, которую можно просмотреть, скорректировать и затем отправить в [Create Monitor](/en/api-reference/endpoint/monitors/create). Этот вызов можно выполнять сколько угодно раз — он лишь создаёт черновик и никогда не сохраняет монитор, не отправляет оповещения и не расходует кредиты. Используйте `intent`, чтобы выбрать действие; если он не указан, применяется эвристика по английским ключевым словам, а нераспознанный ввод по умолчанию трактуется как `create_monitor`. ## OpenAPI ````yaml ru-openapi POST /monitors/interpret openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Информация о профиле рабочей области и статистика использования - name: Enrichment description: Обогащение записей о людях и компаниях подробными B2B-данными - name: Lookalike description: Поиск компаний, похожих на заданную компанию - name: Search description: >- Поиск людей, компаний, вакансий, новостей и рекламы с использованием фильтров - name: Lookup description: >- Просмотр подробной информации о конкретных людях, компаниях, вакансиях, новостях, рекламе и технологиях - name: LinkedIn description: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. url: https://docs.pubrio.com paths: /monitors/interpret: post: tags: - Monitor summary: Интерпретация монитора из текста на естественном языке description: >- Предварительный просмотр монитора перед его созданием — превратите запрос на естественном языке (на любом языке) в проверенную **черновую** конфигурацию, которую можно просмотреть, скорректировать и затем отправить в [Create Monitor](/en/api-reference/endpoint/monitors/create). Этот вызов можно выполнять сколько угодно раз — он лишь создаёт черновик и никогда не сохраняет монитор, не отправляет оповещения и не расходует кредиты. Используйте `intent`, чтобы выбрать действие; если он не указан, применяется эвристика по английским ключевым словам, а нераспознанный ввод по умолчанию трактуется как `create_monitor`. operationId: interpretMonitor parameters: [] requestBody: required: true content: application/json: schema: type: object required: - query properties: query: type: string maxLength: 2000 description: >- Запрос на естественном языке (на любом языке), например «отслеживать компании, выходящие на рынок Японии, получать руководителей уровня C с их рабочим email и отправлять оповещения на me@company.com в реальном времени». Ограничение — 2000 символов. intent: type: string enum: - create_monitor - dry_test - execute - analyze description: >- Какое действие выполнить (не зависит от языка). `create_monitor` (по умолчанию): вернуть черновую конфигурацию. `dry_test`: черновик плюс доступное только для чтения количество текущих совпадающих сигналов. `execute`: черновик плюс предварительный просмотр с пометкой для подтверждения (никогда не активируется автоматически). `analyze` (например, «какой рынок, SG или JP?»): на запрос отвечает аналитический агент по экспансии вместо построения монитора. Если не указано, используется эвристика по английским ключевым словам; нераспознанный ввод по умолчанию трактуется как `create_monitor`. deep: type: boolean description: >- Выполнить проход рефлексии для более высокой точности (по умолчанию true; примерно удваивает задержку). Установите false для более быстрой однопроходной интерпретации. example: query: >- monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time responses: '200': description: Интерпретированный черновик. Ничего не сохраняется. content: application/json: schema: type: object properties: data: type: object properties: intent: type: string enum: - create_monitor - dry_test - execute - analyze description: >- Определённое действие (create_monitor / dry_test / execute / analyze). no_intent: type: boolean description: >- true, если запрос не был настройкой монитора (приветствие, посторонняя тема или бессмыслица); в этом случае `config` равен null. config: type: object nullable: true description: >- Черновая конфигурация монитора, структура которой в точности повторяет тело запроса [Create Monitor](/en/api-reference/endpoint/monitors/create) (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute, status "draft" и т. д.). Отправьте её в Create Monitor для активации. Также может содержать `domains`/`linkedin_urls`/`company_names`, которые Create Monitor сопоставляет с компаниями. Null, если `no_intent` равен true. missing_fields: type: array items: type: string description: >- Поля, которые всё ещё требуются для активации монитора (например, «destination», «signal_types», «companies»). Соберите их в вашем интерфейсе перед отправкой в Create Monitor. requires_confirmation: type: boolean description: >- true для намерения `execute` — конфигурация готова, но пользователь должен подтвердить её перед активацией. preview: type: object nullable: true description: >- Присутствует для `dry_test` и `execute`: доступная только для чтения оценка того, сколько сигналов совпадает сейчас, по каждому типу сигнала, за последние 30 дней (на основе выборки). Кредиты не расходуются. interpretation: type: object description: >- Отражение необработанных полей, извлечённых из запроса, для отображения или отладки. example: data: intent: create_monitor no_intent: false config: detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP stages: - exploring - committing company_filters: {} companies: [] is_company_enrichment: false is_people_enrichment: true people_enrichment_configs: - max_people_to_return: 5 filters: management_levels: - c_suite people_contact_types: - email-work name: Expansion signals → JP destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 status: draft missing_fields: [] requires_confirmation: false preview: null interpretation: signal_types: - expansions tos: - JP management_levels: - c_suite people_contact_types: - email-work destination_email: me@company.com is_realtime: true '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Некорректный запрос. Запрос был некорректно сформирован или содержал недопустимые параметры. Подробности см. в коде и сообщении об ошибке. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Превышен лимит запросов. За заданный период времени было сделано слишком много запросов. Повторите попытку после сброса окна лимита запросов. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Внутренняя ошибка сервера. На сервере произошла непредвиденная ошибка. Если ошибка повторяется, обратитесь в службу поддержки. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````