[{"data":1,"prerenderedAt":1340},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fguides\u002Fa2a":3,"doc-surround-\u002Fdocs\u002Fguides\u002Fa2a":1234,"doc-nav-zh":1242},{"id":4,"title":5,"body":6,"description":1225,"extension":1226,"meta":1227,"navigation":269,"order":1228,"path":1229,"section":1230,"seo":1231,"stem":1232,"__hash__":1233},"docs_zh\u002Fdocs\u002F02.guides\u002F20.a2a.md","A2A 连接与任务协作",{"type":7,"value":8,"toc":1217},"minimark",[9,13,17,22,25,45,65,80,83,118,125,129,140,177,235,245,281,284,288,295,304,333,352,356,366,484,515,537,735,738,742,749,891,914,1057,1093,1108,1111,1114,1195,1207,1213],[10,11,5],"h1",{"id":12},"a2a-连接与任务协作",[14,15,16],"p",{},"A2A 连接 Agent，MCP 连接工具。本指南描述灵犀指本地内核当前暴露的接口；它不是云端账户 API，也不保证兼容任意版本的第三方 A2A 客户端。注册远端 Agent、创建委派记录和实际远程执行是不同操作。",[18,19,21],"h2",{"id":20},"_1-启动和认证","1. 启动和认证",[14,23,24],{},"先启动 IDE／内核并登录，确认本地许可有效。内核默认监听回环地址；端口冲突时会选择其他端口，以实际配置或启动日志为准，不要直接使用文档中的示例端口。",[14,26,27,28,32,33,36,37,40,41,44],{},"全局配置目录由 ",[29,30,31],"code",{},"LINGXIZHI_HOME"," 决定，未指定时使用可执行文件同级 ",[29,34,35],{},"data","。其中 ",[29,38,39],{},"lxz.config.json"," 的 ",[29,42,43],{},"server.auth_token"," 是本地访问令牌，空值时内核会生成并写回。不要将配置、令牌或带认证头的命令输出上传到公开日志。",[14,46,47,48,50,51,54,55,58,59,61,62,64],{},"当前组合路由有三层检查：本地 ",[29,49,43],{},"、有效登录许可，以及 A2A 的 ",[29,52,53],{},"A2A_API_KEY","。两个令牌检查都读取同一个 ",[29,56,57],{},"Authorization: Bearer ...","，因此当前配置必须使 ",[29,60,53],{}," 等于本地 ",[29,63,43],{},"。在启动内核的进程环境中设置后重启；只给已经启动的进程外部设置环境变量不会生效。这个令牌也能访问本地其他受保护接口，只应交给可信客户端，不要通过公网暴露服务。",[14,66,67,68,71,72,75,76,79],{},"发现入口 ",[29,69,70],{},"\u002F.well-known\u002Fagent-card.json"," 公开；业务接口需要上述认证。",[29,73,74],{},"A2A_AUTH_ENABLED=false","／",[29,77,78],{},"0"," 是开发绕过选项，不是正常配置方法，且不会取消全局认证和许可检查。",[14,81,82],{},"下面变量由你替换，尖括号不是有效凭据。令牌从本机配置安全读取，勿将真实值提交进脚本仓库：",[84,85,90],"pre",{"className":86,"code":87,"language":88,"meta":89,"style":89},"language-powershell shiki shiki-themes tokyo-night","$a2aBase = 'http:\u002F\u002F127.0.0.1:\u003C实际端口>'\n$a2aToken = '\u003C本地 server.auth_token，与启动环境 A2A_API_KEY 一致>'\n$headers = @{ Authorization = \"Bearer $a2aToken\" }\nInvoke-RestMethod \"$a2aBase\u002F.well-known\u002Fagent-card.json\"\n","powershell","",[29,91,92,100,106,112],{"__ignoreMap":89},[93,94,97],"span",{"class":95,"line":96},"line",1,[93,98,99],{},"$a2aBase = 'http:\u002F\u002F127.0.0.1:\u003C实际端口>'\n",[93,101,103],{"class":95,"line":102},2,[93,104,105],{},"$a2aToken = '\u003C本地 server.auth_token，与启动环境 A2A_API_KEY 一致>'\n",[93,107,109],{"class":95,"line":108},3,[93,110,111],{},"$headers = @{ Authorization = \"Bearer $a2aToken\" }\n",[93,113,115],{"class":95,"line":114},4,[93,116,117],{},"Invoke-RestMethod \"$a2aBase\u002F.well-known\u002Fagent-card.json\"\n",[14,119,120,121,124],{},"Card 返回描述、能力和端点。它不代表你的登录许可或模型凭据已经可用。执行前设置启动环境 ",[29,122,123],{},"LXZ_PROJECT_ROOT"," 为允许 Agent 操作的项目目录；未设置时任务使用内核进程当前目录。",[18,126,128],{"id":127},"_2-创建查询和取消任务","2. 创建、查询和取消任务",[14,130,131,132,135,136,139],{},"REST 请求字段使用 camelCase，成功包装为 ",[29,133,134],{},"{\"success\":true,\"data\":...}","；业务失败通常是 HTTP 400 和 ",[29,137,138],{},"{\"success\":false,\"error\":\"...\"}","。创建成功只说明任务已提交，执行结果仍需查询。",[84,141,143],{"className":86,"code":142,"language":88,"meta":89,"style":89},"$body = @{ text = '请只分析项目目录结构，不修改文件' } | ConvertTo-Json\n$created = Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $body\nif (-not $created.success) { throw $created.error }\n$taskId = $created.data.id\n$contextId = $created.data.contextId\nInvoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\" -Headers $headers\n",[29,144,145,150,155,160,165,171],{"__ignoreMap":89},[93,146,147],{"class":95,"line":96},[93,148,149],{},"$body = @{ text = '请只分析项目目录结构，不修改文件' } | ConvertTo-Json\n",[93,151,152],{"class":95,"line":102},[93,153,154],{},"$created = Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $body\n",[93,156,157],{"class":95,"line":108},[93,158,159],{},"if (-not $created.success) { throw $created.error }\n",[93,161,162],{"class":95,"line":114},[93,163,164],{},"$taskId = $created.data.id\n",[93,166,168],{"class":95,"line":167},5,[93,169,170],{},"$contextId = $created.data.contextId\n",[93,172,174],{"class":95,"line":173},6,[93,175,176],{},"Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\" -Headers $headers\n",[14,178,179,181,182,185,186,185,189,185,192,185,195,185,198,201,202,205,206,185,209,185,212,185,215,185,218,221,222,224,225,185,228,185,231,234],{},[29,180,35],{}," 含 ",[29,183,184],{},"id","、",[29,187,188],{},"contextId",[29,190,191],{},"status",[29,193,194],{},"history",[29,196,197],{},"artifacts",[29,199,200],{},"metadata","。",[29,203,204],{},"status.state"," 使用 ",[29,207,208],{},"submitted",[29,210,211],{},"working",[29,213,214],{},"completed",[29,216,217],{},"failed",[29,219,220],{},"canceled"," 等小写连字符值。只有终态及其结果能证明执行结束；不要把 ",[29,223,208],{}," 当作完成。协议还定义 ",[29,226,227],{},"input-required",[29,229,230],{},"auth-required",[29,232,233],{},"rejected","，并非每条执行路径都会发出所有状态。",[14,236,237,238,240,241,244],{},"后续请求可提供 ",[29,239,188],{}," 关联任务，可选 ",[29,242,243],{},"skill"," 指定能力。它不是后台管理角色或云端账户权限。",[84,246,248],{"className":86,"code":247,"language":88,"meta":89,"style":89},"$followUp = @{ text = '继续说明各目录用途'; contextId = $contextId } | ConvertTo-Json\n# 确有需要时再提交，避免重复启动任务。\n# Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $followUp\n\n# 对仍在运行且确实需要停止的任务执行：\nInvoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\u002Fcancel\" -Method Post -Headers $headers\n",[29,249,250,255,260,265,271,276],{"__ignoreMap":89},[93,251,252],{"class":95,"line":96},[93,253,254],{},"$followUp = @{ text = '继续说明各目录用途'; contextId = $contextId } | ConvertTo-Json\n",[93,256,257],{"class":95,"line":102},[93,258,259],{},"# 确有需要时再提交，避免重复启动任务。\n",[93,261,262],{"class":95,"line":108},[93,263,264],{},"# Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002Fcreate\" -Method Post -Headers $headers -ContentType 'application\u002Fjson' -Body $followUp\n",[93,266,267],{"class":95,"line":114},[93,268,270],{"emptyLinePlaceholder":269},true,"\n",[93,272,273],{"class":95,"line":167},[93,274,275],{},"# 对仍在运行且确实需要停止的任务执行：\n",[93,277,278],{"class":95,"line":173},[93,279,280],{},"Invoke-RestMethod \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\u002Fcancel\" -Method Post -Headers $headers\n",[14,282,283],{},"取消不会撤销任务已经写入的文件或其他外部副作用。终态任务可能无法再次取消，读取返回的业务错误即可，不应盲目重试创建。",[18,285,287],{"id":286},"_3-接收-sse-事件","3. 接收 SSE 事件",[14,289,290,291,294],{},"已创建任务可通过 ",[29,292,293],{},"GET \u002Fapi\u002Fa2a\u002Ftasks\u002F:id\u002Fstream"," 接收事件。使用支持设置 Bearer 头的客户端；浏览器原生 EventSource 无法直接设置该头，不能以 query token 假定能通过 A2A 认证。",[84,296,298],{"className":86,"code":297,"language":88,"meta":89,"style":89},"curl.exe --no-buffer --header \"Authorization: Bearer $a2aToken\" \"$a2aBase\u002Fapi\u002Fa2a\u002Ftasks\u002F$taskId\u002Fstream\"\n",[29,299,300],{"__ignoreMap":89},[93,301,302],{"class":95,"line":96},[93,303,297],{},[14,305,306,307,185,310,185,313,185,316,185,319,322,323,75,326,75,329,332],{},"事件名包括 ",[29,308,309],{},"task-created",[29,311,312],{},"task-updated",[29,314,315],{},"task-completed",[29,317,318],{},"task-failed",[29,320,321],{},"task-canceled","，内容按 ",[29,324,325],{},"event:",[29,327,328],{},"id:",[29,330,331],{},"data:"," 解析。流断开后重新查询任务状态，不能把连接关闭本身当作成功。REST 流不提供持久历史重放承诺；晚订阅可能只能看到终态，客户端必须处理这一情况。",[14,334,335,336,339,340,343,344,347,348,351],{},"需要提交并立即订阅时，向 ",[29,337,338],{},"\u002Fa2a\u002Fsubscribe"," POST JSON-RPC ",[29,341,342],{},"tasks\u002FsendSubscribe"," 请求，返回 SSE；也可以向 ",[29,345,346],{},"\u002Fa2a\u002Fjsonrpc"," 调用同名方法，取得订阅 ID，再连接 ",[29,349,350],{},"\u002Fa2a\u002Fsse\u002F:subscription_id","。不要混淆任务 ID 与订阅 ID。",[18,353,355],{"id":354},"_4-json-rpc-调用","4. JSON-RPC 调用",[14,357,358,361,362,365],{},[29,359,360],{},"POST \u002Fa2a\u002Fjsonrpc"," 使用相同认证。下面是查询已有任务的请求体；将 ",[29,363,364],{},"taskId"," 替换为实际值：",[84,367,371],{"className":368,"code":369,"language":370,"meta":89,"style":89},"language-json shiki shiki-themes tokyo-night","{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"read-task-1\",\n  \"method\": \"tasks\u002Fget\",\n  \"params\": { \"taskId\": \"a2a_\u003C实际 ID>\" }\n}\n","json",[29,372,373,379,407,426,446,479],{"__ignoreMap":89},[93,374,375],{"class":95,"line":96},[93,376,378],{"class":377},"sgJMe","{\n",[93,380,381,385,389,392,395,398,402,404],{"class":95,"line":102},[93,382,384],{"class":383},"sAklC","  \"",[93,386,388],{"class":387},"s3R4Z","jsonrpc",[93,390,391],{"class":383},"\"",[93,393,394],{"class":383},":",[93,396,397],{"class":383}," \"",[93,399,401],{"class":400},"sPY7s","2.0",[93,403,391],{"class":383},[93,405,406],{"class":383},",\n",[93,408,409,411,413,415,417,419,422,424],{"class":95,"line":108},[93,410,384],{"class":383},[93,412,184],{"class":387},[93,414,391],{"class":383},[93,416,394],{"class":383},[93,418,397],{"class":383},[93,420,421],{"class":400},"read-task-1",[93,423,391],{"class":383},[93,425,406],{"class":383},[93,427,428,430,433,435,437,439,442,444],{"class":95,"line":114},[93,429,384],{"class":383},[93,431,432],{"class":387},"method",[93,434,391],{"class":383},[93,436,394],{"class":383},[93,438,397],{"class":383},[93,440,441],{"class":400},"tasks\u002Fget",[93,443,391],{"class":383},[93,445,406],{"class":383},[93,447,448,450,453,455,457,460,462,465,467,469,471,474,476],{"class":95,"line":167},[93,449,384],{"class":383},[93,451,452],{"class":387},"params",[93,454,391],{"class":383},[93,456,394],{"class":383},[93,458,459],{"class":377}," {",[93,461,397],{"class":383},[93,463,364],{"class":464},"sySf4",[93,466,391],{"class":383},[93,468,394],{"class":383},[93,470,397],{"class":383},[93,472,473],{"class":400},"a2a_\u003C实际 ID>",[93,475,391],{"class":383},[93,477,478],{"class":377}," }\n",[93,480,481],{"class":95,"line":173},[93,482,483],{"class":377},"}\n",[14,485,486,487,185,490,185,492,185,495,185,498,185,500,185,503,506,507,510,511,514],{},"支持 ",[29,488,489],{},"tasks\u002Fsend",[29,491,441],{},[29,493,494],{},"tasks\u002Flist",[29,496,497],{},"tasks\u002Fcancel",[29,499,342],{},[29,501,502],{},"tasks\u002FpushNotification\u002Fset",[29,504,505],{},"agents\u002Fcard","。JSON-RPC 结果在 ",[29,508,509],{},"result","，错误在 ",[29,512,513],{},"error","，即使 HTTP 200 也需要检查协议错误。",[14,516,517,518,521,522,185,525,528,529,532,533,536],{},"创建任务的 ",[29,519,520],{},"params.message"," 必须有 ",[29,523,524],{},"role",[29,526,527],{},"parts"," 和 Unix 秒 ",[29,530,531],{},"timestamp","，不能直接把 REST 的 ",[29,534,535],{},"text"," 体发到 JSON-RPC：",[84,538,540],{"className":368,"code":539,"language":370,"meta":89,"style":89},"{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"create-task-1\",\n  \"method\": \"tasks\u002Fsend\",\n  \"params\": {\n    \"message\": {\n      \"role\": \"user\",\n      \"parts\": [{ \"type\": \"text\", \"text\": \"只分析，不修改文件\" }],\n      \"timestamp\": 1793232000\n    }\n  }\n}\n",[29,541,542,546,564,583,601,614,628,650,703,718,724,730],{"__ignoreMap":89},[93,543,544],{"class":95,"line":96},[93,545,378],{"class":377},[93,547,548,550,552,554,556,558,560,562],{"class":95,"line":102},[93,549,384],{"class":383},[93,551,388],{"class":387},[93,553,391],{"class":383},[93,555,394],{"class":383},[93,557,397],{"class":383},[93,559,401],{"class":400},[93,561,391],{"class":383},[93,563,406],{"class":383},[93,565,566,568,570,572,574,576,579,581],{"class":95,"line":108},[93,567,384],{"class":383},[93,569,184],{"class":387},[93,571,391],{"class":383},[93,573,394],{"class":383},[93,575,397],{"class":383},[93,577,578],{"class":400},"create-task-1",[93,580,391],{"class":383},[93,582,406],{"class":383},[93,584,585,587,589,591,593,595,597,599],{"class":95,"line":114},[93,586,384],{"class":383},[93,588,432],{"class":387},[93,590,391],{"class":383},[93,592,394],{"class":383},[93,594,397],{"class":383},[93,596,489],{"class":400},[93,598,391],{"class":383},[93,600,406],{"class":383},[93,602,603,605,607,609,611],{"class":95,"line":167},[93,604,384],{"class":383},[93,606,452],{"class":387},[93,608,391],{"class":383},[93,610,394],{"class":383},[93,612,613],{"class":377}," {\n",[93,615,616,619,622,624,626],{"class":95,"line":173},[93,617,618],{"class":383},"    \"",[93,620,621],{"class":464},"message",[93,623,391],{"class":383},[93,625,394],{"class":383},[93,627,613],{"class":377},[93,629,631,634,637,639,641,643,646,648],{"class":95,"line":630},7,[93,632,633],{"class":383},"      \"",[93,635,524],{"class":636},"su0L4",[93,638,391],{"class":383},[93,640,394],{"class":383},[93,642,397],{"class":383},[93,644,645],{"class":400},"user",[93,647,391],{"class":383},[93,649,406],{"class":383},[93,651,653,655,657,659,661,664,666,670,672,674,676,678,680,683,685,687,689,691,693,696,698,701],{"class":95,"line":652},8,[93,654,633],{"class":383},[93,656,527],{"class":636},[93,658,391],{"class":383},[93,660,394],{"class":383},[93,662,663],{"class":377}," [{",[93,665,397],{"class":383},[93,667,669],{"class":668},"sd1Qi","type",[93,671,391],{"class":383},[93,673,394],{"class":383},[93,675,397],{"class":383},[93,677,535],{"class":400},[93,679,391],{"class":383},[93,681,682],{"class":383},",",[93,684,397],{"class":383},[93,686,535],{"class":668},[93,688,391],{"class":383},[93,690,394],{"class":383},[93,692,397],{"class":383},[93,694,695],{"class":400},"只分析，不修改文件",[93,697,391],{"class":383},[93,699,700],{"class":377}," }]",[93,702,406],{"class":383},[93,704,706,708,710,712,714],{"class":95,"line":705},9,[93,707,633],{"class":383},[93,709,531],{"class":636},[93,711,391],{"class":383},[93,713,394],{"class":383},[93,715,717],{"class":716},"sOJ5S"," 1793232000\n",[93,719,721],{"class":95,"line":720},10,[93,722,723],{"class":377},"    }\n",[93,725,727],{"class":95,"line":726},11,[93,728,729],{"class":377},"  }\n",[93,731,733],{"class":95,"line":732},12,[93,734,483],{"class":377},[14,736,737],{},"示例 timestamp 仅演示格式，实际发送使用当前 Unix 秒。回调配置属于主动对外 HTTP 调用，配置前核对目标地址和允许发送的数据，不要将推送能力等同于可靠消息队列。",[18,739,741],{"id":740},"_5-注册发现信任与委派","5. 注册、发现、信任与委派",[14,743,744,745,748],{},"注册用于描述外部 Agent，以下最小体可提交至 ",[29,746,747],{},"POST \u002Fapi\u002Fa2a\u002Fagents\u002Fregister","：",[84,750,752],{"className":368,"code":751,"language":370,"meta":89,"style":89},"{\n  \"id\": \"team-review-agent\",\n  \"name\": \"Team review agent\",\n  \"version\": \"1.0.0\",\n  \"organization\": \"example-team\",\n  \"description\": \"内部审查服务\",\n  \"capabilities\": [],\n  \"endpoints\": []\n}\n",[29,753,754,758,777,797,817,837,857,873,887],{"__ignoreMap":89},[93,755,756],{"class":95,"line":96},[93,757,378],{"class":377},[93,759,760,762,764,766,768,770,773,775],{"class":95,"line":102},[93,761,384],{"class":383},[93,763,184],{"class":387},[93,765,391],{"class":383},[93,767,394],{"class":383},[93,769,397],{"class":383},[93,771,772],{"class":400},"team-review-agent",[93,774,391],{"class":383},[93,776,406],{"class":383},[93,778,779,781,784,786,788,790,793,795],{"class":95,"line":108},[93,780,384],{"class":383},[93,782,783],{"class":387},"name",[93,785,391],{"class":383},[93,787,394],{"class":383},[93,789,397],{"class":383},[93,791,792],{"class":400},"Team review agent",[93,794,391],{"class":383},[93,796,406],{"class":383},[93,798,799,801,804,806,808,810,813,815],{"class":95,"line":114},[93,800,384],{"class":383},[93,802,803],{"class":387},"version",[93,805,391],{"class":383},[93,807,394],{"class":383},[93,809,397],{"class":383},[93,811,812],{"class":400},"1.0.0",[93,814,391],{"class":383},[93,816,406],{"class":383},[93,818,819,821,824,826,828,830,833,835],{"class":95,"line":167},[93,820,384],{"class":383},[93,822,823],{"class":387},"organization",[93,825,391],{"class":383},[93,827,394],{"class":383},[93,829,397],{"class":383},[93,831,832],{"class":400},"example-team",[93,834,391],{"class":383},[93,836,406],{"class":383},[93,838,839,841,844,846,848,850,853,855],{"class":95,"line":173},[93,840,384],{"class":383},[93,842,843],{"class":387},"description",[93,845,391],{"class":383},[93,847,394],{"class":383},[93,849,397],{"class":383},[93,851,852],{"class":400},"内部审查服务",[93,854,391],{"class":383},[93,856,406],{"class":383},[93,858,859,861,864,866,868,871],{"class":95,"line":630},[93,860,384],{"class":383},[93,862,863],{"class":387},"capabilities",[93,865,391],{"class":383},[93,867,394],{"class":383},[93,869,870],{"class":377}," []",[93,872,406],{"class":383},[93,874,875,877,880,882,884],{"class":95,"line":652},[93,876,384],{"class":383},[93,878,879],{"class":387},"endpoints",[93,881,391],{"class":383},[93,883,394],{"class":383},[93,885,886],{"class":377}," []\n",[93,888,889],{"class":95,"line":705},[93,890,483],{"class":377},[14,892,893,894,185,896,185,898,185,901,904,905,185,908,185,911,913],{},"空能力和端点只适合验证注册流程，不能据此执行远程协作。真实能力结构包含 ",[29,895,783],{},[29,897,843],{},[29,899,900],{},"inputSchema",[29,902,903],{},"outputSchema","；端点含 ",[29,906,907],{},"url",[29,909,910],{},"protocol",[29,912,843],{},"，协议枚举须匹配当前内核类型。",[915,916,917,933],"table",{},[918,919,920],"thead",{},[921,922,923,927,930],"tr",{},[924,925,926],"th",{},"操作",[924,928,929],{},"方法与路径",[924,931,932],{},"输入或说明",[934,935,936,963,977,990,1003,1028],"tbody",{},[921,937,938,942,948],{},[939,940,941],"td",{},"发现",[939,943,944,945],{},"POST ",[29,946,947],{},"\u002Fapi\u002Fa2a\u002Fagents\u002Fdiscover",[939,949,950,953,954,185,956,185,958,185,961],{},[29,951,952],{},"{}"," 列出；可传 ",[29,955,243],{},[29,957,823],{},[29,959,960],{},"minTrustScore",[29,962,863],{},[921,964,965,968,974],{},[939,966,967],{},"详情",[939,969,970,971],{},"GET ",[29,972,973],{},"\u002Fapi\u002Fa2a\u002Fagents\u002F:id",[939,975,976],{},"查询注册条目",[921,978,979,982,987],{},[939,980,981],{},"健康状态",[939,983,970,984],{},[29,985,986],{},"\u002Fapi\u002Fa2a\u002Fagents\u002F:id\u002Fhealth",[939,988,989],{},"基于本地状态和信任信息，不代表实时探测远端",[921,991,992,995,1000],{},[939,993,994],{},"信任查询",[939,996,970,997],{},[29,998,999],{},"\u002Fapi\u002Fa2a\u002Ftrust\u002F:id",[939,1001,1002],{},"分数、历史及因子",[921,1004,1005,1008,1013],{},[939,1006,1007],{},"信任更新",[939,1009,944,1010],{},[29,1011,1012],{},"\u002Fapi\u002Fa2a\u002Ftrust\u002Fupdate",[939,1014,1015,185,1018,1021,1022,185,1025],{},[29,1016,1017],{},"agentId",[29,1019,1020],{},"eventType","，可选 ",[29,1023,1024],{},"details",[29,1026,1027],{},"responseMs",[921,1029,1030,1033,1038],{},[939,1031,1032],{},"委派",[939,1034,944,1035],{},[29,1036,1037],{},"\u002Fapi\u002Fa2a\u002Fdelegate",[939,1039,1040,185,1043,185,1046,1049,1050,1053,1054],{},[29,1041,1042],{},"toAgent",[29,1044,1045],{},"skillId",[29,1047,1048],{},"taskDescription","，可选 Unix 秒 ",[29,1051,1052],{},"deadline"," 和 ",[29,1055,1056],{},"priority",[14,1058,1059,1060,1062,1063,1065,1066,1053,1068,1070,1071,185,1074,185,1077,185,1080,185,1083,185,1086,185,1089,1092],{},"发现时 ",[29,1061,243],{}," 优先于 ",[29,1064,823],{},"，两者不是自动组合过滤；",[29,1067,960],{},[29,1069,863],{}," 还会后置过滤。信任事件支持 ",[29,1072,1073],{},"success",[29,1075,1076],{},"failure",[29,1078,1079],{},"timeout",[29,1081,1082],{},"cancelled",[29,1084,1085],{},"security_violation",[29,1087,1088],{},"endorsement",[29,1090,1091],{},"complaint","；它是调用方上报，不是外部认证证明。",[14,1094,1095,1096,185,1099,1102,1103,1107],{},"委派要求目标信任分至少 30。当前 REST 委派返回 ",[29,1097,1098],{},"requestId",[29,1100,1101],{},"chainId"," 等记录信息，",[1104,1105,1106],"strong",{},"该接口本身不发起远端任务执行","，不能拿它的成功返回当作远端已完成工作。注册中心条目的 trust level 与信任引擎分数也并非自动同步的同一存储。",[18,1109,1110],{"id":1110},"限制与排错",[14,1112,1113],{},"任务、上下文、注册中心、信任及委派状态保存在内存，重启后不能恢复。任务池上限 100，订阅上限 200，每订阅事件缓冲 64 条，任务监控超时 30 分钟；不要用于需要长期可追溯或可靠重放的外部生产编排。A2A 请求体上限 1 MiB。",[915,1115,1116,1126],{},[918,1117,1118],{},[921,1119,1120,1123],{},[924,1121,1122],{},"现象",[924,1124,1125],{},"检查顺序",[934,1127,1128,1136,1144,1155,1163,1171,1179,1187],{},[921,1129,1130,1133],{},[939,1131,1132],{},"无法连接",[939,1134,1135],{},"实际监听端口、内核进程、回环地址；不要先开放公网",[921,1137,1138,1141],{},[939,1139,1140],{},"HTTP 401",[939,1142,1143],{},"两层 Bearer 是否一致，是否为启动时配置，头是否被代理删除",[921,1145,1146,1149],{},[939,1147,1148],{},"HTTP 503",[939,1150,1151,1152,1154],{},"通过本地全局校验后仍失败时，检查启动环境 ",[29,1153,53],{}," 是否配置",[921,1156,1157,1160],{},[939,1158,1159],{},"许可门禁拒绝",[939,1161,1162],{},"在 IDE 登录并核对许可，不是用 A2A key 代替登录",[921,1164,1165,1168],{},[939,1166,1167],{},"HTTP 400／422",[939,1169,1170],{},"对照具体接口字段、camelCase 和 JSON-RPC 包装，读取响应错误",[921,1172,1173,1176],{},[939,1174,1175],{},"任务不存在",[939,1177,1178],{},"区分 taskId／subscriptionId，检查重启、FIFO 驱逐；REST 查询常返回 400，流接口缺任务为 404",[921,1180,1181,1184],{},[939,1182,1183],{},"创建后 failed",[939,1185,1186],{},"检查模型、凭据、项目目录和工具批准，创建响应不保证执行成功",[921,1188,1189,1192],{},[939,1190,1191],{},"SSE 断开",[939,1193,1194],{},"查询任务终态；不要无限重新创建任务或假定完整历史重放",[14,1196,1197,1202,1203],{},[1198,1199,1201],"a",{"href":1200},"\u002Fdocs\u002Freference\u002Fkernel-api","内核 API"," · ",[1198,1204,1206],{"href":1205},"\u002Fdocs\u002Fguides\u002Fmcp","MCP 配置",[14,1208,1209],{},[1198,1210,1212],{"href":1211},"\u002Fdocs\u002Fguides\u002Fhooks","Hook 自动化",[1214,1215,1216],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sgJMe, html code.shiki .sgJMe{--shiki-default:#9ABDF5}html pre.shiki code .sAklC, html code.shiki .sAklC{--shiki-default:#89DDFF}html pre.shiki code .s3R4Z, html code.shiki .s3R4Z{--shiki-default:#7AA2F7}html pre.shiki code .sPY7s, html code.shiki .sPY7s{--shiki-default:#9ECE6A}html pre.shiki code .sySf4, html code.shiki .sySf4{--shiki-default:#0DB9D7}html pre.shiki code .su0L4, html code.shiki .su0L4{--shiki-default:#7DCFFF}html pre.shiki code .sd1Qi, html code.shiki .sd1Qi{--shiki-default:#BB9AF7}html pre.shiki code .sOJ5S, html code.shiki .sOJ5S{--shiki-default:#FF9E64}",{"title":89,"searchDepth":102,"depth":102,"links":1218},[1219,1220,1221,1222,1223,1224],{"id":20,"depth":102,"text":21},{"id":127,"depth":102,"text":128},{"id":286,"depth":102,"text":287},{"id":354,"depth":102,"text":355},{"id":740,"depth":102,"text":741},{"id":1110,"depth":102,"text":1110},"配置本地认证，发现 Agent，创建、查询、取消任务并接收事件","md",{},20,"\u002Fdocs\u002Fguides\u002Fa2a","功能指南",{"title":5,"description":1225},"docs\u002F02.guides\u002F20.a2a","oaAozcIFtf77U243wGk6fUY9olwAwe1RHJGnFfo7kpM",[1235,1239],{"title":1236,"path":1237,"stem":1238,"children":-1},"终端与沙箱","\u002Fdocs\u002Fguides\u002Fterminal","docs\u002F02.guides\u002F11.terminal",{"title":1240,"path":1211,"stem":1241,"children":-1},"Hook 自动化与拦截","docs\u002F02.guides\u002F21.hooks",[1243],{"title":1244,"path":1245,"stem":1246,"children":1247,"page":1269},"Docs","\u002Fdocs","docs",[1248,1270,1300,1317],{"title":1249,"path":1250,"stem":1251,"children":1252,"page":1269},"快速上手","\u002Fdocs\u002Fgetting-started","docs\u002F01.getting-started",[1253,1257,1261,1265],{"title":1254,"path":1255,"stem":1256},"安装与下载","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F01.getting-started\u002F01.installation",{"title":1258,"path":1259,"stem":1260},"注册与登录","\u002Fdocs\u002Fgetting-started\u002Fregister-login","docs\u002F01.getting-started\u002F02.register-login",{"title":1262,"path":1263,"stem":1264},"首次配置","\u002Fdocs\u002Fgetting-started\u002Ffirst-setup","docs\u002F01.getting-started\u002F03.first-setup",{"title":1266,"path":1267,"stem":1268},"从 VS Code \u002F Cursor 手动迁移","\u002Fdocs\u002Fgetting-started\u002Fmigrate-from-vscode","docs\u002F01.getting-started\u002F04.migrate-from-vscode",false,{"title":1230,"path":1271,"stem":1272,"children":1273,"page":1269},"\u002Fdocs\u002Fguides","docs\u002F02.guides",[1274,1278,1282,1286,1290,1293,1297,1298,1299],{"title":1275,"path":1276,"stem":1277},"AI 对话与内联编辑","\u002Fdocs\u002Fguides\u002Fai-chat","docs\u002F02.guides\u002F05.ai-chat",{"title":1279,"path":1280,"stem":1281},"RUSH 深度任务","\u002Fdocs\u002Fguides\u002Frush","docs\u002F02.guides\u002F06.rush",{"title":1283,"path":1284,"stem":1285},"FIM 智能补全","\u002Fdocs\u002Fguides\u002Ffim-completion","docs\u002F02.guides\u002F07.fim-completion",{"title":1287,"path":1288,"stem":1289},"语义代码图谱","\u002Fdocs\u002Fguides\u002Fcode-graph","docs\u002F02.guides\u002F08.code-graph",{"title":1291,"path":1205,"stem":1292},"MCP 工具与配置","docs\u002F02.guides\u002F09.mcp",{"title":1294,"path":1295,"stem":1296},"调试","\u002Fdocs\u002Fguides\u002Fdebugging","docs\u002F02.guides\u002F10.debugging",{"title":1236,"path":1237,"stem":1238},{"title":5,"path":1229,"stem":1232},{"title":1240,"path":1211,"stem":1241},{"title":1301,"path":1302,"stem":1303,"children":1304,"page":1269},"模型与计费","\u002Fdocs\u002Fmodels-billing","docs\u002F03.models-billing",[1305,1309,1313],{"title":1306,"path":1307,"stem":1308},"支持的模型","\u002Fdocs\u002Fmodels-billing\u002Fmodels","docs\u002F03.models-billing\u002F12.models",{"title":1310,"path":1311,"stem":1312},"套餐与配额","\u002Fdocs\u002Fmodels-billing\u002Fplans-quota","docs\u002F03.models-billing\u002F13.plans-quota",{"title":1314,"path":1315,"stem":1316},"自带 API Key（BYOK）","\u002Fdocs\u002Fmodels-billing\u002Fbyok","docs\u002F03.models-billing\u002F14.byok",{"title":1318,"path":1319,"stem":1320,"children":1321,"page":1269},"参考与 FAQ","\u002Fdocs\u002Freference","docs\u002F04.reference",[1322,1326,1330,1332,1336],{"title":1323,"path":1324,"stem":1325},"快捷键","\u002Fdocs\u002Freference\u002Fshortcuts","docs\u002F04.reference\u002F15.shortcuts",{"title":1327,"path":1328,"stem":1329},"配置与数据目录","\u002Fdocs\u002Freference\u002Fconfiguration","docs\u002F04.reference\u002F16.configuration",{"title":1201,"path":1200,"stem":1331},"docs\u002F04.reference\u002F17.kernel-api",{"title":1333,"path":1334,"stem":1335},"常见问题","\u002Fdocs\u002Freference\u002Ffaq","docs\u002F04.reference\u002F18.faq",{"title":1337,"path":1338,"stem":1339},"云端 REST API","\u002Fdocs\u002Freference\u002Fcloud-api","docs\u002F04.reference\u002F19.cloud-api",1793596426247]