huawei-cloud-icp-process-guidance
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseHuawei Cloud · ICP备案知识问答
Huawei Cloud · ICP Filing Q&A
内置 ICP备案知识库,提供直接检索式问答。
Built-in ICP Filing knowledge base, providing direct retrieval-based Q&A.
前置条件
Prerequisites
外部依赖(搜索兜底必需)
External Dependencies (Required for Search Fallback)
本Skill在知识库无法覆盖问题时,会调用 agent-reach 的 Exa 搜索进行补全。
为什么需要:搜索能力由 agent-reach 提供,本Skill只负责判断逻辑和输出格式。
安装方法(复制给 AI 执行):
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md安装完成后验证:
bash
mcporter call 'exa.web_search_exa(query: "test", numResults: 1)'如安装遇到问题,参见 agent-reach 故障排除。
This Skill will call agent-reach's Exa search for completion when the knowledge base cannot cover the question.
Why it's needed: The search capability is provided by agent-reach; this Skill only handles judgment logic and output format.
Installation Method (copy for AI to execute):
Help me install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.mdAfter installation, verify:
bash
mcporter call 'exa.web_search_exa(query: "test", numResults: 1)'If you encounter issues during installation, refer to agent-reach Troubleshooting.
知识库准备
Knowledge Base Preparation
本Skill自带 ICP备案知识库,位于目录:./kb/
:知识库文档索引(预生成,开箱即用)index.json :原始 Markdown 文档目录kb/如需更新知识库内容,请:
- 更新
目录下的 Markdown 文件kb/- 运行
重新生成索引python scripts/build_index.py
This Skill comes with an ICP Filing knowledge base located in thedirectory:./kb/
: Knowledge base document index (pre-generated, ready to use out of the box)index.json : Directory of original Markdown documentskb/To update the knowledge base content:
- Update the Markdown files in the
directorykb/- Run
to regenerate the indexpython scripts/build_index.py
环境检查
Environment Check
确保以下路径可访问:
bash
undefinedEnsure the following paths are accessible:
bash
undefined检查 skill 目录结构
Check skill directory structure
ls -la <skill-dir>/
ls -la <skill-dir>/
检查知识库目录
Check knowledge base directory
ls -la <skill-dir>/kb/
其中 `<skill-dir>` 为本技能的安装目录。ls -la <skill-dir>/kb/
Where `<skill-dir>` is the installation directory of this Skill.触发条件
Trigger Conditions
同时满足以下条件时激活:
- 用户提到「华为云」或「华为云ICP」
- 并且提到以下关键词之一:
- 备案相关:备案、备案流程、备案材料、备案条件、备案审核、备案驳回、备案注销、备案变更
- 资源相关:授权码、备案授权码
- 问题类型:FAQ、常见问题、问题、怎么办
- 具体场景:新增网站、域名备案、个人备案、企业备案、分公司备案
示例问题:
- "华为云ICP备案需要准备什么材料?"
- "备案被驳回了怎么处理?"
- "授权码怎么生成的?"
- "分公司能在母公司账号下备案吗?"
- "个人备案和企业备案有什么区别?"
- "ECS备案次数超限了怎么办?"
Activated when all the following conditions are met:
- User mentions "Huawei Cloud" or "Huawei Cloud ICP"
- And mentions one of the following keywords:
- Filing-related: Filing, filing process, filing materials, filing conditions, filing review, filing rejection, filing cancellation, filing change
- Resource-related: Authorization code, filing authorization code
- Question types: FAQ, common questions, issues, how to
- Specific scenarios: New website, domain filing, individual filing, enterprise filing, branch filing
Example Questions:
- "What materials do I need to prepare for Huawei Cloud ICP Filing?"
- "What should I do if my filing is rejected?"
- "How is the authorization code generated?"
- "Can a branch file for filing under the parent company's account?"
- "What's the difference between individual filing and enterprise filing?"
- "What should I do if the ECS filing limit is exceeded?"
检索流程
Retrieval Process
Step 1:读取 index.json
首先读取 ,了解知识库中有哪些文档、各文档的类型和摘要。
index.jsonStep 2:语义匹配选择文档
根据用户问题的语义,从 index.json 中选择最相关的 1-3 篇文档。
匹配依据:
- :文档标题
title - :案例类型标签
case_types - :文档摘要(LLM生成)
summary - 用户问题的核心意图(如"材料"→找材料相关文档)
Step 3:读取选中文档
读取 index.json 中选中的 Markdown 文档原文。
Step 4:提取 Relevant 段落
从文档原文中找出与用户问题最相关的段落/章节。
Step 5:组装回答
按照响应格式组装回答。
Step 6:搜索兜底(条件触发)
当以下情况发生时,启用网络搜索补全(详见 references/search-fallback.md):
| 触发条件 | 操作 |
|---|---|
| 知识库检索结果相关性低(<0.3)或为空 | 立即搜索 |
| 知识库内容发布时间超过6个月 | 搜索最新政策对比 |
| 用户明确询问"最新"、"最近"相关 | 搜索最新进展 |
搜索补全时:
- 构造Query:
华为云ICP备案 + [核心关键词] + 2026 - 调用
mcporter call 'exa.web_search_exa(query: "...", numResults: 3)' - 在回答末尾追加 部分
**网络补充**(仅供参考) - 必须附带免责声明
Step 1: Read index.json
First, read to understand which documents are in the knowledge base, as well as the type and summary of each document.
index.jsonStep 2: Semantic Matching to Select Documents
Based on the semantics of the user's question, select the most relevant 1-3 documents from index.json.
Matching criteria:
- : Document title
title - : Case type tags
case_types - : Document summary (generated by LLM)
summary - Core intent of the user's question (e.g., "materials" → find documents related to materials)
Step 3: Read Selected Documents
Read the original Markdown documents selected in index.json.
Step 4: Extract Relevant Paragraphs
Find the paragraphs/sections most relevant to the user's question from the original document content.
Step 5: Assemble Answer
Assemble the answer according to the response format.
Step 6: Search Fallback (Conditional Trigger)
Enable web search completion in the following scenarios (see references/search-fallback.md):
| Trigger Condition | Action |
|---|---|
| Low relevance of knowledge base retrieval results (<0.3) or no results | Search immediately |
| Knowledge base content was published more than 6 months ago | Search for latest policy comparisons |
| User explicitly asks about "latest" or "recent" information | Search for latest developments |
When using search fallback:
- Construct Query:
Huawei Cloud ICP Filing + [core keywords] + 2026 - Call
mcporter call 'exa.web_search_exa(query: "...", numResults: 3)' - Append a section at the end of the answer
**Web Supplement** (for reference only) - Must include a disclaimer
参数确认
Parameter Confirmation
本Skill为纯问答模式,无外部参数需要用户确认。
但在进行检索时,会根据用户问题的语义自动推断:
- 备案类型:个人备案 / 单位备案
- 备案阶段:首次备案 / 新增网站 / 变更备案 / 注销备案
- 问题类别:材料咨询 / 流程咨询 / 驳回咨询 / 授权码咨询
如用户问题表述模糊,应主动询问澄清。
This Skill is in pure Q&A mode, with no external parameters requiring user confirmation.
However, during retrieval, it will automatically infer based on the semantics of the user's question:
- Filing type: Individual filing / Enterprise filing
- Filing stage: Initial filing / New website addition / Filing change / Filing cancellation
- Question category: Material consultation / Process consultation / Rejection consultation / Authorization code consultation
If the user's question is ambiguous, actively ask for clarification.
边界定义
Boundary Definition
应该回答的问题
Questions to Answer
- ICP备案流程、步骤、注意事项
- 备案材料准备(个人/单位)
- 备案条件、限制、资源要求
- 常见问题、驳回原因及处理方法
- 授权码使用规则、生成方式
- 审核状态追踪
- 备案变更、注销、迁移流程
- 管局政策、地域选择规则
- ICP Filing processes, steps, precautions
- Filing material preparation (individual/enterprise)
- Filing conditions, restrictions, resource requirements
- Common questions, rejection reasons and solutions
- Authorization code usage rules, generation methods
- Review status tracking
- Filing change, cancellation, migration processes
- Administration policies, region selection rules
不应该回答的问题
Questions Not to Answer
| 场景 | 拒绝话术 |
|---|---|
| 其他云(阿里云、腾讯云、AWS)的备案 | "我这边是华为云ICP备案知识库,其他云平台的情况不太清楚,建议查阅相应平台的官方文档。" |
| 与备案无关的技术问题 | "这个问题超出了ICP备案的范围,建议通过工单或客服(950808转3)咨询。" |
| 价格、购买、续订相关 | "这类问题建议联系华为云销售或查看产品定价页。" |
| 知识库中没有的内容 | "抱歉,知识库中暂时没有收录这方面的信息,建议联系华为云客服 950808 转3 咨询。" |
| Scenario | Rejection Response |
|---|---|
| Filing for other clouds (Alibaba Cloud, Tencent Cloud, AWS) | "This is the Huawei Cloud ICP Filing knowledge base. I'm not familiar with the situation of other cloud platforms. Please refer to the official documents of the corresponding platform." |
| Technical issues unrelated to filing | "This question is beyond the scope of ICP Filing. Please consult via ticket or customer service (950808 ext. 3)." |
| Pricing, purchase, renewal-related questions | "For such questions, please contact Huawei Cloud sales or check the product pricing page." |
| Content not included in the knowledge base | "Sorry, this information is not currently included in the knowledge base. Please contact Huawei Cloud customer service at 950808 ext. 3 for consultation." |
输出格式
Output Format
标准格式(Briefing Style)
Standard Format (Briefing Style)
undefinedundefinedICP备案 · [问题主题]
ICP Filing · [Question Topic]
结论:一句话直接回答用户核心问题
关键事实:
· 要点1(来自XXX文档#章节)
· 要点2
· 要点3
适用场景:[补充说明适用范围或前提条件]
操作建议:
- 可执行的步骤1(简要说明)
- 可执行的步骤2(简要说明)
- 如有需要,引导至控制台或人工客服
来源:[文档路径.md]
undefinedConclusion: One-sentence direct answer to the user's core question
Key Facts:
· Point 1 (from XXX document #section)
· Point 2
· Point 3
Applicable Scenarios: [Supplement applicable scope or prerequisites]
Operation Recommendations:
- Executable step 1 (brief description)
- Executable step 2 (brief description)
- If needed, guide to the console or manual customer service
Source: [document path.md]
undefined示例
Example
问:个人备案需要准备什么材料?
答:
undefinedQuestion: What materials do I need to prepare for individual filing?
Answer:
undefinedICP备案 · 个人备案材料
ICP Filing · Individual Filing Materials
结论:个人备案需要准备身份证原件和手机,部分省份需要幕布照。
关键事实:
· 个人备案材料:身份证原件、手机、幕布照(部分省份如贵州、湖南等需要)
· 网站内容限制:个人备案的网站不能涉及经营性内容
· 真实性核验:需由互联网信息服务负责人完成活体认证和签字
· 地域选择:根据身份证所在地或实际居住地选择备案省份
适用场景:首次备案、新增网站/App备案
操作建议:
- 登录华为云控制台,进入ICP备案页面
- 准备好身份证原件和手机(部分省份需备好幕布照)
- 负责人需完成活体认证和签字确认
- 如有问题可拨打客服热线 950808 转3
来源:faq/备案材料咨询.md
undefinedConclusion: Individual filing requires original ID card and mobile phone; some provinces require a backdrop photo.
Key Facts:
· Individual filing materials: Original ID card, mobile phone, backdrop photo (required in some provinces such as Guizhou, Hunan, etc.)
· Website content restrictions: Websites under individual filing cannot involve commercial content
· Authenticity verification: The internet information service responsible person must complete live authentication and signature
· Region selection: Select the filing province based on ID card location or actual residence
Applicable Scenarios: Initial filing, new website/App filing
Operation Recommendations:
- Log in to the Huawei Cloud Console and enter the ICP Filing page
- Prepare original ID card and mobile phone (backdrop photo required in some provinces)
- The responsible person must complete live authentication and signature confirmation
- If you have any questions, you can call the customer service hotline 950808 ext. 3
Source: faq/备案材料咨询.md
undefined索引结构(index.json)
Index Structure (index.json)
json
{
"version": "1.0",
"generated_at": "2026-07-06T10:00:00",
"total_docs": 20,
"docs": [
{
"path": "faq/备案常见问题.md",
"type": "faq",
"title": "备案常见问题",
"case_types": ["备案常见问题", "备案材料咨询", "备案流程咨询", "备案驳回咨询"],
"summary": "汇总ICP备案常见问题,涵盖授权码使用限制、资源备案次数上限、实名核验要求等。"
}
]
}json
{
"version": "1.0",
"generated_at": "2026-07-06T10:00:00",
"total_docs": 20,
"docs": [
{
"path": "faq/备案常见问题.md",
"type": "faq",
"title": "备案常见问题",
"case_types": ["备案常见问题", "备案材料咨询", "备案流程咨询", "备案驳回咨询"],
"summary": "汇总ICP备案常见问题,涵盖授权码使用限制、资源备案次数上限、实名核验要求等。"
}
]
}参考文档
Reference Documents
| 文档 | 说明 |
|---|---|
| references/cli-installation-guide.md | CLI安装指南(本技能为Q&A型,不涉及CLI) |
| references/iam-policies.md | IAM权限策略(本技能为Q&A型,无需云API权限) |
| references/verification-method.md | 验证方法:环境检查、功能验证、性能验证 |
| references/acceptance-criteria.md | 验收标准:功能验收、质量验收、安全验收 |
| references/search-fallback.md | 搜索兜底策略:知识库无果时的网络搜索补全方案 |
| Document | Description |
|---|---|
| references/cli-installation-guide.md | CLI Installation Guide (This Skill is Q&A-type, no CLI involved) |
| references/iam-policies.md | IAM Permission Policies (This Skill is Q&A-type, no cloud API permissions required) |
| references/verification-method.md | Verification Methods: Environment check, function verification, performance verification |
| references/acceptance-criteria.md | Acceptance Criteria: Function acceptance, quality acceptance, security acceptance |
| references/search-fallback.md | Search Fallback Strategy: Web search completion solution when knowledge base has no results |
最佳实践
Best Practices
- 不要猜测:如果知识库中没有明确答案,老实说"没有收录",不要臆造
- 标明来源:每个关键事实都要标明来源文档,增强可信度
- 控制长度:回答精简,不要照搬整篇文档,突出与问题相关的部分
- 术语一致:使用与华为云控制台一致的术语(如"备案授权码"而非"备案码")
- 更新索引:当知识库内容更新后,需重新运行 更新索引
python build_index.py
- Do not guess: If there is no clear answer in the knowledge base, honestly say "not included" instead of making up information
- Indicate source: Each key fact must indicate the source document to enhance credibility
- Control length: Keep answers concise, do not copy the entire document, highlight parts relevant to the question
- Consistent terminology: Use terminology consistent with the Huawei Cloud Console (e.g., "filing authorization code" instead of "filing code")
- Update index: After updating the knowledge base content, re-run to update the index
python build_index.py
文件结构
File Structure
huawei-cloud-icp-process-guidance/ # 技能包根目录
├── SKILL.md # 技能定义文件(必需,唯一入口)
├── index.json # 知识库文档索引(预生成)
├── kb/ # 知识库目录(自包含)
│ ├── faq/ # FAQ文档
│ ├── procedures/ # 流程文档
│ ├── topics/ # 主题文档
│ ├── overview.md # 知识库概览
│ └── index.md # 知识库索引
├── scripts/ # 脚本目录
│ └── build_index.py # 索引构建脚本
└── references/ # 参考文档目录
├── search-fallback.md # 搜索兜底策略
├── verification-method.md # 验证方法
└── acceptance-criteria.md # 验收标准huawei-cloud-icp-process-guidance/ # Skill package root directory
├── SKILL.md # Skill definition file (required, only entry)
├── index.json # Knowledge base document index (pre-generated)
├── kb/ # Knowledge base directory (self-contained)
│ ├── faq/ # FAQ documents
│ ├── procedures/ # Process documents
│ ├── topics/ # Topic documents
│ ├── overview.md # Knowledge base overview
│ └── index.md # Knowledge base index
├── scripts/ # Script directory
│ └── build_index.py # Index building script
└── references/ # Reference document directory
├── search-fallback.md # Search fallback strategy
├── verification-method.md # Verification method
└── acceptance-criteria.md # Acceptance criteria版本历史
Version History
| 版本 | 日期 | 变更说明 |
|---|---|---|
| 1.2.0 | 2026-07-07 | 新增前置依赖说明:明确需要安装 agent-reach 才能启用搜索兜底 |
| 1.1.0 | 2026-07-07 | 新增搜索兜底策略:知识库无果时启用 Exa 网络搜索补全 |
| 1.0.0 | 2026-07-07 | 初始版本,符合华为云Skills规范 |
| Version | Date | Change Description |
|---|---|---|
| 1.2.0 | 2026-07-07 | Added prerequisite dependency description: Clearly stated that agent-reach must be installed to enable search fallback |
| 1.1.0 | 2026-07-07 | Added search fallback strategy: Enabled Exa web search completion when knowledge base has no results |
| 1.0.0 | 2026-07-07 | Initial version, compliant with Huawei Cloud Skills specifications |