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

# Obtener la analítica de Cascade

> Consulta métricas de uso específicas de Cascade, incluidas las líneas sugeridas/aceptadas, el uso del modelo, el consumo de créditos y las estadísticas de uso de herramientas.

<div id="overview">
  ## Descripción general
</div>

Recupera datos de analítica específicos de Cascade, incluidas las líneas sugeridas/aceptadas, el uso del modelo, el consumo de créditos y las estadísticas de uso de herramientas.

<div id="request">
  ## Solicitud
</div>

<ParamField body="service_key" type="string" required>
  Tu clave de servicio con permisos "Teams Read-only"
</ParamField>

<ParamField body="group_name" type="string">
  Filtra los resultados para mostrar solo los usuarios de un grupo específico. No se puede usar con el parámetro `emails`.
</ParamField>

<ParamField body="start_timestamp" type="string">
  Hora de inicio en formato RFC 3339 (p. ej., `2023-01-01T00:00:00Z`)
</ParamField>

<ParamField body="end_timestamp" type="string">
  Hora de finalización en formato RFC 3339 (p. ej., `2023-12-31T23:59:59Z`)
</ParamField>

<ParamField body="emails" type="array">
  Lista de direcciones de correo electrónico para filtrar los resultados. No se puede usar con el parámetro `group_name`.
</ParamField>

<ParamField body="ide_types" type="array">
  Filtra por tipo de IDE. Opciones disponibles:

  * `"editor"` - Editor de escritorio de Devin
  * `"jetbrains"` - Complemento de JetBrains
  * `"cli"` - Devin CLI

  Si se omite, devuelve datos de todos los IDE.

  <Note>Al filtrar por Devin CLI (`"cli"`), solo `cascade_runs` devuelve datos. Las fuentes de datos `cascade_lines` y `cascade_tool_usage` no son compatibles con Devin CLI y devolverán resultados vacíos.</Note>
</ParamField>

<ParamField body="query_requests" type="array" required>
  Lista de consultas de fuentes de datos que se ejecutarán. Cada objeto debe contener una de las fuentes de datos compatibles.
</ParamField>

<div id="data-sources">
  ## Fuentes de datos
</div>

<div id="cascade_lines">
  ### cascade\_lines
</div>

Consulta las líneas de Cascade sugeridas y aceptadas por día.

```json theme={null}
{
  "cascade_lines": {}
}
```

**Campos de la respuesta:**

* `day` - Fecha en formato RFC 3339
* `linesSuggested` - Número de líneas sugeridas
* `linesAccepted` - Número de líneas aceptadas

<div id="cascade_runs">
  ### cascade\_runs
</div>

Consulta datos sobre el uso del modelo, el consumo de créditos y el modo.

```json theme={null}
{
  "cascade_runs": {}
}
```

**Campos de respuesta:**

* `day` - Fecha en formato RFC 3339
* `model` - Nombre del modelo utilizado
* `mode` - Modo de Cascade (consulta los modos a continuación)
* `messagesSent` - Número de mensajes enviados
* `cascadeId` - ID único de la conversación
* `promptsUsed` - Créditos consumidos (en centavos)

**Modos de Cascade:**

* `CONVERSATIONAL_PLANNER_MODE_DEFAULT` - Modo de escritura
* `CONVERSATIONAL_PLANNER_MODE_READ_ONLY` - Modo de solo lectura
* `CONVERSATIONAL_PLANNER_MODE_NO_TOOL` - Modo heredado
* `UNKNOWN` - Modo desconocido

<div id="cascade_tool_usage">
  ### cascade\_tool\_usage
</div>

Consulta estadísticas de uso de herramientas (recuentos agregados).

```json theme={null}
{
  "cascade_tool_usage": {}
}
```

**Campos de la respuesta:**

* `tool` - Identificador de la herramienta (consulta los mapeos de herramientas a continuación)
* `count` - Número de veces que se usó la herramienta

<div id="tool-usage-mappings">
  ## Asignaciones de uso de herramientas
</div>

