Skip to main content

How to Configure a GCS Bucket for DialogFlow CX

Setup a Google Cloud Storage (GCS) bucket specifically for use with Dialogflow CX within the Botium framework

The Dialogflow CX API limits file operations above 10MB. Above this limit, a Google Cloud Storage bucket is required. We recommend setting up a new bucket dedicated to the Botium integration. This follows googles best practices for controlling permissions, using uniform bucket-level access.
Tip: The bucket can be set up on any project or account!
  1. Navigate using an Internet Browser: Open the following link to access the GCP storage browser. https://console.cloud.google.com/storage/browser
  2. Select Project: Ensure that the project you intend to use is selected at the top left of the page.

  3. 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!

  4. 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!
  5. 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.
  6. 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!
  7. Choose how to Control Access to Objects:
    • "Enforce public access prevention on this bucket" should be turned on.
    • Select "Uniform" for Access Control.
  8. 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.
  9. 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:
    1. Selecting the bucket in the cloud console
    2. Going to the lifecycle tab
    3. Selecting “Add a rule”
    4. Choosing the “Delegate Object” action
    5. Selecting a condition of “age” and specifying 7 days
    6. Creating the rule
    This will prevent storage costs growing over time.
  10. Grant Permissions to Service Accounts:
    1. Open the bucket in the cloud console
    2. Swap to the permissions tab
    3. Click “Grant Access” above the table
    4. 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
    5. It is possible to add multiple principals to the box an set permissions on them at the same time
    6. Assign the following roles:
      • Storage Object Creator
      • Storage Object Viewer
  11. Add Details to Botium: To complete your task, simply add the bucket details to the Conversation Model Downloader in Botium.
    1. Chatbot: Choose your chatbot technology
    2. Test Set: Select your test set
    3. Download Mode: Scroll down to the end of the configuration window and select 'All Utterances' from the dropdown menu.
    4. Enter GCS Details: Enter you Google Cloud Services bucket name
    5. 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.

Was this article helpful?

0 out of 0 found this helpful