【问题单号 Defect】202608101423

【修改说明 Modification】AIDR Protobuf初始版本提交。
【修改人 Modifier】qiaonaiqiang 00505699
【评审人 Reviewer】micro 00184944

AgentActionAudit.proto

@@ -0,0 +1,86 @@
+syntax = "proto3";
+package AgentActionAudit;
+
+import "AIDR/AgentIdentify.proto";
+import "AIDR/MCPRemoteToolType2ID.proto";
+import "google/protobuf/timestamp.proto";
+
+// AI Agent 同步服务，AIDR-CLI ---> AAM同步AI Agent动作信息。
+service AIAgentActionSyncService {
+	// 单个新增/删除
+	rpc AIAgentActionSyncOper(AIAgentActionEventReq) returns (AIAgentActionEventRsp);
+	// 批量操作
+	rpc AIAgentSyncOperBatch(AIAgentActionEventReqBatch)returns(AIAgentActionEventRsp);
+}
+
+
+message AIAgentActionEventBase {
+	//标准时间：UTC时间戳（秒+纳秒）
+	google.protobuf.Timestamp event_time = 1;
+	enum AIAgentActionType {
+		ACTION_TYPE_UNUSE = 0;
+		ACTION_TYPE_LLM_CALL = 1;      // POC不需要支持
+		ACTION_TYPE_REMOTE_TOOL = 2;   // POC当前仅支持这一种
+		ACTION_TYPE_LOCAL_TOOL = 3;    // POC不需要支持
+	}
+	AIAgentActionType action_type= 2;
+	oneof data {
+		AIAgentActionRemoteTool remote_tool = 3;    // POC当前仅支持这一种
+		AIAgentActionLocalTool local_tool = 4;      // POC不需要支持
+		AIAgentActionLLMCall llm_call = 5;          // POC不需要支持
+	}
+}
+// AI Agent识别粒度：MAC用户名+终端+AI Agent类别，AIDR-CLI尽力而为，提供终端+AI Agent类型
+// 不支持版本信息，例如， Claude Code v1.1和Claude Code v1.2 agent name均为Claude Code
+// 不支持多实例信息，例如，不同的安装位置，不同的进程等
+message AIAgentActionEventReq {
+	uint64 msg_id = 1;
+	AIAgentIdentify.AIAgentKey key = 2;
+	AIAgentActionEventBase evt = 3;
+}
+
+// 操作返回结果
+message AIAgentActionEventRsp {
+	int32 code = 1;        // 0成功，非0错误码
+	string msg = 2;        // 提示信息
+	uint64 msg_id = 3;     // 消息ID关联字段
+}
+
+message AIAgentActionEventReqBatch {
+	uint64 msg_id = 1;      // 消息；
+	AIAgentIdentify.AIAgentKey key = 2;
+	repeated AIAgentActionEventBase evt_list = 3;
+}
+
+message AIAgentActionRemoteTool {
+	string mcp_oper = 1;        //MCP协议动作
+	McpRemoteToolIdentify.MCPServerName ser_name = 2;
+	McpRemoteToolIdentify.ToolsName tool_name = 3;     // 工具访问名称
+	optional string tool_param = 4;                    // 工具访问的参数不需要
+	optional string mcp_result = 5;                    // MCP协议结果
+}
+
+message AIAgentActionLocalTool {
+	McpRemoteToolIdentify.ToolsName tool_name = 1;     // 工具访问名称
+	optional string tool_param = 2;                    // 工具访问的参数不需要
+}
+
+message AIAgentActionLLMCall {
+	LLMServerName name = 1;                   // LLM调用资源
+	optional string prompt = 2;               // 提示词
+	                                          // 粒度需要继续扩充
+}
+
+message LLMServerName {
+	enum LLMServerNameType{
+		LLM_SERVER_NAME_TYPE_UNUSE = 0;
+		LLM_SERVER_NAME_TYPE_IPV4 = 1;
+		LLM_SERVER_NAME_TYPE_IPV6 = 2;
+		LLM_SERVER_NAME_TYPE_DNS_NAME = 3;
+	}
+	LLMServerNameType name_type = 1;  // LLM Server 名字类型
+	string name_str = 2;
+	uint32 ser_port = 3;              // LLM Server 服务端口
+	string model_name = 4;            // LLM Server 使用的模型名称
+	                                  // 粒度按需求继续可以继续扩充
+}

AgentIdentify.proto

