What is Agent Passport?

Ilse Moreau
Engineering
5 min read

TL;DR: Agent Passport gives each agent a stable identity that websites can recognize, so a well behaved agent can be told apart from anonymous traffic.
Most sites were built for two kinds of visitors: people and bots. Agents acting on behalf of a real user fall somewhere in between, and today they usually get treated like the second kind.
The problem with anonymous agents
When an agent shows up with no identity, a site has no way to know who sent it or what it is allowed to do. The safe choice for the site is to block it, add a challenge or slow it down.
A signed identity tied to your Roamkiln workspace.
A clear record of which user or team an agent is acting for.
A way for site owners to see and manage the agents that visit them.
How a passport is used
You issue a passport in the dashboard and attach it to a session with session.passport("support-agent"). Every request the session makes carries the signed identity with it.
Sites that read the passport can decide how to treat that agent. Sites that do not read it see a normal browser session, so nothing breaks for them.
Where this goes from here
Agent Passport is in early access. We are working with site owners on how passports should be checked, and the format may change as that work continues.
Talk to us about Roamkiln for your team
Get started with sessions for your agents
Get in touch
Keep reading

Introducing Vaults in Roamkiln Functions
Mara Velde & Jonah Price
Engineering

How to design long running browser tasks with Roamkiln
Theo Brandt, Nia Okafor & Lena Sato
Engineering

Roamkiln and Keystone: shared sign in for browser agents across every app your team uses
Roamkiln Team
Company

What is Kiln Script?
Mara Velde
Engineering
View all blog posts
