google-cloud-node icon indicating copy to clipboard operation
google-cloud-node copied to clipboard

[Dialogflow] [Reminder] Start using "locations/global" resource location identifier for Dialogflow ES and CX by April 16, 2024

Open hffmnn opened this issue 5 months ago • 4 comments

We got this email from google about the retirement of some regional endpoints/agents:

Hello Google Dialogflow Customer,

We’re writing to remind you that to improve location availability and data residency, we're updating Dialogflow ES and CX endpoints. The us-dialogflow.googleapis.com endpoint and locations/us resource location, which served as aliases for global resources, will be discontinued on April 16, 2024.

Note: Please ignore the details below if you do not use the "location/us" resource location identifier or the us-dialogflow.googleapis.com endpoint for your Dialogflow ES or CX agents.
What do you need to know?

To ensure continued functionality, please follow these steps:

    Change Resource Location: Update all instances of 'locations/us' to 'locations/global'.
    Update Endpoint: Direct your queries to dialogflow.googleapis.com.

If you do not make these changes, you will receive a '400 (invalidargumenterror)' message.
Dialogflow CX Examples

Currently, the same global Dialogflow CX v3 resource is available through the following resource URLs:

    https://dialogflow.googleapis.com/v3/projects/PROJECT/locations/global/agents/AGENT
    https://dialogflow.googleapis.com/v3/projects/PROJECT/locations/us/agents/AGENT
    https://us-dialogflow.googleapis.com/v3/projects/PROJECT/locations/global/agents/AGENT
    https://us-dialogflow.googleapis.com/v3/projects/PROJECT/locations/us/agents/AGENT

Ensure the location retirement doesn't affect your Dialogflow CX agents by using the following URL before April 16, 2024:

    https://dialogflow.googleapis.com/v3/projects/PROJECT/locations/global/agents/AGENT

The change equally applies to Dialogflow CX v3beta1 resources.
Dialogflow ES Examples

Currently, the same global Dialogflow ES v2 resource is available through the following resource URLs:

    https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents
    https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/us/agents
    https://us-dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents
    https://us-dialogflow.googleapis.com/v2/projects/PROJECT/locations/us/agents

Ensure the location retirement doesn't affect your Dialogflow ES agents by using the following URL before April 16, 2024:

    https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents

The change equally applies to Dialogflow ES v2beta1 resources.
What do you need to do?

    If you are currently using the us-dialogflow.googleapis.com endpoint, you need to replace it with dialogflow.googleapis.com.
    If you are currently using the "locations/us" resource location identifier through endpoints, you will need to replace it with "locations/global".

Alternatively, if you would like to store your data and serve your agent from a region other than global, complete the following steps before April 16, 2024:

...

We are using the @google-cloud/dialogflow package in a rather old version (4.1.0)

My questions are:

  • How to find out which endpoints the Dialogflow SDK is using?
  • Am I correct that, if all our agents are global, we don't have to update anything?

Thanks in advance!

hffmnn avatar Mar 19 '24 10:03 hffmnn