Abatanga ubuhinduzi

Fully backward compatible: provider defaults to azure, so existing Azure workflows keep working unchanged — no edits required.

Guhitamwo umutanga

Gushiraho provider input kuri azure (default), aws, canke google, hanyuma uce utanga impapuro z'uwo mutangabuhamya. Only one provider is used per action call; the action deterministically delegates to the matching SDK behind a factory.

Ugereranije n'abatanga serivisi

Azure AI Translator (default)

Uwutanga amakosa. Tanga ibikoresho vy'ubuhinduzi bwa Azure AI hanyuma ukore subscriptionKey, endpoint, kandi ku bw'region. Ayo ni amwe mu mashirahamwe asanzwe akoresha mu bijanye n'imigenderanire n'ayandi makungu.

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

Koresha @aws-sdk/client-translate. Hitamwo OIDC ukoresheje aws-actions/configure-aws-credentials kugira ngo ntihagire ibanga rimara igihe kirekire ribikwa - igikorwa gisoma umuyoboro w'indangamuntu wa AWS SDK. Ku rundi ruhande, rekisa awsAccessKeyId awsSecretAccessKey mu buryo butomoye. A region is always needed, via awsRegion or the AWS_REGION environment variable.

Official AWS docs

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

OIDC (recommended)

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"]'

Kugira ngo ukoreshe imfunguzo za statique aho gukoresha OIDC, manuka intambwe ya aws-actions/configure-aws-credentials hanyuma uce awsAccessKeyId / awsSecretAccessKey (via secrets) wongeyeko awsRegion.

Google Cloud Translation

Koresha @google-cloud/translate (v2). Authenticate with either an API key (googleApiKey) or a service-account JSON credential (googleCredentials). Tanga imwe; An optional googleProjectId is inferred from the credential when omitted.

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 mapping

Ibiharuro vy'ibiharuro vy'ibiharuro biboneka aho bingana n'ivyo bihari. Ibindi vyose bisubira ku makosa yumvikana, ku buryo inyifato iguma ihindagurika.

Locale codes differ per provider

Buri mutanga ukoresha kode zayo bwite (nk'akarorero igishinwa coroshe zh-Hans kuri Azure, zh kuri AWS, na zh-CN kuri Google). Codes zica muri as-is kandi zitwara amazina y'amadosiye y'ibisohokayandikiro, rero hitamwo ibiciro toLocales umutanga watoye.