クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

エージェントどうしが話す: A2A プロトコル

このレッスンのあとで: Agent Card を読み、そのエージェントにタスクを送るかどうかを決められる。

70分のレッスンコマンド13件AI コーディングエージェントのラボ:opencode でコードを説明・修正し、その結果を確かめる

別のチームのエージェントが必要

あなたのエージェントのチームが、学校の説明会を準備しています。空き教室を知る必要があり、別の部署がすでに時間割に詳しいエージェントを動かしています。

そのコードを読み込むことはできず、中身も見えません。何ができるかを尋ね、仕事を渡すための、決まったやり方が必要です。

このレッスンのゴール

メモ

Agent Card を読み、そのエージェントにタスクを送るかどうかを決められる。

キーワード

ことばいみれい
A2Aエージェントが別のエージェントにタスクを渡すための公開のプロトコル
Agent Cardエージェントが自分を説明する JSON ファイル
スキルカードに書かれた、エージェントができる1つの仕事
タスクエージェントに送る1つの仕事で、状態を持つもの
成果物終わったタスクが返すもの
JSON-RPCJSON を送ってメソッドを呼ぶやり方"method": "message/send"

学生が入力するセルは、このプレビューでは空白です。

A2A はエージェントどうしの共通の言葉

Google は 2025 年に Agent2Agent プロトコルを発表し、その後 Linux Foundation に移しました。公開されているので、どのチームもこれに合わせて作れます。

使うのは普通の HTTP です。クライアントのエージェントは JSON-RPC 2.0 でタスクを送り、相手のエージェントはサーバー送信イベントで経過を返せます。どちらも、相手のコードやプロンプトやツールは見えません。

Agent Card はできることを示す

A2A のエージェントは、サーバーの決まった場所 /.well-known/agent-card.json にカードを置きます。カードには名前とバージョン、タスクの送り先、タグ付きのスキルの一覧があります。

呼び出し側がどう身元を示すべきかも書いてあります。クライアントは、何かを送る前にカードを読みます。

