ai-customer-review-aggregator

ai-customer-review-aggregator Customer Review Insight Assistant

Overview

The Customer Review Insight Assistant is used to answer "what is hidden in the reviews", organize materials, clean data, and identify action items. It is suitable for operations, product, sales, and software to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as documents, spreadsheets or records, pasted documents, spreadsheets, meeting notes, customer feedback, review text, or materials to be organized, organizes key context, and outputs review clusters, pain point attribution, and operations action cards for continued execution, review, or delivery. Capability positioning supplement: review aggregation can cover e-commerce, local life, and content interaction scenarios.

When to Use

Applicable Scenarios

Users ask questions like "what is hidden in the reviews" and need to quickly break down goals, determine priorities, and form executable results
Operations, product, sales, and software need to generate review clusters, pain point attribution, and operations action cards around the Customer Review Insight Assistant
Users have already prepared organization goals (explain the desired structured summary, cleaning rules, action items, gap reminders, or delivery purpose.), target users (explain the audience, team, role, or business scenario the organization results should serve.), and material links (fill in publicly accessible document, spreadsheet, page, or material links; for restricted content, please upload or paste instead.), and want to organize them into executable analysis or optimization results
Users need to turn materials related to the Customer Review Insight Assistant into clear conclusions, priorities, and next-step actions

How to Invoke

Call the AI Skills API directly 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 desired structured summary, cleaning rules, action items, gap reminders, or delivery purpose
`audience`	string	No	-	Explain the audience, team, role, or business scenario the organization results should serve
`materialUrl`	string	No	-	Fill in publicly accessible document, spreadsheet, page, or material links; for restricted content, please upload or paste instead; a complete accessible URL is required
`materialFile`	string	No	-	Upload documents, spreadsheets, meeting minutes, customer materials, or review data files
`materialText`	string	No	-	Paste documents, spreadsheets, meeting records, customer feedback, review text, or materials to be organized
`brandRequirements`	string	No	-	Supplement field definitions, time range, format requirements, immutable facts, sensitive information handling, 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.

Supported Input Formats

This skill directly accepts JSON parameters; if the parameters include link fields, please provide complete, accessible URLs.

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

Comment clustering, pain point attribution, operational action cards: organize core results around user goals that can be directly read, reviewed, or delivered.
Input material interpretation: combine the organization goal (explain the desired structured summary, cleanup rules, action items, gap reminders, or delivery purpose.), intended users (explain the audience, team, role, or business scenario the organized results should serve.), and material links (provide publicly accessible documents, spreadsheets, pages, or material links; for restricted content, upload or paste instead.) to extract key context and judgment basis.
Next steps: provide priorities, execution suggestions, or a content framework that can be further processed.

Suggestions for using the results

First determine whether the output answers the user's core questions about the "Customer Review Insight Assistant".
Then check whether the results cover comment clustering, pain point attribution, and operational action cards, 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 raw 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