ai-customer-research

ai-customer-research User Research Assistant

Quick Start

More Skills

Overview

The user research assistant is used to answer "what do users really want," conduct research analysis, source verification, and evidence summarization, and is suitable for marketing, operations, software, and education and training to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as research questions or material excerpts, pasted issues to verify, candidate sources, web page excerpts, literature leads, or comparative viewpoints, organizes key context, and outputs user insights, demand segmentation, and content/sales pitch suggestions for continued execution, review, or delivery. Capability positioning supplement: user research materials can be turned into reviewable insights and action checklists.

When to Use

Applicable Scenarios

• The user raises questions such as "what do users really want" and needs to quickly break down goals, determine priorities, and form actionable results
• Marketing, operations, software, and education and training need to generate user insights, demand segmentation, and content/sales pitch suggestions around the user research assistant
• The user has already prepared research goals (explain the questions to be answered, comparison dimensions, judgment criteria, or delivery purpose for this task), research audience (explain the readers, roles, markets, courses, or usage scenarios the research conclusions should serve), and public web links (fill in publicly accessible web pages, reports, or material links; for restricted content, upload files or paste excerpts instead), and hopes to organize them into actionable analysis or optimization results
• The user needs to turn materials related to the user research assistant into clear conclusions, priorities, and next steps

How to Invoke

Directly call the AI Skills API through the exported Python runner:

Command Example

Basic Invocation

python3 scripts/run.py --params '{}'

Invocation with Common Parameters

python3 scripts/run.py --params '{"goal":"研究目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	Explain the questions to be answered, comparison dimensions, judgment criteria, or delivery purpose for this task
audience	string	No	-	Explain the readers, roles, markets, courses, or usage scenarios the research conclusions should serve
materialUrl	string	No	-	Fill in publicly accessible web pages, reports, or material links; for restricted content, upload files or paste excerpts instead; an accessible complete URL must be provided
materialFile	string	No	-	Upload research materials, web page excerpts, literature notes, tables, or reports; suitable when the materials are long or the original text needs to be preserved
materialText	string	No	-	Paste the issues to verify, candidate sources, web page excerpts, literature leads, or comparative viewpoints
brandRequirements	string	No	-	Supplement source scope, time range, credibility requirements, unusable sources, conclusion risks, or key points for manual review

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

This skill currently has no categorical parameters that require additional table lookup.

Supported Input Formats

The current skill directly receives JSON parameters; if the parameters contain a link field, please pass a complete, accessible URL.

Example request

The following example parameters can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"goal":"研究目标"}'

Equivalent --params JSON：

{
  "goal": "研究目标"
}

Example return result

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

• User insights, requirement layering, content/sales pitch suggestions: organize core results that can be directly read, reviewed, or delivered around user goals.
• Interpretation of input materials: extract key context and judgment basis based on the research goal (explain the question to be answered this time, comparison dimensions, judgment criteria, or delivery purpose.), research audience (explain the readers, roles, markets, courses, or usage scenarios that the research conclusions should serve.), and public web links (fill in publicly accessible webpages, reports, or material links; for restricted content, please upload files or paste excerpts instead.).
• Next steps: provide priorities, execution suggestions, or a content framework that can continue to be processed.

Suggestions for using the results

• First determine whether the output answers the user's core questions about the "User Research Assistant".
• Then check whether the results cover user insights, requirement layering, content/sales pitch suggestions, and whether clear next steps are given.
• If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.

Preparation before running

• AISKILLS_BASE_URL: default https://ai-skills.ai
• AISKILLS_API_KEY: required, used for authenticated calls
• AISKILLS_TENANT_ID: default default