get_point--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

切片（Point）

get_point

概述

get_point 用于查看知识库下的指定切片的信息

请求参数

参数	类型	是否必选	默认值	参数说明
collectionName	String	否	--	知识库名称
projectName	String	否	default	知识库所属项目，获取方式参见文档API 接入与技术支持若不指定该字段，则在default项目下创建。若需要操作指定项目下的知识库，需正确配置该字段。
resourceId	String	否	--	知识库唯一 id 可选择直接传 ResourceID，或同时传 CollectionName 和 ProjectName 作为知识库的唯一标识
pointId	String	是	--	切片唯一 id
getAttachmentLink	Boolean	否	false	是否获取切片中图片的临时下载链接 10 分钟有效期

响应消息

字段	类型	参数说明
resp	PointInfo	返回切片信息

PointInfo

字段	类型	参数说明
collectionName	String	知识库名称
pointId	String	切片 id（知识库下唯一）
processTime	Long	切片处理完成的时间
originText	String	原始文本
mdContent	String	切片 markdown 解析结果，保留更多的原始表格信息（chunk_type 为 table 时会返回）
htmlContent	String	切片 html 解析结果，保留更多的原始表格信息（chunk_type 为 table 时会返回）
chunkTitle	String	切片标题，是由解析模型识别出来的上一层级的标题。若没有上一层级标题则为空
chunkType	String	切片所属类型
content	String	切片内容
chunkId	Long	切片位次 id，代表在原始文档中的位次顺序
originalQuestion	String	faq 数据检索召回答案对应的原始问题
docInfo	PointDocInfo	PointDocInfo
rerankScore	Double	重排得分
score	Double	检索得分
chunkSource	String	切片来源
chunkAttachment	List	附件信息（GetAttachmentLink 为 true 时返回临时链接，10 分钟有效期）
tableChunkFields	List	结构化数据检索返回单行全量数据
updateTime	Long	更新时间
description	String	文档描述（当前仅支持图片文档）
chunkStatus	String	切片状态
videoFrame	String	视频帧
videoUrl	String	视频链接
videoStartTime	Long	视频切片的起始时间（ms）
videoEndTime	Long	视频切片的结束时间（ms）
videoOutline	Map<String, Object>	视频大纲
audioStartTime	Long	音频切片的起始时间（ms）
audioEndTime	Long	音频切片的结束时间（ms）
audioOutline	Map<String, Object>	音频大纲
sheetName	String	sheet 名称
project	String	项目名
resourceId	String	知识库唯一 id

PointDocInfo

字段	类型	参数说明
docId	String	所属文档 id
docName	String	所属文档名字
createTime	Long	文档创建时间
docType	String	所属原始文档类型
docMeta	String	所属文档的 meta 信息
source	String	所属文档知识来源（url，tos 等）
title	String	所属文档标题
status	DocStatus	DocStatus

DocStatus

字段	类型	参数说明
processStatus	Integer	处理状态
failedCode	Integer	失败错误码
failedMsg	String	失败错误信息

ChunkAttachment

字段	类型	参数说明
uuid	String	附件 uuid
caption	String	附件说明
type	String	附件类型
link	String	附件链接
infoLink	String	附件 info_link
columnName	String	附件列名

PointTableChunkField

字段	类型	参数说明
fieldName	String	字段名
fieldValue	Object	字段值

状态码说明

状态码	http状态码	返回信息	状态码说明
0	200	success	成功
1000001	401	unauthorized	鉴权失败
1000002	403	no permission	权限不足
1000003	400	invalid request：%s	非法参数
1000005	400	collection not exist	collection不存在
1001001	400	doc not exist	doc不存在
1002001	400	point not exist	point_id不存在

请求示例

首次使用知识库 SDK ，可参考使用说明
本示例演示了知识库 Java SDK 中 GetPoint 的基础使用方法，通过指定知识点 ID 查询切片信息，使用前需配置鉴权参数（VOLC_AK/VOLC_SK 或 VIKING_API_KEY）。

package com.volcengine.vikingdb.runtime.knowledge.examples.point_get;

