Available Context

@_platform-references/org-variables.md

AI Ark Data Enrichment

Goal

Batch refresh existing ops table records with current data from AI Ark's enrichment API.

Required Capabilities

• AI Ark API: Bulk enrichment via ai-ark-enrich edge function

Inputs

• table_id: The ops table to enrich (required)
• column_id: Specific column to target (optional)

Credit Cost

Each contact enrichment (reverse lookup) consumes credits individually. Bulk enrichment processes contacts 4 at a time with rate limiting. Warn users about total credit cost before batch operations — estimate as number_of_rows x credits_per_lookup.

Execution

1. Warn the user: "This will enrich N contacts. Each lookup costs credits. Proceed?"
2. Call ai-ark-enrich with action: 'bulk_enrich' and table_id
3. Function reads all rows, identifies records by email/LinkedIn
4. Calls AI Ark reverse lookup API individually (4 concurrent, 250ms between batches)
5. Caches full responses in source_data.ai_ark (enrich-once pattern)
6. Updates cells with refreshed data

Output Contract

Return summary:

• total_rows: Number of rows processed
• enriched: Number successfully enriched
• failed: Number that failed
• unchanged: Number already up to date (from cache)

Data Hygiene Workflow

After enrichment, the copilot can:

1. Highlight rows where title or company changed (job change detected)
2. Suggest re-qualification for contacts who changed companies