---
title: "更新手工知识"
method: PUT
path: "/knowledge/manual/{id}"
tags: ["知识管理"]
---

# 更新手工知识

`PUT /knowledge/manual/{id}`

更新手工录入的Markdown知识内容

## Path parameters

- `id` string, required

## Request body

- GithubComTencentWeKnoraInternalTypesManualKnowledgePayload
  - `channel` string
  - `content` string
  - `process_config` GithubComTencentWeKnoraInternalTypesKnowledgeProcessOverrides
    - `asr_config` GithubComTencentWeKnoraInternalTypesASRConfig
      - `enabled` boolean
      - `language` string — optional: language hint for transcription
      - `model_id` string
    - `chunking_config` GithubComTencentWeKnoraInternalTypesChunkingConfig
      - `child_chunk_size` integer — ChildChunkSize is the size of child chunks used for embedding (default: 384). Only used when EnableParentChild is true.
      - `chunk_overlap` integer — Chunk overlap
      - `chunk_size` integer — Chunk size
      - `enable_parent_child` boolean — EnableParentChild enables two-level parent-child chunking strategy. When enabled, large parent chunks provide context while small child chunks are used for vector matching. Retrieval matches on child but returns parent content.
      - `languages` string[] — Languages hints the heuristic patterns. Empty = auto-detect from content. Examples: ["de"], ["en", "zh"].
      - `parent_chunk_size` integer — ParentChunkSize is the size of parent chunks (default: 4096). Only used when EnableParentChild is true.
      - `parser_engine_rules` GithubComTencentWeKnoraInternalTypesParserEngineRule[] — ParserEngineRules configures which parser engine to use for each file type. When empty, the builtin engine is used for all types.
        - `engine` string
        - `file_types` string[]
        - `xlsx_first_row_as_header` boolean — XLSXFirstRowAsHeader restores row-1 column context for flat XLSX tables. nil preserves the parser default; an explicit false disables the mode.
      - `separators` string[] — Separators
      - `strategy` string — Strategy selects the adaptive chunking tier. Empty / "legacy" preserves the historical recursive splitter; "auto" lets a profiler pick between heading-aware, heuristic and recursive tiers; "heading" / "heuristic" / "recursive" pin the tier explicitly.
      - `table_metadata_instructions` string — TableMetadataInstructions contains optional business guidance used when generating searchable summaries for CSV/Excel tables. The system-owned output contract remains fixed; these instructions only add domain context.
      - `token_limit` integer — TokenLimit caps chunk size in approximate tokens. 0 = use ChunkSize as a character count.
    - `enable_multimodel` boolean
    - `extract_config` GithubComTencentWeKnoraInternalTypesExtractConfig
      - `custom_instructions` string — CustomInstructions adds domain-specific extraction guidance while the system keeps ownership of the structured graph output protocol.
      - `enabled` boolean
      - `nodes` GithubComTencentWeKnoraInternalTypesGraphNode[]
        - `attributes` string[]
        - `chunks` string[]
        - `name` string
      - `relations` GithubComTencentWeKnoraInternalTypesGraphRelation[]
        - `node1` string
        - `node2` string
        - `type` string
      - `tags` string[]
      - `text` string
    - `graph_enabled` boolean
    - `parser_engine_overrides` object — ParserEngineOverrides passes key-value configuration to docreader parsers (e.g. pdf_force_scanned=true). Merged with workspace-level overrides in the parse pipeline; per-upload values take priority on conflict.
    - `parser_engine_rules` GithubComTencentWeKnoraInternalTypesParserEngineRule[]
      - `engine` string
      - `file_types` string[]
      - `xlsx_first_row_as_header` boolean — XLSXFirstRowAsHeader restores row-1 column context for flat XLSX tables. nil preserves the parser default; an explicit false disables the mode.
    - `question_generation_config` GithubComTencentWeKnoraInternalTypesQuestionGenerationConfig
      - `custom_instructions` string — CustomInstructions describes the intended audience or question style. It is appended to the stable system question-generation template.
      - `enabled` boolean
      - `question_count` integer — Number of questions to generate per chunk (default: 3, max: 10)
    - `vlm_config` GithubComTencentWeKnoraInternalTypesVLMConfig
      - `api_key` string — API Key
      - `base_url` string — Base URL
      - `custom_instructions` string — CustomInstructions adds KB-specific image interpretation guidance without replacing the system-owned OCR and Markdown output contract.
      - `description_language` string — DescriptionLanguage controls the language used for generated image captions. Empty means follow the document/request language.
      - `enabled` boolean
      - `interface_type` string — Interface Type: "ollama" or "openai"
      - `model_id` string
      - `model_name` string — 兼容老版本 Model Name
  - `status` string
  - `tag_ids` string[]
  - `title` string

## Response `200`

更新后的知识

- object

## Other responses

- `400` — 请求参数错误

---

[API](https://skmtc.net/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.net/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/versions/d6921ae22ce0/schema)