Skip to content

Conversation

fabistb
Copy link
Contributor

@fabistb fabistb commented Jul 30, 2025

Please follow this checklist before submitting:

  • Commits are signed with Developer Certificate of Origin (DCO - learn more)
  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within codetabs
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have codetabs

In addition, please fill out the following to help reviewers understand this pull request:

Description

Enhance the documentation for the OpenAI conversation API component.
Functionality to also utilize Azure OpenAi is added.

This includes two new optional metadata properties:

  • apiType
  • apiVersion

Also adds some description how the different metadata properties must be configured that Azure OpenAi works.

Related PR:
dapr/components-contrib#3918

Issue reference

#4749

@fabistb fabistb requested review from a team as code owners July 30, 2025 11:26
@fabistb fabistb marked this pull request as draft July 31, 2025 13:15
@fabistb fabistb marked this pull request as ready for review July 31, 2025 19:42
Copy link
Member

@msfussell msfussell left a comment

Choose a reason for hiding this comment

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

@fabistb - See my comment

| `cacheTTL` | N | A time-to-live value for a prompt cache to expire. Uses Golang duration format. | `10m` |
| `apiType` | N | Specifies the API provider type. Required when using a provider that does not follow the default OpenAI API endpoint conventions. | `azure` |
| `apiVersion`| N | The API version to use. Required when the `apiType` is set to `azure`. | `2025-01-01-preview` |
Copy link
Member

Choose a reason for hiding this comment

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

@fabistb - Is 2025-01-01-preview the only current valid value or are there others? If so, is there a link to Azure documentation for this list that we can reference?

Copy link
Contributor Author

@fabistb fabistb Aug 6, 2025

Choose a reason for hiding this comment

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

There are some preview apis as listed here:
https://learn.microsoft.com/en-us/azure/ai-foundry/openai/api-version-lifecycle?tabs=key#preview-api-releases
The newest version is: 2025-04-01-preview

We could add the latest stable version as example value, but some of the newer models won't work then.
If that works for you I would however add link above to the related links section

@fabistb fabistb requested a review from msfussell August 14, 2025 14:04
Copy link
Contributor

@sicoyle sicoyle left a comment

Choose a reason for hiding this comment

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

lgtm, thank you!

Copy link
Member

@msfussell msfussell left a comment

Choose a reason for hiding this comment

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

LGTM

@msfussell msfussell merged commit a4229a7 into dapr:v1.16 Aug 20, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants