VaultService
@Service @Transactional public class VaultService源码Source
io/agentscope/builder/web/managed/service/VaultService.java:35–236Vault 服务，承载智能体的部署、调度与服务化运行。位于 io.agentscope.builder.web.managed.service 包。核心成员包括 list、get、create、delete、listCredentials、addCredential。
CRUD for credential vaults with encrypted secret storage.
嵌套类摘要Nested Class Summary
| 类Class | 类型Kind | 说明Description |
|---|---|---|
CreateVaultRequest | 记录record | 承载创建 Vault 请求数据的记录类型。 Request body for creating a vault. |
AddCredentialRequest | 记录record | 承载添加凭证请求数据的记录类型。 Request body for adding a credential. |
字段摘要Field Summary
| 字段Field | 类型Type | 说明Description |
|---|---|---|
RESOURCE_TYPEstaticfinal | String | 资源类型字段。 Resource-type key used for `ResourceAccessService` share grants. |
构造器摘要Constructor Summary
方法摘要Method Summary
字段详情Field Detail
RESOURCE_TYPE
public static final String RESOURCE_TYPEstaticfinal
资源类型字段。声明为 public static final String RESOURCE_TYPE。
Resource-type key used for ResourceAccessService share grants.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:40构造器详情Constructor Detail
VaultService
public VaultService(VaultEntityRepository vaultRepository, VaultCredentialEntityRepository credentialRepository, VaultCrypto vaultCrypto, ManagedJsonHelper jsonHelper, ResourceAccessService resourceAccessService)初始化 VaultService 实例。
Creates a new instance.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
vaultRepository | VaultEntityRepository | vault 仓库（类型 `VaultEntityRepository`）。The vault repository. |
credentialRepository | VaultCredentialEntityRepository | 凭证仓库（类型 `VaultCredentialEntityRepository`）。The credential repository. |
vaultCrypto | VaultCrypto | vault Crypto（类型 `VaultCrypto`）。The vault crypto. |
jsonHelper | ManagedJsonHelper | JSON Helper（类型 `ManagedJsonHelper`）。The json helper. |
resourceAccessService | ResourceAccessService | 资源访问服务（类型 `ResourceAccessService`）。The resource access service. |
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:54–65方法详情Method Detail
list
public List<VaultDto> list(String ownerId)设置列表。
Lists vaults owned by the user.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
List<VaultDto>返回列出。Returns list.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:68–73get
public VaultDto get(String ownerId, String vaultId)按条件读取数据。
Returns a single vault when owned by, or shared (at least RUN) with, the caller.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
vaultId | String | vault 标识（类型 `String`）。The vault id. |
VaultDto返回VaultDto。Returns vault dto.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:76–79create
public VaultDto create(String ownerId, CreateVaultRequest request)创建并返回实例。
Creates a vault.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
request | CreateVaultRequest | 请求（类型 `CreateVaultRequest`）。The request. |
VaultDto返回VaultDto。Returns vault dto.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:82–95delete
public void delete(String ownerId, String vaultId)删除数据。
Deletes a vault and all credentials.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
vaultId | String | vault 标识（类型 `String`）。The vault id. |
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:98–102listCredentials
public List<VaultCredentialDto> listCredentials(String ownerId, String vaultId)列出凭证。
Lists credential metadata for a vault (no plaintext).
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
vaultId | String | vault 标识（类型 `String`）。The vault id. |
List<VaultCredentialDto>返回列出。Returns list.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:105–111addCredential
public VaultCredentialDto addCredential(String ownerId, String vaultId, AddCredentialRequest request)添加凭证。
Adds an encrypted credential to a vault.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
vaultId | String | vault 标识（类型 `String`）。The vault id. |
request | AddCredentialRequest | 请求（类型 `AddCredentialRequest`）。The request. |
VaultCredentialDto返回VaultCredentialDto。Returns vault credential dto.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:114–136deleteCredential
public void deleteCredential(String ownerId, String vaultId, String credentialId)删除凭证。
Deletes a credential from a vault.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
vaultId | String | vault 标识（类型 `String`）。The vault id. |
credentialId | String | 凭证标识（类型 `String`）。The credential id. |
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:139–155getDecryptedSecret
public String getDecryptedSecret(String ownerId, String credentialId)获取已解密密钥。
Returns decrypted secret JSON for internal MCP injection.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ownerId | String | 所有者标识（类型 `String`）。The owner id. |
credentialId | String | 凭证标识（类型 `String`）。The credential id. |
String返回字符串结果。Returns a string.
源码Source
io/agentscope/builder/web/managed/service/VaultService.java:158–170嵌套类详情Nested Class Detail
CreateVaultRequest
public record CreateVaultRequest(String displayName, Map<String, Object> metadata)承载创建 Vault 请求数据的记录类型。位于 io.agentscope.builder.web.managed.service 包。核心成员包括 displayName、metadata。
Request body for creating a vault.
AddCredentialRequest
public record AddCredentialRequest(String type, String label, String target, String secret)承载添加凭证请求数据的记录类型。位于 io.agentscope.builder.web.managed.service 包。核心成员包括 type、label、target、secret。
Request body for adding a credential.