检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
ource-path部分,并将请求方法写在一起。这是因为URI-scheme都是HTTPS,而Endpoint在同一个区域也相同,所以简洁起见将这两部分省略。 请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 GET:请求服务器返回指定资源。 PUT:请求服务器更新指定资源。
说明 200 OK 请求成功。 201 Created 请求成功,资源已创建。 204 No Content 请求成功,返回体无内容。 异常状态码 返回值 说明 400 Bad Request 请求错误。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。
公共请求参数 表1 公共请求消息头 名称 描述 是否必选 示例 Content-type 发送的实体的MIME类型。 是 application/json Content-Length 请求body长度,单位为Byte。 POST/PUT请求为可选, GET不包含 3495 X-Auth-Token
名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 query 是 String 用户搜索的语句。 最小长度:1 最大长度:512 limit
单击图谱名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 请求参数 无 响应参数 状态码: 200 表2 响应Body参数 参数 参数类型 描述 id String 实体ID。 label String
project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 text 否 String 输入语句,根据语句中的实体信息推荐相应知识。 说明: 请求参数中,“sources” 和“ text”必须有一个为非空。如
名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 text 是 String 用户输入文本,长度限制为1-50个字符。 最小长度:1 最大长度:50
状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响
进行处理。 状态码 错误码 错误信息 描述 处理措施 400 KGP.0001 请求体格式非法。 请求体格式非法。 检查请求体格式。 400 KGP.0002 请求参数错误。 请求参数错误。 检查请求体参数。 400 KGP.0003 资源重名。 资源重名。 修改资源名称。 400
名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 command 是 String 需要执行的gremlin查询语句,只能执行与查询功
scope的取值需要选择project,如下所示。 获取用户Token接口请求构造如下,您可以从接口的请求部分看到所需的请求参数及参数说明。获取Token消息头只需填写“Content-Type”。将消息体加入后的请求如下所示,加粗的斜体字段需要根据实际值填写,其中usernam用户名,domainnam
名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 query 是 String 用户的提问内容,中文英文及中英文标点符号,长度限制为1-50个字符。
调用说明 知识图谱服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 注册并登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 获取账号ID
获取项目ID 从控制台获取项目ID 在调用接口的时候,部分URI中需要填入项目编号,所以需要先在管理控制台上获取到项目编号。 项目编号获取步骤如下: 注册并登录管理控制台。 单击用户名,在下拉列表中选择“我的凭证”。 在“我的凭证”页面的项目列表中查看项目ID。 图1 查看项目ID
单击“预览图谱”,选择匹配方式: 选择“完全匹配”,输入“实体名称”,按回车进入图谱预览页面,预览该实体的知识图谱。 选择“模糊匹配”,输入实体名称部分字段,按回车进入图谱预览页面,预览实体名称含该字段的所有实体的知识图谱。 举例:输入实体名称“任霞”,按回车进入图谱预览页面,预览实体“任霞”的知识图谱。
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 知识图谱服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 知识图谱的终端节点 区域名称 区域 终端节点(Endpoint) 华北-北京四
仅创建图谱版本时,进行知识融合的图谱版本可进行验证操作。 配置知识融合后,如果存在被融合的实体,“版本验证”页面有随机采样的部分融合样例。如果不存在被融合的实体,“版本验证”页面就没有融合样例。 图2 版本验证 在“随机验证”页面,针对随机采样的部分融合样例,您如果认可融合的结果,单击,如果不认可,单击。
如何访问知识图谱 知识图谱服务提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application programming interface)管理方式。 管理控制台方式 KG服务提供了简洁易用的管理控制台,包含配置数据源、图谱本体、信息抽取、知识映射、
抽取结构化的信息。 在通过普通抽取方式进行信息抽取时,即用交互界面配置或用格式化编辑进行信息抽取时,需要配置字段抽取函数。配置字段抽取函数后,KG服务会根据所配置的字段抽取函数进行信息抽取,即从原始数据中抽取结构化的信息。更多详情请见配置信息抽取。 字段抽取函数说明 KG服务支持