> ## 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)

> Premium relationship layer on CIN — 1-hop graph in assess (off / shadow / live), included with CLM-ADD-NET-C.

**Entity Graph (CEG)** is the **extended / premium capability of CIN** (Clausum Intelligence Network). It is **not** a separate network and is **not** sold as a standalone SKU.

Commercial label: **CEG Coverage** — included when staff enables CIN consume (**CLM-ADD-NET-C**).

<Tip>
  Start with [CIN](/guides/clausum-intelligence-network) (contribute + consume). Turn on CEG after exact/aggregate peer matching is stable.
</Tip>

## CIN vs CEG

| | **CIN (base network)** | **CEG (premium extension)** |
| - | - | - |
| Question answered | “Has a peer listed this identifier?” | “Is this entity **linked** to risky neighbors (1 hop)?” |
| Matching | Exact list + aggregate intelligence | Relationship graph (`network_entities` / edges) |
| Tenant mode | `assess_mode`: `shadow` · `advisory` · `enforcement` | `graph_assess_mode`: `off` · `shadow` · `live` |
| Contract | Contribute opt-in · Consume **CLM-ADD-NET-C** | Same consume entitlement |
| Dashboard row | **Settings → Services → CIN** | **Settings → Services → Entity Graph (CEG)** |

Both run during `POST /api/v1/assess` and `POST /api/v1/assess/payout` when consume is enabled. CEG runs **in parallel** with exact CIN (\~400 ms budget, fail-open).

```mermaid theme={null}
flowchart LR
  A[Assess request] --> C[CIN exact + aggregate]
  A --> G[CEG 1-hop graph]
  C --> D[Combined decision]
  G --> D
```

## Modes (`graph_assess_mode`)

| Mode | Lookup | Production decision |
| - | - | - |
| `off` | No | No graph effect |
| `shadow` (default) | Yes — `network_intelligence.graph` with weight `0` | **Unchanged**; use `shadow_would_decision` to compare |
| `live` | Yes — score can apply | May force **review** or hard-block **decline** (≥2 independent sources for hard-block) |

<Warning>
  `graph_assess_mode` is **independent** of CIN `assess_mode`. You can keep CIN in `advisory` while CEG stays in `shadow`.
</Warning>

## Integrate CEG (checklist)

1. **Prerequisites** — CIN consume enabled by Clausum; you already call assess with rich identifiers (email, device, account, IP as applicable).
2. **Observe in shadow** — **Intelligence → Settings** (or **Settings → Services → CEG**) set mode to **shadow**. Run Simulation / Partner traffic; inspect `network_intelligence.graph` and `shadow_would_decision`.
3. **Go live** — After ops review, set **live**. Monitor Protection / assess decisions; roll back to shadow if needed.

### Configure mode (dashboard session)

Modes are changed with a **logged-in dashboard session** (not a Partner `clm_sk_*` key):

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

Or use **Intelligence → Settings → Entity Graph mode** in the UI.

## Privacy

Never exposed to partners: institution IDs, neighbor PII, reconstructable hashes. Lookup is **1 hop** only. Same trust / `min_trust_score` policies as CIN consume.

## Related

* [Intelligence network (CIN)](/guides/clausum-intelligence-network) — contribute, consume, `assess_mode`
* [Settings — Services](/guides/settings-services) — portfolio integration index
* [Collaborative network guarantees](/guides/collaborative-network-guarantees) — legal / enrollment
* [Real-time assessment](/guides/realtime-assessment) — pay-in assess


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