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 documentation and examples for transformers flavor #8236

Merged
merged 5 commits into from
Apr 17, 2023

Conversation

BenWilson2
Copy link
Member

Related Issues/PRs

#xxx

What changes are proposed in this pull request?

Add docs and examples for the transformers flavor.

How is this patch tested?

  • Existing unit/integration tests
  • New unit/integration tests
  • Manual tests (describe details, including test results, below)

Manual validation of docs rendering

Does this PR change the documentation?

  • No. You can skip the rest of this section.
  • Yes. Make sure the changed pages / sections render correctly in the documentation preview.

Release Notes

Is this a user-facing change?

  • No. You can skip the rest of this section.
  • Yes. Give a description of this change to be included in the release notes for MLflow users.

Added examples for the transformers flavor and documentation guides to the flavor.

What component(s), interfaces, languages, and integrations does this PR affect?

Components

  • area/artifacts: Artifact stores and artifact logging
  • area/build: Build and test infrastructure for MLflow
  • area/docs: MLflow documentation pages
  • area/examples: Example code
  • area/model-registry: Model Registry service, APIs, and the fluent client calls for Model Registry
  • area/models: MLmodel format, model serialization/deserialization, flavors
  • area/recipes: Recipes, Recipe APIs, Recipe configs, Recipe Templates
  • area/projects: MLproject format, project running backends
  • area/scoring: MLflow Model server, model deployment tools, Spark UDFs
  • area/server-infra: MLflow Tracking server backend
  • area/tracking: Tracking Service, tracking client APIs, autologging

Interface

  • area/uiux: Front-end, user experience, plotting, JavaScript, JavaScript dev server
  • area/docker: Docker use across MLflow's components, such as MLflow Projects and MLflow Models
  • area/sqlalchemy: Use of SQLAlchemy in the Tracking Service or Model Registry
  • area/windows: Windows support

Language

  • language/r: R APIs and clients
  • language/java: Java APIs and clients
  • language/new: Proposals for new client languages

Integrations

  • integrations/azure: Azure and Azure ML integrations
  • integrations/sagemaker: SageMaker integrations
  • integrations/databricks: Databricks integrations

How should the PR be classified in the release notes? Choose one:

  • rn/breaking-change - The PR will be mentioned in the "Breaking Changes" section
  • rn/none - No description will be included. The PR will be mentioned only by the PR number in the "Small Bugfixes and Documentation Updates" section
  • rn/feature - A new user-facing feature worth mentioning in the release notes
  • rn/bug-fix - A user-facing bug fix worth mentioning in the release notes
  • rn/documentation - A user-facing documentation change worth mentioning in the release notes

Signed-off-by: Ben Wilson <benjamin.wilson@databricks.com>
Signed-off-by: Ben Wilson <benjamin.wilson@databricks.com>
Signed-off-by: Ben Wilson <benjamin.wilson@databricks.com>
@BenWilson2 BenWilson2 requested a review from harupy April 14, 2023 23:50
@mlflow-automation
Copy link
Collaborator

mlflow-automation commented Apr 14, 2023

Documentation preview for dbff39c will be available here when this CircleCI job completes successfully.

More info

@github-actions github-actions bot added area/docs Documentation issues area/examples Example code rn/feature Mention under Features in Changelogs. labels Apr 14, 2023
Copy link
Collaborator

@jinzhang21 jinzhang21 left a comment

Choose a reason for hiding this comment

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

Nice PR, @BenWilson2 !

Comment on lines 1999 to 2000
ZeroShot Classification* Dict[str, Union[List[str]|str]]* str or List[str]
Table Question Answering** Dict[str, Union[List[str]|str]]** str or List[str]
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
ZeroShot Classification* Dict[str, Union[List[str]|str]]* str or List[str]
Table Question Answering** Dict[str, Union[List[str]|str]]** str or List[str]
ZeroShot Classification* Dict[str, List[str] | str]* str or List[str]
Table Question Answering** Dict[str, List[str] | str]** str or List[str]

Copy link
Member

@harupy harupy Apr 15, 2023

Choose a reason for hiding this comment

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

For ZeroShot Classification, is {"<key1>": "<val1>", <key1>: ["<val2>"]} a valid input? Dict[str, List[str] | str] implies it is. If it's not, Dict[str, str], Dict[str, List[str]] is more precise and less confusing.

Copy link
Member Author

Choose a reason for hiding this comment

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

I like this better. Easier to read :)

mlflow.transformers.generate_signature_output(conversational_pipeline, "Hi there, chatbot!"),
)

model_info = mlflow.transformers.log_model(
Copy link
Member

@harupy harupy Apr 17, 2023

Choose a reason for hiding this comment

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

Suggested change
model_info = mlflow.transformers.log_model(
with mlflow.start_run():
model_info = mlflow.transformers.log_model(

Copy link
Member Author

Choose a reason for hiding this comment

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

updated

tokenizer=transformers.T5TokenizerFast.from_pretrained("t5-small", model_max_length=100),
)

model_info = mlflow.transformers.log_model(
Copy link
Member

@harupy harupy Apr 17, 2023

Choose a reason for hiding this comment

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

Suggested change
model_info = mlflow.transformers.log_model(
with mlflow.start_run():
model_info = mlflow.transformers.log_model(

Copy link
Member Author

Choose a reason for hiding this comment

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

updated

)

# Log the pipeline
model_info = mlflow.transformers.log_model(
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
model_info = mlflow.transformers.log_model(
with mlflow.start_run():
model_info = mlflow.transformers.log_model(

Copy link
Member Author

Choose a reason for hiding this comment

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

good catch

)

with mlflow.start_run() as run:
mlflow.transformers.log_model(
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
mlflow.transformers.log_model(
model_info = mlflow.transformers.log_model(

Copy link
Member Author

Choose a reason for hiding this comment

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

updated!

Comment on lines 22 to 24
model_uri = f"runs:/{run.info.run_id}/sentence_builder"

sentence_generator = mlflow.pyfunc.load_model(model_uri)
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
model_uri = f"runs:/{run.info.run_id}/sentence_builder"
sentence_generator = mlflow.pyfunc.load_model(model_uri)
sentence_generator = mlflow.pyfunc.load_model(model_info.model_uri)

Copy link
Member Author

Choose a reason for hiding this comment

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

much nicer :)

Copy link
Member

@harupy harupy left a comment

Choose a reason for hiding this comment

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

left some comments, otherwise LGTM!

BenWilson2 and others added 2 commits April 17, 2023 12:26
Signed-off-by: Ben Wilson <benjamin.wilson@databricks.com>
Signed-off-by: Ben Wilson <39283302+BenWilson2@users.noreply.github.com>
@BenWilson2 BenWilson2 merged commit ceca841 into mlflow:master Apr 17, 2023
25 checks passed
@BenWilson2 BenWilson2 deleted the transformers-docs branch April 17, 2023 17:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs Documentation issues area/examples Example code rn/feature Mention under Features in Changelogs.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants