curl --request POST \
--url 'https://api.flashcat.cloud/safari/a2a-agent/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "a2a_9d4c1f60b3a2",
"description": "Runs traceroute, BGP, and DNS analysis for network incidents."
}
'import requests
url = "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload = {
"agent_id": "a2a_9d4c1f60b3a2",
"description": "Runs traceroute, BGP, and DNS analysis for network incidents."
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: 'a2a_9d4c1f60b3a2',
description: 'Runs traceroute, BGP, and DNS analysis for network incidents.'
})
};
fetch('https://api.flashcat.cloud/safari/a2a-agent/update?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/safari/a2a-agent/update?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent_id' => 'a2a_9d4c1f60b3a2',
'description' => 'Runs traceroute, BGP, and DNS analysis for network incidents.'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload := strings.NewReader("{\n \"agent_id\": \"a2a_9d4c1f60b3a2\",\n \"description\": \"Runs traceroute, BGP, and DNS analysis for network incidents.\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"a2a_9d4c1f60b3a2\",\n \"description\": \"Runs traceroute, BGP, and DNS analysis for network incidents.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"a2a_9d4c1f60b3a2\",\n \"description\": \"Runs traceroute, BGP, and DNS analysis for network incidents.\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}更新 A2A 智能体
编辑 A2A 智能体的 card URL、鉴权、流式开关或所属团队。
curl --request POST \
--url 'https://api.flashcat.cloud/safari/a2a-agent/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "a2a_9d4c1f60b3a2",
"description": "Runs traceroute, BGP, and DNS analysis for network incidents."
}
'import requests
url = "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload = {
"agent_id": "a2a_9d4c1f60b3a2",
"description": "Runs traceroute, BGP, and DNS analysis for network incidents."
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: 'a2a_9d4c1f60b3a2',
description: 'Runs traceroute, BGP, and DNS analysis for network incidents.'
})
};
fetch('https://api.flashcat.cloud/safari/a2a-agent/update?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/safari/a2a-agent/update?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent_id' => 'a2a_9d4c1f60b3a2',
'description' => 'Runs traceroute, BGP, and DNS analysis for network incidents.'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/safari/a2a-agent/update?app_key="
payload := strings.NewReader("{\n \"agent_id\": \"a2a_9d4c1f60b3a2\",\n \"description\": \"Runs traceroute, BGP, and DNS analysis for network incidents.\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"agent_id\": \"a2a_9d4c1f60b3a2\",\n \"description\": \"Runs traceroute, BGP, and DNS analysis for network incidents.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/a2a-agent/update?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent_id\": \"a2a_9d4c1f60b3a2\",\n \"description\": \"Runs traceroute, BGP, and DNS analysis for network incidents.\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}限制说明
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个 app_key 1,000 次/分钟;50 次/秒 |
| 权限要求 | 无 —— 持有有效的 app_key 即可调用 |
使用说明
- 省略某字段即保持不变;仅请求中出现的字段会被更新。
- 每次调用都会记入账户审计日志。
授权
Flashduty 控制台「账户 → APP Keys」中签发的 app_key。调用任何公共 API 都需要它。
请求体
Editable fields of an A2A agent; omitted fields are left unchanged.
Identifier of the agent to update.
New display name.
128New description.
New agent card URL.
New authentication scheme.
New authentication parameters.
Show child attributes
Show child attributes
Toggle streaming-response support.
Reassign the agent to this team; omit to leave unchanged, 0 for account scope.
New credential model.
New per-user secret JSON schema.
New OAuth metadata JSON.
响应
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.
Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.
"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
Error payload inside the response envelope. Present only on non-2xx responses.
Show child attributes
Show child attributes
No payload; the operation returns an empty data field on success.
此页面对您有帮助吗?