Assistants Endpoint Object Structure

Example

Assistants Endpoint

endpoints:
  assistants:
    disableBuilder: false
    pollIntervalMs: 500
    timeoutMs: 10000
    # Use either `supportedIds` or `excludedIds` but not both
    supportedIds: ["asst_supportedAssistantId1", "asst_supportedAssistantId2"]
    # excludedIds: ["asst_excludedAssistantId"]
    # (optional) Models that support retrieval, will default to latest known OpenAI models that support the feature
    # retrievalModels: ["gpt-4-turbo-preview"]
    # (optional) Assistant Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below.
    # capabilities: ["code_interpreter", "retrieval", "actions", "tools", "image_vision"]

This configuration enables the builder interface for assistants, sets a polling interval of 500ms to check for run updates, and establishes a timeout of 10 seconds for assistant run operations.

disableBuilder

Key:

Key	Type	Description	Example
disableBuilder	Boolean	Controls the visibility and use of the builder interface for assistants.	When set to `true`, disables the builder interface for the assistant, limiting direct manual interaction.

Default: false

Example:

endpoints / assistants / disableBuilder

disableBuilder: false

pollIntervalMs

Key:

Key	Type	Description	Example
pollIntervalMs	Integer	Specifies the polling interval in milliseconds for checking run updates or changes in assistant run states.	Specifies the polling interval in milliseconds for checking assistant run updates.

Default: 750

Example:

endpoints / assistants / pollIntervalMs

pollIntervalMs: 500

timeoutMs

Key:

Key	Type	Description	Example
timeoutMs	Integer	Defines the maximum time in milliseconds that an assistant can run before the request is cancelled.	Sets a timeout in milliseconds for assistant runs. Helps manage system load by limiting total run operation time.

Default: 180000

Example:

endpoints / assistants / timeoutMs

timeoutMs: 10000

Note: Defaults to 3 minutes (180,000 ms). Run operation times can range between 50 seconds to 2 minutes but also exceed this. If the timeoutMs value is exceeded, the run will be cancelled.

supportedIds

Key:

Key	Type	Description	Example
supportedIds	Array/List of Strings	List of supported assistant Ids	Use this or `excludedIds` but not both (the `excludedIds` field will be ignored if so).

Example:

endpoints / assistants / supportedIds

supportedIds:
  - "asst_supportedAssistantId1"
  - "asst_supportedAssistantId2"

excludedIds

Key:

Key	Type	Description	Example
excludedIds	Array/List of Strings	List of excluded assistant Ids	Use this or `supportedIds` but not both (the `excludedIds` field will be ignored if so).

Example:

endpoints / assistants / excludedIds

excludedIds:
  - "asst_excludedAssistantId1"
  - "asst_excludedAssistantId2"

retrievalModels

Key:

Key	Type	Description	Example
retrievalModels	Array/List of Strings	Specifies the models that support retrieval for the assistants endpoint.	Defines the models that support retrieval capabilities for the assistants endpoint. By default, it uses the latest known OpenAI models that support the official Retrieval feature.

Default: [] (uses the latest known OpenAI models that support retrieval)

Example:

endpoints / assistants / retrievalModels

retrievalModels:
  - "gpt-4-turbo-preview"

capabilities

Key:

Key	Type	Description	Example
capabilities	Array/List of Strings	Specifies the assistant capabilities available to all users for the assistants endpoint.	Defines the assistant capabilities that are available to all users for the assistants endpoint. You can omit the capabilities you wish to exclude from the list.

Default: ["code_interpreter", "image_vision", "retrieval", "actions", "tools"]

Example:

endpoints / assistants / capabilities

capabilities:
  - "code_interpreter"
  - "retrieval"
  - "actions"
  - "tools"
  - "image_vision"

Note: This field is optional. If omitted, the default behavior is to include all the capabilities listed in the example.

Registration Custom Endpoint