Rank a catalog

​

On the device

let ranking = try await pool.context.rank([
    RankCandidate(id: "sku-1", text: "Leather tote, Polène", imageData: toteJPEG),
    RankCandidate(id: "sku-2", text: "Nike Air Max 90 White"),
], using: grant)

for item in ranking.items {
    print(item.id, item.score, item.reasons)
}

• A candidate is your id plus whatever you have: text, imageData (PNG, JPEG or HEIC), or an embedding you computed yourself. Up to 500 candidates per call.
• Only your ids, scores and reasons come back. No photo, no capture id and no library content.
• It needs the query operation, like any other read.

​

On your server

let grant = try await pool.authorization.requestAccess(
    AccessRequest(
        data: [.products],
        operations: [.query, .exportTaste],
        purpose: "Share a summary of the style of what you save, not your photos, to build your feed"
    )
)

let taste = try await pool.context.tasteVectors(using: grant)
upload(taste.modelSignature, taste.centres.map { ($0.vector, $0.weight) })

• centres holds six vectors by default, each with a weight. The weights sum to 1. Pass clusters: for 1 to 12.
• They are centres of groups of captures, never a vector for one capture, and nothing in them points back to a photo.
• modelSignature names the model the vectors come from. Embed your catalog with the same model, and check the signature before you mix vectors from two calls.
• With fewer than 20 saved captures there are no centres, and basedOnCaptures says how many there were.
• Captures that Pool marks as sensitive never take part.

​

What ranking never says