Tõlketeenuse pakkujad

Täielikult tagurpidi ühilduv: provider vaikimisi kasutab azure, nii et olemasolevad Azure'i töövood töötavad muutumatult — muudatusi pole vaja.

Teenusepakkuja valimine

Määra provider sisendiks azure (vaikimisi), aws või google ning sisesta selle pakkuja mandaadid. Iga tegevuskõne kohta kasutatakse ainult ühte teenusepakkujat; tegevus delegeerib deterministlikult sobivale SDK-le tehase taga.

Pakkujate võrdlus

Azure AI Translator (default)

Vaikimisi teenusepakkuja. Loo Azure AI Translator ressurss ja edasta subscriptionKey, endpoint ja valikuliselt region. See on sama konfiguratsioon, mida olemasolevad töövood juba kasutavad.

Official Azure docs

• Azure Translator documentation
• Translate API reference
• Custom Translator overview
• Language support

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            azure:
              subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
              endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
              region: ${{ secrets.TRANSLATOR_REGION }}
          sourceLocale: en
          toLocales: '["es","fr","de"]'

AWS Translate

Kasutab @aws-sdk/client-translate. Eelista OIDC-d aws-actions/configure-aws-credentials kaudu, et pikaajalisi saladusi ei salvestataks — tegevus loeb AWS SDK vaikimisi mandaadiahelat. Või siis tee awsAccessKeyId ja awsSecretAccessKey selgelt. Regioon on alati vajalik, kas awsRegion või AWS_REGION keskkonnamuutuja kaudu.

Official AWS docs

• Amazon Translate overview
• TranslateText API reference
• Setting formality
• Using brevity
• Custom terminology
• Parallel data
• Supported languages

OIDC (soovitatav)

permissions:
  id-token: write # for aws-actions/configure-aws-credentials OIDC
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/gh-actions-translate
          aws-region: us-east-1

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            aws:
              region: us-east-1 # or rely on AWS_REGION from the step above
              formality: FORMAL
              brevity: true
          sourceLocale: en
          toLocales: '["es","fr","de"]'

Staatiliste klahvide kasutamiseks OIDC asemel jäta aws-actions/configure-aws-credentials samm välja ja anna awsAccessKeyId / awsSecretAccessKey (secrets kaudu) pluss awsRegion.

Google Cloud Translation

Kasutab @google-cloud/translate (v2). Auntimine kas API võtme (googleApiKey) või teenusekonto JSON mandaadiga (googleCredentials). Anna täpselt üks; Vabatahtlik googleProjectId tuletatakse kvalifikatsioonist, kui see välja jäetakse.

Official Google docs

• Cloud Translation documentation
• Cloud Translation setup
• Translating text
• Supported languages

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            google:
              # Provide EITHER a service-account JSON credential...
              credentials: ${{ secrets.GCP_TRANSLATE_CREDENTIALS }}
              # ...OR an API key:
              # apiKey: ${{ secrets.GCP_TRANSLATE_API_KEY }}
              model: nmt
          sourceLocale: en
          toLocales: '["es","fr","de"]'

Intent-specifier kaardistamine

Teenusepakkujaspetsiifilised spetsifikaatorid kaardistatakse kohtades, kus eksisteerib ekvivalent. Kõik muu langeb mõistlike vaikimisi reegleid, et käitumine püsiks ühtlane.

Kohalikud koodid erinevad teenusepakkujati

Iga teenusepakkuja kasutab oma kohalikke koode (näiteks Simplified Chinese on Azure'is zh-Hans, AWS-is zh ja Google'is zh-CN). Koodid läbivad nii nagu on ja juhivad väljundfailide nimesid, seega vali, toLocales väärtusi sinu valitud teenusepakkuja toetab.