Agent Profile

Working Draft0.0.1

An open standard for portable agent profiles.

Agent Profile is an open, vendor-neutral standard for a portable directory package describing one durable logical AI agent. A profile can name an owner, list contact methods, associate external identifiers, and bundle Agent Plugins. Those values are metadata claims, not credentials or proof.

Read the specification (external)View on GitHub (external)
profile.json
{
  "$schema": "https://agentprofile.org/schemas/0.0.1/profile.schema.json",
  "id": "urn:uuid:7a18f6ba-22c8-4d4f-a60e-1e2e8fe4dc44",
  "name": "Research Librarian",
  "version": "0.1.0",
  "description": "Organizes public research for Example Cooperative.",
  "owner": {
    "name": "Example Cooperative",
    "email": "agents@example.com",
    "url": "https://example.com/"
  },
  "contacts": [
    "mailto:research@example.com",
    "sms:+12025550123",
    "tel:+12025550123"
  ],
  "identifiers": [
    {
      "type": "issuer-subject",
      "issuer": "https://identity.example.com",
      "subject": "agent_01EXAMPLE"
    },
    {
      "type": "uri",
      "value": "spiffe://example.com/agents/research"
    }
  ]
}

Profile anatomy

What a profile describes

  1. Identity

    A permanent absolute URI identifies one durable logical agent, not a process, installation, runtime, or session.

  2. Owner

    Optional public metadata names the human or organization responsible for the agent. It does not grant authority.

  3. Contacts

    Optional URI values can describe email, SMS, telephone, or other ways to contact the agent.

  4. External identifiers

    Optional issuer-and-subject or URI identifiers associate the profile with identities used by other systems.

  5. Agent Plugins

    A profile package may include portable capabilities under its plugins directory. Agent Plugins remains authoritative for each plugin's contents.

Participate

Open development

Agent Profile 0.0.1 is a working draft developed in public. Read the specification, inspect the schema and conformance fixtures, or open an issue on GitHub.

Influences

Agent Plugins (external)
Portable packages for agent capabilities.
Model Context Protocol (external)
Interoperable context and tool connections.
Token Canopy (external)
Infrastructure for accountable agent operation.