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

# 解析监控

> 在正式创建之前预览监控——将自然语言请求（可用任意语言）转换为经过校验的**草稿**监控配置，供你查看、调整后再提交到 [创建监控](/cn/api-reference/endpoint/monitors/create)。可以随意多次调用：它只生成草稿，绝不会保存监控、发送提醒或消耗额度。通过 `intent` 指定操作；若省略，将使用英文关键词启发式判断，无法识别时默认为 `create_monitor`。



## OpenAPI

````yaml cn-openapi POST /monitors/interpret
openapi: 3.0.0
info:
  description: >-
    Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖
    200+ 市场、带类型与日期的动向信号。
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/zh-CN/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/zh-CN/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: 创建和管理数据监控，包括 Webhook、统计和处理
  - 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: >-
        在正式创建之前预览监控——将自然语言请求（可用任意语言）转换为经过校验的**草稿**监控配置，供你查看、调整后再提交到
        [创建监控](/cn/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`（例如“新加坡还是日本？”）：由扩张分析代理回答，而非创建监控。若省略，将使用英文关键词启发式；无法识别时默认为
                    `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: >-
                          草稿监控配置，其结构与
                          [创建监控](/cn/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"）。请在界面中收集后再提交到创建监控。
                      requires_confirmation:
                        type: boolean
                        description: 当 intent 为 `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

````