PromptBuilder::usingModelPreference( string|WordPress\AiClient\Providers\Models\Contracts\ModelInterface|WordPress\AiClient\Builders\array{0:string,1:string} $preferredModels ): self

256    public function usingModelPreference(...$preferredModels): self257    {258        if ($preferredModels === []) {259            throw new InvalidArgumentException('At least one model preference must be provided.');260        }261        $preferenceKeys = [];262        foreach ($preferredModels as $preferredModel) {263            if (is_array($preferredModel)) {264                // [model identifier, provider ID] tuple265                if (!array_is_list($preferredModel) || count($preferredModel) !== 2) {266                    throw new InvalidArgumentException('Model preference tuple must contain model identifier and provider ID.');267                }268                [$providerId, $modelId] = $preferredModel;269                $modelId = $this->normalizePreferenceIdentifier($modelId);270                $providerId = $this->normalizePreferenceIdentifier($providerId, 'Model preference provider identifiers cannot be empty.');271                $preferenceKey = $this->createProviderModelPreferenceKey($providerId, $modelId);272            } elseif ($preferredModel instanceof ModelInterface) {273                // Model instance274                $modelId = $preferredModel->metadata()->getId();275                $providerId = $preferredModel->providerMetadata()->getId();276                $preferenceKey = $this->createProviderModelPreferenceKey($providerId, $modelId);277            } elseif (is_string($preferredModel)) {278                // Model ID279                $modelId = $this->normalizePreferenceIdentifier($preferredModel);280                $preferenceKey = $this->createModelPreferenceKey($modelId);281            } else {282                // Invalid type283                throw new InvalidArgumentException('Model preferences must be model identifiers, instances of ModelInterface, ' . 'or provider/model tuples.');284            }285            $preferenceKeys[] = $preferenceKey;286        }287        $this->modelPreferenceKeys = $preferenceKeys;288        return $this;289    }