diff --git a/models_gen.go b/models_gen.go index 2d5142b..e320721 100644 --- a/models_gen.go +++ b/models_gen.go @@ -188,8 +188,8 @@ type A2aAgentCreateRequest struct { AuthType string `json:"auth_type,omitempty" toon:"auth_type,omitempty"` // URL of the remote agent card. CardURL string `json:"card_url,omitempty" toon:"card_url,omitempty"` - // Agent description. - Description string `json:"description,omitempty" toon:"description,omitempty"` + // Invocation instructions included in AI SRE's system prompt to decide when to call this A2A agent. Must be nonblank. + Instructions string `json:"instructions,omitempty" toon:"instructions,omitempty"` // JSON OAuth metadata; reserved for per_user_oauth. OauthMetadata string `json:"oauth_metadata,omitempty" toon:"oauth_metadata,omitempty"` // JSON secret schema; required when auth_mode=per_user_secret. @@ -240,8 +240,8 @@ type A2aAgentItem struct { CreatedAt TimestampMilli `json:"created_at" toon:"created_at"` // Member ID that created the agent. CreatedBy int64 `json:"created_by" toon:"created_by"` - // Agent description. - Description string `json:"description" toon:"description"` + // Invocation instructions included in AI SRE's system prompt to decide when to call this A2A agent. + Instructions string `json:"instructions" toon:"instructions"` // JSON-encoded OAuth metadata (per_user_oauth mode). OauthMetadata string `json:"oauth_metadata" toon:"oauth_metadata"` // JSON-encoded secret schema (per_user_secret mode). @@ -292,8 +292,8 @@ type A2aAgentUpdateRequest struct { AuthType *string `json:"auth_type,omitempty" toon:"auth_type,omitempty"` // New card URL. Omit to leave unchanged. CardURL *string `json:"card_url,omitempty" toon:"card_url,omitempty"` - // New description. Omit to leave unchanged. - Description *string `json:"description,omitempty" toon:"description,omitempty"` + // New invocation instructions. Omit to leave unchanged; when supplied, must be nonblank. + Instructions *string `json:"instructions,omitempty" toon:"instructions,omitempty"` // New JSON OAuth metadata. OauthMetadata *string `json:"oauth_metadata,omitempty" toon:"oauth_metadata,omitempty"` // New JSON secret schema. diff --git a/openapi/openapi.en.json b/openapi/openapi.en.json index d32cb4d..8430b86 100644 --- a/openapi/openapi.en.json +++ b/openapi/openapi.en.json @@ -21769,7 +21769,8 @@ "card_url": "https://agents.example.com/deploy-bot/card", "auth_type": "bearer", "streaming": true, - "team_id": 0 + "team_id": 0, + "instructions": "Use when deployment pipelines need inspection or rollback advice." } } } @@ -21826,7 +21827,6 @@ "team_id": 0, "can_edit": true, "agent_name": "deploy-bot", - "description": "Remote agent that inspects deployment pipelines.", "card_url": "https://agents.example.com/deploy-bot/card", "auth_type": "bearer", "streaming": true, @@ -21841,7 +21841,8 @@ "auth_mode": "shared", "created_by": 80011, "created_at": 1716960000000, - "updated_at": 1717046400000 + "updated_at": 1717046400000, + "instructions": "Remote agent that inspects deployment pipelines." } ], "total": 1 @@ -21928,7 +21929,6 @@ "team_id": 0, "can_edit": true, "agent_name": "deploy-bot", - "description": "Remote agent that inspects deployment pipelines.", "card_url": "https://agents.example.com/deploy-bot/card", "auth_type": "bearer", "streaming": true, @@ -21943,7 +21943,8 @@ "auth_mode": "shared", "created_by": 80011, "created_at": 1716960000000, - "updated_at": 1717046400000 + "updated_at": 1717046400000, + "instructions": "Remote agent that inspects deployment pipelines." } } } @@ -22050,7 +22051,7 @@ }, "example": { "agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D", - "description": "Inspects deployment pipelines and proposes rollbacks." + "instructions": "Inspect deployment pipelines and propose rollback steps." } } } @@ -43038,10 +43039,6 @@ "type": "string", "description": "Agent display name." }, - "description": { - "type": "string", - "description": "Agent description." - }, "card_url": { "type": "string", "description": "URL of the remote agent card." @@ -43119,6 +43116,10 @@ "type": "integer", "format": "int64", "description": "Last update time. Unix timestamp in milliseconds." + }, + "instructions": { + "type": "string", + "description": "Invocation instructions included in AI SRE's system prompt to decide when to call this A2A agent." } }, "required": [ @@ -43127,7 +43128,7 @@ "team_id", "can_edit", "agent_name", - "description", + "instructions", "card_url", "auth_type", "streaming", @@ -43155,14 +43156,6 @@ "description": "New display name. Omit to leave unchanged.", "maxLength": 128 }, - "description": { - "type": [ - "string", - "null" - ], - "description": "New description. Omit to leave unchanged.", - "maxLength": 2000 - }, "card_url": { "type": [ "string", @@ -43219,6 +43212,13 @@ "null" ], "description": "New JSON OAuth metadata." + }, + "instructions": { + "type": [ + "string", + "null" + ], + "description": "New invocation instructions. Omit to leave unchanged; when supplied, must be nonblank." } }, "required": [ @@ -43234,11 +43234,6 @@ "description": "Agent display name.", "maxLength": 128 }, - "description": { - "type": "string", - "description": "Agent description.", - "maxLength": 2000 - }, "card_url": { "type": "string", "description": "URL of the remote agent card." @@ -43274,10 +43269,15 @@ "oauth_metadata": { "type": "string", "description": "JSON OAuth metadata; reserved for per_user_oauth." + }, + "instructions": { + "type": "string", + "description": "Invocation instructions included in AI SRE's system prompt to decide when to call this A2A agent. Must be nonblank." } }, "required": [ "agent_name", + "instructions", "card_url" ] }, diff --git a/openapi/openapi.zh.json b/openapi/openapi.zh.json index 5a26bdf..2ee5fb8 100644 --- a/openapi/openapi.zh.json +++ b/openapi/openapi.zh.json @@ -21761,7 +21761,8 @@ "card_url": "https://agents.example.com/deploy-bot/card", "auth_type": "bearer", "streaming": true, - "team_id": 0 + "team_id": 0, + "instructions": "当需要检查部署流水线或给出回滚建议时使用。" } } } @@ -21818,7 +21819,6 @@ "team_id": 0, "can_edit": true, "agent_name": "deploy-bot", - "description": "Remote agent that inspects deployment pipelines.", "card_url": "https://agents.example.com/deploy-bot/card", "auth_type": "bearer", "streaming": true, @@ -21833,7 +21833,8 @@ "auth_mode": "shared", "created_by": 80011, "created_at": 1716960000000, - "updated_at": 1717046400000 + "updated_at": 1717046400000, + "instructions": "Remote agent that inspects deployment pipelines." } ], "total": 1 @@ -21920,7 +21921,6 @@ "team_id": 0, "can_edit": true, "agent_name": "deploy-bot", - "description": "Remote agent that inspects deployment pipelines.", "card_url": "https://agents.example.com/deploy-bot/card", "auth_type": "bearer", "streaming": true, @@ -21935,7 +21935,8 @@ "auth_mode": "shared", "created_by": 80011, "created_at": 1716960000000, - "updated_at": 1717046400000 + "updated_at": 1717046400000, + "instructions": "Remote agent that inspects deployment pipelines." } } } @@ -22042,7 +22043,7 @@ }, "example": { "agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D", - "description": "Inspects deployment pipelines and proposes rollbacks." + "instructions": "检查部署流水线并给出回滚步骤。" } } } @@ -43029,10 +43030,6 @@ "type": "string", "description": "智能体显示名称。" }, - "description": { - "type": "string", - "description": "智能体描述。" - }, "card_url": { "type": "string", "description": "远程智能体卡片的 URL。" @@ -43110,6 +43107,10 @@ "type": "integer", "format": "int64", "description": "最近更新时间，Unix 毫秒时间戳。" + }, + "instructions": { + "type": "string", + "description": "调用说明，会进入 AI SRE 的系统提示词，用于判断何时调用此 A2A 智能体。" } }, "required": [ @@ -43118,7 +43119,7 @@ "team_id", "can_edit", "agent_name", - "description", + "instructions", "card_url", "auth_type", "streaming", @@ -43146,14 +43147,6 @@ "description": "新的显示名称。省略则不变。", "maxLength": 128 }, - "description": { - "type": [ - "string", - "null" - ], - "description": "新的描述。省略则不变。", - "maxLength": 2000 - }, "card_url": { "type": [ "string", @@ -43210,6 +43203,13 @@ "null" ], "description": "新的 JSON OAuth 元数据。" + }, + "instructions": { + "type": [ + "string", + "null" + ], + "description": "新的调用说明。省略则不变；传入时不能为空。" } }, "required": [ @@ -43225,11 +43225,6 @@ "description": "智能体显示名称。", "maxLength": 128 }, - "description": { - "type": "string", - "description": "智能体描述。", - "maxLength": 2000 - }, "card_url": { "type": "string", "description": "远程智能体卡片的 URL。" @@ -43265,10 +43260,15 @@ "oauth_metadata": { "type": "string", "description": "JSON OAuth 元数据；为 per_user_oauth 预留。" + }, + "instructions": { + "type": "string", + "description": "调用说明，会进入 AI SRE 的系统提示词，用于判断何时调用此 A2A 智能体。不能为空。" } }, "required": [ "agent_name", + "instructions", "card_url" ] },