@@ -0,0 +1,84 @@
+syntax = "proto3";
+
+package AIAgentIdentify;
+
+
+// AI Agent识别粒度：NAC用户名+终端AI Agent类别，AIDR-CLI 尽力而为，提供终端+AI Agent类型
+// 不支持版本信息，例如， Claude Code v1.1和Claude Code v1.2 agent name均为Claude Code
+// 不支持多实例信息，例如，不同的安装位置，不同的进程等
+message AIAgentKey {
+	string device_id = 1;                  // key字段，参考 HuaweiSdpGrpc.proto::IamSdpMessageHeader::device_id
+	                                       //
+										   //
+										   //
+										   //
+										   //
+
+	string agent_name = 2;                 // Key字段，Agent的名字或类别，典型的例如 Claude Code
+	                                       // 安全产品R26.1对应的变量名称时name，Agent Nac中命名为Agent Type
+}
+
+message AIAgent {
+	AIAgentKey Key = 1;                    // Key字段
+	string host_name = 2;				   // windows on pc参考: Windows主机名 DESKTOP-PRNHF35.china.huawei.com还是DESKTOP-PRNHF35？
+										   //
+										   //
+										   //
+    string user_name_os = 3;               // os用户名；
+                                           //
+										   //
+										   //
+										   
+	string IP = 4;                         // 属性字段 ip地址
+    string MAC = 5;                        // 属性字段 MAC地址	
+										   //
+	optional string user_name_iam = 6;     // IAM使用的用户名									   
+    optional string iam_token = 7;         // IAM使用的用户名
+
+	optional string user_name_nac = 8;         // 终端协议认证使用的用户名
+	                                           // 
+											   //
+											   //
+											   //
+	optional string nac_token = 9;             // IAM使用的用户名
+}
+
+// 单个AI Agent同步操作（新增、删除、更新），请求消息结构
+message AIAgentSyncReq {
+	// 操作类型枚举：新增/删除/更新
+	enum AIAgentSyncOpType {
+		OPERATE_UNKNOWN =0;
+		OPERATE_ADD = 1;          // 添加 AI Agent
+		OPERATE_DELETE = 2;       // 删除 AI Agent
+		OPERATE_UPDATE = 3;       // 更新 AI Agent相关信息
+	}
+	AIAgentSyncOpType op_type = 1;
+	AIAgent agent_info = 2;
+	optional string agent_id = 3; // Agent身份化的ID。
+}
+
+// 操作返回操作
+message AIAgentSyncRsp {
+	int32 code = 1;              // 0成功，非0错误码
+	string msg = 2;            // 提示成功
+	AIAgentKey key = 3;          // Key字段
+	int32 agent_type_id = 4;     // Agent对应的TypeID
+}
+
+//批量AI Agent同步操作（新增/删除/更新），请求消息结构
+message AIAgentSyncReqBatch{
+	repeated AIAgentSyncReq req = 1;
+}
+
+//批量操作返回
+message AIAgentSyncRspBatch {
+    repeated AIAgentSyncRsp rsp = 1;    // 每一条AI Agent对应的结果
+}
+
+//AI Agent同步服务，AIDR-CLI ---> AAM同步AI Agent信息。
+service AIAgentSyncService {
+	// 单个新增/删除
+	rpc AIAgentSyncOper(AIAgentSyncReq)returns(AIAgentSyncRsp);
+	// 批量操作
+	rpc AIAgentSyncOperBatch(AIAgentSyncReqBatch)returns(AIAgentSyncRspBatch);
+}

MCPRemoteToolType2ID.proto

@@ -0,0 +1,78 @@
+syntax = "proto3";
+
+package McpRemoteToolIdentify;
+
+
+// AI Agent 订阅服务， AAM --> AIDR-CLI 同步Tool Name to Tool ID。
+service MCPToolInfoSubsService {
+	// 单个操作
+	rpc MCPToolsSubs (MCPToolSubReq) returns (MCPToolsSubRsp);
+	rpc MCPToolsUnSubs (MCPToolsUnSubReq) returns (MCPToolsUnSubRsp);
+}
+
+message MCPServerName{
+	enum McpServerNameType {
+		NAME_TYPE_UNUSE = 0;
+		NAME_TYPE_IPV4 = 1;
+		NAME_TYPE_IPV6 = 2;
+		NAME_TYPE_DNS_NAME = 3;
+	}
+	McpServerNameType name_type = 1;    // MCP Remote Server 名字类型
+	string name_str = 2;                // MCP Remote Server 名字， IPv4地址/IPv6地址/DNS域名
+	uint32 ser_port = 3;                // MCP Remote Server 服务端口
+}
+
+//单个AI Agent订阅操作
+message MCPToolSubReq {
+	MCPServerName key = 1;
+}
+
+message ToolsName2Id{
+	string tools_name = 1;// MCP 工具名
+	int32 tools_id = 2;   // MCP 工具的ID
+}
+
+message ToolsName {
+	string tools_name = 1; // MCP 工具名
+}
+
+message ToolsSyn {
+	enum McpToolsSyncType {
+		TOOL_SYN_TYPE_UNUSE = 0;
+		TOOL_SYN_TYPE_ADD = 1;
+		TOOL_SYN_TYPE_UPDATE = 2;
+		TOOL_SYN_TYPE_DELETE =3;
+	}
+	McpToolsSyncType sync_type = 1;   // 同步类型
+	oneof data {
+		ToolsName2Id name2id = 2;     // ADD和UPDATE时使用
+		ToolsName tools_name = 3;     // 删除时使用
+	}
+}
+
+message MCPToolsSubRsp {
+	MCPServerName key = 1;            // Key字段
+	repeated ToolsSyn tools_list = 2; // Tools更新的列表
+}
+
+message MCPToolsUnSubReq {
+	MCPServerName key = 1;
+}
+
+message MCPToolsUnSubRsp {
+	int32 code = 1;                   // 0成功，非0错误码
+	string msg = 2;                   // 提示信息
+	MCPServerName key = 3;            // Key字段
+}
+
+message MCPToolsSubReqBatch {
+	repeated MCPServerName key_list = 1;
+}
+
+message MCPToolsUnSubReqBatch {
+	repeated MCPServerName key_list = 1;
+}
+
+message MCPToolsUnSubRspBatch {
+	repeated MCPToolsUnSubRsp list_rsp = 1;
+}