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

.Net: Update PromptTemplateEngine to render code blocks in parallel #1889

Merged
merged 6 commits into from
Jul 12, 2023

Conversation

dehoward
Copy link
Contributor

@dehoward dehoward commented Jul 7, 2023

Motivation and Context

this PR looks to add basic parallelization when rendering code blocks in the template engine.
today, functions are called sequentially but have the ability to be invoked in either way.

Description

  • changed PromptTemplateEngine to use Task.WhenAll instead of await when calling ICodeRendering.RenderCodeAsync.
    to ensure the code blocks are appended to the prompt in the same order, a placeholder is inserted into the output before the function call has completed. once it's done, the placeholder, a Guid in RenderAsync and null in RenderCodeAsync, is replaced with the result of the call.
  • added a test for PromptTemplateEngine.RenderCodeAsync.

Contribution Checklist

changes both PromptTemplateEngine.RenderAsync and PromptTemplateEngine.RenderCodeAsync
to render code blocks in parallel using Task.WhenAll() instead of awaiting
each function call. to keep the same order, a placeholder is inserted
into the output and is later replaced when the async action is complete.

added a unit test to verify that code blocks are rendered in the correct
order.
@dehoward dehoward added .NET Issue or Pull requests regarding .NET code kernel Issues or pull requests impacting the core kernel kernel.core labels Jul 7, 2023
@dehoward dehoward requested a review from a team as a code owner July 7, 2023 04:01
@dehoward dehoward self-assigned this Jul 7, 2023
@dehoward
Copy link
Contributor Author

dehoward commented Jul 7, 2023

fyi, we already mention the ability for parallelization in a comment at the top of the file:

/// - Functions can be invoked in order and in parallel so the context variables must be immutable when invoked within the template

@dehoward dehoward linked an issue Jul 7, 2023 that may be closed by this pull request
@dmytrostruk dmytrostruk added the PR: feedback to address Waiting for PR owner to address comments/questions label Jul 7, 2023
removes RenderCodeAsync from IPromptTemplateEngine since it was pointed
out that the function is not being used and does not have much value.
in addition, adds a unit test for RenderAsync to ensure that variables
remain immutable throughout the rendering process.
@dehoward dehoward added PR: ready for review All feedback addressed, ready for reviews and removed PR: feedback to address Waiting for PR owner to address comments/questions labels Jul 11, 2023
@shawncal shawncal added this pull request to the merge queue Jul 12, 2023
Merged via the queue into microsoft:main with commit 6e7202e Jul 12, 2023
11 checks passed
piotrek-appstream pushed a commit to Appstream-Studio/semantic-kernel that referenced this pull request Jul 19, 2023
…icrosoft#1889)

### Motivation and Context
<!-- Thank you for your contribution to the semantic-kernel repo!
Please help reviewers and future users, providing the following
information:
  1. Why is this change required?
  2. What problem does it solve?
  3. What scenario does it contribute to?
  4. If it fixes an open issue, please link to the issue here.
-->
this PR looks to add basic parallelization when rendering code blocks in
the template engine.
today, functions are called sequentially but have the ability to be
invoked in either way.

### Description
<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->
- changed `PromptTemplateEngine` to use `Task.WhenAll` instead of
`await` when calling `ICodeRendering.RenderCodeAsync`.
to ensure the code blocks are appended to the prompt in the same order,
a placeholder is inserted into the output before the function call has
completed. once it's done, the placeholder, a `Guid` in `RenderAsync`
and `null` in `RenderCodeAsync`, is replaced with the result of the
call.
- added a test for `PromptTemplateEngine.RenderCodeAsync`.

### Contribution Checklist
<!-- Before submitting this PR, please make sure: -->
- [X] The code builds clean without any errors or warnings
- [X] The PR follows SK Contribution Guidelines
(https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
- [X] The code follows the .NET coding conventions
(https://learn.microsoft.com/dotnet/csharp/fundamentals/coding-style/coding-conventions)
verified with `dotnet format`
- [X] All unit tests pass, and I have added new tests where possible
- [ ] I didn't break anyone 😄

---------

Co-authored-by: Shawn Callegari <36091529+shawncal@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kernel Issues or pull requests impacting the core kernel .NET Issue or Pull requests regarding .NET code PR: ready for review All feedback addressed, ready for reviews
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Explore parallelization of PromptTemplateEngine
3 participants