a2a-messages-parts

A2A Messages and Parts

Before writing code

Fetch live docs:

1. Fetch https://a2a-protocol.org/latest/specification/ for the Message and Part schemas
2. Web-search site:github.com a2aproject A2A message parts TextPart FilePart DataPart for schema details
3. Web-search site:github.com a2aproject a2a-samples message for message construction examples
4. Fetch SDK docs for message builder classes and part types

Conceptual Architecture

What Messages Are

Messages are the communication units between agents in A2A. Each message belongs to a task and contains one or more Parts that carry the actual content. Messages have roles indicating direction.

Message Structure

• role — user (from client agent) or agent (from server agent)
• parts — Array of Part objects (the actual content)
• metadata — Optional key-value pairs for custom data

Three Part Types

TextPart

Plain text or markdown content.

• kind: "text"
• text: The text content string
• metadata: Optional key-value pairs

Use for: Natural language instructions, responses, explanations, formatted output.

FilePart

File content, either inline or by reference.

• kind: "file"
• file: Object containing either:
  • bytes: Base64-encoded file content + mimeType
  • uri: URL to the file + optional mimeType
• metadata: Optional key-value pairs

Use for: Images, documents, code files, generated files, binary data.

DataPart

Structured JSON data.

• kind: "data"
• data: Any valid JSON value (object, array, string, number, etc.)
• metadata: Optional key-value pairs

Use for: Structured results, API responses, configuration, machine-readable output.

Content Negotiation

Agents declare supported MIME types in their Agent Card:

• defaultInputModes — What the agent can receive
• defaultOutputModes — What the agent can produce

Clients can specify preferred output modes in the request:

• acceptedOutputModes — MIME types the client wants (in the configuration object)