模型使用教程
NLP自然語(yǔ)言處理中,電商行業(yè)能力(商品評(píng)價(jià)解析、電銷場(chǎng)景)、通用行業(yè)能力適配NLP自學(xué)習(xí)平臺(tái)的API調(diào)用接口,模型調(diào)用接口以及SDK調(diào)用請(qǐng)參考如下信息。
使用NLP自學(xué)習(xí)平臺(tái)SDK
引入NLP自學(xué)習(xí)平臺(tái)的SDK,查看最新SDK版本。
SDK調(diào)用示例參考:SDK示例。
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>3.5.0</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-nlp-automl</artifactId>
<version>0.0.8</version>
</dependency>
模型調(diào)用API示例
API文檔參考:RunPreTrainService
API測(cè)試參考:Open API測(cè)試
長(zhǎng)文本調(diào)用API示例
如何使用異步預(yù)測(cè)接口,進(jìn)行模型預(yù)測(cè)的異步調(diào)用,支持更長(zhǎng)文本的離線調(diào)用。
異步預(yù)測(cè)接口使用示例:創(chuàng)建異步接口
獲取異步預(yù)測(cè)結(jié)果:異步結(jié)果獲取
通過(guò)環(huán)境變量配置訪問(wèn)憑證(AKSK)
說(shuō)明:
阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限,風(fēng)險(xiǎn)很高。強(qiáng)烈建議您創(chuàng)建并使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維,請(qǐng)登錄RAM控制臺(tái)創(chuàng)建RAM用戶。
強(qiáng)烈建議不要把AccessKey和AccessKeySecret保存到代碼里,會(huì)存在密鑰泄漏風(fēng)險(xiǎn),在此提供通過(guò)配置環(huán)境變量的方式來(lái)保存和訪問(wèn)aksk
Linux和macOS系統(tǒng)配置方法
export NLP_AK_ENV=<access_key_id> export NLP_SK_ENV=<access_key_secret>
其中<access_key_id>替換為已準(zhǔn)備好的AccessKey ID,<access_key_secret>替換為AccessKey Secret,AccessKey ID和AccessKey Secret的獲取方式見(jiàn)步驟二:獲取賬號(hào)的AccessKey
Windows系統(tǒng)配置方法
新建環(huán)境變量文件,添加環(huán)境變量
NLP_AK_ENV
和NLP_SK_ENV
,并寫(xiě)入已準(zhǔn)備好的AccessKey ID和AccessKey Secret。重啟Windows系統(tǒng)。
商品評(píng)價(jià)解析服務(wù)
新聞層次分類服務(wù)
簡(jiǎn)歷抽取(中文)
簡(jiǎn)歷抽取(英文)
裁判文書(shū)抽取
定罪量刑預(yù)測(cè)服務(wù)
定罪量刑預(yù)測(cè)服務(wù)使用示例(現(xiàn)版本僅支持刑事案件的定罪量刑預(yù)測(cè))
說(shuō)明
調(diào)用刑事定罪量刑服務(wù),ServiceName需要傳入:convictionSentencingService。
java代碼示例
/**
* 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限,風(fēng)險(xiǎn)很高。強(qiáng)烈建議您創(chuàng)建并使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維,請(qǐng)登錄RAM控制臺(tái)創(chuàng)建RAM用戶。
* 此處以把AccessKey和AccessKeySecret保存在環(huán)境變量為例說(shuō)明。您也可以根據(jù)業(yè)務(wù)需要,保存到配置文件里。
* 強(qiáng)烈建議不要把AccessKey和AccessKeySecret保存到代碼里,會(huì)存在密鑰泄漏風(fēng)險(xiǎn)
*/
String accessKeyId = System.getenv("NLP_AK_ENV");
String accessKeySecret = System.getenv("NLP_SK_ENV");
DefaultProfile defaultProfile = DefaultProfile.getProfile("cn-hangzhou",accessKeyId,accessKeySecret);
IAcsClient client = new DefaultAcsClient(defaultProfile);
Map<String, Object> input = new HashMap();
input.put("reqId","reqId");
input.put("text","案情描述");
RunPreTrainServiceRequest request = new RunPreTrainServiceRequest();
request.setServiceName("convictionSentencingService");
request.setPredictContent(JSON.toJSONString(input));
RunPreTrainServiceResponse response = client.getAcsResponse(request);
System.out.println(response.getPredictResult());
python代碼示例
# 安裝依賴
pip install aliyun-python-sdk-core
pip install aliyun-python-sdk-nlp-automl
# -*- coding: utf8 -*-
import json
import os
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdknlp_automl.request.v20191111 import RunPreTrainServiceRequest
/**
* 阿里云賬號(hào)AccessKey擁有所有API的訪問(wèn)權(quán)限,風(fēng)險(xiǎn)很高。強(qiáng)烈建議您創(chuàng)建并使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維,請(qǐng)登錄RAM控制臺(tái)創(chuàng)建RAM用戶。
* 此處以把AccessKey和AccessKeySecret保存在環(huán)境變量為例說(shuō)明。您也可以根據(jù)業(yè)務(wù)需要,保存到配置文件里。
* 強(qiáng)烈建議不要把AccessKey和AccessKeySecret保存到代碼里,會(huì)存在密鑰泄漏風(fēng)險(xiǎn)
*/
access_key_id = os.environ['NLP_AK_ENV']
access_key_secret = os.environ['NLP_SK_ENV']
# Initialize AcsClient instance
client = AcsClient(
access_key_id,
access_key_secret,
"cn-hangzhou"
);
reqid = 'reqid'
text = '案情描述'
input_params = {
"reqId": reqid,
"text": text
}
# Initialize a request and set parameters
request = RunPreTrainServiceRequest.RunPreTrainServiceRequest()
request.set_ServiceName('convictionSentencingService')
request.set_PredictContent(json.dumps(input_params))
# Print response
response = client.do_action_with_exception(request)
resp_obj = json.loads(response)
predict_result = json.loads(resp_obj['PredictResult'])
print(json.dumps(predict_result['data']))
PredictContent內(nèi)容示例
PredictContent參數(shù)為JSON字符串傳入,JSON字符串包含內(nèi)容參考下面舉例。
{
"reqId": "123445aad",
"text": "公訴機(jī)關(guān)指控吸毒人員唐某于2013年3月8日15時(shí)許,與一名男子(另案處理)通過(guò)電話聯(lián)系并約定在廣州市南沙區(qū)金嶺北路的漢明酒店303房?jī)?nèi)進(jìn)行毒品交易。當(dāng)天17時(shí)許,被告人尹某受上述男子的指派到上述地點(diǎn)以人民幣300元的價(jià)格將1小包透明晶體販賣給吸毒人員溫某鵬后被公安機(jī)關(guān)人贓并獲,公安人員還從被告人尹某身上繳獲錫紙2條。被告人尹某歸案后向公安機(jī)關(guān)如實(shí)供述其犯罪事實(shí)。經(jīng)鑒定,被繳獲的1小包透明晶體凈重0.4克,檢出甲基苯丙胺成分。公安機(jī)關(guān)對(duì)被告人尹某進(jìn)行甲基安非他命測(cè)定呈陽(yáng)性。公訴機(jī)關(guān)建議本院對(duì)被告人尹某在××至一年的幅度內(nèi)量刑,并處罰金。"
}
入?yún)⒄f(shuō)明
入?yún)?/p> | 類型 | 說(shuō)明 |
reqId | 字符串 | 請(qǐng)求ID |
text | 字符串 | 案情描述 |
PredictResult內(nèi)容示例
PredictResult是JSON字符串,需要反序列化之后進(jìn)行解析,具體結(jié)構(gòu)如下示例。
{
"reqId": "123445aad",
"penalty": "有期徒刑7個(gè)月",
"articles": [{
"lawText": "第三百四十七條【走私、販賣、運(yùn)輸、制造毒品罪】走私、販賣、運(yùn)輸、制造毒品,無(wú)論數(shù)量多少,都應(yīng)當(dāng)追究刑事責(zé)任,予以刑事處罰。走私、販賣、運(yùn)輸、制造毒品,有下列情形之一的,處十五年有期徒刑、無(wú)期徒刑或者死刑,并處沒(méi)收財(cái)產(chǎn):(一)走私、販賣、運(yùn)輸、制造鴉片一千克以上、海洛因或者甲基苯丙胺五十克以上或者其他毒品數(shù)量大的;(二)走私、販賣、運(yùn)輸、制造毒品集團(tuán)的首要分子;(三)武裝掩護(hù)走私、販賣、運(yùn)輸、制造毒品的;(四)以暴力抗拒檢查、拘留、逮捕,情節(jié)嚴(yán)重的;(五)參與有組織的國(guó)際販毒活動(dòng)的。走私、販賣、運(yùn)輸、制造鴉片二百克以上不滿一千克、海洛因或者甲基苯丙胺十克以上不滿五十克或者其他毒品數(shù)量較大的,處七年以上有期徒刑,并處罰金。走私、販賣、運(yùn)輸、制造鴉片不滿二百克、海洛因或者甲基苯丙胺不滿十克或者其他少量毒品的,處三年以下有期徒刑、拘役或者管制,并處罰金;情節(jié)嚴(yán)重的,處三年以上七年以下有期徒刑,并處罰金。單位犯第二款、第三款、第四款罪的,對(duì)單位判處罰金,并對(duì)其直接負(fù)責(zé)的主管人員和其他直接責(zé)任人員,依照各該款的規(guī)定處罰。利用、教唆未成年人走私、販賣、運(yùn)輸、制造毒品,或者向未成年人出售毒品的,從重處罰。對(duì)多次走私、販賣、運(yùn)輸、制造毒品,未經(jīng)處理的,毒品數(shù)量累計(jì)計(jì)算。",
"provisionName": "刑法第347條"
}], // 預(yù)測(cè)法條輸出
"accusation": ["走私、販賣、運(yùn)輸、制造毒品"],
"features": [{
"span": [207, 212],
"content": "甲基苯丙胺",
"type": "定罪要素",
"name": "毒品種類"
}, {
"span": [40, 122],
"content": "電話聯(lián)系并約定在廣州市南沙區(qū)金嶺北路的漢明酒店303房?jī)?nèi)進(jìn)行毒品交易。當(dāng)天17時(shí)許,被告人尹某受上述男子的指派到上述地點(diǎn)以人民幣300元的價(jià)格將1小包透明晶體販賣給",
"type": "定罪要素",
"name": "利用信息網(wǎng)絡(luò)販賣毒品"
}, {
"span": [151, 212],
"content": "身上繳獲錫紙2條。被告人尹某歸案后向公安機(jī)關(guān)如實(shí)供述其犯罪事實(shí)。經(jīng)鑒定,被繳獲的1小包透明晶體凈重0.4克,檢出甲基苯丙胺",
"type": "定罪要素",
"name": "攜帶毒品方式進(jìn)行運(yùn)輸"
}, {
"span": [151, 212],
"content": "身上繳獲錫紙2條。被告人尹某歸案后向公安機(jī)關(guān)如實(shí)供述其犯罪事實(shí)。經(jīng)鑒定,被繳獲的1小包透明晶體凈重0.4克,檢出甲基苯丙胺",
"type": "定罪要素",
"name": "從販毒人員住所|車輛等處查獲的毒品"
}, {
"span": [207, 212],
"content": "甲基苯丙胺",
"type": "量刑要素",
"name": "毒品種類"
}, {
"span": [198, 204],
"content": "凈重0.4克",
"type": "量刑要素",
"name": "毒品克數(shù)"
}, {
"span": [198, 204],
"content": "凈重0.4克",
"type": "量刑要素",
"name": "毒品克數(shù)"
}, {
"span": [199, 204],
"content": "重0.4克",
"type": "量刑要素",
"name": "毒品克數(shù)"
}]
}
出參說(shuō)明
出參 | 類型 | 說(shuō)明 |
reqId | 字符串 | 請(qǐng)求id |
penalty | 字符串 | 刑期預(yù)測(cè)結(jié)果 |
articles | 列表 | 建議法條結(jié)果 |
articles.lawText | 字符串 | 法條內(nèi)容 |
articles.provisionName | 字符串 | 法條名稱 |
accusation | 列表 | 罪名預(yù)測(cè)結(jié)果 |
features | 列表 | 要素結(jié)合 |
features.span | [start int, end int] | 案情描述中要素對(duì)應(yīng)的起始位置 |
features.content | 字符串 | 案情描述中要素對(duì)應(yīng)的文本內(nèi)容 |
features.type | 字符串 | 要素類型 |
features.name | 字符串 | 要素名稱 |