Skip to main content
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#overview

PluginWebConfig

Provider web-search configuration used to augment a generation request.

Type-reference view: API Schema 9frhv4euve, API Schema 9ftjkkjhfa. Request and response views describe this type; they do not declare an endpoint.

Meaning and usage​

Section ID: DOC-API-MODEL-schema-1g3q0m5uun#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-1g3q0m5uun#fields

UsageFields and validation
In requestsView fields
In responsesView fields

In requests​

Section ID: DOC-API-MODEL-schema-1g3q0m5uun#request

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#request-field-engineenginestringOptionalSee meaning below.
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#request-field-maxresultsmaxResultsstring (int64)OptionalMaximum web-search result count requested by the plugin. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#request-field-searchpromptsearchPromptstringOptionalInstructions supplied to the web-search plugin.
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#request-field-websearchoptionswebSearchOptionsWebSearchOptionsOptionalOptions controlling the amount of web-search context requested.

engine

Search engine selected for the provider’s web-search plugin.

e.g., native/exa

In responses​

Section ID: DOC-API-MODEL-schema-1g3q0m5uun#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#field-engineSection ID: DOC-API-MODEL-schema-1g3q0m5uun#response-field-engineenginestringOptionalSee meaning below.
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#field-maxresultsSection ID: DOC-API-MODEL-schema-1g3q0m5uun#response-field-maxresultsmaxResultsstring (int64)OptionalMaximum web-search result count requested by the plugin. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#field-searchpromptSection ID: DOC-API-MODEL-schema-1g3q0m5uun#response-field-searchpromptsearchPromptstringOptionalInstructions supplied to the web-search plugin.
Section ID: DOC-API-MODEL-schema-1g3q0m5uun#field-websearchoptionsSection ID: DOC-API-MODEL-schema-1g3q0m5uun#response-field-websearchoptionswebSearchOptionsWebSearchOptionsOptionalOptions controlling the amount of web-search context requested.

engine

Search engine selected for the provider’s web-search plugin.

e.g., native/exa

Where used​

Section ID: DOC-API-MODEL-schema-1g3q0m5uun#where-used

ReferenceRelationship
Create an agent profilePOST /api/v1/agent-profiles/create
Get an agent profilePOST /api/v1/agent-profiles/get
Import a prompt libraryPOST /api/v1/agent-profiles/import
List agent profilesPOST /api/v1/agent-profiles/list
Update an agent profilePOST /api/v1/agent-profiles/update
Withdraw your rating on a messagePOST /api/v1/llm/delete-message-rating
Get full conversation statePOST /api/v1/llm/conversation-state
Rate an assistant messagePOST /api/v1/llm/rate-message
Send a message and wait for the resultPOST /api/v1/llm/send-message-sync
Submit client-side tool results and wait for the next segmentPOST /api/v1/llm/submit-client-tool-results-sync
Update context management settingsPOST /api/v1/llm/update-context-management-settings
Update default generation configPOST /api/v1/llm/update-default-generation-config
Get the caller's end-user profilePOST /api/v1/enduser/get
Append a message without generatingPOST /api/v1/llm/append-message
Create a new conversation threadPOST /api/v1/llm/create-thread
Send a message to a conversationPOST /api/v1/llm/send-message
Update the caller's default generation configPOST /api/v1/enduser/update-generation-config
ReceiveMessageRequestAPI JSON uses JSON field names (camelCase).
ClientToolDispatchAPI JSON uses JSON field names (camelCase).
Models containing this value
ModelRelationship
PluginConfigNested in model
PluginConfigNested in model

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-1g3q0m5uun