AGENT 接入

把 Jev 接到 Agent

用 REST、远程 MCP 或可移植 Skills 传入精简业务字段。服务端组装成 Jev 的 state + questions。它不替代 Agent 主模型，也不生成长篇推理。

API 密钥预设实验场

1. 访问密钥

到密钥页创建个人密钥。MCP 和 REST 把它放进本机凭证库或 JEV_API_KEY。不要写进 Skill、项目文件或页面源码。网页实验场走登录会话，不必贴这把钥匙。

export JEV_API_KEY="your-jev-api-key"

2. 接入 MCP

无状态 Streamable HTTP，地址 /mcp。六个工具：jev_route_model、jev_guard_tool_call、jev_route_task、jev_check_research、jev_review_completion、jev_decide。

[mcp_servers.jev]
url = "http://www.jevai.org/mcp"
bearer_token_env_var = "JEV_API_KEY"
tool_timeout_sec = 30

3. 安装 Skills

安装总控 Skill 和五个专项 Skill。它们只说明何时调用、填哪些字段、结果怎么用，不会扩大权限。

for skill in jev jev-task-router jev-model-router \
  jev-tool-guard jev-research-guard jev-completion-review; do
  mkdir -p ".agents/skills/$skill"
  curl -fsSL "http://www.jevai.org/skills/$skill/SKILL.md" \
    -o ".agents/skills/$skill/SKILL.md"
done

4. REST 预设

本站网页走登录会话。MCP 和应用代码用个人密钥做 Bearer。返回 { code, message, data }。Agent 优先 MCP；应用代码优先预设；只有预设表达不了时才用原生 Decisions。

请求示例 /api/v1/decisions/tool-guard

{
  "tool": "issue_customer_refund",
  "action": "Refund USD 680 after a disputed duplicate charge",
  "arguments_summary": [
    "order_id=ord_7429",
    "amount_usd=680"
  ],
  "side_effects": [
    "Moves funds",
    "Changes the order payment state"
  ],
  "safeguards": [
    "Customer identity and duplicate charge verified"
  ],
  "policy": [
    "Refunds above USD 500 require human approval"
  ],
  "reversibility": "partially_reversible"
}

5. 原生协议

POST /api/v1/decisions 接收 model、state、questions。只接受 Jev 模型标识。不要走 /chat/completions。

使用原则