Nhà cung cấp dịch thuật

Hoàn toàn tương thích ngược: provider mặc định là azure, vì vậy quy trình làm việc Azure hiện có tiếp tục hoạt động không thay đổi — không cần chỉnh sửa.

Chọn nhà cung cấp

Đặt đầu vào provider thành azure (mặc định), aws hoặc google, sau đó cung cấp thông tin đăng nhập của nhà cung cấp đó. Chỉ một nhà cung cấp được sử dụng cho mỗi lệnh gọi hành động; hành động ủy quyền xác định cho SDK phù hợp phía sau nhà máy.

So sánh nhà cung cấp

Azure AI Translator (mặc định)

Nhà cung cấp mặc định. Cung cấp tài nguyên Azure AI Translator và chuyển subscriptionKey, endpoint và region tùy chọn. Đây là cấu hình tương tự mà quy trình làm việc hiện có đã sử dụng.

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

Dịch AWS

Sử dụng @aws-sdk/client-translate. Ưu tiên OIDC qua aws-actions/configure-aws-credentials để không lưu trữ bí mật tồn tại lâu dài — hành động đọc chuỗi thông tin xác thực mặc định của AWS SDK. Ngoài ra, hãy chuyển awsAccessKeyId và awsSecretAccessKey một cách rõ ràng. Một khu vực luôn được yêu cầu, thông qua awsRegion hoặc biến môi trường AWS_REGION.

Official AWS docs

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

OIDC (khuyến nghị)

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

Để sử dụng phím tĩnh thay vì OIDC, hãy bỏ bước aws-actions/configure-aws-credentials và chuyển awsAccessKeyId / awsSecretAccessKey (qua secrets) cộng với awsRegion.

Dịch thuật Google Cloud

Sử dụng @google-cloud/translate (v2). Xác thực bằng khóa API (googleApiKey) hoặc thông tin xác thực JSON tài khoản dịch vụ (googleCredentials). Cung cấp chính xác một; Một googleProjectId tùy chọn được suy ra từ thông tin xác thực khi bị bỏ qua.

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

Ánh xạ trình chỉ định ý định

Bộ chỉ định dành riêng cho nhà cung cấp được ánh xạ ở nơi tồn tại một chỉ số tương đương. Mọi thứ khác đều quay trở lại mặc định hợp lý để hành vi vẫn nhất quán.

Mã ngôn ngữ khác nhau tùy theo nhà cung cấp

Mỗi nhà cung cấp sử dụng mã ngôn ngữ riêng (ví dụ: Tiếng Trung giản thể được zh-Hans trên Azure, zh trên AWS và zh-CN trên Google). Mã truyền qua nguyên trạng và điều khiển tên tệp đầu ra, vì vậy hãy chọn toLocales giá trị mà nhà cung cấp đã chọn của bạn hỗ trợ.