ai-customer-journey-map

ai-customer-journey-map User Journey Map Assistant

Overview

The User Journey Map Assistant is used to answer "where are users stuck," content production, copy optimization, and publishing preparation. It is suitable for content creators, marketing, operations, and content media to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as business materials or problem statements, pasted business background, problem statements, reference materials, goals, constraints, or content to be organized. It organizes key context and outputs conversion issue diagnoses, copy and structure suggestions, and experiment checklists, making it easy to continue execution, review, or delivery.

When to Use

Applicable Scenarios

Users raise questions such as "where are users stuck," and need to quickly break down goals, determine priorities, and form actionable results
Content creators, marketing, operations, and content media need to generate conversion issue diagnoses, copy and structure suggestions, and experiment checklists around the User Journey Map Assistant
Users have already prepared the processing goal (explain the problem to be solved this time, judgment target, output format, or delivery purpose.), target audience (explain the audience, role, team, or business scenario the output should serve.), reference links (fill in publicly accessible pages, materials, reference cases, or background links.), and hope to organize them into actionable analysis or optimization results
Users need to turn User Journey Map Assistant-related materials into clear conclusions, priorities, and next steps

How to Invoke

Call the AI Skills API directly through the exported Python runner:

Command Examples

Basic Call

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

Call with Common Parameters

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

Parameter Description

Parameter	Type	Required	Default	Description
`goal`	string	No	-	Explain the problem to be solved this time, judgment target, output format, or delivery purpose
`audience`	string	No	-	Explain the audience, role, team, or business scenario the output should serve
`materialUrl`	string	No	-	Fill in publicly accessible pages, materials, reference cases, or background links; a complete accessible URL must be provided
`materialFile`	string	No	-	Upload business documents, data tables, reference materials, screenshots, or explanatory files
`materialText`	string	No	-	Paste business background, problem statements, reference materials, goals, constraints, or content to be organized
`brandRequirements`	string	No	-	Supplement format requirements, unchangeable facts, constraints, risk points, or manual review priorities

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 lookup tables.

Supported Input Formats

This skill directly accepts JSON parameters; if a parameter contains a link field, please provide a complete, accessible URL.

Example Request

The example parameters below 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

Conversion problem diagnosis, copy and structure recommendations, experiment checklist: organize the core results around user goals that can be directly read, reviewed, or delivered.
Interpretation of input materials: combine the processing goal (explain the problem this is intended to solve, the judgment objective, the output format, or the delivery purpose.), intended users (explain the audience, roles, team, or business scenario the output should serve.), reference links (provide publicly accessible pages, materials, reference cases, or background links.) to extract key context and the basis for judgment.
Next steps: provide priorities, execution recommendations, or a content framework that can be further processed.

Recommendations for using the results

First determine whether the output answers the user's core questions about the "User Journey Map Assistant".
Then check whether the results cover the conversion problem diagnosis, copy and structure recommendations, and experiment checklist, and whether clear next steps are provided.
If there is little input material, it is recommended to have the user supplement the goal, 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