The secret_vault function allows you to securely retrieve the contents of secrets added to your account.

​
Usage

To use the secret_vault function, follow these steps:

​
Step 1: Import the Function

First, import the secret_vault function into your custom function: 
from agent_v3.deployment_service.agents.functions.builtin import (
    secret_vault,
)

​
Step 2: Use the Function

Next, you can use the secret_vault function to retrieve your secret: 
secret_value = secret_vault('name of your secret')

​
Returns

​
For a key-value type secret

For a key-value type secret, the function returns a dictionary of key-value pairs. Example: 
{
    "secret_key": "secret_value"
}
You can access this like a standard Python dictionary in your function code.

​
For a single type secret

For a single type secret, the function returns the string containing the secret_value. Example: 
{
    "secret_key": "secret_value"
}

​
Tips

  • Check Available Secrets: There is a box called “Secrets” on the top right corner of the “Function Definition” box in the Function Editor. Click that to see what secrets your agent has access to.
  • Permission Issues: If you cannot see the secret in the “Secrets” box, please refer to the Access Control for Secrets page to add permission for your function.
  • Copy Code Snippet: In the “Secrets” box, you can also copy the code snippet for accessing the secret directly into your function code.