| Identificador de herramienta | Nombre visible               |
| ---------------------------- | ---------------------------- |
| `CODE_ACTION`                | Edición de código            |
| `VIEW_FILE`                  | Ver archivo                  |
| `RUN_COMMAND`                | Ejecutar comando             |
| `FIND`                       | Herramienta de búsqueda      |
| `GREP_SEARCH`                | Búsqueda con Grep            |
| `VIEW_FILE_OUTLINE`          | Ver esquema del archivo      |
| `MQUERY`                     | Riptide                      |
| `WORKFLOWS_USED`             | Flujos de trabajo utilizados |
| `LIST_DIRECTORY`             | Listar directorio            |
| `MCP_TOOL`                   | Herramienta MCP              |
| `PROPOSE_CODE`               | Proponer código              |
| `SEARCH_WEB`                 | Buscar en la web             |
| `MEMORY`                     | Memoria                      |
| `PROXY_WEB_SERVER`           | Vista previa en el navegador |
| `DEPLOY_WEB_APP`             | Desplegar aplicación web     |

<div id="example-request">
  ## Solicitud de ejemplo
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2025-01-01T00:00:00Z",
  "end_timestamp": "2025-01-02T00:00:00Z",
  "emails": ["user1@cognition.ai", "user2@cognition.ai"],
  "ide_types": ["editor"],
  "query_requests": [
    {
      "cascade_lines": {}
    },
    {
      "cascade_runs": {}
    },
    {
      "cascade_tool_usage": {}
    }
  ]
}' \
https://server.codeium.com/api/v1/CascadeAnalytics
```

<div id="response">
  ## Respuesta
</div>

<ResponseField name="queryResults" type="array">
  Array de resultados de consultas, uno por cada solicitud de consulta

  <Expandable title="Resultado de líneas de Cascade">
    <ResponseField name="cascadeLines" type="object">
      <ResponseField name="cascadeLines" type="array">
        Array de estadísticas diarias de líneas

        <ResponseField name="day" type="string">
          Fecha en formato RFC 3339
        </ResponseField>

        <ResponseField name="linesSuggested" type="string">
          Número de líneas sugeridas ese día
        </ResponseField>

        <ResponseField name="linesAccepted" type="string">
          Número de líneas aceptadas ese día
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Resultado de ejecuciones de Cascade">
    <ResponseField name="cascadeRuns" type="object">
      <ResponseField name="cascadeRuns" type="array">
        Array de estadísticas de uso del modelo

        <ResponseField name="day" type="string">
          Fecha en formato RFC 3339
        </ResponseField>

        <ResponseField name="model" type="string">
          Nombre del modelo usado para la ejecución
        </ResponseField>

        <ResponseField name="mode" type="string">
          Identificador del modo de Cascade
        </ResponseField>

        <ResponseField name="messagesSent" type="string">
          Número de mensajes enviados
        </ResponseField>

        <ResponseField name="cascadeId" type="string">
          Identificador único de la conversación
        </ResponseField>

        <ResponseField name="promptsUsed" type="string">
          Créditos consumidos en centavos (p. ej., "100" = 1 crédito)
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Resultado de uso de herramientas de Cascade">
    <ResponseField name="cascadeToolUsage" type="object">
      <ResponseField name="cascadeToolUsage" type="array">
        Array de estadísticas de uso de herramientas

        <ResponseField name="tool" type="string">
          Identificador de la herramienta
        </ResponseField>

        <ResponseField name="count" type="string">
          Número de veces que se usó la herramienta
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Ejemplo de respuesta
</div>

```json theme={null}
{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "2025-05-01T00:00:00Z",
            "linesSuggested": "206",
            "linesAccepted": "157"
          },
          {
            "day": "2025-05-02T00:00:00Z",
            "linesSuggested": "16"
          }
        ]
      }
    },
    {
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "2025-05-01T00:00:00Z",
            "model": "Claude 3.7 Sonnet (Thinking)",
            "mode": "CONVERSATIONAL_PLANNER_MODE_DEFAULT",
            "messagesSent": "1",
            "cascadeId": "0d35c1f7-0a85-41d0-ac96-a04cd2d64444"
          }
        ]
      }
    },
    {
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "CODE_ACTION",
            "count": "15"
          },
          {
            "tool": "LIST_DIRECTORY",
            "count": "20"
          }
        ]
      }
    }
  ]
}
```

<div id="notes">
  ## Notas
</div>

* La API devuelve datos en bruto que pueden contener valores "UNKNOWN"
* Para el análisis de métricas, agrupa por los campos específicos de interés (p. ej., suma `promptsUsed` para los patrones de uso)
* Los datos de modo y de prompt pueden estar divididos en múltiples entradas
* El consumo de créditos (`promptsUsed`) se devuelve en centavos (100 = 1 crédito)