偽の時間割エージェントを書く(1)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const http = require(\"http\");' 'const CARD = {' '  protocolVersion: \"0.3.0\",' '  name: \"時間割エージェント\",' '  description: \"学校の時間割についての質問に答えます。\",' '  url: \"http://localhost:4100/a2a\",' '  version: \"1.0.0\",' '  capabilities: { streaming: true },' '  defaultInputModes: [\"text/plain\"],' '  defaultOutputModes: [\"text/plain\"],' '  securitySchemes: { classKey: { type: \"http\", scheme: \"bearer\" } },' '  security: [{ classKey: [] }],' '  skills: [' '    { id: \"free-rooms\", name: \"空き教室\", description: \"指定の時刻に空いている教室を挙げます。\", tags: [\"教室\", \"時間割\"] },' '    { id: \"clashes\", name: \"重複\", description: \"同じ教室に入った2つの授業を探します。\", tags: [\"時間割\"] },' '  ],' '};' > agent.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

偽の時間割エージェントを書く(2)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const ANSWER = \"月曜14時の空き教室: B12 と C3。\";' 'function task(id, state, text) {' '  const t = { kind: \"task\", id: id, contextId: \"ctx-1\", status: { state: state } };' '  if (text) t.artifacts = [{ artifactId: \"a-1\", name: \"answer\", parts: [{ kind: \"text\", text: text }] }];' '  return t;' '}' 'function said(call) { return call.params.message.parts[0].text; }' 'function send(call) {' '  if (said(call).includes(\"重複\")) return task(\"task-9\", \"failed\", \"\");' '  return task(\"task-7\", \"completed\", ANSWER);' '}' >> agent.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

偽の時間割エージェントを書く(3)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'function stream(call, res) {' '  res.setHeader(\"content-type\", \"text/event-stream\");' '  const events = [' '    { kind: \"status-update\", taskId: \"task-8\", status: { state: \"submitted\" }, final: false },' '    { kind: \"status-update\", taskId: \"task-8\", status: { state: \"working\" }, final: false },' '    { kind: \"artifact-update\", taskId: \"task-8\", artifact: { artifactId: \"a-1\", parts: [{ kind: \"text\", text: ANSWER }] } },' '    { kind: \"status-update\", taskId: \"task-8\", status: { state: \"completed\" }, final: true },' '  ];' '  events.forEach(function (e) {' '    res.write(\"data: \" + JSON.stringify({ jsonrpc: \"2.0\", id: call.id, result: e }) + \"\n\n\");' '  });' '  res.end();' '}' >> agent.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

偽の時間割エージェントを書く(4)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'function rpc(res, body) {' '  const call = JSON.parse(body);' '  if (call.method === \"message/stream\") return stream(call, res);' '  res.setHeader(\"content-type\", \"application/json\");' '  const out = { jsonrpc: \"2.0\", id: call.id };' '  if (call.method === \"message/send\") out.result = send(call);' '  else out.error = { code: -32601, message: \"Method not found\" };' '  res.end(JSON.stringify(out));' '}' >> agent.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

偽の時間割エージェントを書く(5)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'function start(port) {' '  const server = http.createServer(function (req, res) {' '    if (req.method === \"GET\" && req.url === \"/.well-known/agent-card.json\") {' '      res.setHeader(\"content-type\", \"application/json\");' '      return res.end(JSON.stringify(CARD));' '    }' '    if ((req.headers.authorization === \"Bearer class-key\") === false) {' '      res.statusCode = 401;' '      return res.end();' '    }' '    let body = \"\";' '    req.on(\"data\", function (c) { body += c; });' '    req.on(\"end\", function () { rpc(res, body); });' '  });' '  return new Promise(function (ok) { server.listen(port, function () { ok(server); }); });' '}' 'module.exports = { start };' >> agent.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

カードを読むスクリプトを書く

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const { start } = require(\"./agent\");' 'async function main() {' '  const server = await start(4100);' '  const res = await fetch(\"http://localhost:4100/.well-known/agent-card.json\");' '  const card = await res.json();' '  console.log(\"名前: \" + card.name + \"、バージョン \" + card.version);' '  console.log(\"タスクの送り先: \" + card.url);' '  console.log(\"更新を逐次送るか: \" + card.capabilities.streaming);' '  card.skills.forEach(function (s) {' '    console.log(\"スキル \" + s.id + \": \" + s.description + \" タグ: \" + s.tags.join(\"、\"));' '  });' '  const schemes = Object.values(card.securitySchemes).map(function (s) { return s.scheme; });' '  console.log(\"呼び出し側に求めるもの: \" + schemes.join(\"、\"));' '  server.close();' '}' 'main();' > card.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

Agent Card を取ってきて読む

コマンド
docker exec -w /home/node/project agent node card.js

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

タスクは状態を順に進む

クライアントは message/send でメッセージを送ります。エージェントはタスクで答えます。タスクには id と状態があり、終われば成果物が付きます。

タスクは submitted で始まり、working になり、追加の情報がほしいときは input-required で止まります。最後は completed、failed、canceled、rejected のどれかです。message/stream では変化のたびにイベントが届き、最後のものには final の印が付きます。

タスクを送るスクリプトを書く(1)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const { start } = require(\"./agent\");' 'function call(method, text, key) {' '  const headers = { \"content-type\": \"application/json\" };' '  if (key) headers.authorization = \"Bearer \" + key;' '  const message = { role: \"user\", messageId: \"m-1\", parts: [{ kind: \"text\", text: text }] };' '  const body = { jsonrpc: \"2.0\", id: 1, method: method, params: { message: message } };' '  return fetch(\"http://localhost:4100/a2a\", { method: \"POST\", headers: headers, body: JSON.stringify(body) });' '}' 'function line(e) {' '  const what = e.status ? e.status.state : \"成果物 \" + e.artifact.parts[0].text;' '  return \"イベント \" + e.kind + \": \" + what + (e.final ? \" (final)\" : \"\");' '}' > task.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

タスクを送るスクリプトを書く(2)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'async function main() {' '  const server = await start(4100);' '  const sent = await (await call(\"message/send\", \"月曜14時に空いている教室はどこですか。\", \"class-key\")).json();' '  console.log(\"タスク \" + sent.result.id + \": \" + sent.result.status.state);' '  console.log(\"成果物: \" + sent.result.artifacts[0].parts[0].text);' '  const text = await (await call(\"message/stream\", \"同じ質問を、逐次で。\", \"class-key\")).text();' '  text.split(\"\n\n\").filter(Boolean).forEach(function (chunk) {' '    console.log(line(JSON.parse(chunk.slice(6)).result));' '  });' '  const odd = await (await call(\"tasks/sing\", \"こんにちは\", \"class-key\")).json();' '  console.log(\"知らないメソッド: エラー \" + odd.error.code);' '  console.log(\"鍵なし: HTTP \" + (await call(\"message/send\", \"こんにちは\", \"\")).status);' '  server.close();' '}' 'main();' >> task.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

タスクを送り、次に逐次で受け取る

コマンド
docker exec -w /home/node/project agent node task.js

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

Run の表示

行起きたこと
タスク task-7: completedmessage/send は終わるまで待った
成果物: 月曜14時の空き教室: B12 と C3。タスクが返した答え
イベント status-update: submitted、続いて workingストリームが状態ごとに知らせる
イベント artifact-update: 成果物 月曜14時の…答えがストリームの中で届く
イベント status-update: completed (final)これ以上は何も来ない
知らないメソッド: エラー -32601存在しないメソッドを表す JSON-RPC のコード
鍵なし: HTTP 401トークンのない呼び出しを、エージェントが断った

学生が入力するセルは、このプレビューでは空白です。

A2A と MCP は別の仕事をする

MCPA2A
つなぐもの1つのエージェントとツールやデータエージェントと別のエージェント
相手側言われたことを1歩ずつ行う自分で計画し、時間がかかることもある
見えるものツールの呼び出しと結果のすべてタスクと、その状態と成果物だけ
組み合わせ相手のエージェントが中で MCP を使うこともあるあなたのエージェントは仕事をまるごと任せる

学生が入力するセルは、このプレビューでは空白です。

カードは名乗りであって、証拠ではない

どんなスキルを名乗るカードでも、誰でも公開できます。だから信頼するホストの一覧を持ち、そこにないホストは呼びません。

次に、答えがわかっているタスクで、名乗られたスキルを試します。何を送るかはカードのセキュリティ方式に書いてあります。それでも相手のエージェントは、タスクのたびに、この呼び出し側が頼んでよいかを確かめる必要があります。

信頼の確認を書く(1)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const { start } = require(\"./agent\");' 'const ALLOWED = [\"localhost:4100\"];' 'const OTHER = { name: \"親切なエージェント\", url: \"https://agents.example.net/a2a\", skills: [{ id: \"anything\" }] };' 'function hostOf(url) { return url.split(\"/\")[2]; }' 'async function test(card, text) {' '  const message = { role: \"user\", messageId: \"m-2\", parts: [{ kind: \"text\", text: text }] };' '  const body = { jsonrpc: \"2.0\", id: 2, method: \"message/send\", params: { message: message } };' '  const headers = { \"content-type\": \"application/json\", authorization: \"Bearer class-key\" };' '  const res = await fetch(card.url, { method: \"POST\", headers: headers, body: JSON.stringify(body) });' '  return (await res.json()).result.status.state;' '}' > trust.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

信頼の確認を書く(2)

コマンド
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'async function main() {' '  const server = await start(4100);' '  const ours = await (await fetch(\"http://localhost:4100/.well-known/agent-card.json\")).json();' '  [ours, OTHER].forEach(function (c) {' '    const known = ALLOWED.includes(hostOf(c.url));' '    console.log(c.name + \" (\" + hostOf(c.url) + \"): \" + (known ? \"許可リストにある\" : \"許可リストにないので呼ばない\"));' '  });' '  console.log(\"カードが名乗るスキル: \" + ours.skills.map(function (s) { return s.id; }).join(\"、\"));' '  console.log(\"free-rooms の試験: \" + await test(ours, \"月曜14時に空いている教室はどこですか。\"));' '  console.log(\"clashes の試験: \" + await test(ours, \"B12 教室の重複を探してください。\"));' '  server.close();' '}' 'main();' >> trust.js"

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

カードが名乗るスキルを試す

コマンド
docker exec -w /home/node/project agent node trust.js

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

よくある間違い

注意

Agent Card を、エージェントが何をできるかの証拠だと考える人が多くいます。カードは、エージェントが自分で書いた説明です。ここでもカードは clashes を名乗っていますが、重複を探すタスクは failed で返ってきます。スキルを信じるのは、答えのわかった試験に通ってから、しかも自分で選んだホストに限ります。

このラボとソースについて: AI コーディングエージェントのラボ:opencode でコードを説明・修正し、その結果を確かめる

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。