Crowdin AI

Crowdin 与顶级 AI 提供商集成，包括 OpenAI、Google Gemini、Microsoft Azure OpenAI 等，使您能够利用考虑不同级别的额外背景的高级 AI 翻译。只需点击几下，使用通过 AI 自动翻译即可将这些译文应用到您的内容中。此外，Crowdin 中的 AI 还可用于编辑器中的 AI 建议和 AI QA 检查。

您可以通过从 Crowdin 商店安装相应的应用程序来扩展您的 AI 提供商选项。

配置 AI

Crowdin AI 集成为增强本地化工作流提供了强大的功能。配置 AI 涉及设置提供商和创建提示词。

配置 AI 提示词

提示工程（Prompt Engineering）对于引导 AI 理解语境并提供准确的译文至关重要。 Crowdin 中的自定义提示词可确保 AI 算法理解项目的细微差别，从而提高翻译质量。

语境提示词 – 自定义提示词以提供语境信息，例如项目特定的术语、风格偏好和目标受众考虑因素。例如，包括关于一致地翻译技术术语或在各语言中保持品牌基调的说明。
占位符利用 – 结合占位符将特定于语境的信息动态插入提示词中，使 AI 能够生成符合项目要求的译文。
文件级语境 – 使用文件级语境提供说明和语境见解，增强 AI 对内容细微差别的理解。包括文件描述、摘要或术语库以及风格指南的引用。

要配置 AI 提示词，请按照以下步骤操作：

打开您的个人资料并在左侧边栏中选择 AI。
在提示词选项卡中，单击 添加提示词。如果尚未创建任何提示词，您可以单击创建默认提示词，快速设置预配置的示例，并根据个人偏好进行自定义。
在出现的对话框中，设置提示词参数：
- 选择提示词类型（即自动翻译与 AI 建议、QA 检查或创建自定义类型）
- 自定义类型名称（特定于自定义提示词类型）
- 将此提示词用作编辑器中 AI 建议的默认提示词（特定于自动翻译与 AI 建议提示词类型）
- 标题
- 模型（包括 AI 提供商）
- 高级设置：
  - 可见性 – 选择可使用提示词的项目：
    - 所有项目 – 该提示词在所有项目中均可用。
    - 选定项目 – 该提示词仅在您选择的项目中可用。如果未选择任何项目，或所有已分配的项目后来被删除，则该提示词将在任何项目中均不可用。
  - QA 问题自动重试 – 如果收到的译文未通过 QA 检查，允许自动向 AI 发送额外请求。
- 提示词编辑器模式（即基本模式或高级模式）
- 附加语境（基本模式）– 使用以下字段指定将包含在提示词中的数据：
  
  默认包含的语境：字符串语境、字符串标识符（键）、译文最大长度。
  - 其他语言译文 – 选择特定语言的译文供 AI 视为附加语境，或留空此字段以使用所有语言的译文。
  - 术语库术语 – 允许 AI 考虑领域术语库术语。
  - 翻译记忆译文 – 允许 AI 考虑翻译记忆译文。
  - 风格指南 – 允许 AI 考虑项目中分配的风格指南中定义的规则、语气和语言偏好。
  - 前后字符串 – 允许 AI 考虑前后字符串以获取附加语境。
  - 文件语境 – 允许 AI 考虑在文件设置或编辑器中为文件添加的文字说明。
  - AI 生成的文件语境 – 在缺少文件语境时自动生成。如果未手动提供文件语境，AI 将分析源内容并生成语境摘要。此摘要在自动翻译期间和编辑器中均作为参考资料使用。
    
    此选项仅在基于文件的项目中可用，并且需要启用“文件语境”选项。
  - 截图 – 允许 AI 考虑标记了字符串的截图中的视觉语境。这提高了准确性和语境感知能力。
    详细了解截图。
  - Project context – allows AI to consider the project name and description. This gives the AI a high-level understanding of your product, helping it choose appropriate terminology and tone.
  - 代码片段 – 选择之前在您的 Crowdin 账户的 AI > 代码片段中创建的可复用内容，以快速将标准文本代码片段插入提示词中。
  - 评估步骤（特定于 QA 检查提示词类型）– 定义 AI 用于评估译文的标准。您可以自定义、删除或创建符合您质量要求的新步骤。
