A2A Protocol - BeforeQuery

Every project publishes an A2A (Agent-to-Agent) interface: a public AgentCard for discovery plus a JSON-RPC message/send endpoint so external agent systems can converse with your assistant.

Agent Card (public, no auth)

GET https://api.agents.beforequery.com/a2a/projects/:projectId/agent-card

Returns public AgentCard JSON describing the agent’s name, description, and capabilities.

Send a message (client-key auth)

POST https://api.agents.beforequery.com/a2a/projects/:projectId

JSON-RPC message/send — returns a completed task with a text artifact containing the grounded answer.

curl -X POST https://api.agents.beforequery.com/a2a/projects/proj_xxx \
  -H "X-Client-Key: bq_pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{ "kind": "text", "text": "What can you help me with?" }]
      }
    }
  }'

Using the agents SDK

import { BeforeQueryAgents } from "@beforequery/agents";

const client = new BeforeQueryAgents({ clientKey: "bq_pk_..." });

// Discovery — no auth required
const card = await client.getAgentCard("proj_xxx");
console.log(card.name, card.description, card.capabilities);

// Conversation
const result = await client.sendMessage("proj_xxx", "What can you help me with?");
console.log(result.output);

Error handling

import { A2AError } from "@beforequery/agents";

try {
  await client.sendMessage("proj_xxx", "hello");
} catch (err) {
  if (err instanceof A2AError) {
    console.error("A2A error:", err.code, err.message);
  }
}

A2A exchanges are recorded as a2a traces in observability. See Agents & Actions for building multi-agent graphs that A2A callers can invoke.