1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

interface AgentSkill {
	// 技能的唯一标识符
	id: string;
	name: string;
	description: string;
	// 分类和发现的关键词
	tags: string[];
	//示例提示或用例
	examples: string[];
	// 支持的输入和输出媒体类型，如 "text/plain", "application/json"
	inputModes: string[];
	outputModes: string[];
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

interface AgentCard {
	name: string;
	description: string;
	// 可访问 A2A 服务的端点
	url: string;
	version: string;
	// 指定支持的 A2A 功能，如流式输出streaming、消息推送pushNotifications
	capabilities: {
		streaming: boolean;
		pushNotifications: boolean;
	};
	//AgentSkill 对象列表
	skills: Array<{}>;
	// agent默认媒体类型，如 "text/plain", "application/json"
	defaultInputModes: string[];
	defaultOutputModes: string[];
}

1
2
3
4
5

interface Message {
	role: 'user' | 'agent'; // 消息发送者的角色
	parts: Part[]; // 消息包含的部分数组
	metadata?: Record<string, any>; // 扩展元数据
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

// 示例结构 (具体定义可能不同)

interface TextPart {
	type: 'text' | 'text/plain'; // 或其他文本相关 MIME 类型
	text: string;
}

interface FilePart {
	type: 'file' | string; // 例如 "image/jpeg", "application/pdf"
	uri?: string; // 指向文件的 URI
	data?: string; // Base64 编码的文件内容
	filename?: string;
}

interface JsonPart {
	type: 'json' | 'application/json';
	json: any; // 实际的 JSON 对象或数组
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

// 任务主体
interface Task {
	id: string; // 任务的唯一标识符
	sessionId: string; // 客户端生成的会话 ID
	status: TaskStatus; // 任务当前状态
	history?: Message[]; // 消息历史记录
	artifacts?: Artifact[]; // 代理创建的工件集合
	metadata?: Record<string, any>; // 扩展元数据
}

// 任务状态及附带消息
interface TaskStatus {
	state: TaskState;
	message?: Message; // 向客户端提供的额外状态更新
	timestamp?: string; // ISO 日期时间值
}

// 任务状态枚举
type TaskState =
	| 'submitted'
	| 'working'
	| 'input-required'
	| 'completed'
	| 'canceled'
	| 'failed'
	| 'unknown';

// 用于创建、继续或重启任务的客户端参数
interface TaskSendParams {
	id: string; // 任务 ID
	sessionId?: string; // 会话 ID (如果未设置，服务器会为新任务创建)
	message: Message; // 发送的消息
	historyLength?: number; // 要检索的最近消息数量
	pushNotification?: PushNotificationConfig; // 断开连接时服务器发送通知的配置
	metadata?: Record<string, any>; // 扩展元数据
}

// 服务器在 sendSubscribe 或 subscribe 请求期间发送的状态更新事件
interface TaskStatusUpdateEvent {
	id: string;
	status: TaskStatus;
	final: boolean; // 指示事件流是否结束
	metadata?: Record<string, any>;
}

// 服务器在 sendSubscribe 或 subscribe 请求期间发送的工件更新事件
interface TaskArtifactUpdateEvent {
	id: string;
	artifact: Artifact;
	metadata?: Record<string, any>;
}

// 推送通知配置 (具体结构未在源文档中详细说明)
interface PushNotificationConfig {
	// ... 配置细节
}

1
2
3
4
5
6
7
8
9

interface Artifact {
	name?: string; // 工件的可选名称
	description?: string; // 工件的可选描述
	parts: Part[]; // 工件包含的部分数组
	metadata?: Record<string, any>; // 扩展元数据
	index: number; // 工件在其所属任务中的索引
	append?: boolean; // 是否允许追加 Part (用于流式传输)
	lastChunk?: boolean; // 是否是流式传输的最后一块
}