- 高级模式 – 单击高级模式，以更高精度编写您的提示词。使用以下占位符插入语境：
  
  单击占位符可将其复制，然后粘贴到提示词字段中。
  - %sourceLanguage% – 项目的源语言。
  - %targetLanguages% – 项目所有目标语言的列表。
  - %targetLanguage% – 内容翻译成的目标语言。
  - %pluralForms% – 目标语言的复数形式列表。
  - %strings% – 当前句段的字符串集合，包括字符串标识符（键）、语境、文本、最大长度以及其他语言译文（如果指定了译文占位符）。
  - %translationUnits% – AI 在 QA 检查期间评估的翻译单元列表（源文本和译文）。
  - %fileName% – 当前句段的文件名。
  - %fileContext% – 当前句段的文件语境（通过“文件”选项卡中的文件设置模式提供）。
  - %siblingsStrings% – 文件中的前后句段，用于提供语境翻译参考。
  - %filteredStrings% – 编辑器中符合当前筛选条件的字符串，提供给 AI 以提高评估准确性和效率。
  - %projectName% – The project name.
  - %projectDescription% – The project description.
  - %assignedStyleGuides% – 分配给项目的风格指南。
  - 代码片段 – 使用 %custom:snippetName% 格式，插入之前在您的 Crowdin 账户的 AI > 代码片段中定义的可复用内容。
使用重置为默认按钮可恢复 Crowdin 原始默认提示词内容和占位符。如果您希望在保存前放弃更改并从头开始，此功能非常有用。
单击创建。

在项目设置中创建提示词

您也可以直接从项目的设置 > AI 部分创建提示词。以这种方式创建的提示词默认情况下仅对该特定项目可见。

详细了解项目中的 AI 设置。

管理 AI 提示词

在 Crowdin 中管理 AI 提示词涉及各种操作，例如筛选与搜索、编辑、克隆以及删除 AI 提示词。下面您可以找到每个操作的说明。

查看与筛选 AI 提示词

打开 AI 页面后，您可以在 提示词 选项卡中查看和搜索提示词。

您可以查看已添加提示词的列表，其中包含以下详细信息：

名称 – 提示词的名称。
可见性 – 显示该提示词在多少个项目中可用的计数器，以及项目列表（带有可点击的链接）。
类型 – 提示词的类型（例如，自动翻译与 AI 建议、QA 检查、自定义类型）。
模型 – 提示词使用的 AI 模型。模型名称旁边的状态指示器显示提示词是否可以使用：
- 绿色圆点表示提示词配置正确，可以使用。
- 红色圆点表示提示词配置存在问题（例如，所选提供商已被禁用）。将鼠标悬停在模型名称上可查看具体错误信息。
创建时间 – 提示词的创建日期。
创建者 – 创建该提示词的用户。
最后修改时间 – 提示词最后更新的日期。
修改者 – 最后修改该提示词的用户。
最后使用者 – 最后使用该提示词的用户。
最后使用时间 – 提示词最后使用的日期。
使用次数 – 该提示词被使用的总次数。

要查找特定提示词，请使用搜索字段。要缩小列表范围，请单击筛选器按钮，可按类型、创建时间日期、创建者用户、最后修改时间日期、修改者用户、最后使用者用户和最后使用时间日期进行筛选。

编辑 AI 提示词

如果您需要调整已配置的提示词，只需对其进行编辑即可。

要编辑 AI 提示词，请按照以下步骤操作：

打开您的个人资料并在左侧边栏中选择 AI。
在提示词选项卡中，单击所需提示词的并选择编辑。
根据需要修改提示词，然后单击更新以保存更改。

编辑提示词时，您会看到提示词元数据部分。此信息为协作和故障排查提供了清晰的审计跟踪。通过跟踪创建、修改和使用数据，您可以了解哪些提示词最有效，识别热门提示词以进行优化，并更高效地管理成本。该部分包含以下只读详情：

创建者 – 创建该提示词的用户。
创建时间 – 提示词创建的日期和时间。
修改者 – 最后修改该提示词的用户。
最后修改时间 – 提示词最后修改的日期和时间。
最后使用者 – 最后使用该提示词的用户。
最后使用时间 – 提示词最后使用的日期和时间。
使用次数 – 使用此提示词向 AI 发出请求的总次数。

