36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
---
|
||
name: run-waterfall-enrichment
|
||
description: Executes provider waterfalls with credit governance, failover rules, and delivery targets.
|
||
usage: /data-signal-enrichment:run-waterfall-enrichment --type contact --input "Taylor Reed, Nimbus" --sequence apollo,hunter,rocketreach --max-credits 5
|
||
---
|
||
|
||
# Command: run-waterfall-enrichment
|
||
|
||
## Inputs
|
||
- **type** – contact | company | technographic | intent.
|
||
- **input** – record payload (name/company/email/domain/file).
|
||
- **sequence** – optional ordered provider list; default uses ops config.
|
||
- **max-credits** – ceiling for total credits to consume.
|
||
- **delivery** – crm | csv | warehouse specifying output target.
|
||
|
||
## Workflow
|
||
1. **Request Validation** – confirm fields, dedupe against recent runs, and enforce rate limits.
|
||
2. **Sequence Selection** – pull provider order from configs, adjust for overrides or outages.
|
||
3. **Execution Loop** – call providers, capture response metadata, apply validation logic.
|
||
4. **Aggregation & Scoring** – merge best data, attach confidence + provenance tags.
|
||
5. **Delivery & Logging** – push to destination, log credits, update success dashboards, trigger alerts if thresholds exceeded.
|
||
|
||
## Outputs
|
||
- Enrichment payload (JSON/CSV/CRM payload) with fields, provider, timestamp, confidence.
|
||
- Credit + latency report appended to provider utilization table.
|
||
- Alert entries when max-credits hit or providers fail.
|
||
|
||
## Agent/Skill Invocations
|
||
- `provider-ops-lead` – supplies sequence + credit policy.
|
||
- `signal-integrator` – handles normalization + delivery.
|
||
- `data-quality-steward` – validates results before release.
|
||
- `waterfall-blueprint` skill – enforces sequencing template.
|
||
- `provider-scorecard` skill – logs performance + cost metrics.
|
||
|
||
---
|