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

# Entity Graph (CEG)

> Capa premium de relaciones sobre CIN — grafo 1-hop en assess (off / shadow / live), incluido con CLM-ADD-NET-C.

**Entity Graph (CEG)** es la **capacidad extendida / premium de CIN** (Clausum Intelligence Network). **No** es una red aparte y **no** se vende como SKU standalone.

Etiqueta comercial: **CEG Coverage** — incluida cuando staff habilita el consumo CIN (**CLM-ADD-NET-C**).

<Tip>
  Empieza por [CIN](/es/guides/clausum-intelligence-network) (contribuir + consumir). Activa CEG cuando el matching exacto/agregado esté estable.
</Tip>

## CIN vs CEG

| | **CIN (red base)** | **CEG (extensión premium)** |
| - | - | - |
| Pregunta que responde | «¿Un peer listó este identificador?» | «¿Esta entidad está **enlazada** a vecinos de riesgo (1 hop)?» |
| Matching | Lista exacta + inteligencia agregada | Grafo de relaciones (`network_entities` / edges) |
| Modo del tenant | `assess_mode`: `shadow` · `advisory` · `enforcement` | `graph_assess_mode`: `off` · `shadow` · `live` |
| Contrato | Contribuir opt-in · Consumir **CLM-ADD-NET-C** | Mismo entitlement de consumo |
| Fila en el panel | **Configuración → Servicios → CIN** | **Configuración → Servicios → Entity Graph (CEG)** |

Ambos corren en `POST /api/v1/assess` y `POST /api/v1/assess/payout` con consumo activo. CEG corre **en paralelo** con CIN exacto (presupuesto \~400 ms, fail-open).

```mermaid theme={null}
flowchart LR
  A[Request assess] --> C[CIN exacto + agregado]
  A --> G[CEG grafo 1-hop]
  C --> D[Decisión combinada]
  G --> D
```

## Modos (`graph_assess_mode`)

| Modo | Lookup | Decisión productiva |
| - | - | - |
| `off` | No | Sin efecto de grafo |
| `shadow` (default) | Sí — `network_intelligence.graph` con weight `0` | **Sin cambio**; usa `shadow_would_decision` para comparar |
| `live` | Sí — puede aplicar score | Puede forzar **review** o hard-block **decline** (≥2 fuentes independientes para hard-block) |

<Warning>
  `graph_assess_mode` es **independiente** de `assess_mode` de CIN. Puedes dejar CIN en `advisory` y CEG en `shadow`.
</Warning>

## Integrar CEG (checklist)

1. **Prerrequisitos** — Consumo CIN habilitado por Clausum; ya llamas assess con identificadores ricos (email, dispositivo, cuenta, IP según aplique).
2. **Observar en shadow** — En **Inteligencia → Configuración** (o **Configuración → Servicios → CEG**) pon el modo en **shadow**. Corre Simulación / tráfico Partner; inspecciona `network_intelligence.graph` y `shadow_would_decision`.
3. **Pasar a live** — Tras revisión de ops, pon **live**. Monitorea Protección / decisiones assess; vuelve a shadow si hace falta.

### Configurar modo (sesión del panel)

Los modos se cambian con **sesión del dashboard** (no con clave Partner `clm_sk_*`):

```bash theme={null}
curl -X PATCH "https://dashboard.clausum.ai/api/v1/network/membership" \
  -H "Cookie: <sesión del panel>" \
  -H "Content-Type: application/json" \
  -d '{ "graph_assess_mode": "shadow" }'
```

O usa **Inteligencia → Configuración → Modo Entity Graph** en la UI.

## Privacidad

Nunca se expone al partner: IDs de institución, PII de vecinos, hashes reconstruibles. Lookup solo **1 hop**. Mismas políticas de trust / `min_trust_score` que el consumo CIN.

## Relacionado

* [Red de inteligencia (CIN)](/es/guides/clausum-intelligence-network) — contribuir, consumir, `assess_mode`
* [Configuración — Servicios](/es/guides/settings-services) — índice de integración del portafolio
* [Garantías de la red colaborativa](/es/guides/collaborative-network-guarantees) — legal / enrolamiento
* [Assessment en tiempo real](/es/guides/realtime-assessment) — assess pay-in


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