Skip to main content
Challenge

Cross-Border e-Commerce Duty & Customs Agent with Google ADK

Global e-commerce platforms like Shein navigate complex cross-border trade tariffs, dynamic customs valuation, and multi-country tax declarations across Asian logistics hubs. Automated compliance agents must rapidly parse multi-item manifests, evaluate applicable trade agreements (such as RCEP), and assign exact HS harmonized tariff codes. In this challenge, you will implement a cross-border customs clearance agent using Google's Agent Development Kit (ADK) with Gemini multimodal reasoning. The agent processes consignment invoices, checks preferential tariff treatment rules, and prepares audit-compliant customs clearance documentation.

Workflow AutomationHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Build a cross-border e-commerce customs valuation agent using Google Agent Development Kit (ADK) and Gemini.

Delivery guide

How work is evaluated

Evaluation

Evaluates HS Code accuracy and calculated tariff duty values.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
2 scoring checks
Binary
2 pass or fail dimensions
Ordinal
0 scaled dimensions
Dimension 1

hs_code_accuracy

Assigned HS Code must match prefix ground truth.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Dimension 2

valuation_accuracy

Calculated total tax/duty accuracy percentage • target: 99 • range: 0-100

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Develop custom tools and agents using Google Agent Development Kit (ADK)

  • Map product descriptions to 6-digit HS Tariff Codes using Gemini multimodal models

  • Evaluate tariff origin rules (Rules of Origin) under RCEP agreements

  • Generate automated duty assessment receipts and import declaration forms

Resources and assets

Reference links and supporting material

Dataset notes

Cross-border e-commerce product dataset with HS Code mappings and Singapore Customs tax rate tables.

Challenge setup

Evaluates HS Code accuracy and calculated tariff duty values.

Challenge input

JSON containing product title, material composition, origin country, and destination

Google ADK

Required Google Agent Development Kit for building agent tools with Gemini.

Evaluated output

JSON containing HS code, standard duty rate, RCEP preferential rate, and final duty amount

Evaluation checks
  • Assigned HS Code must match prefix ground truth.
  • Calculated total tax/duty accuracy percentage • target: 99 • range: 0-100
Configured evaluation evidence
  • Benchmark: LogiBench-Customs
  • Valuation Accuracy target: 99
  • 1 public reference case
Configured runtime
  • Python execution harness
  • Python sandbox (unavailable on Versalist)

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Google ADK · Required
  • Google · Optional
  • Google Gemini · Optional

Evaluation contract

  • hs_code_accuracy · Weight 1
  • valuation_accuracy · Weight 1

Metrics

  • valuation_accuracy · Target 99

Benchmarks

  • LogiBench-Customs
  • general

Reference cases

  • 1 public reference case

Workflow tasks

  1. Task 1

    Input: JSON containing product title, material composition, origin country, and destination

    Output: JSON containing HS code, standard duty rate, RCEP preferential rate, and final duty amount

    Execution harness: Python

Evaluation tools

  • Google ADK · Agent Framework

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Cross-Border e-Commerce Duty & Customs Agent with Google ADK