An OCaml library that runs agentic applications as A2AServers following the Agent2Agent (A2A) Protocol.
A basic example:
let () =
let client =
A2a.Client.create
~base_url:"https://agent.example.com"
()
in
let message =
A2a.Request.Message.create
~role:A2a.Types.User
~text:"What is the weather in London?"
()
in
match A2a.Client.send_message client message with
| A2a.Types.Message message ->
Printf.printf "Agent response: %s\n" (A2a.Types.Message.text message)
| A2a.Types.Task task ->
Printf.printf "Task created: %s\n" task.idA message may contain multiple parts. For a simple text message:
let message =
A2a.Request.Message.create
~role:A2a.Types.User
~text:"Analyse this document and summarise its contents."
()The message may then be sent through the client:
let response =
A2a.Client.send_message client messageAn agent may respond immediately with a message:
match response with
| A2a.Types.Message message ->
Printf.printf
"Agent replied: %s\n"
(A2a.Types.Message.text message)
| A2a.Types.Task task ->
Printf.printf
"The agent created task %s\n"
task.idA Task represents a unit of work that may continue beyond the initial request; it's monitored and retrieved through the client.
The client is configured with the A2A agent endpoint:
let client =
A2a.Client.create
~base_url:"https://agent.example.com"
()An application may construct a client with an authentication token:
let client =
A2a.Client.create
~base_url:"https://agent.example.com"
~bearer_token:"..."
()When an agent performs a long-running operation, send_message may return a task:
match A2a.Client.send_message client message with
| A2a.Types.Message message ->
Printf.printf
"Agent replied immediately: %s\n"
(A2a.Types.Message.text message)
| A2a.Types.Task task ->
Printf.printf
"Task ID: %s\n"
task.id;
Printf.printf
"Context ID: %s\n"
task.context_idThe task may then be queried:
let task =
A2a.Client.get_task
client
~task_id:task_id
()The application may inspect the current status of it:
match task.status.state with
| A2a.Types.Working ->
print_endline "The agent is still working"
| A2a.Types.Completed ->
print_endline "The task has completed"
| A2a.Types.Failed ->
print_endline "The task failed"
| _ ->
print_endline "The task has another state"For agents that support streaming:
A2a.Client.send_message_stream
client
message
~on_event:(function
| A2a.Types.Task_status_update event ->
Printf.printf
"Task state: %s\n"
(A2a.Types.Task_state.to_string event.status.state)
| A2a.Types.Task_artifact_update event ->
Printf.printf
"Artifact: %s\n"
event.artifact.artifact_id)An application which implements its own transport may need to construct a JSON-RPC request directly:
let request =
A2a.Jsonrpc.send_message_request
(A2a.Jsonrpc.String_id "request-1")
paramsand serialise it:
let json =
A2a.Jsonrpc.request_to_json requestAlex Maslakoff
Apache-2.0.