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

# Crear Matriz de Riesgo

> Crear una nueva matriz de riesgo con activadores — usando el motor de scoring de riesgo gu1 con activadores configurables, con ejemplos para create.

## Descripción General

Crea una nueva matriz de riesgo con configuración de puntuación y activadores opcionales.

## Cuerpo de la Solicitud

<ParamField body="name" type="string" required>
  Nombre de la matriz de riesgo
</ParamField>

<ParamField body="description" type="string">
  Descripción de la matriz de riesgo
</ParamField>

<ParamField body="category" type="string" default="custom">
  Categoría: aml, kyc, fraud, sanctions, transaction\_monitoring, customer\_risk, regulatory, custom
</ParamField>

<ParamField body="status" type="string" default="draft">
  Estado: draft, active, shadow, inactive
</ParamField>

<ParamField body="scoringConfig" type="object">
  Configuración de puntuación con umbrales
</ParamField>

<ParamField body="triggers" type="array">
  Array de configuraciones de activadores
</ParamField>

<ParamField body="tags" type="array">
  Array de etiquetas para organización
</ParamField>

## Configuración de Activadores

Cada activador puede tener:

```json theme={null}
{
  "name": "Activador de Alto Riesgo",
  "description": "Crear investigación cuando el riesgo es alto",
  "condition": {
    "field": "riskScore",
    "operator": "gte",
    "value": 80
  },
  "action": "create_investigation",
  "priority": "HIGH"
}
```

## Ejemplo

```bash theme={null}
curl -X POST http://api.gu1.ai/risk-matrices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Matriz de Monitoreo de Transacciones",
    "description": "Monitorear transacciones de alto riesgo",
    "category": "transaction_monitoring",
    "status": "active",
    "scoringConfig": {
      "minScore": 0,
      "maxScore": 100,
      "thresholds": {
        "low": 30,
        "medium": 60,
        "high": 80
      }
    },
    "triggers": [
      {
        "name": "Activador de Riesgo Crítico",
        "description": "Crear investigación automáticamente para riesgo crítico",
        "condition": {
          "field": "riskScore",
          "operator": "gte",
          "value": 90
        },
        "action": "create_investigation",
        "priority": "CRITICAL"
      },
      {
        "name": "Alerta de Riesgo Medio",
        "description": "Crear alerta para riesgo medio",
        "condition": {
          "field": "riskScore",
          "operator": "between",
          "value": [60, 89]
        },
        "action": "create_alert",
        "priority": "MEDIUM"
      }
    ],
    "tags": ["transaction", "aml"]
  }'
```

## Respuesta

```json theme={null}
{
  "riskMatrix": {
    "id": "rm-new-123",
    "name": "Matriz de Monitoreo de Transacciones",
    "status": "active",
    "triggers": [/* ... */]
  },
  "usingDefaultStrategy": false
}
```

## Acciones de Activadores

* **create\_alert**: Crear una alerta
* **create\_investigation**: Crear una investigación
* **send\_notification**: Enviar notificación al equipo
* **block\_entity**: Bloquear entidad del procesamiento
* **request\_approval**: Solicitar aprobación manual
* **escalate**: Escalar al supervisor

## Ver También

* [Actualizar Matriz de Riesgo](/es/api-reference/risk-matrix/update)
* [Crear Regla](/es/api-reference/rules/create)