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 and within Python code. Vault overview

​
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 use 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.

​
Use a secret in Python code

You can access secrets in Python code blocks within blueprints 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']}"
}
Learn more about accessing secrets in Python code.