Store secrets with Vault

Agent Builder provides Vault, which is a secure way to store and use secrets in your agents. Use Vault to store sensitive information like API keys, passwords, and other credentials.

You can reference secrets in any block in your blueprint.

​

Create a secret

Secrets are strings stored as key-value pairs. To create a secret, go to the Vault tab in the Agent Builder UI and click Add a pair.

The example below creates a secret with the name WRITER_API_KEY. When you type the value, it’s masked in the UI.

Click Save to store the secret.

You can also delete and update secrets from the Vault tab.

​

Use a secret

To use a secret, reference it in a block in your blueprint with the prefix @{vault}. For example, to use the WRITER_API_KEY secret, you would it as @{vault.WRITER_API_KEY}.

The example below shows adding an authorization header to an HTTP request block using the WRITER_API_KEY secret.

When you reference a secret, it’s automatically masked in the UI.

​

Secrets in Python code

You can also reference secrets in Python code blocks using the vault object. vault is a dictionary that contains all the secrets in your blueprint. For example, to access a secret called API_KEY and use it in an HTTP request, you would use the following code:

headers = {
    "Authorization": f"Bearer {vault['API_KEY']}"
}