# Attribute Mapping Agent

*/Agents/Attribute_Mapping_Agent*

## Solution Overview

The Attribute Mapping Agent ingests raw, unstructured vendor catalogs and supplier line sheets, extracting product specifications and translating them into a retailer's rigid internal taxonomy. It standardizes units of measure, normalizes color and material descriptions—such as mapping a vendor's "Midnight Navy" to the master "Blue" category—and flags missing mandatory fields like voltage or choking hazards. The outcome is a normalized JSON payload ready for immediate upload into a Product Information Management (PIM) system, accompanied by a confidence score for each mapped value.

E-commerce merchandising teams and retail catalog managers hire this agent to eliminate the manual bottleneck of onboarding new seasonal inventory from disparate suppliers. Instead of spending weeks copying and pasting specs from PDF cut sheets into master Excel templates, merchandisers simply CC the agent on vendor onboarding emails. The agent requires a human checkpoint for novel attributes or low-confidence mappings, routing these specific edge cases to a catalog specialist via a Slack approval queue before finalizing the batch.

Operating in the middle of the catalog ingestion stack, the agent consumes unstructured text via headless document parsers and computer vision APIs that strip tables from vendor PDFs. Above it, enterprise PIM platforms like Salsify or Akeneo consume the agent's standardized output via direct API integration, allowing downstream inventory agents and storefront listing services to rely on instantly populated, compliant product data.

## Icp Problems

- [Supplier Catalog Onboarding Delays](/Problems/Supplier_Catalog_Onboarding_Delays) — supply-chain
- [Divergent Data Schema Reconciliation](/Problems/Divergent_Data_Schema_Reconciliation) — ops
- [Regulatory Attribute Data Gaps](/Problems/Regulatory_Attribute_Data_Gaps) — compliance
- [Syndicated Channel Feed Formatting](/Problems/Syndicated_Channel_Feed_Formatting) — demand-gen
- [Marketplace Taxonomy Rule Shifts](/Problems/Marketplace_Taxonomy_Rule_Shifts) — competitive
- [Unannounced Supplier Schema Drift](/Problems/Unannounced_Supplier_Schema_Drift) — ops

## Icp Opportunities

- [Catalog Onboarding Service](/Opportunities/Catalog_Onboarding_Service) — Service-as-Software
- [Schema Reconciliation Engine](/Opportunities/Schema_Reconciliation_Engine) — Headless SaaS
- [Taxonomy Compliance Agent](/Opportunities/Taxonomy_Compliance_Agent) — Agent
- [Pipeline Healing Agent](/Opportunities/Pipeline_Healing_Agent) — Agent
- [Regulatory Data Enrichment](/Opportunities/Regulatory_Data_Enrichment) — Service-as-Software

## Agent Definition

**Goals**:
- [Catalog Onboarding Cycle Time](/Metrics/Catalog_Onboarding_Cycle_Time)
- [First-Pass Match Rate](/Metrics/First-Pass_Match_Rate)
- [Taxonomy Compliance Rate](/Metrics/Taxonomy_Compliance_Rate)
**Tools**:
- [Salsify](/Products/Salsify)
- [Akeneo](/Products/Akeneo)
- [Amazon Textract](/Products/Amazon_Textract)
**Skills**:
- [Information Ordering](/Skills/Information_Ordering)
- [Category Flexibility](/Skills/Category_Flexibility)
- [Reading Comprehension](/Skills/Reading_Comprehension)
- [Data Analysis](/Skills/Data_Analysis)
**Contacts**:
- Email
- Slack
- API
**Identity**: did:web:agents.retail.example/attribute-mapping-agent
**Core Tasks**:
- [Extract Product Specifications](/Tasks/Extract_Product_Specifications)
- [Map Vendor Attributes](/Tasks/Map_Vendor_Attributes)
- [Standardize Units Of Measure](/Tasks/Standardize_Units_Of_Measure)
- [Format PIM Upload Payloads](/Tasks/Format_PIM_Upload_Payloads)
**Escalation**: Any novel attribute or mapping with a low confidence score escalates to a catalog specialist via a Slack approval queue before batch finalization.
**Memory Kind**: persistent
**Memory Note**: Retains previously approved vendor-specific attribute mappings to automatically translate repeat terminology in future ingestions.
**Autonomy Mode**: guarded
**Replaces Role**: [Catalog Data Specialist](/JobTypes/Catalog_Data_Specialist)
**Solves Problem**: [Manual Catalog Onboarding](/Problems/Manual_Catalog_Onboarding)
**Responsibilities**:
- Standardize Vendor Specifications
- Maintain Master Taxonomy Alignment
- Flag Non-Compliant Product Data

## Agent Function Cascade

