Structured outputs

[damo]

Includes optional local JSON schema validation and draft SDK documentation.

[TomerAberbach]

Suggested change

	Pass the top-level class—`BookList` in this example—to `responseFormat(Class<T>)` when building the
	Pass the top-level class—`BookList` in this example to `responseFormat(Class<T>)` when building the

[damo]

The parenthetical phrase is "Booklist in this example". It is delimited by em dashes to give it more emphasis than it would have it if were delimited by parentheses or commas, as it helps to clarify what "top-level class" means in this context. Taking out one of the dashes would be like taking out a closing parenthesis while keeping the opening one.

[TomerAberbach]

Suggested change

	.responseFormat(books.class)
	.responseFormat(books.getClass())

(the previous code wouldn't have compiled)

[damo]

Luckily, that was in code that was introduced with, "the following will not work". I'm a man of my word!

[TomerAberbach]

Suggested change

	StructuredChatCompletionCreateParams<BookList> params = ChatCompletionCreateParams.builder()
	StructuredChatCompletionCreateParams<List<String>> params = ChatCompletionCreateParams.builder()

[damo]

I meant to write it as List<Book>, the same as the field from the BookList class. Clearly, I was not operating on all cylinders at that moment.