Okapi Framework - User contributions [en]

Google AutoML Connector

2018-10-27T00:12:34Z

Sksharan: /* Parameters */

{{Connectors Header}}
__TOC__
==Overview==

This is a connector for [https://cloud.google.com/translate/automl/docs/ Google AutoML Translation], a service that allows users to train custom models and use them for translation. If you don't require a custom model, consider using the [[Google MT v2 Connector]] instead.

{{WarningBox|The end-user is solely responsible for the costs of using this service. The developers of the Okapi Framework do their best to provide bug-free components and they are not liable, in any way, for any cost incurred by the end-user even when caused by defective code.}}

==Using the Connector==

In order to use the connector, you'll need to [https://cloud.google.com/iam/docs/creating-managing-service-accounts#creating_a_service_account create a Google service account] and [https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating_service_account_keys download a private key JSON file] for the account.

You must train a model for each language pair you intend to use with the connector. Google has a [https://cloud.google.com/translate/automl/docs/quickstart tutorial] on how to train a model through the AutoML Translation UI. You can also use the AutoML Translation API to [https://cloud.google.com/translate/automl/docs/tutorial train models programatically].

==Parameters==

<cite>Credential file path</cite> (internal name: <tt>credentialFilePath</tt>) — Absolute path on your filesystem to a JSON file containing private key information for a Google service account. This is the same JSON file described in the previous section.

<cite>Model JSON map</cite> (internal name: <tt>modelMap</tt>) — A JSON string that maps a language pair to the resource name of the model that will process translations for that language pair. Model resource names are typically of the form <code>projects/{projectId}/locations/{computeRegion}/models/{modelId}</code>.
* Example: <code>{"en-US/ja-JP": "projects/my-project/locations/us-central1/models/ABC123", "en-US/de-DE": "projects/my-project/locations/us-central1/models/DEF456"}</code>

==Limitations==

* AutoML Translation is currently in beta, so it isn't recommended for production use.
* There are costs associated with training a model. See the [https://cloud.google.com/translate/automl/pricing pricing] page for more information.
* The connector requires you have a trained model for each language pair you intend to use.
* Unlike the [[Google MT v2 Connector]], API keys cannot be used with this connector due to a [https://groups.google.com/forum/#!topic/google-translate-api/e3sOLcC1qZI limitation] of the AutoML Translation API.
* The connector does not retry API calls when they fail.
[[Category:Connectors]]

Google AutoML Connector

2018-10-27T00:03:35Z

Sksharan: /* Limitations */

{{Connectors Header}}
__TOC__
==Overview==

This is a connector for [https://cloud.google.com/translate/automl/docs/ Google AutoML Translation], a service that allows users to train custom models and use them for translation. If you don't require a custom model, consider using the [[Google MT v2 Connector]] instead.

{{WarningBox|The end-user is solely responsible for the costs of using this service. The developers of the Okapi Framework do their best to provide bug-free components and they are not liable, in any way, for any cost incurred by the end-user even when caused by defective code.}}

==Using the Connector==

In order to use the connector, you'll need to [https://cloud.google.com/iam/docs/creating-managing-service-accounts#creating_a_service_account create a Google service account] and [https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating_service_account_keys download a private key JSON file] for the account.

You must train a model for each language pair you intend to use with the connector. Google has a [https://cloud.google.com/translate/automl/docs/quickstart tutorial] on how to train a model through the AutoML Translation UI. You can also use the AutoML Translation API to [https://cloud.google.com/translate/automl/docs/tutorial train models programatically].

==Parameters==

'''Credential file path''': Absolute path on your filesystem to a JSON file containing private key information for a Google service account. This is the same JSON file described in the previous section.

'''Model JSON map''': A JSON string that maps a language pair to the resource name of the model that will process translations for that language pair. Model resource names are typically of the form <code>projects/{projectId}/locations/{computeRegion}/models/{modelId}</code>.
* Example: <code>{"en-US/ja-JP": "projects/my-project/locations/us-central1/models/ABC123", "en-US/de-DE": "projects/my-project/locations/us-central1/models/DEF456"}</code>

==Limitations==

* AutoML Translation is currently in beta, so it isn't recommended for production use.
* There are costs associated with training a model. See the [https://cloud.google.com/translate/automl/pricing pricing] page for more information.
* The connector requires you have a trained model for each language pair you intend to use.
* Unlike the [[Google MT v2 Connector]], API keys cannot be used with this connector due to a [https://groups.google.com/forum/#!topic/google-translate-api/e3sOLcC1qZI limitation] of the AutoML Translation API.
* The connector does not retry API calls when they fail.
[[Category:Connectors]]

Google AutoML Connector

2018-10-26T23:39:11Z

Sksharan: /* Parameters */

{{Connectors Header}}
__TOC__
==Overview==

This is a connector for [https://cloud.google.com/translate/automl/docs/ Google AutoML Translation], a service that allows users to train custom models and use them for translation. If you don't require a custom model, consider using the [[Google MT v2 Connector]] instead.

{{WarningBox|The end-user is solely responsible for the costs of using this service. The developers of the Okapi Framework do their best to provide bug-free components and they are not liable, in any way, for any cost incurred by the end-user even when caused by defective code.}}

==Using the Connector==

In order to use the connector, you'll need to [https://cloud.google.com/iam/docs/creating-managing-service-accounts#creating_a_service_account create a Google service account] and [https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating_service_account_keys download a private key JSON file] for the account.

You must train a model for each language pair you intend to use with the connector. Google has a [https://cloud.google.com/translate/automl/docs/quickstart tutorial] on how to train a model through the AutoML Translation UI. You can also use the AutoML Translation API to [https://cloud.google.com/translate/automl/docs/tutorial train models programatically].

==Parameters==

'''Credential file path''': Absolute path on your filesystem to a JSON file containing private key information for a Google service account. This is the same JSON file described in the previous section.

'''Model JSON map''': A JSON string that maps a language pair to the resource name of the model that will process translations for that language pair. Model resource names are typically of the form <code>projects/{projectId}/locations/{computeRegion}/models/{modelId}</code>.
* Example: <code>{"en-US/ja-JP": "projects/my-project/locations/us-central1/models/ABC123", "en-US/de-DE": "projects/my-project/locations/us-central1/models/DEF456"}</code>

==Limitations==

TODO

[[Category:Connectors]]

Google AutoML Connector

2018-10-26T23:31:21Z

Sksharan: /* Using the Connector */

Google AutoML Connector

2018-10-26T23:06:47Z

Sksharan: /* Overview */

Google AutoML Connector

2018-10-26T23:03:41Z

Sksharan: /* Overview */