**Ai Role**: AI extracts vendor data, maps attributes from persistent memory, and standardizes units end-to-end, escalating only novel or low-confidence mappings to a human catalog specialist for explicit approval via Slack before batching the PIM payload.
**Cascade**:
- Kind: Generative · Note: Parses raw vendor files to isolate product attributes. · Step: Extract Vendor Specifications · Verb: extract · Realizes: Extract Product Specifications · Oversight: none
- Kind: Generative · Note: Applies memory of past approvals to align vendor terminology. · Step: Map To Master Taxonomy · Verb: map · Realizes: Map Vendor Attributes · Oversight: none
- Kind: Code · Note: Deterministically converts parsed measurements to master catalog standards. · Step: Standardize Units Of Measure · Verb: standardize · Realizes: Standardize Units Of Measure · Oversight: none
- Kind: Human · Note: Specialist approves novel or low-confidence mappings via Slack queue. · Step: Approve Mapping Exceptions · Verb: approve · Realizes: Review Product Data · Oversight: approves
- Kind: Code · Note: Compiles validated attributes into structured schemas for Salsify or Akeneo. · Step: Generate PIM Payload · Verb: format · Realizes: Format PIM Upload Payloads · Oversight: none
**Optimizes**:
- [Catalog Onboarding Cycle Time](/Metrics/Catalog_Onboarding_Cycle_Time)
- [First-Pass Match Rate](/Metrics/First-Pass_Match_Rate)
- [Taxonomy Compliance Rate](/Metrics/Taxonomy_Compliance_Rate)

## Agent Representative Offer

**Warranty**: Commits to a predefined taxonomy compliance rate for auto-mapped items, issuing service credits for payload batches that fall below the accuracy threshold.
**Price Band**: Roughly $0.02 to $0.15 per SKU mapped and standardized, depending on catalog volume and attribute complexity.
**Pricing Kind**: UsageMeter
**Deliverables**:
- Standardized PIM upload payloads
- Vendor attribute extraction logs
- Unit-of-measure conversion records
- Low-confidence exception queues routed to Slack
**Delivery Mode**: Self-serve API integration instantly provisions the agent into the ingestion pipeline, metering usage automatically per product processed.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- stored-credential

## Agent Composes Headless Saas

- [Document OCR Engine](/Software/Document_OCR_Engine) — Data Extraction
- [Taxonomy Resolution API](/Software/Taxonomy_Resolution_API) — Semantic Matching
- [Unit Conversion API](/Software/Unit_Conversion_API) — Data Normalization
- [PIM Ingestion API](/Software/PIM_Ingestion_API) — Catalog Sync
- [Mapping History Store](/Software/Mapping_History_Store) — State Management

## Agent Sequence Diagram

```mermaid
sequenceDiagram
    participant T as Webhook
    participant A as Attribute Mapping Agent
    participant OCR as Document OCR Engine
    participant MapHist as Mapping History Store
    participant TaxAPI as Taxonomy Resolution API
    participant UCA as Unit Conversion API
    participant H as Human: Catalog Data Specialist
    participant PIM as PIM Ingestion API
    T->>A: Receive vendor product payload
    A->>OCR: Extract product specifications
    OCR-->>A: Return raw attributes
    A->>MapHist: Query past vendor mappings
    MapHist-->>A: Return historical rules
    A->>TaxAPI: Resolve master taxonomy alignment
    TaxAPI-->>A: Return standardized taxonomy
    A->>UCA: Standardize units of measure
    UCA-->>A: Return converted units
    alt Novel attribute or low confidence score
        A->>H: Request mapping approval via Slack
        H-->>A: Provide correction or approval
    end
    A->>MapHist: Update persistent memory with approved mappings
    A->>PIM: Format and push PIM upload payloads
    PIM-->>A: Confirm ingestion
    A-->>T: Return batch completion status
```

## Neighborhood

### Composed into

- [Absinthic](/Startups/Absinthic) — composes · Startups

### What it does

- [Maintain Mapping Specifications Per Source](/Tasks/Maintain_Mapping_Specifications_Per_Source) — performs · Tasks
- [Resolve Ambiguous Field Correspondences](/Tasks/Resolve_Ambiguous_Field_Correspondences) — performs · Tasks
- [Propose Field Level Crosswalks Between Schemas](/Tasks/Propose_Field_Level_Crosswalks_Between_Schemas) — performs · Tasks
- [Apply Unit And Code Normalization Rules](/Tasks/Apply_Unit_And_Code_Normalization_Rules) — performs · Tasks
- [Extract Product Specifications](/Tasks/Extract_Product_Specifications) — performs · Tasks
- [Format PIM Upload Payloads](/Tasks/Format_PIM_Upload_Payloads) — performs · Tasks
- [Map Vendor Attributes](/Tasks/Map_Vendor_Attributes) — performs · Tasks

### Uses tool

- [Schema Matching Tools](/Products/Schema_Matching_Tools) — uses tool · Products
- [Data Catalog Platforms](/Products/Data_Catalog_Platforms) — uses tool · Products
- [Version Mapping Rules](/Action/Version_Mapping_Rules) — uses tool · Action
- [Compare Field Names And Sample Values](/Action/Compare_Field_Names_And_Sample_Values) — uses tool · Action

