Models

​

Overview

Use the Poolside Console to create and manage models centrally for your organization. After configuration, users can select a model in different contexts, such as custom agents or editor-based workflows, depending on the model type. You can:

• Connect models to inference endpoints
• Configure models used by agents
• Set a default model for your organization
• Reuse shared connection settings across multiple models

​

Manage model providers

Use a model provider to store shared connection settings that multiple models can reuse. A provider defines settings such as a base API URL and custom HTTP headers, so you can configure them once instead of repeating the same connection details for each model.

​

Create a model provider

Prerequisites

• You belong to a team with the tenant-admin role.

Steps

1. In the Poolside Console, navigate to Agents > Models.
2. Select the Providers tab.
3. Click New Model Provider.
4. Enter a Provider Name.
5. Enter the Base URL for the provider’s API. Poolside sends requests to this URL. If needed, include query parameters in the URL. For example, https://inference.provider.com/openai/v1/?api-version=2024-10-21.
6. Optional: Upload a Provider Logo. Supported formats: PNG, JPEG, SVG, and WebP. Maximum size: 512 KB.
7. Optional: Under Custom HTTP Headers, enter the header name and value for any headers required by the provider. For example, Authorization: Bearer <api-key>. To add additional headers, click Add HTTP header.
8. Optional: To insert runtime values in a header, click the plus icon in the value field and choose a placeholder such as Request ID, Identity (E-Mail), or Tenant SSO ID.
9. Click Create.

Next steps

• Connect a model that uses the provider for your organization.

​

Edit or delete a provider

Deleting a provider removes the provider association from any models that use it. Those models remain available and keep the provider’s base URL as their endpoint URL, but they no longer inherit settings from the deleted provider. Prerequisites

• You belong to a team with the tenant-admin role.

Steps

1. In the Poolside Console, navigate to Agents > Models.
2. Select the Providers tab.
3. Select the provider you want to update or remove.
4. To edit, click Edit Provider, make changes as needed, and then click Save Changes.
5. To delete, click Delete Provider.

​

Manage models

Use the Models pages in the Poolside Console to review models in your organization by type. You can review each model’s name, provider, status, and age, then select a model to inspect its full configuration, test its connection, or make changes.

• Use the Agents > Models page to view and manage chat models, including agentic models, used by the Poolside Web Assistant and custom agents in Poolside Assistant.
• Use the Code Completion > Models page to view and manage models that generate inline and multi-line code suggestions in supported IDEs.

​

Connect a model

Prerequisites

• You belong to a team with the tenant-admin role.

​

Test a model connection

You can test a model connection in real time to verify that Poolside can reach the endpoint and send a valid request for the selected model type. Depending on the model configuration, the test can include checks such as endpoint access, inference, and model-specific capabilities. Each check reports its result as it completes. If a check fails, the test returns a specific error message to help you diagnose the problem, such as a network issue or an authentication error. Prerequisites

• You belong to a team with the tenant-admin role.

Steps

1. In the Poolside Console, navigate to Agents > Models or Code Completion > Models.
2. Select the model you want to test.
3. On the model detail page, click Test Connection. The Testing Connection dialog opens.
4. When the check is complete, click Close.

​

Set a default model

Set a default model to control which model Poolside uses when an agent or workflow does not explicitly specify one. Prerequisites

• You belong to a team with the tenant-admin role.

Steps

1. In the Poolside Console, navigate to Agents > Models or Code Completion > Models.
2. Select the model you want to use as the default.
3. Click the ellipsis (…) and select Set as default.

The default model applies to new agents and workflows that do not override model selection.

​

Edit or delete a model

Deleting a model permanently removes it. If one or more agents use the model, Poolside lists those agents in the confirmation dialog and deletes them when you confirm the model deletion. Prerequisites

• You belong to a team with the tenant-admin role.

Steps

1. In the Poolside Console, navigate to Agents > Models or Code Completion > Models.
2. Select the model you want to update or remove.
3. To edit, make changes as needed, click Save Changes, and then click Test Connection to verify the connection.
4. To delete, click the ellipsis (…) and select Delete.