import com.fasterxml.jackson.databind.ObjectWriter;
import com.volcengine.vikingdb.runtime.core.ApiClient;
import com.volcengine.vikingdb.runtime.core.RequestAddition;
import com.volcengine.vikingdb.runtime.core.auth.Auth;
import com.volcengine.vikingdb.runtime.core.auth.AuthWithAkSk;
import com.volcengine.vikingdb.runtime.core.auth.AuthWithApiKey;
import com.volcengine.vikingdb.runtime.enums.Scheme;
import com.volcengine.vikingdb.runtime.knowledge.model.CollectionMeta;
import com.volcengine.vikingdb.runtime.knowledge.model.request.AddDocV2Request;
import com.volcengine.vikingdb.runtime.knowledge.model.request.AddPointRequest;
import com.volcengine.vikingdb.runtime.knowledge.model.response.AddDocResponse;
import com.volcengine.vikingdb.runtime.knowledge.model.response.PointAddResponse;
import com.volcengine.vikingdb.runtime.knowledge.model.response.PointInfo;
import com.volcengine.vikingdb.runtime.knowledge.service.KnowledgeCollectionClient;
import com.volcengine.vikingdb.runtime.knowledge.service.KnowledgeService;

import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

public class Main {
    private static final ObjectWriter PRETTY_JSON = ApiClient.objectMapper.writerWithDefaultPrettyPrinter();
    private static final Scheme SCHEME = Scheme.HTTPS;
    private static final String HOST = "api-knowledgebase.mlp.cn-beijing.volces.com";
    private static final String REGION = "cn-beijing";
    private static final String PROJECT = "default";
    private static final String COLLECTION_NAME = "your_collection_name";
    private static final String COLLECTION_RESOURCE_ID = "";

    public static void main(String[] args) throws Exception {
        Auth auth = preferAuth();
        if (auth == null) {
            System.out.println("missing_auth: set VOLC_AK/VOLC_SK or VIKING_API_KEY");
            return;
        }
        KnowledgeService service = newKnowledgeService(auth);
        KnowledgeCollectionClient kc = service.collection(defaultCollectionMeta());

        String docId = "java-example-doc-" + UUID.randomUUID();
        String uri = "https://pdf.dfcfw.com/pdf/H3_AP202504281663850212_1.pdf";
        AddDocV2Request addDocReq = AddDocV2Request.builder()
                .docId(docId)
                .docName("Java SDK Knowledge Point Get Example")
                .docType("pdf")
                .uri(uri)
                .build();
        AddDocResponse addDocResp = kc.addDocV2(addDocReq, new RequestAddition());
        printJson("add_doc_v2", addDocResp);

        Map<String, Object> field = new HashMap<>();
        field.put("field_name", "topic");
        field.put("field_type", "string");
        field.put("field_value", "your_topic");

        AddPointRequest addPointReq = AddPointRequest.builder()
                .docId(docId)
                .chunkType("text")
                .chunkTitle("your_chunk_title")
                .content("your_chunk_content")
                .fields(Collections.singletonList(field))
                .build();
        PointAddResponse addPointResp = kc.addPoint(addPointReq, new RequestAddition());
        printJson("add_point", addPointResp);

        String pointId = addPointResp != null && addPointResp.getData() != null ? addPointResp.getData().getPointId()
                : null;
        if (pointId == null || pointId.trim().isEmpty()) {
            System.out.println("point_id_empty");
            return;
        }

        PointInfo resp = kc.getPoint(pointId, true, new RequestAddition());
        printJson("get_point", resp);
    }

    private static KnowledgeService newKnowledgeService(Auth auth) {
        return new KnowledgeService(SCHEME, HOST, REGION, auth);
    }

    private static Auth preferAuth() {
        String ak = getEnv("VOLC_AK");
        String sk = getEnv("VOLC_SK");
        if (!ak.isEmpty() && !sk.isEmpty()) {
            return new AuthWithAkSk(ak, sk);
        }
        String apiKey = getEnv("VIKING_API_KEY");
        if (!apiKey.isEmpty()) {
            return new AuthWithApiKey(apiKey);
        }
        return null;
    }

    private static CollectionMeta defaultCollectionMeta() {
        return CollectionMeta.builder()
                .collectionName(COLLECTION_NAME)
                .projectName(PROJECT)
                .resourceId(COLLECTION_RESOURCE_ID)
                .build();
    }

    private static String getEnv(String name) {
        String v = System.getenv(name);
        if (v == null) {
            return "";
        }
        v = v.trim();
        return v.isEmpty() ? "" : v;
    }

    private static void printJson(String name, Object obj) throws Exception {
        if (obj == null) {
            System.out.println(name + ": null");
            return;
        }
        System.out.println(name + ": " + PRETTY_JSON.writeValueAsString(obj));
    }
}

最近更新时间：2026.03.26 17:20:14

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

PointInfo #

PointDocInfo #

DocStatus #

ChunkAttachment #