> ## Documentation Index > Fetch the complete documentation index at: https://docs.niadra.com/llms.txt > Use this file to discover all available pages before exploring further. # Aproveitamento do contexto > Uso, repetição, contradição e transferência sem leitura, agrupados por fonte, fornecedor, canal ou view. ## OpenAPI ````yaml openapi/pt/cell.json GET /v1/context-use openapi: 3.1.0 info: title: API de dados da Niadra version: '1' description: >- Escrita, contexto, histórico, objetos, identidade, privacidade e governança de um espaço. Cada espaço tem um endereço estável, com o espaço e a região no nome. servers: - url: https://{space}.{region}.api.niadra.com variables: space: default: acme-prod description: O espaço, que vem na chave de fonte. region: default: us-east-1 description: A região do espaço, que também vem na chave. security: [] paths: /v1/context-use: get: tags: - governance summary: Aproveitamento do contexto description: >- Mede se cada agente usou o contexto que recebeu: entregas com ao menos um item usado, perguntas repetidas, contradições, transferências que o destino não leu, entregas atrasadas e sessões sem contexto. Agrupe com `group_by` por `day`, `source_id`, `vendor`, `channel`, `view` ou `experiment_group` (padrão `source_id`). As taxas vêm com intervalo de confiança, e uma taxa sem nada a medir é `null`, nunca zero. Pessoas com o papel vendor só veem as próprias fontes. **Autenticação.** Token de pessoa do Console com o papel `analysis`, `vendor` (ou admin), ou chave de fonte com o escopo `admin`. operationId: context_use_v1_context_use_get parameters: - in: query name: since required: false schema: anyOf: - format: date type: string - type: 'null' title: Since - in: query name: until required: false schema: anyOf: - format: date type: string - type: 'null' title: Until - in: query name: group_by required: false schema: anyOf: - items: type: string type: array - type: 'null' title: Group By description: >- Repita o parâmetro para agrupar por mais de uma entre `day`, `source_id`, `vendor`, `channel`, `view` e `experiment_group`. example: - vendor - in: query name: source_id required: false schema: anyOf: - format: uuid type: string - type: 'null' title: Source Id - in: query name: channel required: false schema: anyOf: - type: string - type: 'null' title: Channel - in: query name: view required: false schema: anyOf: - type: string - type: 'null' title: View - in: query name: experiment_group required: false schema: anyOf: - type: string - type: 'null' title: Experiment Group description: >- Só um grupo de um experimento, como o grupo de controle, para comparar com o grupo que recebe a memória. responses: '200': content: application/json: schema: $ref: '#/components/schemas/ContextUseReport' example: since: '2026-09-15' until: '2026-09-22' group_by: - vendor buckets: - vendor: voice-platform sessions: 4120 deliveries: 4302 deliveries_used: 3054 questions: 9810 repeated: 588 contradicted: 12 transfers: 410 transfers_unread: 31 late_deliveries: 18 no_context: 133 not_measured: 57 selection_misses: 9 recontacts: 96 usage_rate: value: 0.71 low: 0.69 high: 0.72 'n': 4302 repetition_rate: value: 0.06 low: 0.055 high: 0.065 'n': 9810 transfer_unread_rate: value: 0.076 low: 0.052 high: 0.106 'n': 410 recontact_rate: value: 0.023 low: 0.019 high: 0.028 'n': 4120 description: Um grupo para cada combinação das dimensões de `group_by`. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- 422 `invalid_input`, `verification_not_allowed` ou `about_without_link`. security: - sourceKey: [] - personToken: [] components: schemas: ContextUseReport: additionalProperties: false properties: buckets: items: $ref: '#/components/schemas/ContextUseBucket' title: Buckets type: array group_by: items: type: string title: Group By type: array since: format: date title: Since type: string until: format: date title: Until type: string required: - since - until - group_by - buckets title: ContextUseReport type: object Problem: additionalProperties: false description: >- Detalhes do problema no formato da RFC 9457; `code` vem do catálogo de erros versionado. properties: code: title: Code type: string detail: anyOf: - type: string - type: 'null' default: null title: Detail request_id: anyOf: - type: string - type: 'null' default: null title: Request Id status: title: Status type: integer title: title: Title type: string type: default: about:blank title: Type type: string required: - title - status - code title: Problem type: object ContextUseBucket: additionalProperties: false properties: channel: anyOf: - type: string - type: 'null' title: Channel contradicted: title: Contradicted type: integer day: anyOf: - format: date type: string - type: 'null' title: Day deliveries: title: Deliveries type: integer deliveries_used: title: Deliveries Used type: integer experiment_group: anyOf: - type: string - type: 'null' title: Experiment Group late_deliveries: description: Contexto entregue depois do primeiro turno do agente. title: Late Deliveries type: integer no_context: description: >- Sessões sem nenhuma leitura de `context()`: cobertura, nunca uma taxa zero. title: No Context type: integer not_measured: title: Not Measured type: integer questions: title: Questions type: integer recontact_rate: anyOf: - $ref: '#/components/schemas/RateOut' - type: 'null' recontacts: title: Recontacts type: integer repeated: title: Repeated type: integer repetition_rate: anyOf: - $ref: '#/components/schemas/RateOut' - type: 'null' selection_misses: description: >- Contradições de itens que o contexto não levava; nunca atribuídas ao agente. title: Selection Misses type: integer sessions: title: Sessions type: integer source_id: anyOf: - format: uuid type: string - type: 'null' title: Source Id transfer_unread_rate: anyOf: - $ref: '#/components/schemas/RateOut' - type: 'null' transfers: title: Transfers type: integer transfers_unread: title: Transfers Unread type: integer usage_rate: anyOf: - $ref: '#/components/schemas/RateOut' - type: 'null' vendor: anyOf: - type: string - type: 'null' description: >- Vem da configuração da fonte; `""` quando a fonte não tem fornecedor. title: Vendor view: anyOf: - type: string - type: 'null' description: >- Vazio nos contadores por sessão (cobertura, transferências, recontatos). title: View required: - sessions - no_context - deliveries - not_measured - late_deliveries - deliveries_used - questions - repeated - contradicted - selection_misses - transfers - transfers_unread - recontacts title: ContextUseBucket type: object RateOut: additionalProperties: false properties: high: title: High type: number low: description: Limite inferior do intervalo de Wilson de 95%. title: Low type: number 'n': description: 'O denominador: amostras pequenas dão intervalos largos.' title: 'N' type: integer value: title: Value type: number required: - value - low - high - 'n' title: RateOut type: object securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... personToken: type: http scheme: bearer bearerFormat: JWT ````