# Install the Bocha Jev skill

Install this skill when the user wants their agent to use Bocha Jev for classification, routing, rubric scoring, and true/false probability judgments. Installation adds a Markdown skill to the agent; it does not download model weights or start a service.

## Install

1. Identify the skill directory supported by the current agent and the user's requested project or personal scope. Use the agent's native installer if available. Do not guess a universal directory for all agents.
2. Fetch **https://jev.bocha.cn/install/bocha-jev/SKILL.md**. Check that the response is Markdown with YAML frontmatter containing `name: bocha-jev`, not an HTML page or an authentication error.
3. Save it as `bocha-jev/SKILL.md` within that directory. If the skill already exists, inspect it and preserve local changes before updating. Reload skill discovery or start a new agent session when required.

For an agent with shell access, after choosing its supported skill directory and checking for an existing installation:

```sh
: "${BOCHA_JEV_SKILLS_DIR:?Set this to your agent's supported skill directory}"
mkdir -p "$BOCHA_JEV_SKILLS_DIR/bocha-jev"
curl --fail --silent --show-error --location \
  https://jev.bocha.cn/install/bocha-jev/SKILL.md \
  --output "$BOCHA_JEV_SKILLS_DIR/bocha-jev/SKILL.md"
```

Read the saved file to verify its contents. If filesystem access or installable skills are unavailable, give the user the skill file and explain how to add it to their agent; do not claim a persistent installation.

## Configure access

Use a Bocha client API Key supplied through the agent's trusted environment or secret settings:

- Preferred variable: `BOCHA_JEV_API_KEY`.
- An existing `BOCHA_SEARCH_API_KEY` may be reused when it grants access to this service.
- API origin: `https://jev.bocha.cn`.
- Model: `bocha-jev-v1`.

Keep keys outside skill files, source control, browser code, and logs. `JEV_UPSTREAM_API_KEY` is an internal service credential, not the client key to configure here. If no client key is available, complete the file installation and state that API verification is pending credential configuration.

## Verify

When a client key is available, make one small request using the example in the installed skill. Check HTTP 200 and a matching typed answer under `answers`; `noul` must be a number in [0, 1]. Installation alone does not prove API access.

For 401, fix credentials rather than repeating the call. For 422, inspect the request and input limits. For 429, 503, or 529, follow `Retry-After` with bounded retries. Report the installed path, whether the agent recognizes the skill, and whether API verification succeeded or remains pending.

## Links

- Skill: https://jev.bocha.cn/install/bocha-jev/SKILL.md
- API documentation: https://bocha-ai.feishu.cn/wiki/PhrPwCrEaiCyyPkkDNecdfRSnHR
- Homepage and live demo: https://jev.bocha.cn/