Skip to content

Updated conversation api docs to latest alpha v2 with tool calling#4881

Merged
marcduiker merged 3 commits intodapr:v1.16from
bibryam:fix/4687-clean
Sep 16, 2025
Merged

Updated conversation api docs to latest alpha v2 with tool calling#4881
marcduiker merged 3 commits intodapr:v1.16from
bibryam:fix/4687-clean

Conversation

@bibryam
Copy link
Contributor

@bibryam bibryam commented Sep 12, 2025

Thank you for helping make the Dapr documentation better!

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

Updated Conversation API docs to v1.0-alpha2 with tool calling
-Aligned documented fields with the code: metadata, tool_choice, temperature,

  • Clarified URL/body/YAML precedence for metadata
  • Refreshed request/response examples with real curl commands and consistent JSON format, ready to use
  • Converted message types into a table for easier reference (aligned with tool calling format).
  • Removed redundant fields (e.g. name, camelCase variants) and standardized on snake_case (as per code)

Issue reference

#4687

…est, add metadata, remove redundant fields like name, fixes dapr#4687

Signed-off-by: Bilgin Ibryam <bibryam@gmail.com>
Copy link
Contributor

@marcduiker marcduiker left a comment

Choose a reason for hiding this comment

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

Can the prompt caching be described in a bit more detail? See the comment.

Signed-off-by: Marc Duiker <marcduiker@users.noreply.github.com>
Copy link
Contributor

@marcduiker marcduiker left a comment

Choose a reason for hiding this comment

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

LGTM

Signed-off-by: Bilgin Ibryam <bibryam@gmail.com>
@bibryam
Copy link
Contributor Author

bibryam commented Sep 15, 2025

reverted back to camel case

@marcduiker marcduiker merged commit 7723834 into dapr:v1.16 Sep 16, 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.

2 participants