| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765 |
- <?php
- /**
- * PostApiV3AgentTracesRequest
- *
- * PHP version 8.1
- *
- * @category Class
- * @package WikipaliApi
- * @author OpenAPI Generator team
- * @link https://openapi-generator.tech
- */
- /**
- * MINT API
- *
- * International Academy Of Pali Tipitaka(国际巴利三藏学院) 由 `php openapi/scripts/generate.php` 依据 api-v13 的路由与控制器源码生成。 响应统一封装为 `{ok, message, data}`;`ok=false` 时 `message` 为错误信息。
- *
- * The version of the OpenAPI document: 2026.11.12
- * Generated by: https://openapi-generator.tech
- * Generator version: 7.25.0
- */
- /**
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
- namespace WikipaliApi\Model;
- use \ArrayAccess;
- use \WikipaliApi\ObjectSerializer;
- /**
- * PostApiV3AgentTracesRequest Class Doc Comment
- *
- * @category Class
- * @package WikipaliApi
- * @author OpenAPI Generator team
- * @link https://openapi-generator.tech
- * @implements \ArrayAccess<string, mixed>
- */
- 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<string, string|null>
- * @psalm-var array<string, string|null>
- */
- 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));
- }
- }
|