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

feat: [Orchestration] Update to Orchestration Spec 0.36.1 #203

Merged
merged 3 commits into from
Dec 2, 2024

Conversation

MatKuhr
Copy link
Member

@MatKuhr MatKuhr commented Nov 29, 2024

Context

AI/ai-sdk-java-backlog#119.

Feature scope:

  • Regenerate client

Definition of Done

  • Functionality scope stated & covered
  • Tests cover the scope above
  • Error handling created / updated & covered by the tests above
  • Aligned changes with the JavaScript SDK
  • Documentation updated
  • Release notes updated

@MatKuhr MatKuhr added the please-review Request to review a pull-request label Nov 29, 2024
$ref: "#/components/schemas/AzureThreshold"
"Sexual":
$ref: "#/components/schemas/AzureThreshold"
"Violence":
Copy link
Contributor

Choose a reason for hiding this comment

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

(Comment)

I'm wondering what makes them using " for property keys here, but nowhere else.

Copy link
Member

Choose a reason for hiding this comment

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

My best guess is "historical reasons". git blame tells me this is from (one of) the original commits on content filtering 8 months ago.

Copy link
Member

Choose a reason for hiding this comment

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

Here's a PR that addresses this: https://github.tools.sap/AI/llm-orchestration/pull/832
(code generation seems unaffected)

anyOf:
- enum:
- document_grounding_service
- {}
Copy link
Contributor

Choose a reason for hiding this comment

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

(Comment/Question)
wtf is this.

Copy link
Member Author

Choose a reason for hiding this comment

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

This is done for future extensibility. Without the anyof, users may complain if the enum allows additional values in the future. Not sure how strong this argument really is though..

Copy link
Member

Choose a reason for hiding this comment

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

See also this (very related) carfuffle: OpenAPITools/openapi-diff#303

Copy link
Member Author

Choose a reason for hiding this comment

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

yeah, we are also setting the flag enumUnknownDefaultCase for exactly this reason..

Copy link
Contributor

@newtork newtork left a comment

Choose a reason for hiding this comment

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

Waiting for response on the question, why use 0.36.1 when 0.40.1 is live on prod already.

@MatKuhr MatKuhr merged commit 61d3fc5 into main Dec 2, 2024
5 checks passed
@MatKuhr MatKuhr deleted the feat/update-orchestration branch December 2, 2024 12:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
please-review Request to review a pull-request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants