Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add masking strategies to message transforms #2284

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

supreethmanyam
Copy link

@supreethmanyam supreethmanyam commented Jan 20, 2025

Context

What is the purpose of this PR? Is it to

  • add a new feature
  • fix a bug
  • update tests and/or documentation
  • other (please add here)

Please link to any issues this PR addresses.
#2261

Changelog

What are the changes made in this PR?

  • Added mask_messages utility in torchtune/data/_messages.py to mask each message given a list of messages based on user provided masking_strategy
  • Fixes in-built message transforms to always mask system message
  • Added tests for calling message transforms with masking strategies

Test plan

Please make sure to do each of the following if applicable to your PR. If you're unsure about any one of these just ask and we will happily help. We also have a contributing page for some guidance on contributing.

  • run pre-commit hooks and linters (make sure you've first installed via pre-commit install)
  • add unit tests for any new functionality
  • update docstrings for any new or updated methods or classes
  • run unit tests via pytest tests
  • run recipe tests via pytest tests -m integration_test
  • manually run any new or modified recipes with sufficient proof of correctness
  • include relevant commands and any other artifacts in this summary (pastes of loss curves, eval results, etc.)

UX

If your function changed a public API, please add a dummy example of what the user experience will look like when calling it.
Here is a docstring example
and a tutorial example

  • I did not change any public API
  • I have added an example to docs or docstrings

Copy link

pytorch-bot bot commented Jan 20, 2025

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/torchtune/2284

Note: Links to docs will display an error until the docs builds have been completed.

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@facebook-github-bot facebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jan 20, 2025
@supreethmanyam supreethmanyam force-pushed the add-chat-loss-masking-strategies branch from db9a565 to 255bdcd Compare January 20, 2025 23:14
@supreethmanyam supreethmanyam force-pushed the add-chat-loss-masking-strategies branch from 255bdcd to ac6272f Compare January 20, 2025 23:22
@supreethmanyam
Copy link
Author

supreethmanyam commented Jan 21, 2025

@RdoubleA Added mask_messages utility in torchtune/data/_messages.py along with relevant unit tests.
I will update the documentation once the changes look good. Please let me know.

@RdoubleA RdoubleA mentioned this pull request Jan 21, 2025
Copy link
Contributor

@RdoubleA RdoubleA left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great, really like the tests 👌 left a couple of comments

@@ -176,12 +185,24 @@ class InputOutputToMessages(Transform):

def __init__(
self,
train_on_input: bool = False,
masking_strategy: Optional[str] = "train_on_all",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if the default value for train_on_input was False, this would correspond to train_on_assistant. Let's keep that same default behavior.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated default strategy

@@ -305,11 +332,23 @@ class ChosenRejectedToMessages(Transform):

def __init__(
self,
train_on_input: bool = False,
masking_strategy: Optional[str] = "train_on_all",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment here

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated default strategy


Raises:
ValueError: If ``column_map`` is provided and ``conversations`` not in ``column_map``.
"""

def __init__(
self,
train_on_input: bool = False,
masking_strategy: Optional[str] = "train_on_all",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment here

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated default strategy

"""

def __init__(
self, train_on_input: bool = True, column_map: Optional[Dict[str, str]] = None
self,
masking_strategy: Optional[str] = "train_on_all",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

contrary to the other comment, this default value should remain train_on_all since train_on_input was defaulted to True. so let's keep this

ValueError: If the masking strategy is not one of the supported strategies:
`train_on_all`, `train_on_assistant`, `train_on_last`.
"""
if masking_strategy not in ["train_on_all", "train_on_assistant", "train_on_last"]:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One suggestion that I didn't mention in the issue is that we could make masking_strategy an Enum so that it can be type checked more easily. users can still specify as a string in the config and in the message transforms above, but here in mask_messages you could convert to the Enum, and the ValueError will automatically be captured.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Converted masking_strategy to Enum and raises ValueErroe automatically if doesn't match with mapping

@supreethmanyam
Copy link
Author

@RdoubleA

In addition to converting masking_strategy to Enum and fixing default strategy in built-in transforms, I made following small changes:

  1. I modified structure of column_map usage in InputOutputToMessages and AlpacaToMessages to make it consistent across transforms
  2. I realized there were no unit tests for AlpacaToMessages, I added a few tests.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants