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

# モニターの解析

> モニターを作成する前にプレビューできます。自然言語のリクエスト（任意の言語）を検証済みの**下書き**設定に変換し、内容を確認・調整してから [モニター作成](/jp/api-reference/endpoint/monitors/create) に送信できます。何度でも安全に呼び出せます。下書きを作成するだけで、モニターの保存・アラート送信・クレジット消費は一切行いません。`intent` で操作を指定します。省略した場合は英語キーワードによる推定が使われ、判別できない場合は `create_monitor` になります。



## OpenAPI

````yaml jp-openapi POST /monitors/interpret
openapi: 3.0.0
info:
  description: >-
    Pubrio API
    はマーケット拡大インテリジェンスを提供します——企業の新市場参入を捉えるリアルタイムシグナルと、その基盤となる企業・人物データ。アカウントやコンタクトの検索・ルックアップ・エンリッチメントに加え、200+
    市場にわたる種別・日付付きの動きシグナルを購読できます。
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/ja/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/ja/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: >-
        モニターを作成する前にプレビューできます。自然言語のリクエスト（任意の言語）を検証済みの**下書き**設定に変換し、内容を確認・調整してから
        [モニター作成](/jp/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。レイテンシは約 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: >-
                          下書きのモニター設定。[モニター作成](/jp/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

````