tooling

santiagxf · santiagxf · commit 7d12da230b34 · 2024-05-26T15:57:11.000Z
diff --git a/articles/ai-studio/reference/reference-model-inference-chat-completions.md b/articles/ai-studio/reference/reference-model-inference-chat-completions.md
@@ -43,7 +43,7 @@ POST /chat/completions?api-version=2024-04-01-preview
 | stop |     |     | Sequences where the API will stop generating further tokens. |
 | stream |     | boolean | If set, partial message deltas will be sent. Tokens will be sent as data-only [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format) as they become available, with the stream terminated by a `data: [DONE]` message. |
 | temperature |     | number | Non-negative number. Return 422 if value is unsupported by model. |
-| tool\_choice |     | ChatCompletionToolChoiceOption | Controls which (if any) function is called by the model. `none` means the model will not call a function and instead generates a message. `auto` means the model can pick between generating a message or calling a function. Specifying a particular function via `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that function.<br><br>`none` is the default when no functions are present. `auto` is the default if functions are present. Returns a 422 error if the tool is not supported by the model. |
+| tool\_choice |     | ChatCompletionToolChoiceOption(#chatcompletiontoolchoiceoption) | Controls which (if any) function is called by the model. `none` means the model will not call a function and instead generates a message. `auto` means the model can pick between generating a message or calling a function. Specifying a particular function via `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that function.<br><br>`none` is the default when no functions are present. `auto` is the default if functions are present. Returns a 422 error if the tool is not supported by the model. |
 | tools |     | [ChatCompletionTool](#chatcompletiontool)\[\] | A list of tools the model may call. Currently, only functions are supported as a tool. Use this to provide a list of functions the model may generate JSON inputs for. Returns a 422 error if the tool is not supported by the model. |
 | top\_p |     | number | An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top\_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered.<br><br>We generally recommend altering this or `temperature` but not both. |
 
@@ -293,7 +293,7 @@ The API call fails when the prompt triggers a content filter as configured. Modi
 | stop |     |     | Sequences where the API will stop generating further tokens. |
 | stream | boolean | False | If set, partial message deltas will be sent. Tokens will be sent as data-only [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format) as they become available, with the stream terminated by a `data: [DONE]` message. |
 | temperature | number | 1   | Non-negative number. Return 422 if value is unsupported by model. |
-| tool\_choice | ChatCompletionToolChoiceOption |     | Controls which (if any) function is called by the model. `none` means the model will not call a function and instead generates a message. `auto` means the model can pick between generating a message or calling a function. Specifying a particular function via `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that function.<br><br>`none` is the default when no functions are present. `auto` is the default if functions are present. Returns a 422 error if the tool is not supported by the model. |
+| tool\_choice | ChatCompletionToolChoiceOption(#chatcompletiontoolchoiceoption) |     | Controls which (if any) function is called by the model. `none` means the model will not call a function and instead generates a message. `auto` means the model can pick between generating a message or calling a function. Specifying a particular function via `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that function.<br><br>`none` is the default when no functions are present. `auto` is the default if functions are present. Returns a 422 error if the tool is not supported by the model. |
 | tools | [ChatCompletionTool](#chatcompletiontool)\[\] |     | A list of tools the model may call. Currently, only functions are supported as a tool. Use this to provide a list of functions the model may generate JSON inputs for. Returns a 422 error if the tool is not supported by the model. |
 | top\_p | number | 1   | An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top\_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered.<br><br>We generally recommend altering this or `temperature` but not both. |
 
@@ -321,6 +321,17 @@ The API call fails when the prompt triggers a content filter as configured. Modi
 | image | string |  |
 | image_url | string |  |
 
+### ChatCompletionToolChoiceOption
+
+Controls which (if any) tool is called by the model.
+
+| Name | Type | Description |
+| --- | --- | --- |
+| none | string | The model will not call any tool and instead generates a message. |
+| auto | string | The model can pick between generating a message or calling one or more tools. |
+| required | string | The model must call one or more tools. |
+| | string | Specifying a particular tool via `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that tool. |
+
 ### ImageDetail
 
 Specifies the detail level of the image.
diff --git a/articles/ai-studio/reference/reference-model-inference-completions.md b/articles/ai-studio/reference/reference-model-inference-completions.md
@@ -50,11 +50,11 @@ POST /completions?api-version=2024-04-01-preview
 | Name | Type | Description |
 | --- | --- | --- |
 | 200 OK | [CreateCompletionResponse](#createcompletionresponse) | OK  |
-| 401 Unauthorized |     | Access token is missing or invalid |
-| 404 Not Found |     | Modality not supported by the model. Check the documentation of the model to see which routes are available. |
-| 422 Unprocessable Entity | [UnprocessableContentError](#unprocessablecontenterror) | The request contains unprocessable content<br><br>Headers<br><br>x-ms-error-code: string |
-| 429 Too Many Requests |     | You have hit your assigned rate limit and your request need to be paced. |
-| Other Status Codes | [ContentFilterError](#contentfiltererror) | Bad request<br><br>Headers<br><br>x-ms-error-code: string |
+| 401 Unauthorized         | [UnauthorizedError](#unauthorizederror)                 | Access token is missing or invalid<br><br>Headers<br><br>x-ms-error-code: string                                                                           |
+| 404 Not Found            | [NotFoundError](#notfounderror)                         | Modality not supported by the model. Check the documentation of the model to see which routes are available.<br><br>Headers<br><br>x-ms-error-code: string |
+| 422 Unprocessable Entity | [UnprocessableContentError](#unprocessablecontenterror) | The request contains unprocessable content<br><br>Headers<br><br>x-ms-error-code: string                                                                   |
+| 429 Too Many Requests    | [TooManyRequestsError](#toomanyrequestserror)           | You have hit your assigned rate limit and your request need to be paced.<br><br>Headers<br><br>x-ms-error-code: string                                     |
+| Other Status Codes       | [ContentFilterError](#contentfiltererror)               | Bad request<br><br>Headers<br><br>x-ms-error-code: string                                                                                                  |
 
 
 ## Security
