Skip to main content

快速开始

选择 API、MCP 或 Agent,通过案例检索、法规检索或法律咨询示例完成首次调用

先准备个人 API Key,再选择下方的 API、MCP 或 Agent 示例完成首次调用。选择符合你接入场景的一种即可。
接入方式适合的场景本页示例
API在自己的应用中调用接口,处理结构化结果用 curl 检索劳动争议案例
MCP让 AI 客户端发现并调用法律工具配置法规检索服务,在对话中检索法规
Agent提交一个法律任务,接收执行过程和结果调用法律咨询专家,接收 SSE 流式响应

准备 API Key

  1. 在法睿切换到个人身份,点击左下角头像,在菜单中选择「API Key」。
  2. 点击「创建 API Key」,填写便于识别的名称,选择过期时间并创建。
  3. 立即复制并妥善保存完整密钥。已有个人 API Key 的话,也可以使用已关联且启用的 Key。
完整密钥仅在创建成功后显示一次,关闭后无法再次查看。请勿将密钥提交到公开仓库或发送给他人。界面操作和密钥管理见接入认证。
请使用目标环境中已启用、具有对应能力访问权限的 API Key。服务地址与 API 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-TypeJSON 请求体使用 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为例,检索「劳动争议」并读取第一页结果。
1

设置环境变量

将 <API_KEY> 替换为个人 API Key 原文,在终端设置密钥和服务基础地址。后续命令在同一个终端运行:
export FARUI_API_KEY='<API_KEY>'
export FARUI_API_BASE_URL='https://farui.cn-beijing.aliyuncs.com'
2

发送检索请求

curl --request POST \
  --url "${FARUI_API_BASE_URL%/}/open/v1/case/search" \
  --header "Authorization: ${FARUI_API_KEY}" \
  --header "x-acs-date: $(date -u '+%Y-%m-%dT%H:%M:%SZ')" \
  --header 'x-acs-version: 2026-10-19' \
  --header 'Content-Type: application/json' \
  --data '{"query":"劳动争议","pageParam":{"pageNumber":1,"pageSize":10}}'
检索词和分页参数放在 JSON 请求体中。命令每次发送请求时生成当前 x-acs-date。
3

检查检索结果

先检查 HTTP 状态,再读取响应体。success 为 true 时,当前页结果在 data.records,总条数在 data.total;records 为空数组且 total 为 0 表示检索成功但没有匹配结果。success 为 false 时,检查 code 和 message。完整响应示例、筛选条件和翻页规则见案例检索 API。

查看调用记录与用量

完成首次调用后,可在「开放能力 → 调用记录」查看调用情况,在头像菜单的「积分用量」查看扣减记录。详见计费与用量。 遇到错误时,保留请求标识和调用时间,按错误与排障检查 API Key、目标环境、请求头、权限与响应内容。

继续接入