Setup a Google Cloud Storage (GCS) bucket specifically for use with Dialogflow CX within the Botium framework
Tip: The bucket can
be set up on any project or account!
- Navigate using an Internet Browser: Open the following link to access the GCP storage browser. https://console.cloud.google.com/storage/browser
-
Select Project: Ensure that the project you intend to use is selected at
the top left of the page.
-
Click Create: Click the Create button to begin setup. The
following steps detail the settings recommended when setting up the bucket. This
choice does not directly impact Botium integration!
-
Name your Bucket: Choose a name (and any tags) that are meaningful and
align with your naming conventions.
Note: This choice does not directly impact the Botium integration!
-
Choose Where to Store your Data: The bucket is needed only for
short-term transfer, so increased redundancy or versioning is not
necessary.
Note: This choice does not directly impact the Botium integration!Tip: Choosing a location type of "Region" and a region that matches your DialogFlow agents region may lead to lower costs.
-
Choose a Storage Class: The default "Standard" storage class is best
suited, as all others are intended for long term storage.
Note: This choice does not directly impact the Botium integration!
-
Choose how to Control Access to Objects:
- "Enforce public access prevention on this bucket" should be turned on.
- Select "Uniform" for Access Control.
-
Choose how to Protect Object Data: Protection tools are not
required.
Note: This choice does not directly impact the Botium integration!Tip: The choice between Google-managed or customer-managed encryption keys should be based on your organization's policies.
-
Create the Bucket: Once you have configured your advanced settings,
click the Create button to finalize your choices.
Tip: We strongly recommend adding a lifecycle rule to the bucket! (Botium will not delete any data itself):Set a Lifecycle to Auto-Delete. This can be done by:
- Selecting the bucket in the cloud console
- Going to the lifecycle tab
- Selecting “Add a rule”
- Choosing the “Delegate Object” action
- Selecting a condition of “age” and specifying 7 days
- Creating the rule
-
Grant Permissions to Service Accounts:
- Open the bucket in the cloud console
- Swap to the permissions tab
- Click “Grant Access” above the table
- Add the service accounts to the “New Principals” box – you will need to paste in the “email address” of the service account – see “Retrieving a service account email address” below
- It is possible to add multiple principals to the box an set permissions on them at the same time
- Assign the following roles:
- Storage Object Creator
- Storage Object Viewer
-
Add Details to Botium: To complete your task, simply add the bucket
details to the Conversation Model Downloader in Botium.
- Chatbot: Choose your chatbot technology
- Test Set: Select your test set
- Download Mode: Scroll down to the end of the configuration window and select 'All Utterances' from the dropdown menu.
- Enter GCS Details: Enter you Google Cloud Services bucket name
-
Download: Click the Download button to begin your
download
Tip: See How to Use the Conversation Model Downloader for a more detailed steps on using the conversation model downloader.