编辑提示词允许您根据需要更新和改进它们，以确保它们保持有效并符合您的要求。如果您不想丢失当前的提示词配置，但又不确定所做的更改，请考虑克隆您的提示词并使用副本进行实验。

克隆 AI 提示词

克隆 AI 提示词允许您尝试和改进提示词配置而不更改原始提示词。此功能对于在保留初始设置的同时测试改进版本的提示词特别有用。此功能对于在保留初始设置的同时测试提示词的改进版本特别有用。

要克隆 AI 提示词，请按照以下步骤操作：

打开您的个人资料并在左侧边栏中选择 AI。
在提示词选项卡中，单击所需提示词的并选择克隆。
因此，提示词的副本将出现在提示词列表中。

然后，您可以编辑克隆的提示词以尝试不同的配置。这样您就可以安全地测试增强功能并优化性能，而不会冒丢失原始提示词配置的风险。

删除 AI 提示词

删除 AI 提示词是一个简单的过程，但应谨慎操作以避免丢失宝贵的配置。当您不再需要特定提示词或想要清理未使用的提示词时，此操作很有用。

要删除 AI 提示词，请按照以下步骤操作：

打开您的个人资料并在左侧边栏中选择 AI。
在提示词选项卡中，单击所需提示词的并选择移除。
确认删除。

配置 AI 提供商

Crowdin 支持各种 AI 提供商，每种提供商都为翻译任务提供独特的模型和功能。通过配置提供商，您可以定制 AI 功能以满足您的特定本地化需求。无论是使用由 Crowdin 管理的服务还是集成您自己的 API 密钥，Crowdin 都能实现与 AI 服务的无缝集成。

在 提供商 选项卡中，您可以查看提供商列表，其中包含以下详细信息：

名称
状态：已启用、已禁用。
由 Crowdin 托管：是、否。
提示词数量：如果使用特定提供商配置了一个或多个提示词，您将看到实际的提示词数量，否则您将看到重定向到提示词创建对话框的创建按钮。

Crowdin AI 提供商分为两种类型。系统提供商（例如 OpenAI、Microsoft Azure OpenAI、Google Gemini）为内置提供商，可立即进行配置。此外，您还可以通过从 Crowdin 商店安装其他 AI 提供商来扩展您的选项。

目前，Crowdin 支持以下 AI 提供商：

Crowdin AI System
OpenAI System
Microsoft Azure OpenAI System
Google Gemini System
Mistral AI System
Anthropic System
xAI System
IBM Watsonx System
DeepSeek System
Groq
Cloudflare Workers AI
Fireworks AI
Together AI
OpenRouter
Cohere
Replicate
Credal
AWS Bedrock
Alibaba Cloud Model Studio
Xiaomi MiMo
NVIDIA NIM

新的 AI 提供商会定期添加。

配置 AI 提供商时，您可以从两个选项中进行选择：

使用您自己的 API 密钥 – 如果担心数据安全并希望增强隐私和所有权，Crowdin 建议使用此选项。此选项需要外部注册才能从 AI 提供商处获取 API 密钥/凭证。
使用由 Crowdin 托管的服务 – 简化 AI 集成，无需管理您自己的 API 密钥。允许您利用 Crowdin 的默认设置和基础设置以便捷的方式访问 AI 功能。非常适合简单且快速的任务。要开始使用由 Crowdin 托管的 AI 提供商，您只需向余额中添加资金。

要配置 AI 提供商，请按照以下步骤操作：

打开您的个人资料并在左侧边栏中选择 AI。
在提供商选项卡中，单击所需提供商的并选择编辑。或者，只需双击所需的提供商。
选择已启用。
选择您的凭据类型：
- 要使用由 Crowdin 托管的服务，请选择 {Provider} 由 Crowdin 托管。在这种情况下，您需要向账户余额中添加资金。
- 要使用您自己的账户，请选择使用我自己的 API 密钥并输入所需凭据。有关生成 API 密钥的说明，请参阅您的 AI 提供商的官方文档。某些 AI 提供商可能还需要额外的特定凭据。详情请参阅下方的提供商特定凭据部分。
（可选） 单击高级设置以访问其他选项：
- 覆盖基础 URL – 允许您将 AI 提供商请求定向到自定义或特定区域的端点，而非默认 URL。如果您正在使用代理或从提供自定义端点的第三方服务使用 AI，此功能非常有用。否则，您可以将此字段留空。
  注意
  - 使用由 Crowdin 托管服务时，此选项不可用。
  - 对于 Microsoft Azure OpenAI，Crowdin 需要使用默认的 Azure URL 结构。例如：https://{baseUrl}/deployments/{deploymentName}/chat/completions
