OAI Interactive Tutorial

Learn by doing

Step 1: Create Your Client

In OAI, clients (apps that connect to agents) have their own identity. Let's create one for your simulated app.

Your Client Manifest agent-identity.json

What's happening?

This manifest would be hosted at https://your-domain/.well-known/agent-identity.json. Agents fetch this to verify who's connecting to them. The type: "client" distinguishes your app from agents.

Verify you're human to continue

Step 2: Choose an Agent

Now let's connect to an agent. We have two agents with different authorization policies.

A

Acme Open

@acme-open

Accepts connections from any verified client. Great for public services.

Open Policy
A

Acme

@acme

Only accepts pre-approved clients. You'll need to request access first.

Allowlist Policy

Authorization Policies

Agents can control which clients connect to them. Open accepts anyone verified. Allowlist requires explicit approval. Try both to see the difference!

Step 3: Interact with the Agent

Connected! Now you can chat with the agent.

...
Connecting... Establishing connection to agent