Retrieve secrets

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:

First, import the secret_vault function into your custom function:

from agent_v3.deployment_service.agents.functions.builtin import (
    secret_vault,
)

Next, you can use the secret_vault function to retrieve your secret:

secret_value = secret_vault('name of your 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, the function returns the string containing the secret_value. Example:

{
    "secret_key": "secret_value"
}

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 assistant 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.