> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/chinese/guan-li-yu-she-zhi/settings/global-settings/document-types/troubleshooting.md).

# 故障排查

## 在 DocBits 中排查文档类型配置问题可能较为复杂，因为多种因素都会影响数据识别和提取。

### 以下是一些通用故障排查建议，可帮助识别并解决常见问题：

### 检查布局配置

**检查一致性：**

* 确保此类型的所有文档布局一致。布局差异可能会影响识别。

**检查区域和范围：**

* 检查已定义的区域和范围是否定位正确，并覆盖相关信息。

**更新模板：**

* 如果文档布局发生变化，请相应更新模板。

### 检查字段定义和元数据

**字段名称和数据类型：**

* 确保字段名称正确，且数据类型定义无误。

**格式指南：**

* 检查字段的格式指南是否正确，并与实际数据一致。

**检查必填字段：**

* 确保所有必填字段都能被正确识别并填写。

### 调整正则表达式模式和提取规则

**测试正则表达式模式：**

* 使用正则表达式工具测试这些模式，确保它们能正确捕获所需数据。

**提高特异性：**

* 调整正则表达式模式，使其更具针对性，避免误解。

**检查锚点：**

* 确保数据提取的锚点设置正确。如果模式无法正常工作，请检查是否需要考虑特殊字符或不同格式。

### 调整验证规则

**分析错误消息：**

* 检查错误消息和日志文件，查找验证不正确的迹象。

**优化规则：**

* 必要时调整验证规则，使其更灵活或更严格。

**多步骤验证：**

* 实施额外的验证步骤，以提高数据质量。

### 改进训练数据和模型

**收集有代表性的数据：**

* 确保训练数据涵盖大量示例，反映所有可能的变化。

**重新训练模型：**

* 定期重新训练模型，尤其是在添加新的文档变体时。

**反馈循环：**

* 利用反馈循环持续改进模型。

### 检查自动化工作流

**检查工作流步骤：**

* 检查工作流中的每个步骤，确保数据得到正确处理和路由。

**分析日志：**

* 分析工作流日志，以识别并解决错误来源。

**收集用户反馈：**

* 询问用户使用工作流的体验和遇到的问题，以找出潜在的薄弱环节。

### 检查用户权限和访问控制

**检查访问权限：**

* 确保正确的用户能够访问相关文档类型和字段。

**跟踪变更：**

* 检查近期的访问权限变更是否影响了文档处理。

**定期检查：**

* 定期检查访问权限，确保所有配置均正确。

### 通用故障排查建议

**查阅文档：**

* 通过 DocBits 系统文档和支持资源查找问题的解决方案。

**提供培训：**

* 确保所有用户都接受了充分培训，以避免常见错误。

**更新和补丁：**

* 定期安装包含错误修复和改进的更新和补丁，保持系统为最新状态。

排查文档类型配置问题需要采用系统化的方法，并仔细检查配置的各个方面。通过应用上述建议，您可以识别并修复常见问题，从而提高 DocBits 中文档处理的准确性和效率。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docbits.com/chinese/guan-li-yu-she-zhi/settings/global-settings/document-types/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.