> ## 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.

# 모니터 해석

> 모니터를 만들기 전에 미리 볼 수 있습니다. 자연어 요청(어떤 언어든)을 검증된 **초안** 구성으로 변환하여 검토·조정한 뒤 [모니터 생성](/ko/api-reference/endpoint/monitors/create)에 제출할 수 있습니다. 얼마든지 안전하게 호출할 수 있습니다. 초안만 생성할 뿐 모니터를 저장하거나 알림을 보내거나 크레딧을 소모하지 않습니다. `intent`로 동작을 지정하며, 생략하면 영어 키워드 추론이 적용되고 인식되지 않으면 `create_monitor`가 기본값입니다.



## OpenAPI

````yaml ko-openapi POST /monitors/interpret
openapi: 3.0.0
info:
  description: >-
    Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물
    데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/ko/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/ko/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: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회
  - name: Redeem
    description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치)
  - name: Channels
    description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록)
  - name: Monitor
    description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리
  - name: Filters
    description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등)
  - name: API Keys
    description: API 키의 요청 로그 및 사용량 분석 조회
  - name: Insights
    description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고).
  - name: Export
    description: 대량 데이터 내보내기(크레딧 차감).
  - name: Expansion
    description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.'
externalDocs:
  description: >-
    Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B
    연락처 및 영업 인텔리전스 데이터를 제공합니다.
  url: https://docs.pubrio.com
paths:
  /monitors/interpret:
    post:
      tags:
        - Monitor
      summary: 자연어로 모니터 해석
      description: >-
        모니터를 만들기 전에 미리 볼 수 있습니다. 자연어 요청(어떤 언어든)을 검증된 **초안** 구성으로 변환하여 검토·조정한 뒤
        [모니터 생성](/ko/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-레벨 인물의 업무용 이메일을 받아
                    me@company.com으로 실시간 알림 전송". 최대 2000자.
                intent:
                  type: string
                  enum:
                    - create_monitor
                    - dry_test
                    - execute
                    - analyze
                  description: >-
                    수행할 동작(언어 무관). `create_monitor`(기본): 초안 구성 반환. `dry_test`:
                    초안과 현재 일치하는 시그널 수의 읽기 전용 카운트. `execute`: 초안과 미리보기를 반환하고 확인
                    대기로 표시(자동 활성화 안 함). `analyze`(예: "싱가포르 vs 일본?"): 모니터를 만들지 않고
                    확장 분석 에이전트가 답변. 생략 시 영어 키워드 추론 사용, 인식 불가 시 `create_monitor`가
                    기본값.
                deep:
                  type: boolean
                  description: >-
                    정확도를 높이는 리플렉션 패스 실행(기본 true, 지연 약 2배). 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: >-
                          초안 모니터 구성으로 [모니터
                          생성](/ko/api-reference/endpoint/monitors/create) 요청 본문과
                          동일한 형태입니다(detection_mode, signal_types,
                          signal_filters, people_enrichment_configs,
                          destination_type/destination_config, frequency_minute,
                          status "draft" 등). 모니터 생성에 제출하면 활성화됩니다.
                          `domains`/`linkedin_urls`/`company_names`를 포함할 수 있으며
                          모니터 생성이 이를 회사로 해석합니다. `no_intent`가 true이면 null입니다.
                      missing_fields:
                        type: array
                        items:
                          type: string
                        description: >-
                          모니터를 활성화하기 전에 아직 필요한 필드(예: "destination",
                          "signal_types", "companies"). 모니터 생성에 제출하기 전에 UI에서
                          수집하세요.
                      requires_confirmation:
                        type: boolean
                        description: >-
                          `execute` 인텐트일 때 true — 구성은 준비되었지만 활성화 전에 사용자 확인이
                          필요합니다.
                      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
                          stage_slug_list:
                            - 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
components:
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은
        [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다.
      in: header

````