orbbai_who_knows_them, orbbai_who_knows_someone_there — reads a few people off the record and answers in one call. A research run reads everyone around a person, or the people who matter at a company, scores every tie against your goal, and ranks them. It is the deep answer, and the one that costs.
The flow
Check what is held
orbbai_held lists what your account has already researched. If the subject is there, orbbai_routes_from_research reads it — immediately, and for free.Name the subject
For particular people,
orbbai_people_resolve turns names into handles. It returns candidates and never picks: a common name comes back as several people, and the choice is yours or your user’s.Plan
orbbai_plan with the goal in ask, and one of:handles— a person run, for particular people;company— who inside one company is worth going through;titleswith acountryorcities— a search for people nobody has named yet.
planId. Nothing has started. A plan missing something comes back with refused naming it — a goal nobody gave, a search that says nowhere — and a second call usually settles it.Agree and start
Put the price in front of whoever is paying, then
orbbai_run_start with the planId and nothing else — so what runs is exactly what was quoted. A different set of people is a different plan, at a new price.It answers at once, with the run id in the structured result. reused: true means a run for the same subject was already working, and you are attached to it.Poll
orbbai_run_status with the run id reports progress, then the findings. Runs take minutes — poll every minute or two rather than concluding early.orbbai_run_stop stops a run and keeps everything found so far. What was spent is not refunded.Read the routes
orbbai_routes_from_research ranks routes out of finished research against the goal you give it, with the reasoning. It requires ask — with nothing to rank against, it refuses rather than ordering by nothing.What it costs
Planning is free. Starting spends Research Tokens — the plan quotes the price, and that is what is charged. Typical ranges:
Orbb chooses the depth unless you pass
depth; leave it out unless your user asked. No single run can spend more than 600 tokens.
How long it takes
Making answers better: your own side
Orbb sees the public record. Who you can reach through — colleagues, investors, customers, former teammates — is the half only you hold.orbbai_ours_rememberrecords those people, up to a hundred a call, in your own words for the relationship ("design partner","board member"). Every later answer takes them into account, and routes through them rank first.- On the quick looks, pass
userIs(your user’s LinkedIn URL) anduserWorksAt(their employer). The answer then marks who is already reachable from your side. - When an answer carries an
outsideblock, it names what would sharpen it and which of your systems holds it. Bring what you find back inask.