agent-evidence-vocabulary

agent-evidence-vocabulary

A closed, versioned vocabulary for claims about an agent's execution: what it attempted, what the system beneath it observed or refused, how directly and from what vantage the claim was obtained, and how much of a population the claim covers.

It's for anyone who writes a predicate, a verifier or an evidence format for agents and needs each term to mean one thing across vendors, including teams who want to map their own fields onto it.

Install the Python package: pip install agent-evidence-vocabulary==0.6.0.

Verified by Probity (github.com/probityai/probity). The probityai command line is planned, not yet released: uv add probityai, then pip install probityai.

Quick start

Pin the registry at a release and check its digest:

curl -fsSLO https://raw.githubusercontent.com/probityai/agent-evidence/agent-evidence-vocabulary-v0.6.0/packages/vocabulary/vocabulary.yaml
echo "4a5fdc8397c2fd82ee5795f50d2ad00203dd8d5a122bf77c5d0d0edb67d35760  vocabulary.yaml" | sha256sum -c

Then read a term:

pip install PyYAML==6.0.3
python3 -c 'import yaml; v = yaml.safe_load(open("vocabulary.yaml")); print(v["evidence_dimensions"]["observation_vantage"]["values"])'

It prints ['substrate', 'artifact']. Every term carries a definition, its allowed values and a lifecycle status.

To map your own system's fields onto the vocabulary, copy crosswalk/TEMPLATE.yaml and run python3 scripts/validate_crosswalks.py before opening a pull request.

Status

Release v0.6.0, tagged October 17, 2026. It adds the done_verification section, eight proposed terms. The registry file is CC0-1.0, and the rest of the repository is Apache-2.0. Every term starts as proposed and is promoted only when an independent system emits it; the rules are in GOVERNANCE.md. The first crosswalk came from an independent implementation of the Adversarial Execution Evidence predicate, in pull request 2.

Documentation