Tilbake til guider

Agent Discovery (A2A)

Gjør det enkelt for AI-agenter å finne og forstå hva bedriften din tilbyr, basert på Google sin A2A-protokoll.

Hva er A2A-protokollen?

Agent2Agent (A2A) er en åpen protokoll initiert av Google Cloud som lar AI-agenter kommunisere og samarbeide på tvers av leverandører og teknologier. Den støttes av over 50 teknologipartnere inkludert Salesforce, Atlassian, SAP og PayPal.

Kjernen i A2A er Agent Card - en JSON-fil som ligger på /.well-known/agent.json. Dette er agentens "visittkort" som forteller andre agenter hva den kan gjøre.

Hvorfor bruke agent.json?

  • •Synlighet: AI-agenter kan automatisk oppdage og forstå tjenestene dine.
  • •Interoperabilitet: Standard format som fungerer på tvers av ulike AI-systemer.
  • •Fremtidssikring: Posisjonerer deg for en verden med flere autonome AI-agenter.
  • •Kontroll: Du bestemmer hva agenter kan se og gjøre med din tjeneste.

Minimalt eksempel

For de fleste nettsider er dette tilstrekkelig - en enkel beskrivelse av hvem du er og hva du tilbyr:

/.well-known/agent.jsonjson
{
  "schema_version": "1.0",
  "name": "Bedriftsnavn",
  "description": "Kort beskrivelse av hva bedriften tilbyr",
  "url": "https://example.com",
  "provider": {
    "organization": "Bedriftsnavn AS",
    "url": "https://example.com",
    "contact": "kontakt@example.com"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "main-service",
      "name": "Hovedtjeneste",
      "description": "Beskrivelse av hva tjenesten gjør"
    }
  ]
}

Komplett eksempel med API

Har du et API eller tjenester som agenter kan bruke? Da kan du utvide med autentisering og flere skills:

/.well-known/agent.jsonjson
{
  "schema_version": "1.0",
  "name": "Min Nettbutikk",
  "description": "Nettbutikk med elektronikk og gadgets",
  "url": "https://shop.example.com",
  "provider": {
    "organization": "Shop AS",
    "url": "https://shop.example.com",
    "contact": "support@shop.example.com"
  },
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": false
  },
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["text/plain", "application/json"],
  "skills": [
    {
      "id": "product-search",
      "name": "Produktsøk",
      "description": "Søk etter produkter i katalogen",
      "tags": ["søk", "produkter", "elektronikk"],
      "examples": [
        "Finn alle laptoper under 10000 kr",
        "Vis tilgjengelige hodetelefoner"
      ]
    },
    {
      "id": "order-status",
      "name": "Ordrestatus",
      "description": "Sjekk status på eksisterende ordre",
      "tags": ["ordre", "levering", "sporing"]
    }
  ],
  "authentication": {
    "schemes": ["Bearer"],
    "credentials": "See API documentation"
  },
  "supportsA2A": true,
  "documentation_url": "https://shop.example.com/api/docs",
  "updated_at": "2025-01-15"
}

A2A-felt forklart

provider påkrevd

Informasjon om organisasjonen som tilbyr tjenesten. Inkluderer navn, URL og kontaktinfo.

capabilities påkrevd

Tekniske egenskaper: streaming (støtter sanntidsrespons),pushNotifications (kan sende varsler). Sett til false for informasjonssider.

skills[] påkrevd

Liste over hva agenten/tjenesten kan gjøre. Hver skill har id,name, description, og valgfritt tags og examples.

authentication valgfritt

Hvis du har et API, beskriv autentiseringsmetode (Bearer, OAuth2, etc.). Utelat dette feltet hvis du ikke har API.

supportsA2A valgfritt

Sett til true hvis du har et A2A-kompatibelt endpoint. For informasjonssider, sett til false eller utelat feltet.

A2A vs andre protokoller

ProtokollFokusBruk
A2A (Google)Agent-til-agent kommunikasjonSamarbeid mellom AI-agenter
MCP (Anthropic)Verktøy og kontekstKoble én agent til verktøy
llms.txtInnholdsbeskrivelseHjelpe LLM-er forstå nettsider

Disse protokollene er komplementære - du kan (og bør) bruke flere samtidig.

Test din agent.json

Sjekk om nettsiden har agent.json og om den følger A2A-standarden

Se det i praksis

Denne nettsiden bruker agent.json. Vi har ikke et API, så vi bruker supportsA2A: false og beskriver innholdet vårt via skills:

Se vår agent.json

Neste steg

agent.json fungerer best sammen med andre AI-readiness tiltak:

llms.txt for innholdrobots.txt for crawlereSchema.org for struktur