### Realizes

- [Schema Crosswalk Management](/Services/Schema_Crosswalk_Management) — realizes · Services

### Optimizes

- [Taxonomy Compliance Rate](/Metrics/Taxonomy_Compliance_Rate) — optimizes · Metrics
- [First-Pass Match Rate](/Metrics/First-Pass_Match_Rate) — optimizes · Metrics
- [Catalog Onboarding Cycle Time](/Metrics/Catalog_Onboarding_Cycle_Time) — optimizes · Metrics

### Required skills

- [Reading Comprehension](/Skills/Reading_Comprehension) — requires skill · Skills
- [Data Analysis](/Skills/Data_Analysis) — requires skill · Skills
- [Information Ordering](/Skills/Information_Ordering) — requires skill · Skills
- [Category Flexibility](/Skills/Category_Flexibility) — requires skill · Skills

### What it uses

- [Akeneo](/Products/Akeneo) — uses · Products
- [Amazon Textract](/Products/Amazon_Textract) — uses · Products
- [Salsify](/Products/Salsify) — uses · Products

### Replaces this role

- [Catalog Data Specialist](/JobTypes/Catalog_Data_Specialist) — replaces · JobTypes

### What it addresses

- [Manual Catalog Onboarding](/Problems/Manual_Catalog_Onboarding) — addresses · Problems

### Latent gaps

- [Taxonomy Compliance Agent](/Opportunities/Taxonomy_Compliance_Agent) — latent gap · Opportunities
- [Schema Reconciliation Engine](/Opportunities/Schema_Reconciliation_Engine) — latent gap · Opportunities
- [Catalog Onboarding Service](/Opportunities/Catalog_Onboarding_Service) — latent gap · Opportunities
- [Regulatory Data Enrichment](/Opportunities/Regulatory_Data_Enrichment) — latent gap · Opportunities
- [Pipeline Healing Agent](/Opportunities/Pipeline_Healing_Agent) — latent gap · Opportunities

### Problems this exposes

- [Supplier Catalog Onboarding Delays](/Problems/Supplier_Catalog_Onboarding_Delays) — exposes problem · Problems
- [Syndicated Channel Feed Formatting](/Problems/Syndicated_Channel_Feed_Formatting) — exposes problem · Problems
- [Unannounced Supplier Schema Drift](/Problems/Unannounced_Supplier_Schema_Drift) — exposes problem · Problems
- [Regulatory Attribute Data Gaps](/Problems/Regulatory_Attribute_Data_Gaps) — exposes problem · Problems
- [Marketplace Taxonomy Rule Shifts](/Problems/Marketplace_Taxonomy_Rule_Shifts) — exposes problem · Problems
- [Divergent Data Schema Reconciliation](/Problems/Divergent_Data_Schema_Reconciliation) — exposes problem · Problems

### Composed of

- [Unit Conversion API](/Software/Unit_Conversion_API) — composes · Software
- [Taxonomy Resolution API](/Software/Taxonomy_Resolution_API) — composes · Software
- [PIM Ingestion API](/Software/PIM_Ingestion_API) — composes · Software
- [Mapping History Store](/Software/Mapping_History_Store) — composes · Software
- [Document OCR Engine](/Software/Document_OCR_Engine) — composes · Software

### Similar Startups

- [Abloom](/Startups/Abloom) — similar · Startups
- [Catalogfoundry](/Startups/Catalogfoundry) — similar · Startups
- [Zenonata](/Startups/Zenonata) — similar · Startups
- [Catalogfield](/Startups/Catalogfield) — similar · Startups
- [Springaster](/Startups/Springaster) — similar · Startups
- [Savannarow](/Startups/Savannarow) — similar · Startups
- [Tareck](/Startups/Tareck) — similar · Startups
- [Catalogdock](/Startups/Catalogdock) — similar · Startups
- [Kerfion](/Startups/Kerfion) — similar · Startups
- [Elitetag](/Startups/Elitetag) — similar · Startups
- [Vifig](/Startups/Vifig) — similar · Startups
- [Categorypoint](/Startups/Categorypoint) — similar · Startups
- [Genericloft](/Startups/Genericloft) — similar · Startups
- [Agorastring](/Startups/Agorastring) — similar · Startups
- [Blossortage](/Startups/Blossortage) — similar · Startups

### Similar Agents

- [Agnostic Mapping Agent](/Agents/Agnostic_Mapping_Agent) — similar · Agents
- [Feed Ingestion Agent](/Agents/Feed_Ingestion_Agent) — similar · Agents
- [Contract Mapping Agent](/Agents/Contract_Mapping_Agent) — similar · Agents
- [Billing Normalization Worker](/Agents/Billing_Normalization_Worker) — similar · Agents

### Similar Metrics

- [Catalog Update Cycle Time](/Metrics/Catalog_Update_Cycle_Time) — similar · Metrics