*/ class PostApiV3AgentFeedbackRequest implements ModelInterface, ArrayAccess, \JsonSerializable { public const DISCRIMINATOR = null; /** * The original name of the model. * * @var string */ protected static $openAPIModelName = 'post_api_v3_agent_feedback_request'; /** * Array of property to type mappings. Used for (de)serialization * * @var string[] */ protected static $openAPITypes = [ 'message_id' => 'string', 'thread_id' => 'string', 'rating' => 'int', 'tags' => 'string[]', 'comment' => 'string', 'asked' => 'bool', 'device_id' => 'string', 'client' => 'string' ]; /** * Array of property to format mappings. Used for (de)serialization * * @var string[] * @phpstan-var array * @psalm-var array */ protected static $openAPIFormats = [ 'message_id' => null, 'thread_id' => null, 'rating' => null, 'tags' => null, 'comment' => null, 'asked' => null, 'device_id' => null, 'client' => null ]; /** * Array of nullable properties. Used for (de)serialization * * @var boolean[] */ protected static array $openAPINullables = [ 'message_id' => false, 'thread_id' => false, 'rating' => false, 'tags' => false, 'comment' => false, 'asked' => false, 'device_id' => false, 'client' => false ]; /** * If a nullable field gets set to null, insert it here * * @var boolean[] */ protected array $openAPINullablesSetToNull = []; /** * Array of property to type mappings. Used for (de)serialization * * @return array */ public static function openAPITypes() { return self::$openAPITypes; } /** * Array of property to format mappings. Used for (de)serialization * * @return array */ public static function openAPIFormats() { return self::$openAPIFormats; } /** * Array of nullable properties * * @return array */ protected static function openAPINullables(): array { return self::$openAPINullables; } /** * Array of nullable field names deliberately set to null * * @return boolean[] */ private function getOpenAPINullablesSetToNull(): array { return $this->openAPINullablesSetToNull; } /** * Setter - Array of nullable field names deliberately set to null * * @param boolean[] $openAPINullablesSetToNull */ private function setOpenAPINullablesSetToNull(array $openAPINullablesSetToNull): void { $this->openAPINullablesSetToNull = $openAPINullablesSetToNull; } /** * Checks if a property is nullable * * @param string $property * @return bool */ public static function isNullable(string $property): bool { return self::openAPINullables()[$property] ?? false; } /** * Checks if a nullable property is set to null. * * @param string $property * @return bool */ public function isNullableSetToNull(string $property): bool { return in_array($property, $this->getOpenAPINullablesSetToNull(), true); } /** * Array of attributes where the key is the local name, * and the value is the original name * * @var string[] */ protected static $attributeMap = [ 'message_id' => 'message_id', 'thread_id' => 'thread_id', 'rating' => 'rating', 'tags' => 'tags', 'comment' => 'comment', 'asked' => 'asked', 'device_id' => 'device_id', 'client' => 'client' ]; /** * Array of attributes to setter functions (for deserialization of responses) * * @var string[] */ protected static $setters = [ 'message_id' => 'setMessageId', 'thread_id' => 'setThreadId', 'rating' => 'setRating', 'tags' => 'setTags', 'comment' => 'setComment', 'asked' => 'setAsked', 'device_id' => 'setDeviceId', 'client' => 'setClient' ]; /** * Array of attributes to getter functions (for serialization of requests) * * @var string[] */ protected static $getters = [ 'message_id' => 'getMessageId', 'thread_id' => 'getThreadId', 'rating' => 'getRating', 'tags' => 'getTags', 'comment' => 'getComment', 'asked' => 'getAsked', 'device_id' => 'getDeviceId', 'client' => 'getClient' ]; /** * Array of attributes where the key is the local name, * and the value is the original name * * @return array */ public static function attributeMap() { return self::$attributeMap; } /** * Array of attributes to setter functions (for deserialization of responses) * * @return array */ public static function setters() { return self::$setters; } /** * Array of attributes to getter functions (for serialization of requests) * * @return array */ public static function getters() { return self::$getters; } /** * The original name of the model. * * @return string */ public function getModelName() { return self::$openAPIModelName; } public const CLIENT_MOBILE = 'mobile'; public const CLIENT_WEB = 'web'; /** * Gets allowable values of the enum * * @return string[] */ public function getClientAllowableValues() { return [ self::CLIENT_MOBILE, self::CLIENT_WEB, ]; } /** * Associative array for storing property values * * @var mixed[] */ protected $container = []; /** * Constructor * * @param mixed[]|null $data Associated array of property values * initializing the model */ public function __construct(?array $data = null) { $this->setIfExists('message_id', $data ?? [], null); $this->setIfExists('thread_id', $data ?? [], null); $this->setIfExists('rating', $data ?? [], null); $this->setIfExists('tags', $data ?? [], null); $this->setIfExists('comment', $data ?? [], null); $this->setIfExists('asked', $data ?? [], null); $this->setIfExists('device_id', $data ?? [], null); $this->setIfExists('client', $data ?? [], null); } /** * Sets $this->container[$variableName] to the given data or to the given default Value; if $variableName * is nullable and its value is set to null in the $fields array, then mark it as "set to null" in the * $this->openAPINullablesSetToNull array * * @param string $variableName * @param array $fields * @param mixed $defaultValue */ private function setIfExists(string $variableName, array $fields, $defaultValue): void { if (self::isNullable($variableName) && array_key_exists($variableName, $fields) && is_null($fields[$variableName])) { $this->openAPINullablesSetToNull[] = $variableName; } $this->container[$variableName] = $fields[$variableName] ?? $defaultValue; } /** * Show all the invalid properties with reasons. * * @return array invalid properties with reasons */ public function listInvalidProperties() { $invalidProperties = []; if ($this->container['message_id'] === null) { $invalidProperties[] = "'message_id' can't be null"; } if ($this->container['rating'] === null) { $invalidProperties[] = "'rating' can't be null"; } $allowedValues = $this->getClientAllowableValues(); if (!is_null($this->container['client']) && !in_array($this->container['client'], $allowedValues, true)) { $invalidProperties[] = sprintf( "invalid value '%s' for 'client', must be one of '%s'", $this->container['client'], implode("', '", $allowedValues) ); } return $invalidProperties; } /** * Validate all the properties in the model * return true if all passed * * @return bool True if all properties are valid */ public function valid() { return count($this->listInvalidProperties()) === 0; } /** * Gets message_id * * @return string */ public function getMessageId() { return $this->container['message_id']; } /** * Sets message_id * * @param string $message_id AG-UI 回答消息 id * * @return self */ public function setMessageId($message_id) { if (is_null($message_id)) { throw new \InvalidArgumentException('non-nullable message_id cannot be null'); } $this->container['message_id'] = $message_id; return $this; } /** * Gets thread_id * * @return string|null */ public function getThreadId() { return $this->container['thread_id']; } /** * Sets thread_id * * @param string|null $thread_id 会话 id(uuid) * * @return self */ public function setThreadId($thread_id) { if (is_null($thread_id)) { throw new \InvalidArgumentException('non-nullable thread_id cannot be null'); } $this->container['thread_id'] = $thread_id; return $this; } /** * Gets rating * * @return int */ public function getRating() { return $this->container['rating']; } /** * Sets rating * * @param int $rating 1 赞 / -1 踩(只能是这两个值) * * @return self */ public function setRating($rating) { if (is_null($rating)) { throw new \InvalidArgumentException('non-nullable rating cannot be null'); } $this->container['rating'] = $rating; return $this; } /** * Gets tags * * @return string[]|null */ public function getTags() { return $this->container['tags']; } /** * Sets tags * * @param string[]|null $tags 点赞标签或点踩原因 * * @return self */ public function setTags($tags) { if (is_null($tags)) { throw new \InvalidArgumentException('non-nullable tags cannot be null'); } $this->container['tags'] = $tags; return $this; } /** * Gets comment * * @return string|null */ public function getComment() { return $this->container['comment']; } /** * Sets comment * * @param string|null $comment 选了 other 时的文字说明,最长 1000 字 * * @return self */ public function setComment($comment) { if (is_null($comment)) { throw new \InvalidArgumentException('non-nullable comment cannot be null'); } $this->container['comment'] = $comment; return $this; } /** * Gets asked * * @return bool|null */ public function getAsked() { return $this->container['asked']; } /** * Sets asked * * @param bool|null $asked 是否主动询问问出来的 * * @return self */ public function setAsked($asked) { if (is_null($asked)) { throw new \InvalidArgumentException('non-nullable asked cannot be null'); } $this->container['asked'] = $asked; return $this; } /** * Gets device_id * * @return string|null */ public function getDeviceId() { return $this->container['device_id']; } /** * Sets device_id * * @param string|null $device_id 设备匿名 id(uuid)。未登录时必填 * * @return self */ public function setDeviceId($device_id) { if (is_null($device_id)) { throw new \InvalidArgumentException('non-nullable device_id cannot be null'); } $this->container['device_id'] = $device_id; return $this; } /** * Gets client * * @return string|null */ public function getClient() { return $this->container['client']; } /** * Sets client * * @param string|null $client 客户端 * * @return self */ public function setClient($client) { if (is_null($client)) { throw new \InvalidArgumentException('non-nullable client cannot be null'); } $allowedValues = $this->getClientAllowableValues(); if (!in_array($client, $allowedValues, true)) { throw new \InvalidArgumentException( sprintf( "Invalid value '%s' for 'client', must be one of '%s'", $client, implode("', '", $allowedValues) ) ); } $this->container['client'] = $client; return $this; } /** * Returns true if offset exists. False otherwise. * * @param integer|string $offset Offset * * @return boolean */ public function offsetExists(mixed $offset): bool { return isset($this->container[$offset]); } /** * Gets offset. * * @param integer|string $offset Offset * * @return mixed|null */ #[\ReturnTypeWillChange] public function offsetGet(mixed $offset) { return $this->container[$offset] ?? null; } /** * Sets value based on offset. * * @param int|null $offset Offset * @param mixed $value Value to be set * * @return void */ public function offsetSet($offset, $value): void { if (is_null($offset)) { $this->container[] = $value; } else { $this->container[$offset] = $value; } } /** * Unsets offset. * * @param integer|string $offset Offset * * @return void */ public function offsetUnset(mixed $offset): void { unset($this->container[$offset]); } /** * Serializes the object to a value that can be serialized natively by json_encode(). * @link https://www.php.net/manual/en/jsonserializable.jsonserialize.php * * @return mixed Returns data which can be serialized by json_encode(), which is a value * of any type other than a resource. */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ObjectSerializer::sanitizeForSerialization($this); } /** * Gets the string presentation of the object * * @return string */ public function __toString() { return json_encode( ObjectSerializer::sanitizeForSerialization($this), JSON_PRETTY_PRINT ); } /** * Gets a header-safe presentation of the object * * @return string */ public function toHeaderValue() { return json_encode(ObjectSerializer::sanitizeForSerialization($this)); } }