选择 API、MCP 或 Agent,通过案例检索、法规检索或法律咨询示例完成首次调用
先准备个人 API Key,再选择下方的 API、MCP 或 Agent 示例完成首次调用。选择符合你接入场景的一种即可。
调用 API 或 Agent(A2A)时,携带以下 HTTP 请求头:
在 MCP 客户端中配置
切换标签查看对应示例。API 和 Agent 示例使用 macOS/Linux 终端;MCP 示例使用支持 Streamable HTTP 和自定义请求头的 AI 客户端。
完成首次调用后,可在「开放能力 → 调用记录」查看调用情况,在头像菜单的「积分用量」查看扣减记录。详见计费与用量。
遇到错误时,保留请求标识和调用时间,按错误与排障检查 API Key、目标环境、请求头、权限与响应内容。
| 接入方式 | 适合的场景 | 本页示例 |
|---|---|---|
| API | 在自己的应用中调用接口,处理结构化结果 | 用 curl 检索劳动争议案例 |
| MCP | 让 AI 客户端发现并调用法律工具 | 配置法规检索服务,在对话中检索法规 |
| Agent | 提交一个法律任务,接收执行过程和结果 | 调用法律咨询专家,接收 SSE 流式响应 |
准备 API Key
- 在法睿切换到个人身份,点击左下角头像,在菜单中选择「API Key」。
- 点击「创建 API Key」,填写便于识别的名称,选择过期时间并创建。
- 立即复制并妥善保存完整密钥。已有个人 API Key 的话,也可以使用已关联且启用的 Key。
配置请求头
API 与 Agent
调用 API 或 Agent(A2A)时,携带以下 HTTP 请求头:
| 请求头 | 填写说明 |
|---|---|
Authorization | 填写 API Key 原文,省略 Bearer 前缀 |
x-acs-date | 填写发起请求时的 UTC 时间,使用 ISO 8601 格式,精确到秒并以 Z 结尾,例如 2026-11-10T08:00:00Z。每次请求和重试都重新生成 |
x-acs-version | 填写 2026-10-19 |
Content-Type | JSON 请求体使用 application/json |
x-acs-date 示例仅用于说明格式。macOS/Linux 可使用 date -u '+%Y-%m-%dT%H:%M:%SZ' 生成当前时间,不要使用固定日期。tenantId 和 userId 由服务端根据 API Key 补充,调用方禁止在请求中传入这两个字段。
MCP
在 MCP 客户端中配置 Authorization 为个人 API Key 原文(省略 Bearer 前缀),并配置 x-acs-version 为 2026-10-19。自行发送 HTTP 请求时,还需按 MCP 接入指南配置请求体格式和协议头。
完成首次调用
切换标签查看对应示例。API 和 Agent 示例使用 macOS/Linux 终端;MCP 示例使用支持 Streamable HTTP 和自定义请求头的 AI 客户端。
- API
- MCP
- Agent
以案例检索 API为例,检索「劳动争议」并读取第一页结果。检索词和分页参数放在 JSON 请求体中。命令每次发送请求时生成当前
1
设置环境变量
将
<API_KEY> 替换为个人 API Key 原文,在终端设置密钥和服务基础地址。后续命令在同一个终端运行:2
发送检索请求
x-acs-date。3
检查检索结果
先检查 HTTP 状态,再读取响应体。
success 为 true 时,当前页结果在 data.records,总条数在 data.total;records 为空数组且 total 为 0 表示检索成功但没有匹配结果。success 为 false 时,检查 code 和 message。完整响应示例、筛选条件和翻页规则见案例检索 API。