Skip to content

Update AI Prompts - remove deprecated assist action and add context fields #376

Closed
#384
Closed
Update AI Prompts - remove deprecated assist action and add context fields#376
#384
Labels
enhancementNew feature or requesthelp wantedExtra attention is needed

Description

@andrii-bodnar
andrii-bodnar
opened on Jun 8, 2026

The Crowdin API updates the AI resource (prompts and prompt completions) in both Crowdin and Crowdin Enterprise. API client libraries should be updated accordingly.

Remove deprecated assist action (breaking):

  • The previously deprecated assist AI prompt action is fully removed: it is dropped from the prompt action enum, and the related assist prompt-completion resource and override-prompt-values schemas are removed. Clients should drop assist from any prompt action handling.

New context fields:

  • AI prompt forms: projectContext replaces the now-deprecated old project-context field, and prompt completion forms add projectDescription (deprecating the prior field).
  • Enterprise basic-mode prompt configs (pre_translate, alignment, qa_check) gain an organizationContext flag to include the organization name and internal description in the prompt context, with corresponding enterprise prompt-completion override-prompt-values resources.

References:

  • AI
  • Crowdin Enterprise: AI

Activity

  1. andrii-bodnar
    added
    enhancementNew feature or request
    help wantedExtra attention is needed
    on Jun 8, 2026

  2. GabrielBBaldez commented on Jun 8, 2026

    @GabrielBBaldez
    GabrielBBaldez
    on Jun 8, 2026
    Contributor

    Hi! I looked into this for the Java client before opening a PR, and wanted to share a finding.

    Most of these changes don't seem to need typed changes in this SDK, because the AI prompt/completion structures are modeled loosely here:

    • The prompt action is a plain String (AiPrompt, AiPromptAddRequest) — there's no action enum to drop assist from.
    • config (prompt forms) and overridePromptValues (completion forms) are Map<String, Object>, so projectContext, organizationContext and the override-prompt-values schema changes are already expressible without code changes.

    The one concrete typed change I can see is adding projectDescription to the completion resource (AiPromptCompletionRequest.AiPromptResource). There's also AiSetting.assistActionAiPromptId, which could be removed now that the assist action is gone (breaking).

    Would you like a PR adding projectDescription (and optionally removing assistActionAiPromptId), or do you prefer to keep these as free-form Map/String in the Java client? Happy to send one either way.

  3. andrii-bodnar commented on Jun 9, 2026

    @andrii-bodnar
    andrii-bodnar
    on Jun 9, 2026
    MemberAuthor

    Hi @GabrielBBaldez, thank you for looking into this! Let's address adding the projectDescription and removing assistActionAiPromptId.

  4. GabrielBBaldez commented on Jun 9, 2026

    @GabrielBBaldez
    GabrielBBaldez
    on Jun 9, 2026
    Contributor

    Done in #384 — added projectDescription to the completion resource and removed assistActionAiPromptId from AiSetting. 🙌

  5. andrii-bodnar
    closed this as completedin #384on Jun 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesthelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions