> ## Documentation Index
> Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 评价 Run

> 用完一个已结束 Run 的结果后，评价它完成自身那一份的程度。评价只有 Glasser 可见。

评价这一个 Run 应贡献的那一份，而不是整个任务。每个 Run 保留第一条评价：重复提交返回 `200` 和 `already_reviewed`，不保存。评价不会改变该 Run、其结果或费用。


## OpenAPI

````yaml /openapi.zh.json post /v1/runs/{runId}/review
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: 一个 API Key，无需合同，按次付费，即可调用批量采购的付费 API。每个响应包含 x-request-id；所有错误正文采用统一结构。
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/runs/{runId}/review:
    post:
      tags:
        - Runs
      summary: 评价 Run
      description: >-
        用完一个已结束 Run 的结果后，评价它完成自身那一份的程度，可附不超过 200 个字符的理由。评价只有 Glasser 可见，不会改变该
        Run、其结果或费用。


        - **201：**评价已记录。

        - **200：**该 Run 已有评价。保留第一条；本次提交不保存。

        - **409：**该 Run 尚未结束。
      operationId: runs-review
      parameters:
        - name: runId
          in: path
          schema:
            type: string
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
            format: uuid
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rating:
                  type: string
                  enum:
                    - exceeds_expectations
                    - meets_expectations
                    - partially_meets_expectations
                    - does_not_meet_expectations
                    - unable_to_assess
                  description: >-
                    评价这一个 Run 应贡献的那一份，而不是整个任务。例子：该 Run 被要求返回 20
                    家符合条件且有已验证邮箱的公司。exceeds_expectations：完成了自己的部分，还给出更多有用信息（20
                    家都符合条件且都有已验证邮箱，另外给出可直接用于外联的近期采购信号）。meets_expectations：完成了自己的部分（20
                    家都符合条件且都有已验证邮箱）。partially_meets_expectations：有明确的不足（20
                    家都符合条件，只有 5
                    家有已验证邮箱）。does_not_meet_expectations：结果无法用于它负责的部分（返回的公司都不在目标行业）。unable_to_assess：证据不足，无法判断（返回了邮箱，但没有验证状态，也无法从其他信息判断）。如果邮箱应由另一个
                    Run 验证，那么找到 20 家符合条件公司的 Run 即为 meets_expectations。
                reason:
                  anyOf:
                    - type: string
                      maxLength: 200
                      description: 可选。说明评级理由，不超过 200 个字符：缺了什么、哪里有误或哪里特别有用。不要包含隐私数据。
                    - type: 'null'
              required:
                - rating
              additionalProperties: false
        required: true
      responses:
        '200':
          description: 该 Run 已有评价；保留第一条
          content:
            application/json:
              schema:
                type: object
                properties:
                  review_id:
                    type: string
                  run_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - recorded
                      - already_reviewed
                    description: >-
                      recorded：本次提交已保存。already_reviewed：该 Run
                      已有评价；保留第一条，本次提交未保存。
                  created_at:
                    type: string
                    description: 被保留的那条评价的提交时间。
                    format: date-time
                required:
                  - review_id
                  - run_id
                  - status
                  - created_at
                additionalProperties: false
        '201':
          description: 新记录的评价
          content:
            application/json:
              schema:
                type: object
                properties:
                  review_id:
                    type: string
                  run_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - recorded
                      - already_reviewed
                    description: >-
                      recorded：本次提交已保存。already_reviewed：该 Run
                      已有评价；保留第一条，本次提交未保存。
                  created_at:
                    type: string
                    description: 被保留的那条评价的提交时间。
                    format: date-time
                required:
                  - review_id
                  - run_id
                  - status
                  - created_at
                additionalProperties: false
        '400':
          description: ValidationFailed
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenEncoded'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundEncoded'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
      security:
        - bearer: []
components:
  schemas:
    ValidationFailedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    UnauthorizedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - unauthorized
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ForbiddenEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    NotFoundEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - not_found
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ConflictEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - conflict
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    RateLimitedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - rate_limited
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.