別のチームのエージェントが必要
あなたのエージェントのチームが、学校の説明会を準備しています。空き教室を知る必要があり、別の部署がすでに時間割に詳しいエージェントを動かしています。
そのコードを読み込むことはできず、中身も見えません。何ができるかを尋ね、仕事を渡すための、決まったやり方が必要です。
このレッスンのゴール
メモ
Agent Card を読み、そのエージェントにタスクを送るかどうかを決められる。
キーワード
| ことば | いみ | れい |
|---|---|---|
| A2A | エージェントが別のエージェントにタスクを渡すための公開のプロトコル | |
| Agent Card | エージェントが自分を説明する JSON ファイル | |
| スキル | カードに書かれた、エージェントができる1つの仕事 | |
| タスク | エージェントに送る1つの仕事で、状態を持つもの | |
| 成果物 | 終わったタスクが返すもの | |
| JSON-RPC | JSON を送ってメソッドを呼ぶやり方 | "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: completed | message/send は終わるまで待った |
| 成果物: 月曜14時の空き教室: B12 と C3。 | タスクが返した答え |
| イベント status-update: submitted、続いて working | ストリームが状態ごとに知らせる |
| イベント artifact-update: 成果物 月曜14時の… | 答えがストリームの中で届く |
| イベント status-update: completed (final) | これ以上は何も来ない |
| 知らないメソッド: エラー -32601 | 存在しないメソッドを表す JSON-RPC のコード |
| 鍵なし: HTTP 401 | トークンのない呼び出しを、エージェントが断った |
学生が入力するセルは、このプレビューでは空白です。
A2A と MCP は別の仕事をする
| MCP | A2A | |
|---|---|---|
| つなぐもの | 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 で返ってきます。スキルを信じるのは、答えのわかった試験に通ってから、しかも自分で選んだホストに限ります。