Merge branch 'v1.15' into scheduler

Author: elena-kolevska

daprdocs/content/en/developing-applications/debugging/bridge-to-kubernetes.md

@@ -1,9 +1,9 @@
 ---
 type: docs
 title: "Serialization in Dapr's SDKs"
-linkTitle: "Serialization"
+linkTitle: "SDK Serialization"
 description: "How Dapr serializes data within the SDKs"
-weight: 2000
+weight: 400
 aliases:
   - '/developing-applications/sdks/serialization/'
 ---

daprdocs/content/en/developing-applications/sdks/sdk-serialization.md daprdocs/content/en/developing-applications/local-development/sdk-serialization.md

@@ -62,4 +62,3 @@ For information about:
 - [Upgrade Dapr on a Kubernetes cluster]({{< ref kubernetes-upgrade >}})
 - [Production guidelines for Dapr on Kubernetes]({{< ref kubernetes-production.md >}})
 - [Dapr Kubernetes Quickstart](https://github.com/dapr/quickstarts/tree/master/tutorials/hello-kubernetes)
-- [Use Bridge to Kubernetes to debug Dapr apps locally, while connected to your Kubernetes cluster]({{< ref bridge-to-kubernetes >}})

daprdocs/content/en/operations/hosting/kubernetes/kubernetes-overview.md

@@ -17,7 +17,7 @@ Dapr provides an API to interact with Large Language Models (LLMs) and enables c
 This endpoint lets you converse with LLMs.
 
 ```
-POST /v1.0-alpha1/conversation/<llm-name>/converse
+POST http://localhost:<daprPort>/v1.0-alpha1/conversation/<llm-name>/converse
 ```
 
 ### URL parameters
@@ -30,17 +30,40 @@ POST /v1.0-alpha1/conversation/<llm-name>/converse
 
 | Field | Description |
 | --------- | ----------- |
-| `conversationContext` |  |
-| `inputs` | |
-| `parameters` | | 
+| `conversationContext` | The ID of an existing chat room (like in ChatGPT). |
+| `inputs` | Inputs for the conversation. Multiple inputs at one time are supported. |
+| `metadata` | [Metadata](#metadata) passed to conversation components. |
 
+#### Metadata
+
+Metadata can be sent in the request’s URL. It must be prefixed with `metadata.`, as shown in the table below.
+
+| Parameter | Description |
+| --------- | ----------- |
+| `metadata.key` | The API key for the component. `key` is not applicable to the [AWS Bedrock component]({{< ref "aws-bedrock.md#authenticating-aws" >}}). |
+| `metadata.model` | The Large Language Model you're using. Value depends on which conversation component you're using. `model` is not applicable to the [DeepSeek component]({{< ref deepseek.md >}}). |
+| `metadata.cacheTTL` | A time-to-live value for a prompt cache to expire. Uses Golang duration format. |
+
+For example, to call for [Anthropic]({{< ref anthropic.md >}}):
+
+```bash
+curl POST http://localhost:3500/v1.0-alpha1/conversation/anthropic/converse?metadata.key=key1&metadata.model=claude-3-5-sonnet-20240620&metadata.cacheTTL=10m
+```
+
+{{% alert title="Note" color="primary" %}}
+The metadata parameters available depend on the conversation component you use. [See all the supported components for the conversation API.]({{< ref supported-conversation >}})
+{{% /alert %}}
 
 ### Request content
 
 ```json
 REQUEST = {
   "inputs": ["what is Dapr", "Why use Dapr"],
-  "parameters": {},
+  "metadata": {
+    "model": "model-type-based-on-component-used",
+    "key": "authKey",
+    "cacheTTL": "10m",
+  }
 }
 ```
 
@@ -50,7 +73,7 @@ Code | Description
 ---- | -----------
 `202`  | Accepted
 `400`  | Request was malformed
-`500`  | Request formatted correctly, error in dapr code or underlying component
+`500`  | Request formatted correctly, error in Dapr code or underlying component
 
 ### Response content
 
@@ -71,4 +94,5 @@ RESPONSE  = {
 
 ## Next steps
 
-[Conversation API overview]({{< ref conversation-overview.md >}})
+- [Conversation API overview]({{< ref conversation-overview.md >}})
+- [Supported conversation components]({{< ref supported-conversation >}})

daprdocs/content/en/reference/api/conversation_api.md

@@ -37,6 +37,10 @@ The above example uses secrets as plain strings. It is recommended to use a secr
 | `model` | N | The LLM to use. Defaults to Bedrock's default provider model from Amazon.  | `amazon.titan-text-express-v1` |
 | `cacheTTL` | N | A time-to-live value for a prompt cache to expire. Uses Golang duration format.  | `10m` |
 
+## Authenticating AWS
+
+Instead of using a `key` parameter, AWS Bedrock authenticates using Dapr's standard method of IAM or static credentials. [Learn more about authenticating with AWS.]({{< ref authenticating-aws.md >}})
+
 ## Related links
 
 - [Conversation API overview]({{< ref conversation-overview.md >}})

daprdocs/content/en/reference/components-reference/supported-conversation/aws-bedrock.md

@@ -32,7 +32,7 @@ The above example uses secrets as plain strings. It is recommended to use a secr
 | Field              | Required | Details | Example |
 |--------------------|:--------:|---------|---------|
 | `key`   | Y | API key for DeepSeek. | `mykey` |
-| `maxToken` | N | The max amount of tokens for each request.  | `2048` |
+| `maxTokens` | N | The max amount of tokens for each request.  | `2048` |
 
 ## Related links