单击更新。

提供商特定凭据

当您使用自己的凭据时，某些 AI 提供商在身份验证时除标准 API 密钥外还需要额外信息。

Google Gemini

配置 Google Gemini 时，您需要提供以下凭据：

项目 ID：您唯一的 Google Cloud 项目 ID。您可以在 Google Cloud Console 的控制台中找到此 ID。
区域：您的模型所在的区域。请确保您计划使用的模型在所选区域中可用。您可以在 Vertex AI 控制台中找到此信息。请参阅 Google Cloud 官方文档，获取可用 Gemini 模型和区域列表。
服务账号密钥：用于身份验证的 JSON 文件。获取此文件的方法：

在您的 Google Cloud 项目中，前往 IAM 与管理员 > 服务账号。
创建新服务账号或选择现有服务账号。
为其授予 Vertex AI 用户角色（roles/aiplatform.user）。
前往该服务账号的密钥选项卡，单击添加密钥 > 创建新密钥，选择 JSON，然后单击创建。密钥将自动下载。
在 Crowdin 中，单击选择文件上传此 JSON 密钥。

Microsoft Azure OpenAI

配置 Microsoft Azure OpenAI 时，您需要提供以下凭据：

资源名称：您的 Azure OpenAI 服务资源名称，可在 Azure 主门户中找到。
部署名称：您为部署指定的名称。
API 版本：您的模型所需的 API 版本。通常可以在部署的属性中或 Azure 提供的代码示例中找到推荐版本。例如：2024-02-01。

IBM Watsonx

配置 IBM Watsonx 时，您需要提供以下凭据：

项目 ID：您的 Watsonx.ai 项目 ID。要找到它，请导航到您的项目，前往管理选项卡，然后从常规部分复制项目 ID。
区域：您的 Watsonx 项目所在的区域。您可以在项目控制台中找到此信息。请参阅 IBM Cloud 官方文档，获取 watsonx.ai 可用区域列表。

禁用 AI 提供商

如果需要，您可以随时禁用任何之前启用的提供商。

要禁用 AI 提供商，请按照以下步骤操作：

打开您的个人资料并在左侧边栏中选择 AI。
在提供商选项卡中，单击所需提供商的并选择禁用。或者，双击所需的提供商，然后清除提供商设置中的 已启用。

向账户余额添加资金

Crowdin 管理的机器翻译引擎和 AI 模型是单独付费的服务。要使用它们，您首先需要向 Crowdin 账户余额中添加资金。

详细了解向账户余额添加资金。

AI 提示词的代码片段

代码片段是可复用的信息片段，帮助 AI 更好地理解您的项目。它们提供有关您的公司、产品或特定要求（如品牌声音和目标受众）的语境信息。将这些信息作为代码片段进行管理可节省时间，并有助于生成更好、更一致的译文。

在代码片段选项卡中，您可以查看代码片段及以下详细信息：

名称 – 用于将代码片段插入提示词的唯一标识符。
描述 – 对代码片段用途的简要说明。
创建时间 – 代码片段的创建日期。

使用搜索字段快速查找特定代码片段。

创建代码片段

要创建新代码片段，请按以下步骤操作：

在代码片段选项卡中，单击 添加代码片段。
在添加代码片段对话框中，填写以下字段：
- 名称 – 代码片段的唯一标识符（例如，company-description 或 target-audience）。
- 描述 – 对代码片段用途的简要说明，便于识别。
- 内容 – 使用代码片段时将插入提示词的实际文本。
单击创建。

在提示词中使用代码片段

创建代码片段后，可将其插入任何 AI 提示词中：

在基本模式下，从代码片段部分的下拉菜单中选择一个或多个代码片段。
在高级模式下，使用占位符格式插入代码片段：%custom:snippetName%。例如，名称为 company-description 的代码片段将以 %custom:company-description% 的形式插入。