*/ class PostApiV3AgentTracesRequest implements ModelInterface, ArrayAccess, \JsonSerializable { public const DISCRIMINATOR = null; /** * The original name of the model. * * @var string */ protected static $openAPIModelName = 'post_api_v3_agent_traces_request'; /** * Array of property to type mappings. Used for (de)serialization * * @var string[] */ protected static $openAPITypes = [ 'run_id' => 'string', 'thread_id' => 'string', 'device_id' => 'string', 'client_ip' => 'string', 'client' => 'string', 'question' => 'string', 'status' => 'string', 'improve' => 'bool', 'steps' => 'string[]' ]; /** * Array of property to format mappings. Used for (de)serialization * * @var string[] * @phpstan-var array * @psalm-var array */ protected static $openAPIFormats = [ 'run_id' => null, 'thread_id' => null, 'device_id' => null, 'client_ip' => null, 'client' => null, 'question' => null, 'status' => null, 'improve' => null, 'steps' => null ]; /** * Array of nullable properties. Used for (de)serialization * * @var boolean[] */ protected static array $openAPINullables = [ 'run_id' => false, 'thread_id' => false, 'device_id' => false, 'client_ip' => false, 'client' => false, 'question' => false, 'status' => false, 'improve' => false, 'steps' => 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 = [ 'run_id' => 'run_id', 'thread_id' => 'thread_id', 'device_id' => 'device_id', 'client_ip' => 'client_ip', 'client' => 'client', 'question' => 'question', 'status' => 'status', 'improve' => 'improve', 'steps' => 'steps' ]; /** * Array of attributes to setter functions (for deserialization of responses) * * @var string[] */ protected static $setters = [ 'run_id' => 'setRunId', 'thread_id' => 'setThreadId', 'device_id' => 'setDeviceId', 'client_ip' => 'setClientIp', 'client' => 'setClient', 'question' => 'setQuestion', 'status' => 'setStatus', 'improve' => 'setImprove', 'steps' => 'setSteps' ]; /** * Array of attributes to getter functions (for serialization of requests) * * @var string[] */ protected static $getters = [ 'run_id' => 'getRunId', 'thread_id' => 'getThreadId', 'device_id' => 'getDeviceId', 'client_ip' => 'getClientIp', 'client' => 'getClient', 'question' => 'getQuestion', 'status' => 'getStatus', 'improve' => 'getImprove', 'steps' => 'getSteps' ]; /** * 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'; public const STATUS_OK = 'ok'; public const STATUS_ERROR = 'error'; public const STATUS_CANCELLED = 'cancelled'; public const STATUS_DENIED = 'denied'; /** * Gets allowable values of the enum * * @return string[] */ public function getClientAllowableValues() { return [ self::CLIENT_MOBILE, self::CLIENT_WEB, ]; } /** * Gets allowable values of the enum * * @return string[] */ public function getStatusAllowableValues() { return [ self::STATUS_OK, self::STATUS_ERROR, self::STATUS_CANCELLED, self::STATUS_DENIED, ]; } /** * 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('run_id', $data ?? [], null); $this->setIfExists('thread_id', $data ?? [], null); $this->setIfExists('device_id', $data ?? [], null); $this->setIfExists('client_ip', $data ?? [], null); $this->setIfExists('client', $data ?? [], null); $this->setIfExists('question', $data ?? [], null); $this->setIfExists('status', $data ?? [], null); $this->setIfExists('improve', $data ?? [], true); $this->setIfExists('steps', $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['run_id'] === null) { $invalidProperties[] = "'run_id' can't be null"; } if ($this->container['thread_id'] === null) { $invalidProperties[] = "'thread_id' 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) ); } if ($this->container['question'] === null) { $invalidProperties[] = "'question' can't be null"; } if ($this->container['status'] === null) { $invalidProperties[] = "'status' can't be null"; } $allowedValues = $this->getStatusAllowableValues(); if (!is_null($this->container['status']) && !in_array($this->container['status'], $allowedValues, true)) { $invalidProperties[] = sprintf( "invalid value '%s' for 'status', must be one of '%s'", $this->container['status'], 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 run_id * * @return string */ public function getRunId() { return $this->container['run_id']; } /** * Sets run_id * * @param string $run_id AG-UI runId(uuid) * * @return self */ public function setRunId($run_id) { if (is_null($run_id)) { throw new \InvalidArgumentException('non-nullable run_id cannot be null'); } $this->container['run_id'] = $run_id; return $this; } /** * Gets thread_id * * @return string */ public function getThreadId() { return $this->container['thread_id']; } /** * Sets thread_id * * @param string $thread_id AG-UI threadId(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 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_ip * * @return string|null */ public function getClientIp() { return $this->container['client_ip']; } /** * Sets client_ip * * @param string|null $client_ip 客户端 IP。只对游客记录 * * @return self */ public function setClientIp($client_ip) { if (is_null($client_ip)) { throw new \InvalidArgumentException('non-nullable client_ip cannot be null'); } $this->container['client_ip'] = $client_ip; 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; } /** * Gets question * * @return string */ public function getQuestion() { return $this->container['question']; } /** * Sets question * * @param string $question 用户的提问 * * @return self */ public function setQuestion($question) { if (is_null($question)) { throw new \InvalidArgumentException('non-nullable question cannot be null'); } $this->container['question'] = $question; return $this; } /** * Gets status * * @return string */ public function getStatus() { return $this->container['status']; } /** * Sets status * * @param string $status 运行结果(denied=额度不足被拦下) * * @return self */ public function setStatus($status) { if (is_null($status)) { throw new \InvalidArgumentException('non-nullable status cannot be null'); } $allowedValues = $this->getStatusAllowableValues(); if (!in_array($status, $allowedValues, true)) { throw new \InvalidArgumentException( sprintf( "Invalid value '%s' for 'status', must be one of '%s'", $status, implode("', '", $allowedValues) ) ); } $this->container['status'] = $status; return $this; } /** * Gets improve * * @return bool|null */ public function getImprove() { return $this->container['improve']; } /** * Sets improve * * @param bool|null $improve 用户是否允许用于改进回答(提问那一刻的开关) * * @return self */ public function setImprove($improve) { if (is_null($improve)) { throw new \InvalidArgumentException('non-nullable improve cannot be null'); } $this->container['improve'] = $improve; return $this; } /** * Gets steps * * @return string[]|null */ public function getSteps() { return $this->container['steps']; } /** * Sets steps * * @param string[]|null $steps 每一步(LLM 调用、工具调用、节点事件),最多 500 条 * * @return self */ public function setSteps($steps) { if (is_null($steps)) { throw new \InvalidArgumentException('non-nullable steps cannot be null'); } $this->container['steps'] = $steps; 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)); } }