Tools in Response API should not be readonly

[gaspardpetit]

Service

OpenAI

Describe the bug

Thank you for adding samples with the Response API (dcf3838).

I added a few changelist, I believe the documentation is incorrect in a few places.

In particular, I do not think it is currently possible to assign a Tool as described:

   new ResponseCreationOptions()
    {
        Tools = { ResponseTool.CreateWebSearchTool() },
    });

Since tools is only provided in the code with a getter, and no setter:

ResponseCreationOptions:

public IList<ResponseTool> Tools { get; }

Most likely, the setter should be added.

Steps to reproduce

Try to compile the README.md sample, in particular:

new ResponseCreationOptions()
{
Tools = { ResponseTool.CreateWebSearchTool() },
});

Expect the code to compile;

Observe that the following error is generated:

Property or indexer 'ResponseCreationOptions.Tools' cannot be assigned to -- it is read only

Code snippets

OS

Windows

.NET version

.Net 9.0

Library version

2.2.0-beta.4

[jsquire]

Hi @gaspardpetit. Thank you for reaching out and we regret that you're experiencing difficulties. As a convention across types in the library, collection types for models are intentionally read-only. Their value can be set by mutating the existing collection. This can be done by either adding members after the object has been constructed or using C#'s initializer syntax as part of construction.

// Example: adding items after construction.
var options = new ResponseCreationOptions();
options.Tools.Add( ResponseTool.CreateWebSearchTool());

// Example: initializer syntax
var options = new ResponseCreationOptions()
{
    Tools = { ResponseTool.CreateWebSearchTool() }
};

The snippet that you shared is syntactically correct and makes use of the initializer syntax.