Skip to content
HumanTaskAPI

Capability · product_testing

Get a Human to Test a Product

Send products or instructions to verified humans for structured physical testing and feedback.

Evidence returnedExample

Product Testing · field capture

captured_at · location_confirmed

Structured checklist

required fields · exceptions

Task result object

capability: "product_testing"

A product testing request should answer one question: what exactly must happen at the location, and what proof will show that it happened? HumanTask API turns that question into a dispatchable task whose purpose is to have a human perform a bounded physical test or usability protocol and return structured observations.

When to Use Product Testing

The best product testing jobs are concrete enough that two independent workers would understand the same objective. Examples include follow setup steps and report friction points; test a defined feature under stated conditions; compare two physical variants using the same rubric; or record whether an expected behavior occurs. These are not broad consulting assignments. They are observable field actions that can be accepted, completed and checked.

Define a Product Testing Request

A requester should provide test protocol, device or product location, and allowed actions. It should also state questions and rating scales, media requirements, and stop conditions. The instruction should separate facts the worker can observe from decisions the AI or business will make later. That distinction prevents a simple field task from quietly turning into specialist advice.

Required inputs

  • Test protocol
  • Device or product location
  • Allowed actions
  • Questions and rating scales
  • Media requirements
  • Stop conditions

Evidence That Makes the Result Useful

For product testing, a useful completion package may contain test-step results, structured ratings, photos or video, timing notes, and failure or ambiguity flags. The evidence schema should be selected before dispatch. A task that merely says “send proof” is weaker than one that specifies which files, fields and observations are mandatory. The receiving agent can then test completeness without interpreting a chat message.

Suggested result fields

  • Test-step results
  • Structured ratings
  • Photos or video
  • Timing notes
  • Failure or ambiguity flags

Failure Modes to Plan For

Real locations create exceptions that software APIs rarely face. In this capability, common examples are: the product malfunctions outside the test scope, the protocol would damage the item, a result needs specialist certification, and environmental conditions invalidate the test. Those outcomes should be returned as explicit exception states rather than hidden inside a free-text note. An AI agent can then retry with new instructions, choose another location, widen the deadline or escalate to a specialist.

Exception examples

  • The product malfunctions outside the test scope
  • The protocol would damage the item
  • A result needs specialist certification
  • Environmental conditions invalidate the test

Example Workflow for an AI Agent

Consider this workflow: An AI product manager can request the same assembly test from several humans and compare where users encounter problems. The agent first decides that a physical check is necessary, then creates a product_testing task with the address, deadline and evidence fields. The worker accepts the job, completes only the permitted actions and submits the requested proof. After the result arrives, the software can validate required fields, store the media references and continue its original plan.

Who Uses Product Testing

Product Testing can support product teams, AI labs, quality operations, ecommerce and user-research teams. These users have different business goals, but they share the same bottleneck: the missing fact or action exists offline. A reusable task definition lets them solve that bottleneck without maintaining a field team in every city.

API Shape for Product Testing

The machine-facing representation should be narrow. A product_testing request can carry a normalized location, human-readable instructions, a deadline, budget, required evidence and a client reference. The response should return a task identifier and lifecycle state. Follow-up operations should expose status and evidence without forcing the caller to scrape a dashboard. MCP can present the same operation as an agent tool; REST and OpenAPI can serve conventional application integrations.

Example task object

json · Example
{
  "capability": "product_testing",
  "location": {"address": "TARGET_ADDRESS"},
  "deadline": "ISO_8601",
  "instructions": "TASK-SPECIFIC_INSTRUCTIONS",
  "evidence_required": ["TASK_SPECIFIC_FIELDS"]
}

Launch a Product Testing Task

Start with one product testing request that has an unambiguous outcome. Define the location, deadline and proof first; then create the task through the web flow or the available developer interface. If the workflow repeats, promote the same evidence schema into a reusable integration.

What makes product testing different from a generic gig

The value is not simply that a person is available. The value is that the request is standardized enough for software to understand the expected result. For product testing, the schema should reflect the actual decision being supported: the agent needs evidence about have a human perform a bounded physical test or usability protocol and return structured observations. That makes the task easier to price, route, compare and audit than an open-ended message to a freelancer.

json · Example result shape
{
  "task_id": "tsk_example",
  "capability": "on_site_photos",
  "status": "evidence_submitted",
  "evidence": [
    { "type": "photo", "captured_at": "…", "location_confirmed": true }
  ],
  "exceptions": []
}

Frequently asked questions

What should a product testing request contain?

Include test protocol, device or product location, allowed actions, and questions and rating scales. Add the remaining task-specific fields when they affect access, proof or timing.

What does HumanTask API return for product testing?

A result can contain test-step results, structured ratings, photos or video, and timing notes, plus explicit notes when the task cannot be completed as planned.

What can prevent a product testing task from completing?

Typical blockers include the product malfunctions outside the test scope, the protocol would damage the item, and a result needs specialist certification. The worker should report the blocker rather than invent a successful result.

Can an AI agent create product testing programmatically?

Yes. The intended machine-facing capability is `product_testing`, using the same task object whether the caller comes through REST, OpenAPI or MCP.

When is product testing a poor fit?

It is a poor fit when the request is unsafe, requires unverified professional expertise, depends on private access that has not been arranged, or cannot be evaluated with observable evidence.

Next step

Put a human on it.

Describe the place, the action and the proof you need. The API and MCP integration are in developer preview.