import { AbstractClient } from "../../../common/abstract_client"; import { ClientConfig } from "../../../common/interface"; import { DeleteSessionSpaceResponse, ApproveRegistryRecordRequest, AppendEventResponse, DescribeRegistryRecordResponse, DescribeSandboxToolListRequest, CreatePreCacheImageTaskResponse, ResumeSandboxInstanceRequest, ModifySessionSpaceResponse, DescribePreCacheImageTaskRequest, DescribeDeploymentResponse, RejectRegistryRecordResponse, DescribeRegistryRecordListRequest, UpdateRegistryResponse, ApproveRegistryRecordResponse, DeleteSessionRequest, ResumeSandboxInstanceResponse, AcquireSandboxInstanceTokenRequest, DescribeAPIKeyListResponse, PreviewRegistryRecordResponse, CreateSessionRequest, DescribeDeploymentRequest, DescribeSessionSpaceResponse, DeleteSandboxToolRequest, CreateRegistryResponse, DeleteAPIKeyRequest, DeleteDeploymentRequest, GetSkillPackageUploadURLRequest, UpdateSandboxToolRequest, DescribeSessionSpacesResponse, DescribeSandboxInstanceListResponse, StopSandboxInstanceResponse, DescribeRegistryRecordVersionListResponse, DescribeRegistryRecordVersionListRequest, RejectRegistryRecordRequest, CreateDeploymentRequest, StopSandboxInstanceRequest, GetSkillPackageDownloadURLRequest, DeleteSandboxToolResponse, DescribeQuotaOverviewResponse, UpdateSandboxToolResponse, DescribeRegistryRecordRequest, CancelRegistryRecordRequest, CreateSandboxToolResponse, CreateAPIKeyRequest, DescribeSandboxToolListResponse, CreateRegistryRecordResponse, UpdateSandboxInstanceRequest, ModifySessionRequest, SyncRegistryRecordRequest, DescribeSessionRequest, DeleteRegistryResponse, DescribeAPIKeyListRequest, DescribeSessionSpaceRequest, GetSkillPackageUploadURLResponse, CreateSessionSpaceResponse, DescribeRegistryListResponse, UpdateRegistryRequest, DescribeSessionsResponse, DescribeDeploymentListRequest, DescribeRegistryAuditLogListRequest, PauseSandboxInstanceRequest, DescribeRegistryRecordListResponse, UpdateRegistryRecordRequest, CreateAPIKeyResponse, DescribeRegistryRequest, AcquireDeploymentTokenRequest, DescribeEventsResponse, DescribeDeploymentListResponse, DescribeRegistryResponse, ModifySessionSpaceRequest, CreateSessionSpaceRequest, DeleteAPIKeyResponse, DescribeRegistryListRequest, CreateDeploymentResponse, DeleteRegistryRequest, GetSkillPackageDownloadURLResponse, CreateSessionResponse, StartSandboxInstanceResponse, DescribeSandboxInstanceListRequest, ModifyDeploymentRequest, DescribeRegistryAuditLogListResponse, AcquireSandboxInstanceTokenResponse, PauseSandboxInstanceResponse, StartSandboxInstanceRequest, CancelRegistryRecordResponse, DescribeSessionSpacesRequest, UpdateRegistryRecordResponse, DeleteSessionSpaceRequest, AcquireDeploymentTokenResponse, DescribeSessionsRequest, CreateSandboxToolRequest, DescribePreCacheImageTaskResponse, DeleteRegistryRecordResponse, CreateRegistryRecordRequest, ModifySessionResponse, UpdateSandboxInstanceResponse, DeleteDeploymentResponse, SyncRegistryRecordResponse, DescribeSessionResponse, DeleteRegistryRecordRequest, AppendEventRequest, DeleteSessionResponse, DescribeEventsRequest, CreateRegistryRequest, DescribeQuotaOverviewRequest, ModifyDeploymentResponse, CreatePreCacheImageTaskRequest, PreviewRegistryRecordRequest } from "./ags_models"; /** * ags client * @class */ export declare class Client extends AbstractClient { constructor(clientConfig: ClientConfig); /** * 创建镜像预热任务 */ CreatePreCacheImageTask(req: CreatePreCacheImageTaskRequest, cb?: (error: string, rep: CreatePreCacheImageTaskResponse) => void): Promise; /** * 对 Record 的指定 Version 或 Label 目标发起一次预览调用。VersionId 与 Label 互斥;均省略时使用 Stable。不创建 Version、不修改 Label。 */ PreviewRegistryRecord(req?: PreviewRegistryRecordRequest, cb?: (error: string, rep: PreviewRegistryRecordResponse) => void): Promise; /** * 更新沙箱实例 */ UpdateSandboxInstance(req: UpdateSandboxInstanceRequest, cb?: (error: string, rep: UpdateSandboxInstanceResponse) => void): Promise; /** * 修改 Deployment */ ModifyDeployment(req: ModifyDeploymentRequest, cb?: (error: string, rep: ModifyDeploymentResponse) => void): Promise; /** * 启动沙箱实例 */ StartSandboxInstance(req: StartSandboxInstanceRequest, cb?: (error: string, rep: StartSandboxInstanceResponse) => void): Promise; /** * 获取访问沙箱工具时所需要使用的访问Token,创建沙箱实例后需调用此接口获取沙箱实例访问Token。 此Token可用于调用代码沙箱实例执行代码,或浏览器沙箱实例进行浏览器操作等。 */ AcquireSandboxInstanceToken(req: AcquireSandboxInstanceTokenRequest, cb?: (error: string, rep: AcquireSandboxInstanceTokenResponse) => void): Promise; /** * 查询事件列表。 查询指定会话的事件流,支持按作者和起始时间筛选。 */ DescribeEvents(req: DescribeEventsRequest, cb?: (error: string, rep: DescribeEventsResponse) => void): Promise; /** * 创建 Agent Registry(注册中心)。 */ CreateRegistry(req?: CreateRegistryRequest, cb?: (error: string, rep: CreateRegistryResponse) => void): Promise; /** * 触发一次从远端拉取描述符 / 元数据的同步。可通过互斥的 VersionId 或 Label 指定来源 Version,均省略时默认使用 Stable。有变化时创建新 Version 并移动 Latest;来源必须 SourceType=URL_IMPORT,否则返回 UnsupportedOperation.SourceType。 */ SyncRegistryRecord(req?: SyncRegistryRecordRequest, cb?: (error: string, rep: SyncRegistryRecordResponse) => void): Promise; /** * 分页查询指定Registry / Record / Version的审计日志。 */ DescribeRegistryAuditLogList(req?: DescribeRegistryAuditLogListRequest, cb?: (error: string, rep: DescribeRegistryAuditLogListResponse) => void): Promise; /** * 创建新的API密钥,用于调用Agent Sandbox接口。相较于腾讯云Secret ID Secret Key支持调用所有接口使用,仅有部分接口支持使用API密钥调用。 */ CreateAPIKey(req: CreateAPIKeyRequest, cb?: (error: string, rep: CreateAPIKeyResponse) => void): Promise; /** * 更新 Registry 的可变元数据。 */ UpdateRegistry(req?: UpdateRegistryRequest, cb?: (error: string, rep: UpdateRegistryResponse) => void): Promise; /** * 创建 Deployment */ CreateDeployment(req: CreateDeploymentRequest, cb?: (error: string, rep: CreateDeploymentResponse) => void): Promise; /** * 追加事件。 向指定会话追加一条事件。 */ AppendEvent(req: AppendEventRequest, cb?: (error: string, rep: AppendEventResponse) => void): Promise; /** * 更新沙箱工具 */ UpdateSandboxTool(req: UpdateSandboxToolRequest, cb?: (error: string, rep: UpdateSandboxToolResponse) => void): Promise; /** * 查询 Deployment 信息 */ DescribeDeployment(req: DescribeDeploymentRequest, cb?: (error: string, rep: DescribeDeploymentResponse) => void): Promise; /** * 分页查询 Record 的 Version 列表。list 类接口不接入 CAM 转发鉴权。 */ DescribeRegistryRecordVersionList(req?: DescribeRegistryRecordVersionListRequest, cb?: (error: string, rep: DescribeRegistryRecordVersionListResponse) => void): Promise; /** * 通过 Version 审批:PENDING_APPROVAL → APPROVED。Comment 必填。 */ ApproveRegistryRecord(req?: ApproveRegistryRecordRequest, cb?: (error: string, rep: ApproveRegistryRecordResponse) => void): Promise; /** * 分页查询 Registry 下的 Record 列表。list 类接口不接入 CAM 转发鉴权;业务侧按 CAM 二次过滤。 */ DescribeRegistryRecordList(req?: DescribeRegistryRecordListRequest, cb?: (error: string, rep: DescribeRegistryRecordListResponse) => void): Promise; /** * 查询沙箱实例列表 */ DescribeSandboxInstanceList(req: DescribeSandboxInstanceListRequest, cb?: (error: string, rep: DescribeSandboxInstanceListResponse) => void): Promise; /** * 恢复沙箱实例 */ ResumeSandboxInstance(req: ResumeSandboxInstanceRequest, cb?: (error: string, rep: ResumeSandboxInstanceResponse) => void): Promise; /** * 统一创建 Registry Record(含 revision 1)。请求通过 DescriptorType 与严格内容输入 Union 选择底层类型:MCPSource / AgentSource / SkillSource / CustomDescriptors 四选一,必须与 DescriptorType 对应。不接受 RecordId 或 ChangeLog;同名 Record 返回冲突,不隐式追加 Version。追加 Version 请使用 UpdateRegistryRecord。 */ CreateRegistryRecord(req?: CreateRegistryRecordRequest, cb?: (error: string, rep: CreateRegistryRecordResponse) => void): Promise; /** * PREPARING/PENDING_APPROVAL → CANCELED。Comment 必填。 */ CancelRegistryRecord(req?: CancelRegistryRecordRequest, cb?: (error: string, rep: CancelRegistryRecordResponse) => void): Promise; /** * 删除会话空间。 删除指定的会话空间。仅允许删除不包含会话、事件或用户状态数据的非默认会话空间;系统默认会话空间不能删除。删除成功后不再返回会话空间信息。 */ DeleteSessionSpace(req: DeleteSessionSpaceRequest, cb?: (error: string, rep: DeleteSessionSpaceResponse) => void): Promise; /** * 删除 Registry。 */ DeleteRegistry(req?: DeleteRegistryRequest, cb?: (error: string, rep: DeleteRegistryResponse) => void): Promise; /** * 修改会话信息 */ ModifySession(req: ModifySessionRequest, cb?: (error: string, rep: ModifySessionResponse) => void): Promise; /** * 删除 Deployment */ DeleteDeployment(req: DeleteDeploymentRequest, cb?: (error: string, rep: DeleteDeploymentResponse) => void): Promise; /** * 创建沙箱工具 */ CreateSandboxTool(req: CreateSandboxToolRequest, cb?: (error: string, rep: CreateSandboxToolResponse) => void): Promise; /** * 为 FAILED / EXPIRED 的 TAR Skill Version 生成新的上传尝试;VersionId 与 Revision 保持不变。 */ GetSkillPackageUploadURL(req?: GetSkillPackageUploadURLRequest, cb?: (error: string, rep: GetSkillPackageUploadURLResponse) => void): Promise; /** * 查询 Record 详情和其中一个 Version。请求可通过互斥的 VersionId 或 Label 选择 Version;均省略时默认 Label=stable。取代原 DescribeRegistryRecordVersion。 */ DescribeRegistryRecord(req?: DescribeRegistryRecordRequest, cb?: (error: string, rep: DescribeRegistryRecordResponse) => void): Promise; /** * 修改会话空间。 修改指定会话空间的名称和描述,修改成功后返回更新后的会话空间信息。默认会话空间允许修改名称和描述。 */ ModifySessionSpace(req: ModifySessionSpaceRequest, cb?: (error: string, rep: ModifySessionSpaceResponse) => void): Promise; /** * 删除 Registry Record 或指定 Version。省略 VersionId 时对整个 Record 进行软删除;传入 VersionId 时只删除指定 Version(Stable 指向的 Version 不允许删除;仅剩一个 Approved Version 时不允许删除)。取代原 DeleteRegistryRecordVersion。 */ DeleteRegistryRecord(req?: DeleteRegistryRecordRequest, cb?: (error: string, rep: DeleteRegistryRecordResponse) => void): Promise; /** * 查询会话列表 */ DescribeSessions(req: DescribeSessionsRequest, cb?: (error: string, rep: DescribeSessionsResponse) => void): Promise; /** * 查询沙箱工具列表 */ DescribeSandboxToolList(req: DescribeSandboxToolListRequest, cb?: (error: string, rep: DescribeSandboxToolListResponse) => void): Promise; /** * 获取 Skill 包下载 URL。VersionId 与 Label 互斥;均省略时使用 Stable。响应包含 ResolvedVersionId,便于调用方回填。 */ GetSkillPackageDownloadURL(req?: GetSkillPackageDownloadURLRequest, cb?: (error: string, rep: GetSkillPackageDownloadURLResponse) => void): Promise; /** * 驳回 Version 审批:PENDING_APPROVAL → REJECTED。Comment 必填。 */ RejectRegistryRecord(req?: RejectRegistryRecordRequest, cb?: (error: string, rep: RejectRegistryRecordResponse) => void): Promise; /** * 获取API密钥列表,包含API密钥简略信息,包含名称、创建时间等。 */ DescribeAPIKeyList(req?: DescribeAPIKeyListRequest, cb?: (error: string, rep: DescribeAPIKeyListResponse) => void): Promise; /** * 更新 Registry Record。两种互斥模式:①Record 更新模式:不提交任何 Source / CustomDescriptors,可通过 Description、LabelMutations 修改元数据与 Label(至少提交一项);②Version 创建模式:提交且仅提交一种与现有 DescriptorType 匹配的内容输入,可选 VersionName / ChangeLog,禁止 Description / LabelMutations,服务端在 Record 下创建下一个 Revision。取代原 ChangeRegistryRecordStableVersion / RollbackRegistryRecordVersion / Create*RegistryRecordVersion。 */ UpdateRegistryRecord(req?: UpdateRegistryRecordRequest, cb?: (error: string, rep: UpdateRegistryRecordResponse) => void): Promise; /** * 删除沙箱工具 */ DeleteSandboxTool(req: DeleteSandboxToolRequest, cb?: (error: string, rep: DeleteSandboxToolResponse) => void): Promise; /** * 暂停沙箱实例 */ PauseSandboxInstance(req: PauseSandboxInstanceRequest, cb?: (error: string, rep: PauseSandboxInstanceResponse) => void): Promise; /** * 创建会话。 为指定 Agent 和用户创建会话,创建成功后返回会话信息。 */ CreateSession(req: CreateSessionRequest, cb?: (error: string, rep: CreateSessionResponse) => void): Promise; /** * 创建会话空间。 为当前应用在指定地域创建会话空间,创建成功后返回会话空间信息。会话空间用于隔离不同业务场景下的用户、会话、事件及状态数据。 */ CreateSessionSpace(req: CreateSessionSpaceRequest, cb?: (error: string, rep: CreateSessionSpaceResponse) => void): Promise; /** * 分页查询当前应用和地域下的会话空间。 */ DescribeSessionSpaces(req: DescribeSessionSpacesRequest, cb?: (error: string, rep: DescribeSessionSpacesResponse) => void): Promise; /** * 分页查询当前租户可见的 Registry 列表。 */ DescribeRegistryList(req?: DescribeRegistryListRequest, cb?: (error: string, rep: DescribeRegistryListResponse) => void): Promise; /** * 删除会话 */ DeleteSession(req: DeleteSessionRequest, cb?: (error: string, rep: DeleteSessionResponse) => void): Promise; /** * 查询 Deployment 列表 */ DescribeDeploymentList(req: DescribeDeploymentListRequest, cb?: (error: string, rep: DescribeDeploymentListResponse) => void): Promise; /** * 查询镜像预热任务信息 */ DescribePreCacheImageTask(req: DescribePreCacheImageTaskRequest, cb?: (error: string, rep: DescribePreCacheImageTaskResponse) => void): Promise; /** * 停止沙箱实例 */ StopSandboxInstance(req: StopSandboxInstanceRequest, cb?: (error: string, rep: StopSandboxInstanceResponse) => void): Promise; /** * 按 RegistryId 查询 Registry 详情。 */ DescribeRegistry(req?: DescribeRegistryRequest, cb?: (error: string, rep: DescribeRegistryResponse) => void): Promise; /** * 查询会话。 查询指定会话的信息。 */ DescribeSession(req: DescribeSessionRequest, cb?: (error: string, rep: DescribeSessionResponse) => void): Promise; /** * 查询会话空间详情。 查询指定会话空间的详细信息,查询成功后返回会话空间的名称、描述、状态、所属地域及创建时间等信息。 */ DescribeSessionSpace(req: DescribeSessionSpaceRequest, cb?: (error: string, rep: DescribeSessionSpaceResponse) => void): Promise; /** * 删除API密钥。注意区别于腾讯云Secret ID Secret Key,本接口删除的是Agent Sandbox专用API key。 */ DeleteAPIKey(req: DeleteAPIKeyRequest, cb?: (error: string, rep: DeleteAPIKeyResponse) => void): Promise; /** * 查询当前调用账号的资源配额和当前总用量,以及账号下各配额组的资源配额和当前用量 */ DescribeQuotaOverview(req: DescribeQuotaOverviewRequest, cb?: (error: string, rep: DescribeQuotaOverviewResponse) => void): Promise; /** * 获取 Deployment 访问 Token */ AcquireDeploymentToken(req: AcquireDeploymentTokenRequest, cb?: (error: string, rep: AcquireDeploymentTokenResponse) => void): Promise; }