样本标注

更新时间：2024-11-08

功能介绍

用于进行样本标注。

使用说明

本文API支持通过Python SDK、Go SDK、Java SDK 和 Node.js SDK调用，调用流程请参考SDK安装及使用流程。

SDK调用

调用示例

import os
from qianfan.resources import Data

# 使用安全认证AK/SK鉴权，通过环境变量方式初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

resp = Data.annotate_an_entity(
    dataset_id="ds-7pkzh1exthpuy10n",
    entity_id="f9bc93825e856358886bbc6ad28c7032955b54d171ae8b47587a0346c604139f_7951870f3cd747b497d32f3814b8fxxx",
    content = [{
        "prompt": "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
        "response": [
            ["女司机疲劳驾驶导致9死24伤"]
        ]
    }]
)

print(resp)

package main
import (
    "context"
    "fmt"
    "os"
    "github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)
func main() {
     // 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
    os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
    os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
    
    ca := qianfan.NewConsoleAction()
    
    res, err := ca.Call(context.TODO(),
    // 调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求地址的后缀
    "/wenxinworkshop/entity/annotate", "",
    // 对应本文HTTP调用-请求说明-请求参数-Body参数，具体使用请查看Body参数说明，根据实际使用选择参数
    map[string]interface{}{
                "id": "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
                "datasetId": "ds-7pkzh1exthpuy10n",
                "content": []map[string]any{{
                    "prompt": "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
                    "response": [][]string{
                        {"女司机疲劳驾驶导致9死24伤"},
                    },
                }},
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(string(res.Body))
    
}

import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.console.ConsoleResponse;
import com.baidubce.qianfan.util.CollUtils;
import com.baidubce.qianfan.util.Json;
import java.util.Map;

public class Dome {
    public static void main(String args[]){
        // 使用安全认证AK/SK鉴权，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
        Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
        
        ConsoleResponse<Map<String, Object>> response = qianfan.console()
                // 调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求地址的后缀
                .route("/wenxinworkshop/entity/annotate")
                // 需要传入参数的场景，可以自行封装请求类，或者使用Map.of()来构建请求Body
                // Java 8可以使用SDK提供的CollUtils.mapOf()来替代Map.of()
                // 对应本文HTTP调用-请求说明-请求参数-Body参数，具体使用请查看Body参数说明，根据实际使用选择参数
                .body(CollUtils.mapOf(
                    "id", "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
                    "datasetId", "ds-7pkzh1exthpuy10n",
                    "content",new Map[]{CollUtils.mapOf(
                        "prompt", "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
                        "response", new String[][]{
                            new String[]{"女司机疲劳驾驶导致9死24伤"}
                        }
                    )}
                ))
                .execute();

        System.out.println(Json.serialize(response));
    }
}

import {consoleAction, setEnvVariable} from "@baiducloud/qianfan";

// 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');

async function main() {
  //base_api_route:调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求地址的后缀
  //data:对应本文HTTP调用-请求说明-请求参数-Body参数，具体使用请查看Body参数说明，根据实际使用选择参数
  const res = await consoleAction({base_api_route: '/wenxinworkshop/entity/annotate',data: {
        "id": "48dc586f7eb638457b826c02c1b868ef8ac8911b495504625a1ac824f9d38ff8_5f9ac12ca15e4c9c9351174942865e5a",
        "datasetId": "ds-7pkzh1exthpuy10n",
        "content": [{
            "prompt": "请根据下面的新闻生成摘要, 内容如下:一辆小轿车，一名女司机，竟造成9死24伤。日前，深圳市交警局对事故进行通报：从目前证据看，事故系司机超速行驶且操作不当导致。目前24名伤员已有6名治愈出院，其余正接受治疗，预计事故赔偿费或超一千万元。\n生成摘要如下:",
            "response": [
                ["女司机疲劳驾驶导致9死24伤"]
            ]
        }]
    }
  });    
    
  console.log(res);
}

main();

返回示例

QfResponse(
    code=200,
    headers={...},
    body={
        "log_id": "a15d0g5z8gqgx6uw",
        "result": True,
        "status": 200,
        "success": True
    },
)

{
	"log_id": "x7wwxwhykirrt30n",
	"result": true,
	"status": 200,
	"success": true
}

{
	"log_id": "x7wwxwhykirrt30n",
	"result": true,
	"status": 200,
	"success": true
}

{
	log_id: 'x7wwxwhykirrt30n',
	result: true,
	status: 200,
	success: true
}

请求参数

注意：不同语言SDK的请求参数不同，请根据实际调用选择对应参数。

Python SDK请求参数说明

名称	类型	必填	描述
entity_id	string	是	样本ID，通过调用获取样本列表接口，返回的id字段获取样本ID
dataset_id	string	是	数据集版本id，说明：（1）可以通过以下任一方式获取该字段值： · 方式一，通过调用创建数据集接口，返回的datasetId字段获取 · 方式二，在控制台-数据集管理列表页面，点击详情，在版本信息页查看，如下图所示（2）该字段新增支持string类型，如果之前使用的是int类型，建议变更为string类型，后续可能将逐步废弃int类型；例如之前是通过调用创建数据集V1接口，返回的id字段获取，请替换为接口返回的datasetId字段获取
content	Optional[List[Dict[str, Any]]]	否	问答对信息，只有在文本对话标注类型时，该字段有效
labels	Optional[List[Dict[str, Any]]]	否	标签列表，只有在文生图类型时，该字段有效

content说明

名称	类型	必填	描述
prompt	string	是	问题
response	string[][]	是	问答对。文本对话不同标注模版，对应content格式不同，说明：（1）目前有2种格式，分别为非排序文本对话、排序文本对话格式（2）如果为非排序文本对话，注意： · 一个样本最多支持十个问答对(content) · 非排序文本对话的回答为一个string，放在string[][]中，示例如下：`"response": [ ["《山水情》作为中国水墨动画的绝唱，折服了无数中外人士。"]]` （3）如果为排序文本对话格式，注意： · 一个样本最多支持十个问答对，单个问答对中的排序及回答数量总和最多支持添加5个 · 外层列表表示不同排序，内层列表表示某个排序的所有回答，示例如下： "response": [["国家食药监管总局发布《食品召回管理办法》，明确一级召回，食用后已经或可能导致严重健康损害甚至死亡的食品应在知悉食品安全风险后24小时内启动召回，自公告发布之日起10个工作日内完成召回。", "国家食药监管总局发布《食品召回管理办法》，明确一级召回食品生产者应在知悉食品安全风险后24小时内启动召回，自公告发布之日起10个工作日内完成召回。对于可能导致严重健康损害甚至死亡的食品也明确需要召回。", "国家食药监管总局发布新规定《食品召回管理办法》，对于可能导致严重健康损害甚至死亡的食品，生产者需在知悉风险后的24小时内启动召回，并需在10个工作日内完成。"],["国家食药监管总局发布新规定《食品召回管理办法》，对于可能导致严重健康损害甚至死亡的食品，生产者需在知悉风险后24小时内启动召回，并须在10个工作日内完成召回。"],["国家食药监管总局发布《食品召回管理办法》，明确一级召回的食品应知悉食品安全风险后24小时内启动召回，且自公告发布之日起10个工作日内完成召回。该办法适用于食用后可能导致严重健康损害甚至死亡的食品。"]]}]

labels说明

名称	类型	必填	描述
content	string	是	图片对应的prompt，说明：（1）只有在文生图类型时，该字段有效（2）示例：

其它SDK请求参数说明

名称	类型	必填	说明
id	string	是	样本ID，通过调用获取样本列表接口，返回的id字段获取样本ID
datasetId	string	是	数据集版本id，说明：（1）可以通过以下任一方式获取该字段值： · 方式一，通过调用创建数据集接口，返回的datasetId字段获取 · 方式二，在控制台-数据集管理列表页面，点击详情，在版本信息页查看，如下图所示（2）该字段新增支持string类型，如果之前使用的是int类型，建议变更为string类型，后续可能将逐步废弃int类型；例如之前是通过调用创建数据集V1接口，返回的id字段获取，请替换为接口返回的datasetId字段获取
content	object[]	否	问答对信息，只有在文本对话标注类型时，该字段有效
labels	object[]	否	标签列表，只有在文生图类型时，该字段有效

content说明

名称	类型	必填	描述
prompt	string	是	问题
response	string[][]	是	问答对。文本对话不同标注模版，对应content格式不同，说明：（1）目前有2种格式，分别为非排序文本对话、排序文本对话格式（2）如果为非排序文本对话，注意： · 一个样本最多支持十个问答对(content) · 非排序文本对话的回答为一个string，放在string[][]中，示例如下：`"response": [ ["《山水情》作为中国水墨动画的绝唱，折服了无数中外人士。"]]` （3）如果为排序文本对话格式，注意： · 一个样本最多支持十个问答对，单个问答对中的排序及回答数量总和最多支持添加5个 · 外层列表表示不同排序，内层列表表示某个排序的所有回答，示例如下： "response": [["国家食药监管总局发布《食品召回管理办法》，明确一级召回，食用后已经或可能导致严重健康损害甚至死亡的食品应在知悉食品安全风险后24小时内启动召回，自公告发布之日起10个工作日内完成召回。", "国家食药监管总局发布《食品召回管理办法》，明确一级召回食品生产者应在知悉食品安全风险后24小时内启动召回，自公告发布之日起10个工作日内完成召回。对于可能导致严重健康损害甚至死亡的食品也明确需要召回。", "国家食药监管总局发布新规定《食品召回管理办法》，对于可能导致严重健康损害甚至死亡的食品，生产者需在知悉风险后的24小时内启动召回，并需在10个工作日内完成。"],["国家食药监管总局发布新规定《食品召回管理办法》，对于可能导致严重健康损害甚至死亡的食品，生产者需在知悉风险后24小时内启动召回，并须在10个工作日内完成召回。"],["国家食药监管总局发布《食品召回管理办法》，明确一级召回的食品应知悉食品安全风险后24小时内启动召回，且自公告发布之日起10个工作日内完成召回。该办法适用于食用后可能导致严重健康损害甚至死亡的食品。"]]}]

labels说明

名称	类型	必填	描述
content	string	是	图片对应的prompt，说明：（1）只有在文生图类型时，该字段有效（2）示例：

返回参数

名称	类型	描述
log_id	string	操作记录id
result	bool	返回结果
status	int	状态码
success	bool	是否操作成功，说明： · true：成功 · false：失败

获取样本列表

Prompt工程

百度智能云

百度智能云千帆大模型服务与开发平台ModelBuilder

百度智能云千帆大模型服务与开发平台ModelBuilder

样本标注

功能介绍

使用说明

SDK调用

调用示例

返回示例

请求参数

返回参数