Skip to content
Peritus
Agents

For agents

Six files tell an agent what the product is, how to call it, and when not to. None needs a key.

Discovery kit

How to call it

From GET /skill.md

  1. 1If you have a question in words about sanctions status, a travel advisory level, a tariff, or changes since a date, call ask. Read plan to see how it was understood.
  2. 2If you have a name, call resolve_entity first. For a person, company, vessel, or aircraft, a name alone never selects one entity: pass an identifier (an IMO number, a list's own ID) as a discriminator, or choose a candidate yourself.
  3. 3With entity IDs, call fetch_facts for the fields you need, now or with as_of (valid_at, known_at).
  4. 4Keep the response_id of any answer you rely on. Later, compare_response says what changed and why; get_changes follows the change feed.

When not to use it

  • For opinions, forecasts, scores, trading signals, or adviceThe product states what official sources state, nothing more.
  • As the only basis for a legal or compliance decisionA name match is a candidate, not a determination, and a negative result covers only the lists and versions it names.
  • For a question outside the catalogIt abstains NOT_COVERED rather than guess. The catalog covers sanctions lists (OFAC, UK, EU) and travel advisories (US State Department, UK FCDO) where their sources are active.
  • When you need data newer than the publishers' own release cadenceEvery item says when it was last verified, and strict mode abstains STALE instead of serving old data as fresh.