Microsoft Foundry

Версия API: версия 1

Authentication

Поток: неявный

URL-адрес авторизации:https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области:

  • https://ai.azure.com/.default

Агенты

Агенты — создание агента

POST {endpoint}/agents?api-version=v1

Создает агент.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview, HostedAgents=V1PreviewWorkflowAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
Определение AgentDefinition Да
└️ вид AgentKind Да
└️ rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Уникальное имя, определяющее агент. Имя может быть использовано для получения/обновления/удаления агента.
— должно начинаться и заканчиваться буквенно-цифровыми символами,
- Может содержать дефисы в середине
— не должно превышать 63 символов.
Ограничения: maxLength: 63
Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — агенты списка

GET {endpoint}/agents?api-version=v1

Возвращает список всех агентов.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
добрый query нет струна
Возможные значения: prompt, , hostedcontainer_appworkflow
Фильтруйте агенты по видам. Если не предоставлено, все агенты возвращаются.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — получение агента

GET {endpoint}/agents/{agent_name}?api-version=v1

Извлекает агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента, который необходимо восстановить.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — агент обновления

POST {endpoint}/agents/{agent_name}?api-version=v1

Обновляет агент путем добавления новой версии, если в определение агента вносятся какие-либо изменения. Если изменений нет, возвращается существующая версия агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента, который необходимо восстановить.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview, HostedAgents=V1PreviewWorkflowAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
Определение AgentDefinition Да
└️ вид AgentKind Да
└️ rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — удаление агента

DELETE {endpoint}/agents/{agent_name}?api-version=v1

Удаляет агент.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя удаляемого агента.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DeleteAgentResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — обновление агента из манифеста

POST {endpoint}/agents/{agent_name}/import?api-version=v1

Обновляет агент из манифеста, добавив новую версию, если в определении агента есть какие-либо изменения. Если изменений нет, возвращается существующая версия агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента для обновления.
версия API query Да струна Версия API, используемая для данной операции.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
manifest_id струна Идентификатор манифеста для импорта версии агента из. Да
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
parameter_values объект Входные данные манифеста, которые будут приводить к полностью материализованному агенту. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — создание версии агента

POST {endpoint}/agents/{agent_name}/versions?api-version=v1

Создайте новую версию агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Уникальное имя, определяющее агент. Имя может быть использовано для получения/обновления/удаления агента.
— должно начинаться и заканчиваться буквенно-цифровыми символами,
- Может содержать дефисы в середине
— не должно превышать 63 символов.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview, HostedAgents=V1PreviewWorkflowAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
Определение AgentDefinition Да
└️ вид AgentKind Да
└️ rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentVersionObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — версии агента списка

GET {endpoint}/agents/{agent_name}/versions?api-version=v1

Возвращает список версий агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента, для которого требуется получить версии.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — получение версии агента

GET {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=v1

Извлекает определенную версию агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента, который необходимо восстановить.
agent_version путь Да струна Версия извлекаемого агента.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentVersionObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — удаление версии агента

DELETE {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=v1

Удаляет определенную версию агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя удаляемого агента.
agent_version путь Да струна Версия агента для удаления
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DeleteAgentVersionResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — создание версии агента из манифеста

POST {endpoint}/agents/{agent_name}/versions:import?api-version=v1

Создайте новую версию агента из манифеста.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Уникальное имя, определяющее агент. Имя может быть использовано для получения/обновления/удаления агента.
— должно начинаться и заканчиваться буквенно-цифровыми символами,
- Может содержать дефисы в середине
— не должно превышать 63 символов.
версия API query Да струна Версия API, используемая для данной операции.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
manifest_id струна Идентификатор манифеста для импорта версии агента из. Да
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
parameter_values объект Входные данные манифеста, которые будут приводить к полностью материализованному агенту. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentVersionObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Агенты — создание агента из манифеста

POST {endpoint}/agents:import?api-version=v1

Создает агента из манифеста.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
manifest_id струна Идентификатор манифеста для импорта версии агента из. Да
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Уникальное имя, определяющее агент. Имя может быть использовано для получения/обновления/удаления агента.
— должно начинаться и заканчиваться буквенно-цифровыми символами,
- Может содержать дефисы в середине
— не должно превышать 63 символов.
Ограничения: maxLength: 63
Да
parameter_values объект Входные данные манифеста, которые будут приводить к полностью материализованному агенту. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агентов

Контейнеры агента — операции контейнера агента списка

GET {endpoint}/agents/{agent_name}/operations?api-version=v1

Вывод списка операций контейнера для агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — получение операции контейнера агента

GET {endpoint}/agents/{agent_name}/operations/{operation_id}?api-version=v1

Получение состояния операции контейнера для агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
operation_id путь Да струна Идентификатор операции.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentContainerOperationObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — получение контейнера агента

GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default?api-version=v1

Получите контейнер для определенной версии агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AgentContainerObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — операции контейнера версии агента списка

GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default/operations?api-version=v1

Вывод списка операций контейнера для определенной версии агента.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — удаление контейнера агента

POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:delete?api-version=v1

Удалите контейнер для определенной версии агента. Если контейнер не существует, операция будет no-op. Операция является длительной операцией. Следование рекомендациям по проектированию для долгосрочных операций в Azure REST API. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 202

Описание. Запрос был принят для обработки, но обработка еще не завершена.

Тип содержимого Тип Описание
application/json AgentContainerOperationObject

Заголовки ответа:

Header Тип Description
Операция-Местоположение струна

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агентов — журналы контейнеров агента потоковой передачи

POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:logstream?api-version=v1

Запись журнала контейнера передавалась из контейнера в виде текстовых фрагментов. Каждый блок представляет собой строку UTF-8, которая может быть либо лог-линией в виде обычного текста, либо записью в формате JSON, в зависимости от типа потокового контейнерного журнала. Клиенты должны рассматривать каждый фрагмент как непрозрачный текст и, при необходимости, пытаться парсировать его как JSON в зависимости от требований к логированию.

Для системных журналов формат JSON со следующей структурой: {"TimeStamp":"2025-12-15T16:51:33Z","Type":"Normal","ContainerAppName":null,"RevisionName":null,"ReplicaName":null,"Msg":"Подключение к коллекционеру событий...","Reason":"StartingGettingEvents","EventSource":"ContainerAppController","Count":1} {"TimeStamp":"2025-12-15T16:51:34Z","Type":"Normal","ContainerAppName":null,"RevisionName":null,"ReplicaName":null,"Msg":"Успешно подключено к событиям server","Reason":"ConnectedToEventsServer","EventSource":"ContainerAppController","Count":1}

Для консольных логов формат представляет собой обычный текст, исходящий от stdout/stderr контейнера. 2025-12-15T08:43:48.72656 Подключение к контейнеру 'агент-контейнер'... 2025-12-15T08:43:48.75451 Успешно подключено к контейнеру: 'agent-container' [Редакция: 'je90fe655aa742ef9a188b9fd14d6764--7tca06b', реплика: 'je90fe655aa742ef9a188b9fd14d6764--7tca06b-6898b9c89f-mpkjc'] 2025-12-15T08:08:33:59.0671054Z stdout F INFO: 127.0.0.1:42588 - "GET /readiness HTTP/1.1" 200 OK 2025-12-15T08:34:29.0649033Z stdout F INFO: 127.0.0.1:60246 - "GET /readiness HTTP/1.1" 200 OK 2025-12-15T08:34:59.0644467Z stdout F INFO: 127.0.0.1:43994 - "GET /readiness HTTP/1.1" 200 OK

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
добрый query нет струна
Возможные значения: console, system
Консоль возвращает контейнерный STDout/STDERR, система возвращает поток событий в контейнерном приложении. По умолчанию консоль
replica_name query нет струна Если параметр не указан, сервер выбирает первую реплику для консольных журналов. Требуется нацелиться на конкретную реплику.
хвост query нет целое число Число возвращаемых конечных строк. Принуждено до 1-300. Значение по умолчанию — 20
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — запуск контейнера агента

POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:start?api-version=v1

Запустите контейнер для определенной версии агента. Если контейнер уже запущен, операция будет no-op. Операция является длительной операцией. Следование рекомендациям по проектированию для долгосрочных операций в Azure REST API. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
max_replicas целое число Максимальное количество реплик. Значение по умолчанию — 1. нет 1
min_replicas целое число Минимальное количество реплик. Значение по умолчанию — 1. нет 1

Responses

Код состояния: 202

Описание. Запрос был принят для обработки, но обработка еще не завершена.

Тип содержимого Тип Описание
application/json AgentContainerOperationObject

Заголовки ответа:

Header Тип Description
Операция-Местоположение струна

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — контейнер агента остановки

POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:stop?api-version=v1

Остановите контейнер для определенной версии агента. Если контейнер не запущен или уже остановлен, операция будет no-op. Операция является длительной операцией. Следование рекомендациям по проектированию для долгосрочных операций в Azure REST API. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 202

Описание. Запрос был принят для обработки, но обработка еще не завершена.

Тип содержимого Тип Описание
application/json AgentContainerOperationObject

Заголовки ответа:

Header Тип Description
Операция-Местоположение струна

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Контейнеры агента — контейнер агента обновления

POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:update?api-version=v1

Обновите контейнер для определенной версии агента. Если контейнер не запущен, операция будет no-op. Операция является длительной операцией. Следование рекомендациям по проектированию для долгосрочных операций в Azure REST API. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
agent_name путь Да струна Имя агента.
agent_version путь Да струна Версия агента.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: ContainerAgents=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
max_replicas целое число Максимальное количество реплик. нет
min_replicas целое число Минимальное количество реплик. нет

Responses

Код состояния: 202

Описание. Запрос был принят для обработки, но обработка еще не завершена.

Тип содержимого Тип Описание
application/json AgentContainerOperationObject

Заголовки ответа:

Header Тип Description
Операция-Местоположение струна

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Connections

Подключения — список

GET {endpoint}/connections?api-version=v1

Перечислить все соединения в project, не заполняя учетные данные соединения

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
тип соединения query нет струна
Возможные значения: AzureOpenAI, AzureBlob, AzureStorageAccount, CognitiveSearch, CosmosDB, ApiKey, AppConfig, AppInsights, CustomKeys, RemoteTool_Preview
Список соединений данного конкретного типа
defaultConnection query нет булевый Список подключений, которые являются соединениями по умолчанию

Заголовок запроса

Имя. Обязательно Тип Description
x-ms-client-request-id Неправда струна Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedConnection

Заголовки ответа:

Header Тип Description
x-ms-client-request-id Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Подключения — получение

GET {endpoint}/connections/{name}?api-version=v1

Получение подключения по имени, без заполнения учетных данных подключения

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Понятное имя соединения, предоставленное пользователем.

Заголовок запроса

Имя. Обязательно Тип Description
x-ms-client-request-id Неправда струна Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Подключение

Заголовки ответа:

Header Тип Description
x-ms-client-request-id Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Подключения — получение учетных данных

POST {endpoint}/connections/{name}/getConnectionWithCredentials?api-version=v1

Получение подключения по имени с учетными данными для подключения

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Понятное имя соединения, предоставленное пользователем.

Заголовок запроса

Имя. Обязательно Тип Description
x-ms-client-request-id Неправда струна Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Подключение

Заголовки ответа:

Header Тип Description
x-ms-client-request-id Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных

Наборы данных — список последних версий

GET {endpoint}/datasets?api-version=v1

Перечисление последней версии каждой версии DatasetVersion

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedDatasetVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных — версии списка

GET {endpoint}/datasets/{name}/versions?api-version=v1

Вывод списка всех версий заданного DatasetVersion

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedDatasetVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных — получение версии

GET {endpoint}/datasets/{name}/versions/{version}?api-version=v1

Получите конкретную версию DatasetVersion. Служба возвращает ошибку 404 Not Found, если DatasetVersion не существует.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии извлекаемой версии DatasetVersion.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DatasetVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных — удаление версии

DELETE {endpoint}/datasets/{name}/versions/{version}?api-version=v1

Удалите определенную версию DatasetVersion. Служба возвращает 204 No Content, если DatasetVersion был успешно удален или если DatasetVersion не существует.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Версия DatasetVersion для удаления.

Responses

Код состояния: 204

Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных — создание или обновление версии

PATCH {endpoint}/datasets/{name}/versions/{version}?api-version=v1

Создание новой или обновление существующей версии DatasetVersion с заданным идентификатором версии

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии DatasetVersion для создания или обновления.

Тело запроса

Тип содержания: application/merge-patch+json

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type DatasetType Перечисление для определения типа данных. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DatasetVersion

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json DatasetVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных — получение учетных данных

POST {endpoint}/datasets/{name}/versions/{version}/credentials?api-version=v1

Получите учётную запись SAS для access к аккаунту storage, связанному с версией Dataset.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии DatasetVersion для работы.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json AssetCredentialResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Наборы данных — запуск ожидающей отправки версии

POST {endpoint}/datasets/{name}/versions/{version}/startPendingUpload?api-version=v1

Запустите новую или получите существующую ожидающую загрузку набора данных для определенной версии.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии DatasetVersion для работы.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
connectionName струна Имя соединения Azure Storage Account для генерации временного токена SAS нет
pendingUploadId струна Если PendingUploadId не указан, будет использоваться случайный идентификатор GUID. нет
pendingUploadType перечисление BlobReference является единственным поддерживаемым типом.
Возможные значения: BlobReference
Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json ОжиданиеUploadResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Развертывания

Развертывания — список

GET {endpoint}/deployments?api-version=v1

Перечислите все развернутые модели в project

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
modelPublisher query нет струна Model publisher фильтрует модели по
modelName query нет струна Название модели (специфическое имя publisher) для фильтрации моделей по
deploymentType query нет струна
Возможные значения: ModelDeployment
Тип развертывания для фильтрации списка по

Заголовок запроса

Имя. Обязательно Тип Description
x-ms-client-request-id Неправда струна Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedDeployment

Заголовки ответа:

Header Тип Description
x-ms-client-request-id Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Развертывания — получение

GET {endpoint}/deployments/{name}?api-version=v1

Получите развернутую модель.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Название развертывания

Заголовок запроса

Имя. Обязательно Тип Description
x-ms-client-request-id Неправда струна Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Развертывание

Заголовки ответа:

Header Тип Description
x-ms-client-request-id Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Оценка таксономий

Оценка таксономий — список

GET {endpoint}/evaluationtaxonomies?api-version=v1

Список таксономий оценки

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
inputName query нет струна Фильтрация по имени входных данных оценки.
inputType query нет струна Фильтр по типу ввода таксономии.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedEvaluationTaxonomy

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Оценка таксономий — получение

GET {endpoint}/evaluationtaxonomies/{name}?api-version=v1

Получите прогон оценки по имени.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvaluationTaxonomy

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Оценка таксономий — удаление

DELETE {endpoint}/evaluationtaxonomies/{name}?api-version=v1

Удалите таксономию оценки по имени.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 204

Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Оценка таксономий — создание

PUT {endpoint}/evaluationtaxonomies/{name}?api-version=v1

Создание таксономии оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя таксономии оценки.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
свойства объект Дополнительные свойства для таксономии оценки. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
категории таксономии массив ТаксономииCategory Список категорий таксономии. нет
таксономияInput EvaluationTaxonomyInput Входная конфигурация для таксономии оценки. Да
└─ Тип EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvaluationTaxonomy

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json EvaluationTaxonomy

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Оценка таксономий — обновление

PATCH {endpoint}/evaluationtaxonomies/{name}?api-version=v1

Обновление таксономии оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя таксономии оценки.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
свойства объект Дополнительные свойства для таксономии оценки. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
категории таксономии массив ТаксономииCategory Список категорий таксономии. нет
таксономияInput EvaluationTaxonomyInputUpdate Входная конфигурация для таксономии оценки. нет
└─ Тип EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvaluationTaxonomy

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Правила оценки

Правила оценки — список

GET {endpoint}/evaluationrules?api-version=v1

Перечислите все правила оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
actionType query нет струна
Возможные значения: continuousEvaluation, humanEvaluationPreview
Фильтрация по типу правила оценки.
agentName query нет струна Фильтрация по имени агента.
enabled query нет булевый Фильтрация по включенному статусу.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedEvaluationRule

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Правила оценки — получение

GET {endpoint}/evaluationrules/{id}?api-version=v1

Получите правило оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Уникальный идентификатор для правила оценки.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvaluationRule

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Правила оценки — удаление

DELETE {endpoint}/evaluationrules/{id}?api-version=v1

Удалите правило оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Уникальный идентификатор для правила оценки.

Responses

Код состояния: 204

Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Правила оценки — создание или обновление

PUT {endpoint}/evaluationrules/{id}?api-version=v1

Создание или обновление правила оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Уникальный идентификатор для правила оценки.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features Неправда струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
действие EvaluationRuleAction Модель действия по оценке. Да
└─ Тип EvaluationRuleActionType Тип действия по оценке. Да
описание струна Описание правила вычисления. нет
отображаемое имя струна Отображаемое имя для правила оценки. нет
enabled булевый Указывает, включено ли правило оценки. Значение по умолчанию — истинно. Да
eventType EvaluationRuleEventType Тип события правила оценки. Да
фильтр EvaluationRuleFilter Модель фильтра оценки. нет
└️ agentName струна Фильтрация по имени агента. Да
id строка (только для чтения) Уникальный идентификатор для правила оценки. Да
данные системы object (только для чтения) Системные метаданные для правила оценки. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvaluationRule

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json EvaluationRule

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Оценщиков

Вычислители — список последних версий

GET {endpoint}/evaluators?api-version=v1

Перечислите последнюю версию каждого оценщика

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
type query нет струна
Возможные значения: builtin, customall
Фильтруйте оценщики по типу. Возможные значения: 'all', 'custom', 'builtin'.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedEvaluatorVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Вычислители — версии списка

GET {endpoint}/evaluators/{name}/versions?api-version=v1

Перечислите все версии данного оценщика

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
type query нет струна
Возможные значения: builtin, customall
Фильтруйте оценщики по типу. Возможные значения: 'all', 'custom', 'builtin'.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedEvaluatorVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Вычислители — создание версии

POST {endpoint}/evaluators/{name}/versions?api-version=v1

Создание нового EvaluatorVersion с автоматически увеличиваемым идентификатором версии

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
categories массив проценщикаCategory Категории оценщика Да
Определение ScoreorDefinition Конфигурация базового оценщика с дискриминатором Да
└️ data_schema объект Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
└init_parameters init_parameters объект Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
Метрики └️ объект Список выходных метрик, полученных данным оценщиком нет
└─ Тип ScoreorDefinitionType Тип определения оценщика Да
описание струна Текст описания ресурса. нет
display_name струна Отображаемое имя для оценщика. В AI Foundry легко найти оценщика. Он не обязательно должен быть уникальным. нет
evaluator_type ScoreorType Тип оценщика Да
metadata объект Метаданные об оценщике нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет

Responses

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json ScoreorVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Вычислители — получение версии

GET {endpoint}/evaluators/{name}/versions/{version}?api-version=v1

Получите конкретную версию EvaluatorVersion. Служба возвращает ошибку 404 Not Found, если EvaluatorVersion не существует.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии извлекаемого объекта ScoreorVersion.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json ScoreorVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Вычислители — удаление версии

DELETE {endpoint}/evaluators/{name}/versions/{version}?api-version=v1

Удалите конкретную версию EvaluatorVersion. Служба возвращает 204 No Content, если EvaluatorVersion был успешно удален или если EvaluatorVersion не существует.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Версия объекта ScoreorVersion для удаления.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 204

Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Вычислители — версия обновления

PATCH {endpoint}/evaluators/{name}/versions/{version}?api-version=v1

Обновите существующую версию EvaluatorVersion с указанным идентификатором версии

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Версия объекта ScoreorVersion для обновления.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Evaluations=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
categories массив проценщикаCategory Категории оценщика нет
описание струна Текст описания ресурса. нет
display_name струна Отображаемое имя для оценщика. В AI Foundry легко найти оценщика. Он не обязательно должен быть уникальным. нет
metadata объект Метаданные об оценщике нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json ScoreorVersion

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Индексы

Индексы — список последних версий

GET {endpoint}/indexes?api-version=v1

Перечисление последней версии каждого индекса

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedIndex

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Индексы — версии списка

GET {endpoint}/indexes/{name}/versions?api-version=v1

Список всех версий данного индекса

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedIndex

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Индексы — получение версии

GET {endpoint}/indexes/{name}/versions/{version}?api-version=v1

Получите конкретную версию индекса. Служба возвращает ошибку 404 Not Found, если индекс не существует.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии индекса для извлечения.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Указатель

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Индексы — удаление версии

DELETE {endpoint}/indexes/{name}/versions/{version}?api-version=v1

Удалите конкретную версию индекса. Служба возвращает 204 No Content, если индекс был успешно удален или если индекс не существует.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Версия индекса для удаления.

Responses

Код состояния: 204

Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Индексы — создание или обновление версии

PATCH {endpoint}/indexes/{name}/versions/{version}?api-version=v1

Создание нового или обновление существующего индекса с заданным идентификатором версии

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Имя ресурса
version путь Да струна Идентификатор конкретной версии индекса, который необходимо создать или обновить.

Тело запроса

Тип содержания: application/merge-patch+json

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type IndexType Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Указатель

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json Указатель

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Insights

Аналитика — создание

POST {endpoint}/insights?api-version=v1

Генерируйте аналитические сведения

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Insights=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.
Повторяемость—Request-ID Неправда струна Уникальный, генерируемый клиентом идентификатор для обеспечения идемпотентности запросов. Используйте один и тот же идентификатор для повторных попыток, чтобы избежать дублирования оценок.
Повторяемость—First-Sent Неправда струна Временная метка, указывающая, когда этот запрос был впервые инициирован. Используется в сочетании с repeatability-request-id для управления идемпотентностью.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
отображаемое имя струна Понятное для пользователя отображаемое имя для аналитических сведений. Да
id строка (только для чтения) Уникальный идентификатор для отчета с аналитическими сведениями. Да
metadata InsightsMetadata (только для чтения) Метаданные об инсайтах. Да
└️ completedAt струна Временная метка, когда аналитические сведения были завершены. нет
└️ createdAt струна Временная метка при создании аналитических сведений. Да
запрос InsightsRequest Запрос аналитического отчета. Да
└─ Тип InsightsType Тип запроса. Да
результат InsightsResult (только для чтения) Результат инсайтов. нет
└─ Тип InsightsType Тип полученной информации. Да
государство Azure. Core.Foundations.OperationState (только для чтения) Перечисление, описывающее разрешенные состояния операций. Да

Responses

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json Проницательность

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Аналитика — список

GET {endpoint}/insights?api-version=v1

Перечислите все идеи в обратном хронологическом порядке (сначала новые).

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
type query нет струна
Возможные значения: EvaluationRunClusterInsight, AgentClusterInsightEvaluationComparison
Фильтрация по типу анализа.
evalId query нет струна Фильтрация по идентификатору оценки.
runId query нет струна Фильтрация по идентификатору пробного запуска.
agentName query нет струна Фильтрация по имени агента.
includeCoordinates query нет булевый Включать ли в ответ координаты для визуализации. По умолчанию false.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Insights=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedInsight

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Аналитика — получение

GET {endpoint}/insights/{id}?api-version=v1

Получите конкретное представление по идентификатору.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Уникальный идентификатор для отчета с аналитическими сведениями.
includeCoordinates query нет булевый Включать ли в ответ координаты для визуализации. По умолчанию false.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Insights=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Проницательность

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Хранилища памяти

Создание хранилища памяти

POST {endpoint}/memory_stores?api-version=v1

Создайте хранилище памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
Определение MemoryStoreDefinition Базовое определение для конфигураций хранилища памяти. Да
└️ вид MemoryStoreKind Вид хранилища памяти. Да
описание струна Удобочитаемое описание хранилища памяти.
Ограничения: maxLength: 512
нет
metadata объект Произвольные метаданные типа "ключ-значение" для связи с хранилищем памяти. нет
имя струна Имя хранилища памяти.
Ограничения: maxLength: 256
Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json MemoryStoreObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Список хранилищ памяти

GET {endpoint}/memory_stores?api-version=v1

Перечислите все хранилища памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Обновление хранилища памяти

POST {endpoint}/memory_stores/{name}?api-version=v1

Обновите хранилище памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя хранилища памяти для обновления.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Удобочитаемое описание хранилища памяти.
Ограничения: maxLength: 512
нет
metadata объект Произвольные метаданные типа "ключ-значение" для связи с хранилищем памяти. нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json MemoryStoreObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Получение хранилища памяти

GET {endpoint}/memory_stores/{name}?api-version=v1

Извлечение хранилища памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя извлекаемого хранилища памяти.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json MemoryStoreObject

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Удаление хранилища памяти

DELETE {endpoint}/memory_stores/{name}?api-version=v1

Удалите хранилище памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя удаленного хранилища памяти.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DeleteMemoryStoreResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Получение результата обновления

GET {endpoint}/memory_stores/{name}/updates/{update_id}?api-version=v1

Получите результат обновления хранилища памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя хранилища памяти.
update_id путь Да струна Идентификатор операции обновления памяти.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json MemoryStoreUpdateResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Удаление памяти области

POST {endpoint}/memory_stores/{name}:delete_scope?api-version=v1

Удалите все воспоминания, связанные с определенной областью, из хранилища памяти.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя хранилища памяти.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
scope струна Пространство имен, которое логически группирует и изолирует воспоминания для удаления, например идентификатор пользователя. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json MemoryStoreDeleteScopeResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Поиск воспоминаний

POST {endpoint}/memory_stores/{name}:search_memories?api-version=v1

Ищите релевантные воспоминания в хранилище памяти на основе контекста разговора.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя хранилища памяти для поиска.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
items массив OpenAI.InputItem Предметы, для которых нужно искать подходящие воспоминания. нет
options MemorySearchOptions Варианты поиска в памяти. нет
└max_memories целое число Максимальное количество возвращаемых элементов памяти. нет
previous_search_id струна Уникальный идентификатор предыдущего поискового запроса, позволяющий выполнять добавочный поиск в памяти с того места, где была прервана последняя операция. нет
scope струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json MemoryStoreSearchResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Обновление воспоминаний

POST {endpoint}/memory_stores/{name}:update_memories?api-version=v1

Обновите хранилище памяти с помощью воспоминаний о разговорах.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
имя путь Да струна Имя хранилища памяти для обновления.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: MemoryStores=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
items массив OpenAI.InputItem Элементы разговора, из которых можно извлечь воспоминания. нет
previous_update_id струна Уникальный идентификатор предыдущего запроса на обновление, позволяющий добавочное обновление памяти с того места, где была прервана последняя операция. нет
scope струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да
update_delay целое число Период ожидания перед обработкой обновления памяти в секундах.
Если в течение этого периода будет получен новый запрос на обновление, он отменит текущий запрос и сбросит время ожидания.
Установите значение 0, чтобы немедленно запустить обновление без задержки.
По умолчанию 300 (5 минут).
нет 300

Responses

Код состояния: 202

Описание. Запрос был принят для обработки, но обработка еще не завершена.

Тип содержимого Тип Описание
application/json MemoryStoreUpdateResponse

Заголовки ответа:

Header Тип Description
Операция-Местоположение струна Место для мониторинга рабочего состояния.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Беседы

Создание беседы

POST {endpoint}/openai/v1/conversations

Создайте беседу.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
items массив OpenAI.InputItem нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ConversationResource

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Список бесед

GET {endpoint}/openai/v1/conversations

Возвращает список всех бесед.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
agent_name query нет струна Фильтрация по имени агента. При условии возвращаются только элементы, связанные с указанным агентом.
agent_id query нет струна Фильтрация по идентификатору агента в формате name:version. Если указано, будут возвращены только элементы, связанные с указанным идентификатором агента.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Обновление беседы

POST {endpoint}/openai/v1/conversations/{conversation_id}

Обновите беседу.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор беседы для обновления.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ConversationResource

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Получение беседы

GET {endpoint}/openai/v1/conversations/{conversation_id}

Извлекает беседу.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор извлекаемой беседы.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ConversationResource

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Удаление беседы

DELETE {endpoint}/openai/v1/conversations/{conversation_id}

Удаляет беседу.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор удаленной беседы.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.DeletedConversationResource

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Создание элементов беседы

POST {endpoint}/openai/v1/conversations/{conversation_id}/items

Создайте элементы в беседе с заданным идентификатором.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор беседы, в которой необходимо создать элемент.
include query нет массив Дополнительные поля для включения в ответ.
Дополнительные сведения см. в параметре include для перечисления элементов беседы.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
items массив OpenAI.Item Элементы, добавляемые в беседу. Вы можете добавить до 20 элементов за раз. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ConversationItemList

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Вывод списка элементов беседы

GET {endpoint}/openai/v1/conversations/{conversation_id}/items

Вывод списка всех элементов для беседы с заданным идентификатором.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор беседы, в которой должны быть перечислены элементы.
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
item_type query нет струна
Возможные значения: message, , output_messagefile_search_callcomputer_callcomputer_call_outputweb_search_callfunction_callfunction_call_outputreasoningcompactionimage_generation_callcode_interpreter_calllocal_shell_calllocal_shell_call_outputshell_callshell_call_outputapply_patch_callapply_patch_call_outputmcp_list_toolsmcp_approval_requestmcp_approval_responsemcp_callcustom_tool_call_outputcustom_tool_callstructured_outputsoauth_consent_requestmemory_search_callworkflow_action
Фильтрация по типу элемента. При условии возвращаются только элементы указанного типа.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Получение элемента беседы

GET {endpoint}/openai/v1/conversations/{conversation_id}/items/{item_id}

Получите один элемент из беседы с заданными идентификаторами.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор беседы, содержащей элемент.
item_id путь Да струна Идентификатор извлекаемого элемента беседы.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.OutputItem

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Удаление элемента беседы

DELETE {endpoint}/openai/v1/conversations/{conversation_id}/items/{item_id}

Удалите элемент из беседы с заданными идентификаторами.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
conversation_id путь Да струна Идентификатор беседы, из которой необходимо удалить элемент.
item_id путь Да струна Идентификатор элемента беседы для удаления.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ConversationResource

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals

Evals — список evals

GET {endpoint}/openai/v1/evals

Перечислить все оценки Перечислить оценки для project.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
after query нет струна Идентификатор последнего выполнения из предыдущего запроса разбиения на страницы.
limit query нет целое число Количество запусков для извлечения.
заказ query нет струна
Возможные значения: asc, desc
Порядок сортировки запусков по метке времени. Используется asc для возрастания или desc для убывающего порядка. По умолчанию — asc.
сортировать_по query нет струна
Возможные значения: created_at, updated_at
Evals можно упорядочить по времени создания или времени последнего обновления.
Используется created_at для времени создания или updated_at последнего обновления.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — создание eval

POST {endpoint}/openai/v1/evals

Создание структуры оценки, которую можно использовать для тестирования производительности модели. Оценка — это набор критериев тестирования и конфигурации для источника данных, который определяет схему данных, используемых в оценке. После создания оценки его можно запустить на разных моделях и параметрах модели. Мы поддерживаем несколько типов классировщиков и источников данных. Дополнительные сведения см. в разделе

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
настройка_источника_данных OpenAI.CreateEvalCustomDataSourceConfig или OpenAI.CreateEvalLogsDataSourceConfig или OpenAI.CreateEvalStoredCompletionsDataSourceConfig или AzureAIDataSourceConfig Конфигурация источника данных, используемого для выполнения оценки. Определяет схему данных, используемых в оценке. Да
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Имя оценки. нет
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет
критерии тестирования массив OpenAI.EvalGraderLabelModel или OpenAI.EvalGraderStringCheck или OpenAI.EvalGraderTextSimilarity или OpenAI.EvalGraderPython или OpenAI.EvalGraderScoreModel или EvalGraderAzureAIEvaluator Список оценщиков для всех запусков оценок в этой группе. Классировщики могут ссылаться на переменные в источнике данных с помощью двойной фигурной скобки, например {{item.variable_name}}. Чтобы ссылаться на выходные данные модели, используйте sample пространство имен (т. е. {{sample.output_text}}). Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Eval

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — удаление eval

DELETE {endpoint}/openai/v1/evals/{eval_id}

Удаление оценки Удаление оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор оценки для удаления.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DeleteEvalResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — получение eval

GET {endpoint}/openai/v1/evals/{eval_id}

Получение оценки получения оценки по идентификатору.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор процесса оценки для извлечения.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Eval

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — обновление eval

POST {endpoint}/openai/v1/evals/{eval_id}

Обновите некоторые свойства оценки для оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор обновляемой оценки.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна нет
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Eval

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — запуски списка

GET {endpoint}/openai/v1/evals/{eval_id}/runs

Получение списка запусков для оценки получения списка запусков для оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор вычисления, для которого требуется получить запуски.
after query нет струна Идентификатор последнего выполнения из предыдущего запроса разбиения на страницы.
limit query нет целое число Количество запусков для извлечения.
заказ query нет струна
Возможные значения: asc, desc
Порядок сортировки запусков по метке времени. Используется asc для возрастания или desc для убывающего порядка. По умолчанию — asc.
статус query нет струна
Возможные значения: queued, , in_progresscompleted, canceledfailed. Фильтруйте запуски по статусу. Один из queued, , in_progressfailedcompleted, , canceled.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — создание запуска eval

POST {endpoint}/openai/v1/evals/{eval_id}/runs

Создание запуска оценки

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор оценки для создания процедуры выполнения.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
источник данных OpenAI.CreateEvalJsonlRunDataSource или OpenAI.CreateEvalCompletionsRunDataSource или OpenAI.CreateEvalResponsesRunDataSource или EvalRunDataSource Сведения об источнике данных запуска. Да
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Имя запуска. нет
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvalRun

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — удаление запуска eval

DELETE {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}

Удаление ознакомительного запуска Delete a eval run.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор оценки, из которой нужно удалить запуск.
run_id путь Да струна Идентификатор запуска для удаления.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DeleteEvalRunResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — получение запуска eval

GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}

Проведите оценку. Проведите оценку в ID.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор вычисления, для которого требуется получить запуски.
run_id путь Да струна Идентификатор извлекаемого запуска.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvalRun

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — отмена выполнения eval

POST {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}

Отмена выполнения оценки отмены текущего выполнения оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор оценки, выполнение которой требуется отменить.
run_id путь Да струна Идентификатор запуска, который необходимо отменить.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvalRun

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — получение выходных элементов выполнения eval

GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items

Получение выходных элементов выполнения оценки получает список выходных элементов для выполнения оценки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна
run_id путь Да струна Идентификатор запуска для получения результатов.
after query нет струна Идентификатор последнего выполнения из предыдущего запроса разбиения на страницы.
limit query нет целое число Количество запусков для извлечения.
заказ query нет струна
Возможные значения: asc, desc
Порядок сортировки запусков по метке времени. Используется asc для возрастания или desc для убывающего порядка. По умолчанию — asc.
статус query нет струна
Возможные значения: fail, pass
Фильтрация выходных элементов по состоянию. Использование failed для фильтрации по неудачным выходным данным
элементы или pass фильтрация по переданным выходным элементам.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Evals — получение выходного элемента выполнения eval

GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}

Получение выходного элемента ознакомительного запуска Get an evaluation run output item by ID.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
eval_id путь Да струна Идентификатор вычисления, для которого требуется получить запуски.
run_id путь Да струна Идентификатор извлекаемого запуска.
output_item_id путь Да струна Идентификатор извлекаемого выходного элемента.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json EvalRunOutputItem

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Fine-Tuning

Создание задания тонкой настройки

POST {endpoint}/openai/v1/fine_tuning/jobs?api-version=v1

Создает задание тонкой настройки, которое начинает процесс создания новой модели из заданного набора данных.

Ответ содержит подробные сведения о задании, в том числе о состоянии задания и имени настроенных моделей после завершения.

Узнайте больше о тонкой настройке

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
гиперпараметры OpenAI.CreateFineTuningJobRequestHyperparameters нет
└batch_size string или OpenAI.integer нет авто
└learning_rate_multiplier learning_rate_multiplier string или OpenAI.numeric нет
└️ n_epochs string или OpenAI.integer нет авто
Интеграции массив OpenAI.CreateFineTuningJobRequestIntegrations Список интеграции для задания тонкой настройки. нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
method OpenAI.FineTuneMethod Метод, используемый для точной настройки. нет
модель строка (см. допустимые модели ниже) Имя модели для точной настройки. Вы можете выбрать один из них.
поддерживаемые модели.
Да
seed OpenAI.integer (nullable) нет
Суффикс Строка (нулевая) Строка до 64 символов, которые будут добавлены в имя настраиваемой модели.
Например, suffix в поле "Custom-model-name" будет производиться имя модели, например ft:gpt-4o-mini:openai:custom-model-name:7p4lURel.
Ограничения: minLength: 1, maxLength: 64
нет
файл_обучения струна Идентификатор отправленного файла, содержащего данные обучения.
Сведения о том, как отправить файл, см. в разделе "Отправка файла ".
Набор данных должен быть отформатирован в формате JSONL-файла. Кроме того, необходимо передать файл с целью fine-tune.
Содержимое файла должно отличаться в зависимости от того, использует ли модель чат, формат завершения или использует ли метод тонкой настройки формат предпочтения .
Подробнее смотрите руководство по fine-tuning для подробностей.
Да
Файл_валидации Строка (нулевая) Идентификатор отправленного файла, содержащего данные проверки.
Если этот файл предоставлен, данные используются для создания проверки
Метрики периодически во время тонкой настройки. Эти метрики можно просмотреть в
файл результатов тонкой настройки.
Одни и те же данные не должны присутствовать в файлах обучения и проверки.
Набор данных должен быть отформатирован в формате JSONL-файла. Необходимо отправить файл с целью fine-tune.
Подробнее смотрите руководство по fine-tuning для подробностей.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.FineTuningJob

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Список заданий тонкой настройки с разбивкой на страницы

GET {endpoint}/openai/v1/fine_tuning/jobs?api-version=v1

Перечисление заданий точной настройки организации

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
after query нет струна Идентификатор последнего задания из предыдущего запроса на страницы.
limit query нет целое число Количество получаемых заданий точной настройки.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ListPaginatedFineTuningJobsResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Получение задания тонкой настройки

GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}?api-version=v1

Получение сведений о задании тонкой настройки.

Узнайте больше о тонкой настройке

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
идентификатор_задания_тончайшей_настройки путь Да струна Идентификатор задания тонкой настройки.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.FineTuningJob

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Отмена задания тонкой настройки

POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel?api-version=v1

Немедленно отмените задание точной настройки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
идентификатор_задания_тончайшей_настройки путь Да струна Идентификатор задания тонкой настройки для отмены.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.FineTuningJob

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Перечисление контрольных точек задания тонкой настройки

GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints?api-version=v1

Вывод списка контрольных точек для задания тонкой настройки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
идентификатор_задания_тончайшей_настройки путь Да струна Идентификатор задания точной настройки для получения контрольных точек.
after query нет струна Идентификатор последнего идентификатора контрольной точки из предыдущего запроса на страницы.
limit query нет целое число Количество получаемых контрольных точек.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ListFineTuningJobCheckpointsResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Перечисление событий точной настройки заданий

GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/events?api-version=v1

Получение подробных обновлений состояния для задания точной настройки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
идентификатор_задания_тончайшей_настройки путь Да струна Идентификатор задания точной настройки для получения событий.
after query нет струна Идентификатор последнего события из предыдущего запроса на страницы.
limit query нет целое число Количество извлекаемых событий.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.ListFineTuningJobEventsResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Приостановка задания тонкой настройки

POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/pause?api-version=v1

Приостановить выполнение задания точной настройки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
идентификатор_задания_тончайшей_настройки путь Да струна Идентификатор задания тонкой настройки для приостановки.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.FineTuningJob

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Возобновление задания тонкой настройки

POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/resume?api-version=v1

Возобновление приостановленного задания точной настройки.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
идентификатор_задания_тончайшей_настройки путь Да струна Идентификатор задания тонкой настройки для возобновления.
версия API query Да струна Версия API, используемая для данной операции.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.FineTuningJob

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Responses

Создание ответа — создание потока ответов

POST {endpoint}/openai/v1/responses

Создает модельный ответ. Создает ответ модели (потоковой ответ).

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
фон Булев (нулируемый) нет
разговор OpenAI.ConversationParam (nullable) Беседа, к которой относится этот ответ. Элементы из этой беседы предопределяются input_items для этого запроса ответа.
Входные элементы и выходные элементы из этого ответа автоматически добавляются в эту беседу после завершения этого ответа.
нет
include массив OpenAI.IncludeEnum нет
ввод OpenAI.InputParam Входные данные, такие как текст, изображения или файлы, в модель, используемые для генерации ответа.
Подробнее:
- Текстовые входы и выходы
- Входы изображения
- Входы файла
- состояние разговора
- Вызов функций
нет
instructions Строка (нулевая) нет
max_output_tokens OpenAI.integer (nullable) нет
max_tool_calls OpenAI.integer (nullable) нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
модель струна Развертывание модели, используемое для создания этого ответа. нет
вызовы инструмента в параллельном режиме Булев (нулируемый) нет True
previous_response_id Строка (нулевая) нет
prompt OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
reasoning OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
- усилия OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
└─generate_summary перечисление
Возможные значения: auto, concisedetailed
нет
└️ сводка перечисление
Возможные значения: auto, concisedetailed
нет
safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
уровень обслуживания OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
store Булев (нулируемый) нет True
поток Булев (нулируемый) нет
stream_options OpenAI.ResponseStreamOptions (допускающий значение NULL) Параметры потоковых ответов. Этот параметр устанавливается только при установке stream: true. нет
└include_obfuscation булевый Если задано значение true, будет включена обфускация потока. Добавляется скрытие потока
случайные символы в поле потоковой передачи obfuscation событий разностных событий в
нормализованные размеры полезных данных в качестве устранения определенных атак на стороне канала.
Эти поля маскировки включены по умолчанию, но добавьте небольшое количество.
затраты на поток данных. Можно задать значение include_obfuscation
False для оптимизации пропускной способности, если вы доверяете сетевым каналам между
приложение и API OpenAI.
нет
structured_inputs объект Структурированные входные данные ответа, которые могут участвовать в подстановке шаблона запроса или привязках аргументов инструментов. нет
Температура OpenAI.numeric (nullable) нет 1
текст OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
выбор инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
top_logprobs OpenAI.integer (nullable) нет
top_p OpenAI.numeric (nullable) нет 1
truncation перечисление
Возможные значения: auto, disabled
нет
Пользователь string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.Response
text/event-stream OpenAI.CreateResponseStreamingResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Вывод списка ответов

GET {endpoint}/openai/v1/responses

Возвращает список всех ответов.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.
agent_name query нет струна Фильтрация по имени агента. При условии возвращаются только элементы, связанные с указанным агентом.
agent_id query нет струна Фильтрация по идентификатору агента в формате name:version. Если указано, будут возвращены только элементы, связанные с указанным идентификатором агента.
conversation_id query нет струна Фильтрация по идентификатору беседы. Если это указано, будут возвращены только ответы, связанные с указанной беседой.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Компактный диалог ответа

POST {endpoint}/openai/v1/responses/compact

Создает сжатие беседы с ответами.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
ввод строка или массив OpenAI.InputItem нет
instructions Строка (нулевая) нет
модель OpenAI.ModelIdsCompaction Идентификатор модели, используемый для создания ответа, например gpt-5 или o3. OpenAI предлагает широкий спектр моделей с разными возможностями, характеристиками производительности и ценами. Ознакомьтесь с руководством по модели для просмотра и сравнения доступных моделей. Да
previous_response_id Строка (нулевая) нет

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.CompactResource

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Получение ответа — получение потока ответа

GET {endpoint}/openai/v1/responses/{response_id}

Извлекает ответ модели с заданным идентификатором. Извлекает ответ модели с заданным идентификатором (ответ потоковой передачи).

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
response_id путь Да струна
include[] query нет массив
поток query нет булевый
starting_after query нет целое число

Заголовок запроса

Имя. Обязательно Тип Description
принимать Неправда струна
Возможные значения: text/event-stream

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.Response
text/event-stream OpenAI.CreateResponseStreamingResponse

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Удаление ответа

DELETE {endpoint}/openai/v1/responses/{response_id}

Удаляет ответ модели.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
response_id путь Да струна Идентификатор ответа для удаления.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json DeleteResponseResult

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Отмена ответа

POST {endpoint}/openai/v1/responses/{response_id}/cancel

Отменяет ответ модели.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
response_id путь Да струна Идентификатор ответа на отмену.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json OpenAI.Response

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Список входных элементов

GET {endpoint}/openai/v1/responses/{response_id}/input_items

Возвращает список входных элементов для заданного ответа.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
response_id путь Да струна
limit query нет целое число Ограничение количества возвращаемых объектов. Ограничение может варьироваться от 1 до 100, и
значение по умолчанию — 20.
заказ query нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для порядка возрастания иdesc
для сортировки по убыванию
after query нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
before query нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке.
Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo.
последующий вызов может содержать параметр before=obj_foo, чтобы получить предыдущую страницу списка.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json объект Данные ответа для запрошенного списка элементов.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Redteams

Redteams — список

GET {endpoint}/redTeams/runs?api-version=v1

Перечислите красную команду по имени.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: RedTeams=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedRedTeam

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Красные команды — идите

GET {endpoint}/redTeams/runs/{name}?api-version=v1

Получите редкоманду по названию.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
имя путь Да струна Идентификатор красной команды пробега.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: RedTeams=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json RedTeam

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Redteams — создание

POST {endpoint}/redTeams/runs:run?api-version=v1

Создает забег красной команды.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: RedTeams=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
applicationScenario струна Сценарий приложения для операции красной команды для генерации атак, специфичных для конкретного сценария. нет
атакиStrategies массив АтакStrategy Список стратегий атак или вложенные списки стратегий атак. нет
отображаемое имя струна Название забега красной команды. нет
id строка (только для чтения) Идентификатор красной команды пробега. Да
numTurns целое число Количество раундов моделирования. нет
свойства объект Свойства красной команды. В отличие от тегов, свойства являются только надстройками. После добавления свойство невозможно удалить. нет
Категории рисков массив RiskCategory Список категорий риска для создания целей атаки. нет
имитацияOnly булевый Только симуляция или симуляция + оценка. По умолчанию false, если true, сканирование выводит диалог, а не результат оценки. нет Неправда
статус строка (только для чтения) Статус красной команды. Он задается сервисом и доступен только для чтения. нет
tags объект Метки красной команды. В отличие от свойств, теги полностью изменяются. нет
target TargetConfig Абстрактный класс для целевой конфигурации. Да
└─ Тип струна Тип конфигурации модели. Да

Responses

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json RedTeam

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Schedules

Расписания — список

GET {endpoint}/schedules?api-version=v1

Перечислите все расписания.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
type query нет струна
Возможные значения: Evaluation, Insight
Фильтруйте по типу расписания.
enabled query нет булевый Фильтрация по включенному статусу.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Schedules=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedSchedule

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Расписания — удаление

DELETE {endpoint}/schedules/{id}?api-version=v1

Удалить расписание.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Идентификатор расписания.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Schedules=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 204

Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Расписания — получение

GET {endpoint}/schedules/{id}?api-version=v1

Получить расписание по id.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Идентификатор расписания.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Schedules=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Расписание

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Расписания — создание или обновление

PUT {endpoint}/schedules/{id}?api-version=v1

Создание или обновление шаблона операции.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Идентификатор расписания.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Schedules=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Тело запроса

Тип содержания: application/json

Имя. Тип Description Обязательно По умолчанию
описание струна Описание расписания. нет
отображаемое имя струна Имя расписания. нет
enabled булевый Включен статус расписания. Да
id строка (только для чтения) Идентификатор расписания. Да
свойства объект Свойства расписания. В отличие от тегов, свойства являются только надстройками. После добавления свойство невозможно удалить. нет
provisioningStatus ScheduleProvisioningStatus (только для чтения) Состояние подготовки расписания. нет
данные системы object (только для чтения) Системные метаданные для ресурса. Да
tags объект Теги расписания. В отличие от свойств, теги полностью изменяются. нет
Задача ScheduleTask Модель задачи планирования. Да
Конфигурация └️ объект Конфигурация под задачу. нет
└─ Тип ScheduleTaskType Тип задачи. Да
trigger Trigger Базовая модель для триггера расписания. Да
└─ Тип TriggerType Тип спускового крючка. Да

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json Расписание

Код состояния: 201

Описание: запрос успешно выполнен, и в результате был создан новый ресурс.

Тип содержимого Тип Описание
application/json Расписание

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Расписания — запуски списка

GET {endpoint}/schedules/{id}/runs?api-version=v1

Составьте список всех запланированных запусков.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
версия API query Да струна Версия API, используемая для данной операции.
id путь Да струна Идентификатор расписания.
type query нет струна
Возможные значения: Evaluation, Insight
Фильтруйте по типу расписания.
enabled query нет булевый Фильтрация по включенному статусу.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Schedules=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json PagedScheduleRun

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json Azure. Core.Foundations.ErrorResponse

Заголовки ответа:

Header Тип Description
X-ms-error-code струна Строковый код ошибки, указывающий, что пошло не так.

Расписания — получение запуска

GET {endpoint}/schedules/{schedule_id}/runs/{run_id}?api-version=v1

Получить расписание, запускаемое по id.

Параметры URI

Имя. In Обязательно Тип Description
endpoint путь Да струна Endpoint Foundry Project в виде
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}".
Если у вас только один Project в Foundry Hub или чтобы нацелиться на стандартный Project
в Центре используйте форму
"https://{ai-services-account-name}.services.ai. azure.com/api/projects/_project»
schedule_id путь Да струна Уникальный идентификатор расписания.
run_id путь Да струна Уникальный идентификатор выполнения расписания.
версия API query Да струна Версия API, используемая для данной операции.

Заголовок запроса

Имя. Обязательно Тип Description
Foundry-Features True струна
Возможные значения: Schedules=V1Preview
Флаг функции, необходимый при использовании операций предварительной версии или изменении сохраненных ресурсов предварительной версии.

Responses

Код состояния: 200

Описание: запрос выполнен успешно.

Тип содержимого Тип Описание
application/json ScheduleRun

Код состояния: по умолчанию

Описание: непредвиденная ошибка.

Тип содержимого Тип Описание
application/json ApiErrorResponse

Components

A2APreviewTool

Агент, реализующий протокол A2A.

Имя. Тип Description Обязательно По умолчанию
agent_card_path струна Путь к карточке агента относительно .base_url
Если не указано, по умолчанию используется значение /.well-known/agent-card.json
нет
base_url струна Базовый URL агента. нет
project_connection_id струна Идентификатор соединения в project для сервера A2A.
Соединение хранит аутентификацию и другие сведения о подключении, необходимые для подключения к серверу A2A.
нет
type перечисление Тип средства. Всегда "a2a_preview.
Возможные значения: a2a_preview
Да

AISearchIndexResource

Ресурс индекса поиска AI.

Имя. Тип Description Обязательно По умолчанию
фильтр струна Строка фильтра для ресурса поиска. Подробнее здесь. нет
index_asset_id струна Идентификатор ресурса индекса для ресурса поиска. нет
имя_индекса струна Имя индекса в индексе, подключенном к этому агенту. нет
project_connection_id струна Идентификатор индексного подключения в IndexResource, подключенном к этому агенту. нет
тип_запроса AzureAISearchQueryType Доступные типы запросов для инструмента Azure AI Search. нет
топ_к целое число Количество документов для извлечения из поиска и представления модели. нет

AgentClusterInsightRequest

Анализ набора результатов оценки операторов

Имя. Тип Description Обязательно По умолчанию
agentName струна Идентификатор агента. Да
ModelConfiguration InsightsModelConfiguration Конфигурация модели, используемой при создании аналитических сведений. нет
└️ modelDeploymentName струна Развертывание модели, подлежащее оценке. Принимает только имя развертывания или имя подключения как {connectionName}/<modelDeploymentName>. Да
type перечисление Тип запроса.
Возможные значения: AgentClusterInsight
Да

AgentClusterInsightResult

Выводы из кластерного анализа агентов.

Имя. Тип Description Обязательно По умолчанию
clusterInsight ClusterInsightResult Выводы из кластерного анализа. Да
type перечисление Тип полученной информации.
Возможные значения: AgentClusterInsight
Да

AgentContainerObject

Сведения о контейнере определенной версии агента.

Имя. Тип Description Обязательно По умолчанию
container ContainerDetails (только для чтения) Подробные сведения о контейнере. нет
└health_state струна Состояние работоспособности контейнера. Да
└️ provisioning_error струна Ошибка подготовки контейнера, если она есть. нет
└provisioning_state струна Состояние подготовки контейнера. Да
Реплики └️ массив ContainerReplica Список реплик в контейнере. Да
Состояние └️ струна Состояние контейнера. Да
└️ updated_on струна Время последнего обновления контейнера. Да
создано_в струна Время создания контейнера. Да
error_message строка (только для чтения) Сообщение об ошибке, если контейнер не работал, если таковой не выполнен. нет
id строка (только для чтения) Идентификатор контейнера. нет
max_replicas целое число Максимальное количество реплик для контейнера. По умолчанию 1. нет
min_replicas целое число Минимальное количество реплик для контейнера. По умолчанию 1. нет
объект перечисление Тип объекта, который всегда является agent.container.
Возможные значения: agent.container
Да
статус AgentContainerStatus (только для чтения) Состояние контейнера определенной версии агента. Да
updated_at струна Время последнего обновления контейнера. Да

AgentContainerOperationError

Сведения об ошибке операции контейнера, если таковые есть.

Имя. Тип Description Обязательно По умолчанию
код струна Код ошибки операции контейнера, если таковой есть. Да
сообщение струна Сообщение об ошибке операции контейнера, если таковой есть. Да
type струна Тип ошибки операции контейнера, если таковой есть. Да

AgentContainerOperationObject

Операция контейнера для определенной версии агента.

Имя. Тип Description Обязательно По умолчанию
agent_id струна Идентификатор агента. Да
agent_version_id струна Идентификатор версии агента. Да
container AgentContainerObject Сведения о контейнере определенной версии агента. нет
Контейнер └️ ContainerDetails (только для чтения) Подробные сведения о контейнере. нет
└️ created_at строка (только для чтения) Время создания контейнера. Да
└️ error_message строка (только для чтения) Сообщение об ошибке, если контейнер не работал, если таковой не выполнен. нет
Идентификатор └️ строка (только для чтения) Идентификатор контейнера. нет
└️ max_replicas целое число Максимальное количество реплик для контейнера. По умолчанию 1. нет
└min_replicas целое число Минимальное количество реплик для контейнера. По умолчанию 1. нет
└─ Объект перечисление Тип объекта, который всегда является agent.container.
Возможные значения: agent.container
Да
└─ Состояние AgentContainerStatus (только для чтения) Состояние контейнера определенной версии агента. Да
└updated_at updated_at строка (только для чтения) Время последнего обновления контейнера. Да
ошибка AgentContainerOperationError Сведения об ошибке операции контейнера, если таковые есть. нет
└─ Код струна Код ошибки операции контейнера, если таковой есть. Да
Сообщение └️ струна Сообщение об ошибке операции контейнера, если таковой есть. Да
└─ Тип струна Тип ошибки операции контейнера, если таковой есть. Да
id струна Идентификатор операции контейнера. Этот идентификатор является уникальным идентификатором в системе. Да
статус AgentContainerOperationStatus Состояние операции контейнера для определенной версии агента. Да

AgentContainerOperationStatus

Состояние операции контейнера для определенной версии агента.

Недвижимость Ценность
Тип струна
Значения NotStarted
InProgress
Succeeded
Failed

AgentContainerStatus

Состояние контейнера определенной версии агента.

Недвижимость Ценность
Тип струна
Значения Starting
Running
Stopping
Stopped
Failed
Deleting
Deleted
Updating

AgentDefinition

Дискриминация для AgentDefinition

Этот компонент использует свойство kind для дискриминации между различными типами:

Значение типа Схема
prompt PromptAgentDefinition
workflow WorkflowAgentDefinition
hosted HostedAgentDefinition
container_app ContainerAppAgentDefinition
Имя. Тип Description Обязательно По умолчанию
добрый AgentKind Да
rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
└rai_policy_name струна Название политики RAI, которую необходимо применить. Да

AgentKind

Недвижимость Ценность
Тип струна
Значения prompt
hosted
container_app
workflow

AgentObject

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор агента. Да
имя струна Имя агента.
Ограничения: maxLength: 63
Да
объект перечисление Тип объекта, которым всегда является 'agent'.
Возможные значения: agent
Да
versions объект Актуальная версия агента. Да
└️ последняя версия AgentVersionObject Да

AgentProtocol

Недвижимость Ценность
Тип струна
Значения activity_protocol
responses

Справочник агента

Имя. Тип Description Обязательно По умолчанию
имя струна Имя агента.
Ограничения: maxLength: 256
Да
type перечисление
Возможные значения: agent_reference
Да
version струна Идентификатор версии агента. нет

AgentTaxonomyInput

Конфигурация входных данных для таксономии оценки, если тип ввода — agent.

Имя. Тип Description Обязательно По умолчанию
Категории рисков массив RiskCategory Список категорий риска для оценки. Да
target Цель Базовый класс для целей с поддержкой дискриминаторов. Да
└─ Тип струна Тип целевого объекта. Да
type перечисление Тип входных данных таксономии оценки.
Возможные значения: agent
Да

AgentTaxonomyInputUpdate

Конфигурация входных данных для таксономии оценки, если тип ввода — agent.

Имя. Тип Description Обязательно По умолчанию
Категории рисков массив RiskCategory Список категорий риска для оценки. нет
target TargetUpdate Базовый класс для целей с поддержкой дискриминаторов. нет
└─ Тип струна Тип целевого объекта. Да
type перечисление Тип входных данных таксономии оценки.
Возможные значения: agent
Да

AgentVersionObject

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Временная метка Unix (в секундах) на момент создания агента. Да
Определение AgentDefinition Да
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
id струна Уникальный идентификатор версии агента. Да
metadata Объект (нулируемый) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
Да
имя струна Имя агента. Имя может быть использовано для получения/обновления/удаления агента.
Ограничения: maxLength: 256
Да
объект перечисление Тип объекта, которым всегда является 'agent.version'.
Возможные значения: agent.version
Да
version струна Идентификатор версии агента. Агенты неизменяемы, и каждое обновление создает новую версию с сохранением того же имени. Да

AgenticIdentityPreviewCredentials

Определение учетных данных удостоверения агента

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип учетных данных
Возможные значения: AgenticIdentityToken_Preview
Да

ApiErrorResponse

Ответ об ошибке при сбоях API.

Имя. Тип Description Обязательно По умолчанию
ошибка OpenAI.Error Да

ApiKeyCredentials

Определение учетных данных ключа API

Имя. Тип Description Обязательно По умолчанию
ключ строка (только для чтения) Ключ API нет
type перечисление Тип учетных данных
Возможные значения: ApiKey
Да

AssetCredentialResponse

Представляет ссылку на большой двоичный объект для использования

Имя. Тип Description Обязательно По умолчанию
BLOBReference BlobReference Сведения о ссылке на BLOB-объекты. Да
└️ blobUri струна Путь URI большого двоичного объекта для клиента для отправки данных. Пример: https://blob.windows.core.net/Container/Path Да
Учетные данные └️ SasCredential Информация о учетных данных для access к аккаунту storage. Да
└️ storageAccountArmId струна ARM ID аккаунта storage для использования. Да

Идентификатор актива

Идентификатор сохраненного ресурса.

Тип: string.

АтакаStrategy

Стратегии атак.

Недвижимость Ценность
Описание Стратегии атак.
Тип струна
Значения easy
moderate
difficult
ascii_art
ascii_smuggler
atbash
base64
binary
caesar
character_space
jailbreak
ansi_attack
character_swap
suffix_append
string_join
unicode_confusable
unicode_substitution
diacritic
flip
leetspeak
rot13
morse
url
baseline
indirect_jailbreak
tense
multi_turn
crescendo

Azure. Core.Foundations.Error

Объект ошибки.

Имя. Тип Description Обязательно По умолчанию
код струна Один из определяемых сервером кодов ошибок. Да
details Массив Azure. Core.Foundations.Error Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке. нет
innererror Azure. Core.Foundations.InnerError Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors. нет
└─ Код струна Один из определяемых сервером кодов ошибок. нет
└️ innererror Azure. Core.Foundations.InnerError Внутренняя ошибка. нет
сообщение струна Читаемое пользователем представление ошибки. Да
target струна Целевой объект ошибки. нет

Azure. Core.Foundations.ErrorResponse

Ответ, содержащий сведения об ошибке.

Имя. Тип Description Обязательно По умолчанию
ошибка Azure. Core.Foundations.Error Объект ошибки. Да
└─ Код струна Один из определяемых сервером кодов ошибок. Да
└️ подробности Массив Azure. Core.Foundations.Error Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке. нет
└️ innererror Azure. Core.Foundations.InnerError Объект, содержащий более конкретные сведения, чем текущий объект об ошибке. нет
Сообщение └️ струна Читаемое пользователем представление ошибки. Да
Целевой объект └️ струна Целевой объект ошибки. нет

Azure. Core.Foundations.InnerError

Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Имя. Тип Description Обязательно По умолчанию
код струна Один из определяемых сервером кодов ошибок. нет
innererror Azure. Core.Foundations.InnerError Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors. нет
└─ Код струна Один из определяемых сервером кодов ошибок. нет
└️ innererror Azure. Core.Foundations.InnerError Внутренняя ошибка. нет

Azure. Ядро.Основы.ОперацияСостояние

Перечисление, описывающее разрешенные состояния операций.

Недвижимость Ценность
Описание Перечисление, описывающее разрешенные состояния операций.
Тип струна
Значения NotStarted
Running
Succeeded
Failed
Canceled

Azure. Core.uuid

Универсальный уникальный идентификатор

Тип: string.

Формат: uuid

AzureAIAgentTarget

Представляет цель, указывающую агент AI Azure.

Имя. Тип Description Обязательно По умолчанию
имя струна Уникальный идентификатор агента AI Azure. Да
tool_descriptions массив ToolDescription Параметры, используемые для управления поведением выборки агента во время создания текста. нет
type перечисление Тип цели, всегда azure_ai_agent.
Возможные значения: azure_ai_agent
Да
version струна Версия агента Azure AI. нет

AzureAIAgentTargetUpdate

Представляет цель, указывающую агент AI Azure.

Имя. Тип Description Обязательно По умолчанию
имя струна Уникальный идентификатор агента AI Azure. нет
tool_descriptions массив ToolDescription Параметры, используемые для управления поведением выборки агента во время создания текста. нет
type перечисление Тип цели, всегда azure_ai_agent.
Возможные значения: azure_ai_agent
Да
version струна Версия агента Azure AI. нет

AzureAIDataSourceConfig

Имя. Тип Description Обязательно По умолчанию
сценарий перечисление Сценарий схемы данных.
Возможные значения: red_team, , responsestraces_previewsynthetic_data_gen_preview
Да
schema объект Общая схема JSON объекта для элементов источника данных запуска. Да
type перечисление Тип объекта, который всегда azure_ai_sourceявляется .
Возможные значения: azure_ai_source
Да

AzureAIModelTarget

Представляет цель, указывающую модель Azure AI для операций, требующих выбора модели.

Имя. Тип Description Обязательно По умолчанию
модель струна Уникальный идентификатор модели Azure AI. нет
параметры выборки ModelSamplingParams Представляет набор параметров, используемых для управления поведением выборки языковой модели во время создания текста. нет
└─max_completion_tokens целое число Максимальное число маркеров, разрешенных в завершении. Да
Начальное значение └️ целое число Случайное начальное значение для воспроизведения. Да
└─ Температура число/номер Параметр температуры для выборки. Да
└️ top_p число/номер Параметр top-p для выборки ядра. Да
type перечисление Тип цели, всегда azure_ai_model.
Возможные значения: azure_ai_model
Да

AzureAIModelTargetUpdate

Представляет цель, указывающую модель Azure AI для операций, требующих выбора модели.

Имя. Тип Description Обязательно По умолчанию
модель струна Уникальный идентификатор модели Azure AI. нет
параметры выборки ModelSamplingParamsUpdate Представляет набор параметров, используемых для управления поведением выборки языковой модели во время создания текста. нет
└─max_completion_tokens целое число Максимальное число маркеров, разрешенных в завершении. нет
Начальное значение └️ целое число Случайное начальное значение для воспроизведения. нет
└─ Температура число/номер Параметр температуры для выборки. нет
└️ top_p число/номер Параметр top-p для выборки ядра. нет
type перечисление Тип цели, всегда azure_ai_model.
Возможные значения: azure_ai_model
Да

AzureAIResponsesEvalRunDataSource

Представляет источник данных для выполнения вычислений, относящихся к сценариям непрерывной оценки.

Имя. Тип Description Обязательно По умолчанию
event_configuration_id струна Имя конфигурации события, связанное с этим запуском оценки. Да
item_generation_params ResponseRetrievalItemGenerationParams Представляет параметры для создания элемента извлечения ответа. Да
└️ data_mapping объект Сопоставление из исходных полей в поле response_id, необходимое для получения журнала чата. Да
└max_num_turns целое число Максимальное количество поворотов журнала чата для вычисления. Да
└─ Источник OpenAI.EvalJsonlFileContentSource или OpenAI.EvalJsonlFileIdSource Источник, из которого считывается содержимое JSONL. Да
└─ Тип перечисление Тип параметров создания элементов всегда response_retrieval.
Возможные значения: response_retrieval
Да
max_runs_hourly целое число Максимально допустимое количество прогонов оценки в час. Да
type перечисление Тип источника данных всегда azure_ai_responses.
Возможные значения: azure_ai_responses
Да

Индекс поиска Azure AI

Azure AI Search Index Definition

Имя. Тип Description Обязательно По умолчанию
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
имя строка (только для чтения) Имя ресурса Да
type перечисление Тип индекса
Возможные значения: AzureSearch
Да
version строка (только для чтения) Версия ресурса Да

AzureAISearchIndexUpdate

Azure AI Search Index Definition

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type перечисление Тип индекса
Возможные значения: AzureSearch
Да

AzureAISearchQueryType

Доступные типы запросов для инструмента Azure AI Search.

Недвижимость Ценность
Описание Доступные типы запросов для инструмента Azure AI Search.
Тип струна
Значения simple
semantic
vector
vector_simple_hybrid
vector_semantic_hybrid

AzureAISearchTool

Входная информация о определении для инструмента Azure AI search, используемого для настройки агента.

Имя. Тип Description Обязательно По умолчанию
azure_ai_search AzureAISearchToolResource Набор ресурсов индекса, используемых средством azure_ai_search. Да
Индексы └️ массив AISearchIndexResource Индексы, присоединенные к этому агенту. Может быть не более 1 индекса
ресурс, подключенный к агенту.
Ограничения: maxItems: 1
Да
type перечисление Тип объекта, который всегда равен 'azure_ai_search'.
Возможные значения: azure_ai_search
Да

AzureAISearchToolResource

Набор ресурсов индекса, используемых средством azure_ai_search.

Имя. Тип Description Обязательно По умолчанию
Индексы массив AISearchIndexResource Индексы, присоединенные к этому агенту. Может быть не более 1 индекса
ресурс, подключенный к агенту.
Да

AzureFunctionBinding

Структура для сохранения имени storage queue и URI.

Имя. Тип Description Обязательно По умолчанию
storage_queue AzureFunctionStorageQueue Структура для сохранения имени storage queue и URI. Да
└queue_name струна Название очереди storage функции Azure. Да
└️ queue_service_endpoint струна URI в сервис Azure Storage Queue, позволяющий управлять очередью. Да
type перечисление Тип привязки, который всегда является "storage_queue".
Возможные значения: storage_queue
Да

AzureFunctionDefinition

Определение функции Azure.

Имя. Тип Description Обязательно По умолчанию
function объект Определение функции azure и её параметров. Да
└─ Описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
└️ имя струна Имя вызываемой функции. Да
└️ Параметры объект Параметры, которые принимают функции, описаны как объект схемы JSON. Да
input_binding AzureFunctionBinding Структура для сохранения имени storage queue и URI. Да
└️ storage_queue AzureFunctionStorageQueue Storage queue. Да
└─ Тип перечисление Тип привязки, который всегда является "storage_queue".
Возможные значения: storage_queue
Да
output_binding AzureFunctionBinding Структура для сохранения имени storage queue и URI. Да
└️ storage_queue AzureFunctionStorageQueue Storage queue. Да
└─ Тип перечисление Тип привязки, который всегда является "storage_queue".
Возможные значения: storage_queue
Да

AzureFunctionStorageQueue

Структура для сохранения имени storage queue и URI.

Имя. Тип Description Обязательно По умолчанию
queue_name струна Название очереди storage функции Azure. Да
queue_service_endpoint струна URI в сервис Azure Storage Queue, позволяющий управлять очередью. Да

AzureFunctionTool

Входная информация о определении для инструмента функции Azure, используемая для настройки агента.

Имя. Тип Description Обязательно По умолчанию
azure_function AzureFunctionDefinition Определение функции Azure. Да
Функция └️ объект Определение функции azure и её параметров. Да
└─ Описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
└️ имя струна Имя вызываемой функции. Да
└️ Параметры объект Параметры, которые принимают функции, описаны как объект схемы JSON. Да
└️ input_binding AzureFunctionBinding Очередь ввода storage. Триггер queue storage выполняет функцию по мере добавления сообщений. Да
└️ output_binding AzureFunctionBinding Выход очереди storage. Функция записывает выходные данные в эту очередь при обработке входных элементов. Да
type перечисление Тип объекта, который всегда равен 'browser_automation'.
Возможные значения: azure_function
Да

AzureOpenAIModelConfiguration

Azure OpenAI model configuration. Версия API будет выбрана сервисом для запроса модели.

Имя. Тип Description Обязательно По умолчанию
modelDeploymentName струна Имя развертывания для модели AOAI. Пример: gpt-4o если в AIServices или на основе connection_name/deployment_name соединения (например, my-aoai-connection/gpt-4o). Да
type перечисление
Возможные значения: AzureOpenAIModel
Да

BaseCredentials

Базовый класс для учетных данных подключения

Дискриминация для BaseCredentials

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
ApiKey ApiKeyCredentials
AAD EntraIDCredentials
CustomKeys CustomCredential
SAS SASCredentials
None NoAuthenticationCredentials
AgenticIdentityToken_Preview AgenticIdentityPreviewCredentials
Имя. Тип Description Обязательно По умолчанию
type CredentialType (только для чтения) Тип учетных данных, используемых подключением Да

BingCustomSearchConfiguration

Пользовательская настройка поиска bing.

Имя. Тип Description Обязательно По умолчанию
количество целое число Количество результатов поиска, которые возвращаются в ответе API bing нет
freshness струна Фильтруйте результаты поиска по определенному временному диапазону. См. принятые значения здесь. нет
instance_name струна Имя настраиваемого экземпляра конфигурации, заданного для конфигурации. Да
рынок струна Рынок, из которого приходят результаты. нет
project_connection_id струна Project connection id для заземления с поиском bing Да
set_lang струна Язык, используемый для строк пользовательского интерфейса при вызове Bing API. нет

BingCustomSearchPreviewTool

Информация о определении входов для пользовательского поиска Bing, используемого для настройки агента.

Имя. Тип Description Обязательно По умолчанию
bing_custom_search_preview BingCustomSearchToolParameters Параметры пользовательского поиска bing. Да
└search_configurations массив BingCustomSearchConfiguration Соединения project, подключённые к этому инструменту. Может быть не более 1 подключения
ресурс, подключенный к средству.
Ограничения: maxItems: 1
Да
type перечисление Тип объекта, который всегда «bing_custom_search_preview».
Возможные значения: bing_custom_search_preview
Да

BingCustomSearchToolParameters

Параметры пользовательского поиска bing.

Имя. Тип Description Обязательно По умолчанию
search_configurations массив BingCustomSearchConfiguration Соединения project, подключённые к этому инструменту. Может быть не более 1 подключения
ресурс, подключенный к средству.
Да

BingGroundingSearchConfiguration

Конфигурация поиска для заземления Bing

Имя. Тип Description Обязательно По умолчанию
количество целое число Количество результатов поиска, которые возвращаются в ответе API bing нет
freshness струна Фильтруйте результаты поиска по определенному временному диапазону. См. принятые значения здесь. нет
рынок струна Рынок, из которого приходят результаты. нет
project_connection_id струна Project connection id для заземления с поиском bing Да
set_lang струна Язык, используемый для строк пользовательского интерфейса при вызове Bing API. нет

BingGroundingSearchToolParameters

Параметры инструмента поиска по заземлению bing.

Имя. Тип Description Обязательно По умолчанию
search_configurations массив BingGroundingSearchConfiguration Конфигурации поиска, прилагаемые к этому средству. Может быть не более 1
Ресурс конфигурации поиска, подключенный к средству.
Да

BingGroundingTool

Информация о определении входов для инструмента поиска заземления bing, используемого для настройки агента.

Имя. Тип Description Обязательно По умолчанию
bing_grounding BingGroundingSearchToolParameters Параметры инструмента поиска по заземлению bing. Да
└search_configurations массив BingGroundingSearchConfiguration Конфигурации поиска, прилагаемые к этому средству. Может быть не более 1
Ресурс конфигурации поиска, подключенный к средству.
Ограничения: maxItems: 1
Да
type перечисление Тип объекта, который всегда является "bing_grounding".
Возможные значения: bing_grounding
Да

BlobReference

Сведения о ссылке на BLOB-объекты.

Имя. Тип Description Обязательно По умолчанию
BLOBURI струна Путь URI большого двоичного объекта для клиента для отправки данных. Пример: https://blob.windows.core.net/Container/Path Да
credential SasCredential Определение учетных данных SAS Да
└️ sasUri строка (только для чтения) Универсальный код ресурса (URI) SAS Да
└─ Тип перечисление Тип учетных данных
Возможные значения: SAS
Да
storageAccountArmId струна ARM ID аккаунта storage для использования. Да

BrowserAutomationPreviewTool

Входные данные определения для средства автоматизации браузера, используемого для настройки агента.

Имя. Тип Description Обязательно По умолчанию
browser_automation_preview BrowserAutomationToolParameters Определение входных параметров для Browser Automation Tool. Да
Подключение └️ BrowserAutomationToolConnectionParameters Параметры подключения project, связанные с инструментом автоматизации браузера. Да
type перечисление Тип объекта, который всегда является «browser_automation_preview».
Возможные значения: browser_automation_preview
Да

BrowserAutomationToolConnectionParameters

Определение входных параметров для соединения, используемого средством автоматизации браузера.

Имя. Тип Description Обязательно По умолчанию
project_connection_id струна ID соединения project с вашим ресурсом Azure Playwright. Да

BrowserAutomationToolParameters

Определение входных параметров для Browser Automation Tool.

Имя. Тип Description Обязательно По умолчанию
connection BrowserAutomationToolConnectionParameters Определение входных параметров для соединения, используемого средством автоматизации браузера. Да
└project_connection_id струна ID соединения project с вашим ресурсом Azure Playwright. Да

CaptureStructuredOutputsTool

Инструмент для фиксации структурированных выходных данных

Имя. Тип Description Обязательно По умолчанию
выходные данные StructuredOutputDefinition Структурированные выходные данные, которые можно создать агентом. Да
└─ Описание струна Описание выходных данных, которые будут выдаваться. Используется моделью для определения времени выдачи выходных данных. Да
└️ имя струна Имя структурированного выходного документа. Да
└─ Схема объект Схема JSON для структурированных выходных данных. Да
└─ строгий Булев (нулируемый) Следует ли применять строгую валидацию. trueпо умолчанию. Да
type перечисление Тип средства. Всегда capture_structured_outputs.
Возможные значения: capture_structured_outputs
Да

ChartCoordinate

Координаты для диаграммы анализа.

Имя. Тип Description Обязательно По умолчанию
size целое число Размер элемента диаграммы. Да
x целое число Координаты по оси X. Да
и целое число Координата по оси Y. Да

ChatSummaryMemoryItem

Элемент памяти, содержащий сводку, извлеченную из бесед.

Имя. Тип Description Обязательно По умолчанию
содержимое струна Содержимое памяти. Да
добрый перечисление Вид объекта памяти.
Возможные значения: chat_summary
Да
memory_id струна Уникальный идентификатор элемента памяти. Да
scope струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да
updated_at целое число Время последнего обновления элемента памяти. Да

ClusterInsightResult

Выводы из кластерного анализа.

Имя. Тип Description Обязательно По умолчанию
clusters массив InsightsCluster Список кластеров, выявленных в аналитических сведениях. Да
Координаты объект Опциональное сопоставление идентификаторов с 2D-координатами, используемыми UX для визуализации.

Ключи карты — это строковые идентификаторы (например, идентификатор кластера или пример идентификатора)
и значения — координаты и визуальный размер для отрисовки на трехмерной диаграмме.

Это свойство опущено, если координаты клиентских запросов (например,
путем передачи includeCoordinates=true в качестве параметра запроса).

Пример:
<br> {<br> "cluster-1": { "x": 12, "y": 34, "size": 8 },<br> "sample-123": { "x": 18, "y": 22, "size": 4 }<br> }<br>

Координаты предназначены только для визуализации на стороне клиента и не используются
измените результаты канонической аналитики.
нет
summary InsightsSummary Сводка кластерного анализа ошибок. Да
Метод └️ струна Метод, используемый для кластеризации. Да
└️ sampleCount целое число Общее количество проанализированных образцов. Да
└️ uniqueClusterCount целое число Общее количество уникальных кластеров. Да
└️ uniqueSubclusterCount целое число Общее количество уникальных меток подкластера. Да
└─ использование ClusterTokenUsage Использование токенов при выполнении кластерного анализа Да

ClusterTokenUsage

Использование токенов для кластерного анализа

Имя. Тип Description Обязательно По умолчанию
inputTokenUsage целое число Использование входного токена Да
outputTokenUsage целое число Использование выходного токена Да
totalTokenUsage целое число Общее использование токенов Да

CodeBasedEvaluatorDefinition

Определение оценщика на основе кода с использованием кода Python

Имя. Тип Description Обязательно По умолчанию
code_text струна Встроенный текст кода для оценщика Да
data_schema объект Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
init_parameters объект Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
metrics объект Список выходных метрик, полученных данным оценщиком нет
type перечисление
Возможные значения: code
Да

ЗавершениеMessageToolCallChunk

Сведения о вызове средства в сообщении.

Имя. Тип Description Обязательно По умолчанию
function FunctionToolCall Сведения о вызове средства функции. нет
└─ аргументы струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Да
└️ имя струна Имя вызываемой функции. Да
id струна Идентификатор вызова средства. Да
type перечисление Тип вызова средства, который всегда является функцией.
Возможные значения: function
Да

Подключение

Ответ из списка и операции получения соединений

Имя. Тип Description Обязательно По умолчанию
credentials BaseCredentials (только для чтения) Базовый класс для учетных данных подключения Да
└─ Тип CredentialType (только для чтения) Тип учетных данных, используемых подключением Да
id строка (только для чтения) Уникальный идентификатор соединения, сгенерированный сервисом Да
по умолчанию boolean (только для чтения) Помечено ли соединение как соединение по умолчанию для своего типа Да
metadata object (только для чтения) Метаданные подключения Да
имя строка (только для чтения) Понятное имя соединения, предоставленное пользователем. Да
target строка (только для чтения) URL-адрес подключения, используемый для этой службы Да
type ConnectionType (только для чтения) Тип (или категория) подключения Да

Тип соединения

Тип (или категория) подключения

Недвижимость Ценность
Описание Тип (или категория) подключения
Тип струна
Значения AzureOpenAI
AzureBlob
AzureStorageAccount
CognitiveSearch
CosmosDB
ApiKey
AppConfig
AppInsights
CustomKeys
RemoteTool_Preview

ContainerAppAgentDefinition

Определение агента контейнера приложения.

Имя. Тип Description Обязательно По умолчанию
container_app_resource_id струна Идентификатор ресурса Azure Container App, в котором размещается этот агент. Не изменяется между версиями. Да
container_protocol_versions массив ProtocolVersionRecord Протоколы, поддерживаемые агентом для входящего обмена данными контейнеров. Да
ingress_subdomain_suffix струна Суффикс, применяемый к поддомену приложения при отправке входящего трафика агенту. Это может быть метка (например, '---current'), конкретная редакция (например, '--0000001') или empty, чтобы использовать конечную точку по умолчанию для приложения-контейнера. Да
добрый перечисление
Возможные значения: container_app
Да
rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
└rai_policy_name струна Название политики RAI, которую необходимо применить. Да

ContainerDetails

Подробные сведения о контейнере.

Имя. Тип Description Обязательно По умолчанию
health_state струна Состояние работоспособности контейнера. Да
provisioning_error струна Ошибка подготовки контейнера, если она есть. нет
provisioning_state струна Состояние подготовки контейнера. Да
replicas массив ContainerReplica Список реплик в контейнере. Да
государство струна Состояние контейнера. Да
updated_on струна Время последнего обновления контейнера. Да

ContainerLogKind

Тип логов для потока из контейнера.

Недвижимость Ценность
Тип струна
Значения console
system

ContainerReplica

Сведения о реплике контейнера.

Имя. Тип Description Обязательно По умолчанию
container_state струна Состояние контейнера реплики. Да
имя струна Имя реплики. Да
государство струна Состояние реплики. Да

ContinuousEvaluationRuleAction

Действие правила оценки для непрерывной оценки.

Имя. Тип Description Обязательно По умолчанию
evalId струна Eval Id для добавления непрерывных прогонов оценки. Да
maxHourlyRuns целое число Максимально допустимое количество прогонов оценки в час. нет
type перечисление
Возможные значения: continuousEvaluation
Да

CosmosDBIndex

Определение индекса векторного хранилища CosmosDB

Имя. Тип Description Обязательно По умолчанию
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
имя строка (только для чтения) Имя ресурса Да
type перечисление Тип индекса
Возможные значения: CosmosDBNoSqlVectorStore
Да
version строка (только для чтения) Версия ресурса Да

CosmosDBIndexUpdate

Определение индекса векторного хранилища CosmosDB

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type перечисление Тип индекса
Возможные значения: CosmosDBNoSqlVectorStore
Да

CreateAgentFromManifestRequest

Имя. Тип Description Обязательно По умолчанию
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
manifest_id струна Идентификатор манифеста для импорта версии агента из. Да
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Уникальное имя, определяющее агент. Имя может быть использовано для получения/обновления/удаления агента.
— должно начинаться и заканчиваться буквенно-цифровыми символами,
- Может содержать дефисы в середине
— не должно превышать 63 символов.
Ограничения: maxLength: 63
Да
parameter_values объект Входные данные манифеста, которые будут приводить к полностью материализованному агенту. Да

CreateAgentRequest

Имя. Тип Description Обязательно По умолчанию
Определение AgentDefinition Да
└️ вид AgentKind Да
└️ rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Уникальное имя, определяющее агент. Имя может быть использовано для получения/обновления/удаления агента.
— должно начинаться и заканчиваться буквенно-цифровыми символами,
- Может содержать дефисы в середине
— не должно превышать 63 символов.
Ограничения: maxLength: 63
Да

CreateAgentVersionFromManifestRequest

Имя. Тип Description Обязательно По умолчанию
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
manifest_id струна Идентификатор манифеста для импорта версии агента из. Да
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
parameter_values объект Входные данные манифеста, которые будут приводить к полностью материализованному агенту. Да

CreateAgentVersionRequest

Имя. Тип Description Обязательно По умолчанию
Определение AgentDefinition Да
└️ вид AgentKind Да
└️ rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет

СоздатьЗапросОценки

Имя. Тип Description Обязательно По умолчанию
настройка_источника_данных OpenAI.CreateEvalCustomDataSourceConfig или OpenAI.CreateEvalLogsDataSourceConfig или OpenAI.CreateEvalStoredCompletionsDataSourceConfig или AzureAIDataSourceConfig Конфигурация источника данных, используемого для выполнения оценки. Определяет схему данных, используемых в оценке. Да
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Имя оценки. нет
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет
критерии тестирования массив OpenAI.EvalGraderLabelModel или OpenAI.EvalGraderStringCheck или OpenAI.EvalGraderTextSimilarity или OpenAI.EvalGraderPython или OpenAI.EvalGraderScoreModel или EvalGraderAzureAIEvaluator Список оценщиков для всех запусков оценок в этой группе. Классировщики могут ссылаться на переменные в источнике данных с помощью двойной фигурной скобки, например {{item.variable_name}}. Чтобы ссылаться на выходные данные модели, используйте sample пространство имен (т. е. {{sample.output_text}}). Да

СоздатьЗапросНаВыполнениеОценки

Имя. Тип Description Обязательно По умолчанию
источник данных OpenAI.CreateEvalJsonlRunDataSource или OpenAI.CreateEvalCompletionsRunDataSource или OpenAI.CreateEvalResponsesRunDataSource или EvalRunDataSource Сведения об источнике данных запуска. Да
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна Имя запуска. нет
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет

CredentialType

Тип учетных данных, используемых подключением

Недвижимость Ценность
Описание Тип учетных данных, используемых подключением
Тип струна
Значения ApiKey
AAD
SAS
CustomKeys
None
AgenticIdentityToken_Preview

CronTrigger

Триггер на основе cron.

Имя. Тип Description Обязательно По умолчанию
endTime струна Время окончания графика cron в формате ISO 8601. нет
expression струна Выражение cron, определяющее частоту расписания. Да
startTime струна Время начала работы по расписанию cron в формате ISO 8601. нет
часовой пояс струна Часовой пояс для расписания cron. нет UTC
type перечисление
Возможные значения: Cron
Да

CustomCredential

Определение пользовательских учетных данных

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип учетных данных
Возможные значения: CustomKeys
Да

Этот объект также принимает дополнительные свойства типа: строка

DailyRecurrenceSchedule

Ежедневный график повторения.

Имя. Тип Description Обязательно По умолчанию
Часов массив целых чисел Часы для графика повторения. Да
type перечисление Тип ежедневного рецидива.
Возможные значения: Daily
Да

DataSourceConfig

Базовый класс для запуска источников данных с дискриминационным поддержкой.

Дискриминация для DataSourceConfig

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
Имя. Тип Description Обязательно По умолчанию
schema объект Общая схема JSON объекта для элементов источника данных запуска. Да
type струна Тип источника данных дискриминационный. Да

DatasetType

Перечисление для определения типа данных.

Недвижимость Ценность
Описание Перечисление для определения типа данных.
Тип струна
Значения uri_file
uri_folder

DatasetVersion

Определение DatasetVersion

Дискриминация для DatasetVersion

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
uri_file FileDatasetVersion
uri_folder FolderDatasetVersion
Имя. Тип Description Обязательно По умолчанию
connectionName струна Имя соединения Azure Storage Account. Обязательно, если startPendingUploadVersion не был вызван перед созданием набора данных нет
dataUri струна URI данных (пример)
Ограничения: minLength: 1, шаблон: [a-zA-Z0-9_]
Да
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
isReference boolean (только для чтения) Указывает, содержит ли набор данных ссылку на storage или же сам dataset управляет storage. Если значение равно true, базовые данные не будут удалены при удалении версии набора данных нет
имя строка (только для чтения) Имя ресурса Да
type DatasetType Перечисление для определения типа данных. Да
version строка (только для чтения) Версия ресурса Да

DatasetVersionUpdate

Определение DatasetVersion

Дискриминация для DatasetVersionUpdate

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
uri_file FileDatasetVersionUpdate
uri_folder FolderDatasetVersionUpdate
Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type DatasetType Перечисление для определения типа данных. Да

ДеньНедели

Дни недели для графика повторения.

Недвижимость Ценность
Описание Дни недели для графика повторения.
Тип струна
Значения Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

DeleteAgentResponse

Удаленный объект агента

Имя. Тип Description Обязательно По умолчанию
удалено булевый Был ли агент успешно удален. Да
имя струна Имя агента. Да
объект перечисление Тип объекта. Всегда 'agent.deleted'.
Возможные значения: agent.deleted
Да

DeleteAgentVersionResponse

Удаленная версия агента Object

Имя. Тип Description Обязательно По умолчанию
удалено булевый Был ли агент успешно удален. Да
имя струна Имя агента. Да
объект перечисление Тип объекта. Всегда "agent.version.deleted".
Возможные значения: agent.version.deleted
Да
version струна Идентификатор версии агента. Да

DeleteEvalResponse

Удаленный объект оценки

Имя. Тип Description Обязательно По умолчанию
удалено булевый Успешно ли удалена овал. Да
eval_id струна идентификатор eval. Да
объект перечисление Тип объекта. Всегда "eval.deleted".
Возможные значения: eval.deleted
Да

DeleteEvalRunResponse

Удаленный объект запуска оценки.

Имя. Тип Description Обязательно По умолчанию
удалено булевый Успешно ли удалена овал. нет
объект перечисление Тип объекта. Всегда "eval.deleted".
Возможные значения: eval.deleted
нет
run_id струна идентификатор eval. нет

DeleteMemoryStoreResponse

Имя. Тип Description Обязательно По умолчанию
удалено булевый Было ли успешно удалено хранилище памяти. Да
имя струна Имя хранилища памяти. Да
объект перечисление Тип объекта. Всегда 'memory_store.deleted'.
Возможные значения: memory_store.deleted
Да

DeleteResponseResult

Результат операции удаления ответа.

Имя. Тип Description Обязательно По умолчанию
удалено перечисление Всегда возвращать значение true
Возможные значения: True
Да
id струна Идентификатор операции. Да
объект перечисление Всегда возвращайте "ответ".
Возможные значения: response
Да

Развертывание

Определение развертывания модели

Дискриминация для развертывания

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
ModelDeployment ModelDeployment
Имя. Тип Description Обязательно По умолчанию
имя строка (только для чтения) Название развертывания Да
type DeploymentType Да

DeploymentType

Недвижимость Ценность
Тип струна
Значения ModelDeployment

EntraIDCredentials

Определение учетных данных Entra ID

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип учетных данных
Возможные значения: AAD
Да

Оценка

Объект Eval с конфигурацией источника данных и критериями тестирования. Eval представляет задачу для интеграции LLM. Любить:

  • Улучшение качества чат-бота
  • Узнайте, как хорошо мой чат-бот обрабатывает поддержку клиентов
  • Проверьте, лучше ли o4-mini в моем регистре использования, чем gpt-4o
Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для момента создания eval. Да
создано пользователем струна имя пользователя, создавшего запуск. нет
настройка_источника_данных OpenAI.CreateEvalCustomDataSourceConfig или OpenAI.CreateEvalLogsDataSourceConfig или OpenAI.CreateEvalStoredCompletionsDataSourceConfig или AzureAIDataSourceConfig Настройка источников данных, используемых при выполнении оценки. Да
id струна Уникальный идентификатор для оценки. Да
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
Да
modified_at integer нет
имя струна Имя оценки. Да
объект перечисление Тип объекта.
Возможные значения: eval
Да
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет
критерии тестирования массив OpenAI.EvalGraderLabelModel или OpenAI.EvalGraderStringCheck или OpenAI.EvalGraderTextSimilarity или OpenAI.EvalGraderPython или OpenAI.EvalGraderScoreModel или EvalGraderAzureAIEvaluator Список критериев тестирования. Да

EvalCsvFileIdSource

Представляет ссылку на отправленный CSV-файл, используемый в качестве источника для оценки данных.

Имя. Тип Description Обязательно По умолчанию
id струна Идентификатор отправленного CSV-файла. Да
type перечисление Тип источника всегда file_id.
Возможные значения: file_id
Да

EvalCsvRunDataSource

Представляет источник данных CSV для выполнения оценки.

Имя. Тип Description Обязательно По умолчанию
Источник EvalCsvFileIdSource Представляет ссылку на отправленный CSV-файл, используемый в качестве источника для оценки данных. Да
Идентификатор └️ струна Идентификатор отправленного CSV-файла. Да
└─ Тип перечисление Тип источника всегда file_id.
Возможные значения: file_id
Да
type перечисление Тип источника данных всегда csv.
Возможные значения: csv
Да

EvalGraderAzureAIEvaluator

Имя. Тип Description Обязательно По умолчанию
сопоставление данных объект Модель, используемая для оценки. Должен поддерживать структурированные выходные данные. нет
evaluator_name струна Имя вычислителя. Да
evaluator_version струна Версия вычислителя. Последняя версия, если она не указана. нет
initialization_parameters объект Параметры инициализации для оценки. Должен поддерживать структурированные выходные данные. нет
имя струна Имя классировщика. Да
type перечисление Тип объекта, который всегда azure_ai_evaluatorявляется .
Возможные значения: azure_ai_evaluator
Да

EvalResult

Результат оценки.

Имя. Тип Description Обязательно По умолчанию
имя струна Наименование чека Да
пройденный булевый указывает, прошла ли проверка или не прошла Да
счёт число/номер счёт Да
type струна Вид проверки Да

EvalRun

Схема, представляющая процесс оценки.

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) при создании запуска оценки. Да
создано пользователем струна имя пользователя, создавшего запуск. нет
источник данных OpenAI.CreateEvalJsonlRunDataSource или OpenAI.CreateEvalCompletionsRunDataSource или OpenAI.CreateEvalResponsesRunDataSource или EvalRunDataSource Сведения об источнике данных запуска. Да
ошибка OpenAI.EvalApiError Объект, представляющий ответ об ошибке из API Eval. Да
eval_id струна Идентификатор ассоциированной оценки. Да
id струна Уникальный идентификатор для оценочной сессии. Да
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
Да
модель струна Модель, подлежащая оценке, если применимо. Да
modified_at integer нет
имя струна Название сеанса оценки. Да
объект перечисление Тип объекта . Всегда "eval.run".
Возможные значения: eval.run
Да
использование_на_модель массив OpenAI.EvalRunPerModelUsage Статистика использования для каждой модели во время выполнения оценки. Да
результаты_по_критериям_тестирования массив OpenAI.EvalRunPerTestingCriteriaResults Результаты для каждого критерия тестирования, применяемые во время выполнения оценки. Да
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет
report_url струна URL-адрес отчета о визуализации результатов выполнения оценочного запуска на панели мониторинга пользовательского интерфейса. Да
количество_результатов OpenAI.EvalRunResultCounts Да
Ошибка OpenAI.integer Да
└─ Ошибка OpenAI.integer Да
├─ прошло OpenAI.integer Да
└─ всего OpenAI.integer Да
статус струна Состояние выполнения оценки. Да

EvalRunDataSource

Базовый класс для запуска источников данных с дискриминационным поддержкой.

Дискриминация для EvalRunDataSource

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
azure_ai_traces_preview TracesPreviewEvalRunDataSource
azure_ai_synthetic_data_gen_preview SyntheticDataGenerationPreviewEvalRunDataSource
azure_ai_responses AzureAIResponsesEvalRunDataSource
azure_ai_target_completions TargetCompletionEvalRunDataSource
csv EvalCsvRunDataSource
azure_ai_red_team RedTeamEvalRunDataSource
Имя. Тип Description Обязательно По умолчанию
type струна Тип источника данных дискриминационный. Да

EvalRunOutputItem

Схема, представляющая выходной элемент оценочного запуска.

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) при создании запуска оценки. Да
элемент источника данных объект Сведения об элементе источника входных данных. Да
идентификатор_элемента_источника_данных OpenAI.integer Да
eval_id струна Идентификатор группы оценки. Да
id струна Уникальный идентификатор элемента результата выполнения оценки. Да
объект перечисление Тип объекта . Всегда "eval.run.output_item".
Возможные значения: eval.run.output_item
Да
results массив EvalRunOutputItemResult Список результатов оценки для этого выходного элемента. Да
run_id струна Идентификатор оценки, связанной с этим результирующим элементом. Да
образец OpenAI.EvalRunOutputItemSample Да
└─ Ошибка OpenAI.EvalApiError Объект, представляющий ответ об ошибке из API Eval. Да
└️ причина_завершения струна Да
└─ Входные данные массив EvalRunOutputItemSampleInput Да
└─max_completion_tokens OpenAI.integer Да
└─ Модель струна Да
вывод └─ массив EvalRunOutputItemSampleOutputOutput Да
Начальное значение └️ OpenAI.integer Да
└─ Температура OpenAI.numeric Да
└️ top_p OpenAI.numeric Да
└─ использование OpenAI.EvalRunOutputItemSampleUsage Да
статус струна Состояние выполнения оценки. Да

EvalRunOutputItemResult

Результат одного класса для выходного элемента выполнения оценки.

Имя. Тип Description Обязательно По умолчанию
label струна Метка, связанная с метрикой критериев теста (например, pass, fail, "good", "bad"). нет
metric струна Имя метрики (например, "fluency", "f1_score"). нет
имя струна Имя классировщика. Да
пройденный булевый Считается ли классировщик выходным результатом прохода. Да
свойства объект Дополнительные сведения о метриках критериев тестирования. нет
причина струна Причина метрики критериев теста. нет
образец Объект (нулируемый) Необязательный пример или промежуточные данные, созданные классировщиком. нет
счёт OpenAI.numeric Да
threshold число/номер Пороговое значение, используемое для определения прохождения или сбоя для этого критерия теста, если оно числовое. нет
type струна Тип оценок (например, string-check-grader). нет

Этот объект также принимает дополнительные свойства.

EvalRunOutputItemSampleInput

Сообщение в выполнении оценки.

Имя. Тип Description Обязательно По умолчанию
содержимое струна Да
роль струна Да
вызовы инструментов массив CompletionMessageToolCallChunk Вызовы инструментов, сделанные в сообщении, если таковые есть. Да

EvalRunOutputItemSampleOutput

Сообщение в выполнении оценки.

Имя. Тип Description Обязательно По умолчанию
содержимое струна нет
роль струна нет
вызовы инструментов массив CompletionMessageToolCallChunk Вызовы инструментов, сделанные в сообщении, если таковые есть. Да

EvalRunResultCompareItem

Сравнение метрик лечения с исходным уровнем.

Имя. Тип Description Обязательно По умолчанию
deltaEstimate число/номер Предполагаемая разница между лечением и исходным уровнем. Да
pValue число/номер P-значение для эффекта лечения. Да
лечениеEffect TreatmentEffectType Тип эффекта лечения. Да
treatmentRunId струна Прогон лечения ID. Да
treatmentRunSummary EvalRunResultSummary Сводная статистика метрики в прогоне оценки. Да
└️ среднее число/номер Среднее значение метрики в прогоне оценки. Да
└️ runId струна Идентификатор прогона оценки. Да
└️ sampleCount целое число Количество выборок в прогоне оценки. Да
└️ standardDeviation число/номер Стандартное отклонение метрики в прогоне оценки. Да

EvalRunResultComparison

Результаты сравнения результатов лечения с исходным уровнем.

Имя. Тип Description Обязательно По умолчанию
базовая версияRunSummary EvalRunResultSummary Сводная статистика метрики в прогоне оценки. Да
└️ среднее число/номер Среднее значение метрики в прогоне оценки. Да
└️ runId струна Идентификатор прогона оценки. Да
└️ sampleCount целое число Количество выборок в прогоне оценки. Да
└️ standardDeviation число/номер Стандартное отклонение метрики в прогоне оценки. Да
compareItems массив EvalRunResultCompareItem Список результатов сравнения для каждого сеанса лечения. Да
вычислитель струна Имя оценщика для данного критерия тестирования. Да
metric струна Оцениваемая метрика. Да
testingCriteria струна Наименование критериев тестирования. Да

EvalRunResultSummary

Сводная статистика метрики в прогоне оценки.

Имя. Тип Description Обязательно По умолчанию
средний число/номер Среднее значение метрики в прогоне оценки. Да
runId струна Идентификатор прогона оценки. Да
sampleCount целое число Количество выборок в прогоне оценки. Да
StandardDeviation число/номер Стандартное отклонение метрики в прогоне оценки. Да

EvaluationComparisonInsightRequest

Запрос на сравнение оценок

Имя. Тип Description Обязательно По умолчанию
baselineRunId струна Идентификатор базового прогона для сравнения. Да
evalId струна Идентификатор для оценки. Да
treatmentRunIds Массив строк Список идентификаторов сеансов лечения для сравнения. Да
type перечисление Тип запроса.
Возможные значения: EvaluationComparison
Да

EvaluationComparisonInsightResult

Выводы из сравнения оценок.

Имя. Тип Description Обязательно По умолчанию
Сравнения массив EvalRunResultComparison Результаты сравнения для каждого сеанса лечения с исходным уровнем. Да
method струна Для сравнения используется статистический метод. Да
type перечисление Тип полученной информации.
Возможные значения: EvaluationComparison
Да

EvaluationResultSample

Образец из результата оценки.

Имя. Тип Description Обязательно По умолчанию
correlationInfo объект Информация о корреляции для анализируемой выборки. Да
evaluationResult EvalResult Результат оценки. Да
└️ имя струна Наименование чека Да
├─ прошло булевый указывает, прошла ли проверка или не прошла Да
└️ оценка число/номер счёт Да
└─ Тип струна Вид проверки Да
features объект Функции, помогающие с дополнительной фильтрацией данных в UX. Да
id струна Уникальный идентификатор образца анализа. Да
type перечисление Тип образца результата оценки
Возможные значения: EvaluationResultSample
Да

Правило оценки

Модель правила оценки.

Имя. Тип Description Обязательно По умолчанию
действие EvaluationRuleAction Модель действия по оценке. Да
└─ Тип EvaluationRuleActionType Тип действия по оценке. Да
описание струна Описание правила вычисления. нет
отображаемое имя струна Отображаемое имя для правила оценки. нет
enabled булевый Указывает, включено ли правило оценки. Значение по умолчанию — истинно. Да
eventType EvaluationRuleEventType Тип события правила оценки. Да
фильтр EvaluationRuleFilter Модель фильтра оценки. нет
└️ agentName струна Фильтрация по имени агента. Да
id строка (только для чтения) Уникальный идентификатор для правила оценки. Да
данные системы object (только для чтения) Системные метаданные для правила оценки. Да

EvaluationRuleAction

Модель действия по оценке.

Дискриминация для EvaluationRuleAction

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
continuousEvaluation ContinuousEvaluationRuleAction
humanEvaluationPreview HumanEvaluationPreviewRuleAction
Имя. Тип Description Обязательно По умолчанию
type EvaluationRuleActionType Тип действия по оценке. Да

EvaluationRuleActionType

Тип действия по оценке.

Недвижимость Ценность
Описание Тип действия по оценке.
Тип струна
Значения continuousEvaluation
humanEvaluationPreview

EvaluationRuleEventType

Тип события правила оценки.

Недвижимость Ценность
Описание Тип события правила оценки.
Тип струна
Значения responseCompleted
manual

EvaluationRuleFilter

Модель фильтра оценки.

Имя. Тип Description Обязательно По умолчанию
agentName струна Фильтрация по имени агента. Да

EvaluationRunClusterInsightRequest

Выводы о наборе результатов оценки

Имя. Тип Description Обязательно По умолчанию
evalId струна Идентификатор оценки для аналитических сведений. Да
ModelConfiguration InsightsModelConfiguration Конфигурация модели, используемой при создании аналитических сведений. нет
└️ modelDeploymentName струна Развертывание модели, подлежащее оценке. Принимает только имя развертывания или имя подключения как {connectionName}/<modelDeploymentName>. Да
runIds Массив строк Список идентификаторов тестовых запусков для аналитических сведений. Да
type перечисление Тип запроса аналитических сведений.
Возможные значения: EvaluationRunClusterInsight
Да

EvaluationRunClusterInsightResult

Выводы, полученные в ходе оценки, запускают кластерный анализ.

Имя. Тип Description Обязательно По умолчанию
clusterInsight ClusterInsightResult Выводы из кластерного анализа. Да
type перечисление Тип полученной информации.
Возможные значения: EvaluationRunClusterInsight
Да

EvaluationScheduleTask

Задание на оценку расписания.

Имя. Тип Description Обязательно По умолчанию
configuration объект Конфигурация под задачу. нет
evalId струна Идентификатор группы оценки. Да
evalRun объект Полезная нагрузка для ознакомительного прогона. Да
type перечисление
Возможные значения: Evaluation
Да

EvaluationTaxonomy

Определение таксономии оценки

Имя. Тип Description Обязательно По умолчанию
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
имя строка (только для чтения) Имя ресурса Да
свойства объект Дополнительные свойства для таксономии оценки. нет
категории таксономии массив ТаксономииCategory Список категорий таксономии. нет
таксономияInput EvaluationTaxonomyInput Входная конфигурация для таксономии оценки. Да
└─ Тип EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да
version строка (только для чтения) Версия ресурса Да

EvaluationTaxonomyCreateOrUpdate

Определение таксономии оценки

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
свойства объект Дополнительные свойства для таксономии оценки. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
категории таксономии массив ТаксономииCategory Список категорий таксономии. нет
таксономияInput EvaluationTaxonomyInput Входная конфигурация для таксономии оценки. Да
└─ Тип EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да

EvaluationTaxonomyInput

Входная конфигурация для таксономии оценки.

Дискриминация для EvaluationTaxonomyInput

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
agent AgentTaxonomyInput
Имя. Тип Description Обязательно По умолчанию
type EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да

EvaluationTaxonomyInputType

Тип входных данных таксономии оценки.

Недвижимость Ценность
Описание Тип входных данных таксономии оценки.
Тип струна
Значения agent
policy

EvaluationTaxonomyInputUpdate

Входная конфигурация для таксономии оценки.

Дискриминация для EvaluationTaxonomyInputUpdate

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
agent AgentTaxonomyInputUpdate
Имя. Тип Description Обязательно По умолчанию
type EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да

EvaluationTaxonomyUpdate

Определение таксономии оценки

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
свойства объект Дополнительные свойства для таксономии оценки. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
категории таксономии массив ТаксономииCategory Список категорий таксономии. нет
таксономияInput EvaluationTaxonomyInputUpdate Входная конфигурация для таксономии оценки. нет
└─ Тип EvaluationTaxonomyInputType Тип входных данных таксономии оценки. Да

ОценщикCategory

Категория оценщика

Недвижимость Ценность
Описание Категория оценщика
Тип струна
Значения quality
safety
agents

ScoreorDefinition

Конфигурация базового оценщика с дискриминатором

Дискриминация для scoreorDefinition

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
code CodeBasedEvaluatorDefinition
prompt PromptBasedEvaluatorDefinition
Имя. Тип Description Обязательно По умолчанию
data_schema объект Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
init_parameters объект Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
metrics объект Список выходных метрик, полученных данным оценщиком нет
type ScoreorDefinitionType Тип определения оценщика Да

ScoreorDefinitionType

Тип определения оценщика

Недвижимость Ценность
Описание Тип определения оценщика
Тип струна
Значения prompt
code
prompt_and_code
service
openai_graders

Оценка метрик

Метрика Evaluator

Имя. Тип Description Обязательно По умолчанию
desirable_direction ScoreorMetricDirection Направление метрики, указывающее, является ли более высокое значение лучше, более низкое значение лучше или нейтральным нет
is_primary булевый Указывает, является ли эта метрика основной при наличии нескольких метрик. нет
max_value число/номер Максимальное значение метрики. Если не указано, предполагается, что оно не ограничено. нет
min_value число/номер Минимальное значение метрики нет
type ScoreorMetricType Тип оценщика нет

ScoreorMetricDirection

Направление метрики, указывающее, является ли более высокое значение лучше, более низкое значение лучше или нейтральным

Недвижимость Ценность
Описание Направление метрики, указывающее, является ли более высокое значение лучше, более низкое значение лучше или нейтральным
Тип струна
Значения increase
decrease
neutral

ScoreorMetricType

Тип оценщика

Недвижимость Ценность
Описание Тип оценщика
Тип струна
Значения ordinal
continuous
boolean

ScoreorType

Тип оценщика

Недвижимость Ценность
Описание Тип оценщика
Тип струна
Значения builtin
custom

ScoreorVersion

Определение оценщика

Имя. Тип Description Обязательно По умолчанию
categories массив проценщикаCategory Категории оценщика Да
создано_в строка (только для чтения) Дата/время создания оценщика Да
создано пользователем строка (только для чтения) Создатель оценщика Да
Определение ScoreorDefinition Конфигурация базового оценщика с дискриминатором Да
└️ data_schema объект Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
└init_parameters init_parameters объект Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
Метрики └️ объект Список выходных метрик, полученных данным оценщиком нет
└─ Тип ScoreorDefinitionType Тип определения оценщика Да
display_name струна Отображаемое имя для оценщика. В AI Foundry легко найти оценщика. Он не обязательно должен быть уникальным. нет
evaluator_type ScoreorType Тип оценщика Да
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
metadata объект Метаданные об оценщике нет
modified_at строка (только для чтения) Дата и время последнего изменения оценщика Да
имя строка (только для чтения) Имя ресурса Да
version строка (только для чтения) Версия ресурса Да

ScoreorVersionCreate

Определение оценщика

Имя. Тип Description Обязательно По умолчанию
categories массив проценщикаCategory Категории оценщика Да
Определение ScoreorDefinition Конфигурация базового оценщика с дискриминатором Да
└️ data_schema объект Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
└init_parameters init_parameters объект Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
Метрики └️ объект Список выходных метрик, полученных данным оценщиком нет
└─ Тип ScoreorDefinitionType Тип определения оценщика Да
описание струна Текст описания ресурса. нет
display_name струна Отображаемое имя для оценщика. В AI Foundry легко найти оценщика. Он не обязательно должен быть уникальным. нет
evaluator_type ScoreorType Тип оценщика Да
metadata объект Метаданные об оценщике нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет

ScoreorVersionUpdate

Определение оценщика

Имя. Тип Description Обязательно По умолчанию
categories массив проценщикаCategory Категории оценщика нет
описание струна Текст описания ресурса. нет
display_name струна Отображаемое имя для оценщика. В AI Foundry легко найти оценщика. Он не обязательно должен быть уникальным. нет
metadata объект Метаданные об оценщике нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет

FabricDataAgentToolParameters

Параметры инструмента агента данных набора данных.

Имя. Тип Description Обязательно По умолчанию
project_connections массив ToolProjectConnection Соединения project, подключённые к этому инструменту. Может быть не более 1 подключения
ресурс, подключенный к средству.
нет

FileDatasetVersion

Определение FileDatasetVersion

Имя. Тип Description Обязательно По умолчанию
connectionName струна Имя соединения Azure Storage Account. Обязательно, если startPendingUploadVersion не был вызван перед созданием набора данных нет
dataUri струна URI данных (пример)
Ограничения: minLength: 1, шаблон: [a-zA-Z0-9_]
Да
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
isReference boolean (только для чтения) Указывает, содержит ли набор данных ссылку на storage или же сам dataset управляет storage. Если значение равно true, базовые данные не будут удалены при удалении версии набора данных нет
имя строка (только для чтения) Имя ресурса Да
type перечисление Тип набора данных
Возможные значения: uri_file
Да
version строка (только для чтения) Версия ресурса Да

FileDatasetVersionUpdate

Определение FileDatasetVersion

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type перечисление Тип набора данных
Возможные значения: uri_file
Да

FolderDatasetVersion

Определение FileDatasetVersion

Имя. Тип Description Обязательно По умолчанию
connectionName струна Имя соединения Azure Storage Account. Обязательно, если startPendingUploadVersion не был вызван перед созданием набора данных нет
dataUri струна URI данных (пример)
Ограничения: minLength: 1, шаблон: [a-zA-Z0-9_]
Да
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
isReference boolean (только для чтения) Указывает, содержит ли набор данных ссылку на storage или же сам dataset управляет storage. Если значение равно true, базовые данные не будут удалены при удалении версии набора данных нет
имя строка (только для чтения) Имя ресурса Да
type перечисление Тип набора данных
Возможные значения: uri_folder
Да
version строка (только для чтения) Версия ресурса Да

FolderDatasetVersionUpdate

Определение FileDatasetVersion

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type перечисление Тип набора данных
Возможные значения: uri_folder
Да

FunctionToolCall

Сведения о вызове средства функции.

Имя. Тип Description Обязательно По умолчанию
arguments струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Да
имя струна Имя вызываемой функции. Да

HostedAgentDefinition

Определение размещенного агента.

Имя. Тип Description Обязательно По умолчанию
container_protocol_versions массив ProtocolVersionRecord Протоколы, поддерживаемые агентом для входящего обмена данными контейнеров. Да
cpu струна Конфигурация ЦП для размещенного агента. Да
environment_variables объект Переменные среды, устанавливаемые в контейнере размещенного агента. нет
image струна Идентификатор образа агента, применимый к размещенным агентам на основе образа. нет
добрый перечисление
Возможные значения: hosted
Да
memory струна Конфигурация памяти для размещенного агента. Да
rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
└rai_policy_name струна Название политики RAI, которую необходимо применить. Да
инструменты массив OpenAI.Tool Набор инструментов, которые модель размещенного агента может вызывать во время генерации ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
нет

HourlyRecurrenceSchedule

Почасовой график повторения.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: Hourly
Да

HumanEvaluationPreviewRuleAction

Действие правила оценки для оценки человека.

Имя. Тип Description Обязательно По умолчанию
идентификатор шаблона AssetId Идентификатор сохраненного ресурса. Да
type перечисление
Возможные значения: humanEvaluationPreview
Да

Index

Определение ресурса индекса

Дискриминация по индексу

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
AzureSearch AzureAISearchIndex
ManagedAzureSearch ManagedAzureAISearchIndex
CosmosDBNoSqlVectorStore CosmosDBIndex
Имя. Тип Description Обязательно По умолчанию
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
имя строка (только для чтения) Имя ресурса Да
type IndexType Да
version строка (только для чтения) Версия ресурса Да

IndexType

Недвижимость Ценность
Тип струна
Значения AzureSearch
CosmosDBNoSqlVectorStore
ManagedAzureSearch

IndexUpdate

Определение ресурса индекса

Дискриминация для IndexUpdate

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
AzureSearch AzureAISearchIndexUpdate
ManagedAzureSearch ManagedAzureAISearchIndexUpdate
CosmosDBNoSqlVectorStore CosmosDBIndexUpdate
Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type IndexType Да

Проницательность

Тело ответа для аналитики кластера.

Имя. Тип Description Обязательно По умолчанию
отображаемое имя струна Понятное для пользователя отображаемое имя для аналитических сведений. Да
id строка (только для чтения) Уникальный идентификатор для отчета с аналитическими сведениями. Да
metadata InsightsMetadata (только для чтения) Метаданные об инсайтах. Да
└️ completedAt струна Временная метка, когда аналитические сведения были завершены. нет
└️ createdAt струна Временная метка при создании аналитических сведений. Да
запрос InsightsRequest Запрос аналитического отчета. Да
└─ Тип InsightsType Тип запроса. Да
результат InsightsResult (только для чтения) Результат инсайтов. нет
└─ Тип InsightsType Тип полученной информации. Да
государство Azure. Core.Foundations.OperationState (только для чтения) Перечисление, описывающее разрешенные состояния операций. Да

InsightsCluster

Кластер образцов анализа.

Имя. Тип Description Обязательно По умолчанию
описание струна Описание кластера анализа. Да
id струна Идентификатор кластера анализа. Да
label струна Метка для кластера Да
Образцы массив InsightsSample Список образцов, принадлежащих к этому кластеру. Пусто, если сэмплы входят в состав подкластеров. нет
subClusters массив InsightsCluster Список подкластеров в этом кластере. Пусто, если подкластеров нет. нет
Предложение струна Предложение по кластеру Да
предложениеTitle струна Заголовок предложения для кластера Да
weight целое число Вес кластера анализа. Это указывает на количество выборок в кластере. Да

InsightsModelConfiguration

Конфигурация модели, используемой при создании аналитических сведений.

Имя. Тип Description Обязательно По умолчанию
modelDeploymentName струна Развертывание модели, подлежащее оценке. Принимает только имя развертывания или имя подключения как {connectionName}/<modelDeploymentName>. Да

InsightsRequest

Запрос аналитического отчета.

Дискриминация для InsightsRequest

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
EvaluationRunClusterInsight EvaluationRunClusterInsightRequest
AgentClusterInsight AgentClusterInsightRequest
EvaluationComparison EvaluationComparisonInsightRequest
Имя. Тип Description Обязательно По умолчанию
type InsightsType Запрос инсайтов. Да

InsightsResult

Результат инсайтов.

Дискриминация для InsightsResult

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
EvaluationComparison EvaluationComparisonInsightResult
EvaluationRunClusterInsight EvaluationRunClusterInsightResult
AgentClusterInsight AgentClusterInsightResult
Имя. Тип Description Обязательно По умолчанию
type InsightsType Запрос инсайтов. Да

InsightsSample

Образец из анализа.

Дискриминация для InsightsSample

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
EvaluationResultSample EvaluationResultSample
Имя. Тип Description Обязательно По умолчанию
correlationInfo объект Информация о корреляции для анализируемой выборки. Да
features объект Функции, помогающие с дополнительной фильтрацией данных в UX. Да
id струна Уникальный идентификатор образца анализа. Да
type SampleType Тип пробы, используемой при анализе. Да

InsightsScheduleTask

Задача анализа для расписания.

Имя. Тип Description Обязательно По умолчанию
configuration объект Конфигурация под задачу. нет
аналитика Проницательность Тело ответа для аналитики кластера. Да
└️ displayName струна Понятное для пользователя отображаемое имя для аналитических сведений. Да
Идентификатор └️ строка (только для чтения) Уникальный идентификатор для отчета с аналитическими сведениями. Да
└─ Метаданные InsightsMetadata (только для чтения) Метаданные об отчете с аналитическими сведениями. Да
Запрос └️ InsightsRequest Запрос на анализ инсайтов. Да
Результат └️ InsightsResult (только для чтения) Результат аналитического отчета. нет
Состояние └️ Azure. Core.Foundations.OperationState (только для чтения) Текущее состояние аналитических сведений. Да
type перечисление
Возможные значения: Insight
Да

InsightsSummary

Сводка кластерного анализа ошибок.

Имя. Тип Description Обязательно По умолчанию
method струна Метод, используемый для кластеризации. Да
sampleCount целое число Общее количество проанализированных образцов. Да
uniqueClusterCount целое число Общее количество уникальных кластеров. Да
uniqueSubclusterCount целое число Общее количество уникальных меток подкластера. Да
использование ClusterTokenUsage Использование токенов для кластерного анализа Да
└️ inputTokenUsage целое число Использование входного токена Да
└️ outputTokenUsage целое число Использование выходного токена Да
└️ totalTokenUsage целое число Общее использование токенов Да

InsightType

Запрос инсайтов.

Недвижимость Ценность
Описание Запрос инсайтов.
Тип струна
Значения EvaluationRunClusterInsight
AgentClusterInsight
EvaluationComparison

InsightsMetadata

Метаданные об инсайтах.

Имя. Тип Description Обязательно По умолчанию
completedAt струна Временная метка, когда аналитические сведения были завершены. нет
createdAt струна Временная метка при создании аналитических сведений. Да

ItemGenerationParams

Представляет набор параметров, используемых для управления операциями создания элементов.

Дискриминация для ItemGenerationParams

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
red_team RedTeamItemGenerationParams
red_team_seed_prompts RedTeamSeedPromptsItemGenerationParams
red_team_taxonomy RedTeamTaxonomyItemGenerationParams
response_retrieval ResponseRetrievalItemGenerationParams
Имя. Тип Description Обязательно По умолчанию
type ItemGenerationParamsType Типы параметров для создания элементов красной команды. Да

ItemGenerationParamsType

Типы параметров для создания элементов красной команды.

Недвижимость Ценность
Описание Типы параметров для создания элементов красной команды.
Тип струна
Значения red_team
response_retrieval
red_team_seed_prompts
red_team_taxonomy
synthetic_data_gen_preview

ManagedAzureAISearchIndex

Managed Azure AI Search Index Definition

Имя. Тип Description Обязательно По умолчанию
id строка (только для чтения) Asset ID — уникальный идентификатор актива нет
имя строка (только для чтения) Имя ресурса Да
type перечисление Тип индекса
Возможные значения: ManagedAzureSearch
Да
version строка (только для чтения) Версия ресурса Да

ManagedAzureAISearchIndexUpdate

Managed Azure AI Search Index Definition

Имя. Тип Description Обязательно По умолчанию
описание струна Текст описания ресурса. нет
tags объект Словарь тегов. Теги можно добавлять, удалять и обновлять. нет
type перечисление Тип индекса
Возможные значения: ManagedAzureSearch
Да

MemoryItem

Один элемент памяти, хранящийся в хранилище памяти и содержащий содержимое и метаданные.

Дискриминация для MemoryItem

Этот компонент использует свойство kind для дискриминации между различными типами:

Значение типа Схема
user_profile UserProfileMemoryItem
chat_summary ChatSummaryMemoryItem
Имя. Тип Description Обязательно По умолчанию
содержимое струна Содержимое памяти. Да
добрый MemoryItemKind Вид элемента памяти. Да
memory_id струна Уникальный идентификатор элемента памяти. Да
scope струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да
updated_at целое число Время последнего обновления элемента памяти. Да

MemoryItemKind

Вид элемента памяти.

Недвижимость Ценность
Описание Вид элемента памяти.
Тип струна
Значения user_profile
chat_summary

MemoryOperation

Представляет собой одну операцию памяти (создание, обновление или удаление), выполненную над элементом памяти.

Имя. Тип Description Обязательно По умолчанию
добрый MemoryOperationKind Вид операций с памятью. Да
memory_item MemoryItem Один элемент памяти, хранящийся в хранилище памяти и содержащий содержимое и метаданные. Да
└─ Содержимое струна Содержимое памяти. Да
└️ вид MemoryItemKind Вид объекта памяти. Да
└️ memory_id струна Уникальный идентификатор элемента памяти. Да
Область └️ струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да
└updated_at updated_at целое число Время последнего обновления элемента памяти. Да

MemoryOperationKind

Вид операций с памятью.

Недвижимость Ценность
Описание Вид операций с памятью.
Тип струна
Значения create
update
delete

MemorySearchItem

Извлеченный элемент памяти из поиска в памяти.

Имя. Тип Description Обязательно По умолчанию
memory_item MemoryItem Один элемент памяти, хранящийся в хранилище памяти и содержащий содержимое и метаданные. Да
└─ Содержимое струна Содержимое памяти. Да
└️ вид MemoryItemKind Вид объекта памяти. Да
└️ memory_id струна Уникальный идентификатор элемента памяти. Да
Область └️ струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да
└updated_at updated_at целое число Время последнего обновления элемента памяти. Да

MemorySearchOptions

Варианты поиска в памяти.

Имя. Тип Description Обязательно По умолчанию
max_memories целое число Максимальное количество возвращаемых элементов памяти. нет

MemorySearchPreviewTool

Инструмент для интеграции воспоминаний в агент.

Имя. Тип Description Обязательно По умолчанию
memory_store_name струна Имя используемого хранилища памяти. Да
scope струна Пространство имен, используемое для группировки и изоляции воспоминаний, например идентификатор пользователя.
Ограничивает количество воспоминаний, которые могут быть восстановлены или обновлены.
Используйте специальную переменную {{$userId}} для ограничения памяти текущим вошедшим в систему пользователем.
Да
search_options MemorySearchOptions Варианты поиска в памяти. нет
└max_memories целое число Максимальное количество возвращаемых элементов памяти. нет
type перечисление Тип средства. Всегда memory_search_preview.
Возможные значения: memory_search_preview
Да
update_delay целое число Время ожидания перед обновлением воспоминаний после бездействия (секунды). По умолчанию 300. нет 300

MemorySearchToolCallItemParam

Имя. Тип Description Обязательно По умолчанию
results массив MemorySearchItem Результаты, полученные в результате поиска в памяти. нет
type перечисление
Возможные значения: memory_search_call
Да

MemorySearchToolCallItemResource

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
response_id струна Ответ, на котором создается элемент. нет
results массив MemorySearchItem Результаты, полученные в результате поиска в памяти. нет
статус перечисление Состояние вызова средства поиска памяти. Один из in_progress,
searching completed, или ,incompletefailed
Возможные значения: in_progress, searching, completed, incomplete, failed
Да
type перечисление
Возможные значения: memory_search_call
Да

MemoryStoreDefaultDefinition

Реализация хранилища памяти по умолчанию.

Имя. Тип Description Обязательно По умолчанию
chat_model струна Имя или идентификатор развертывания модели завершения чата, используемого для обработки памяти. Да
embedding_model струна Имя или идентификатор развертывания модели внедрения, используемого для обработки памяти. Да
добрый перечисление Вид хранилища памяти.
Возможные значения: default
Да
options MemoryStoreDefaultOptions Конфигурации хранилища памяти по умолчанию. нет
└chat_summary_enabled булевый Можно ли включить chat summary extraction and storage. Значение по умолчанию — истинно. Да True
└user_profile_details струна Определенные категории или типы информации профиля пользователя для извлечения и хранения. нет
└user_profile_enabled булевый Можно ли включать извлечение и storage пользовательского профиля. Значение по умолчанию — истинно. Да True

MemoryStoreDefaultOptions

Конфигурации хранилища памяти по умолчанию.

Имя. Тип Description Обязательно По умолчанию
chat_summary_enabled булевый Можно ли включить chat summary extraction and storage. Значение по умолчанию — истинно. Да True
user_profile_details струна Определенные категории или типы информации профиля пользователя для извлечения и хранения. нет
user_profile_enabled булевый Можно ли включать извлечение и storage пользовательского профиля. Значение по умолчанию — истинно. Да True

MemoryStoreDefinition

Базовое определение для конфигураций хранилища памяти.

Дискриминация для MemoryStoreDefinition

Этот компонент использует свойство kind для дискриминации между различными типами:

Значение типа Схема
default MemoryStoreDefaultDefinition
Имя. Тип Description Обязательно По умолчанию
добрый MemoryStoreKind Тип используемой реализации хранилища памяти. Да

MemoryStoreDeleteScopeResponse

Реакция на удаление воспоминаний из области видимости.

Имя. Тип Description Обязательно По умолчанию
удалено булевый Была ли операция удаления успешной. Да
имя струна Имя хранилища памяти. Да
объект перечисление Тип объекта. Всегда 'memory_store.scope.deleted'.
Возможные значения: memory_store.scope.deleted
Да
scope струна Область, из которой были удалены воспоминания. Да

MemoryStoreKind

Тип используемой реализации хранилища памяти.

Недвижимость Ценность
Описание Тип используемой реализации хранилища памяти.
Тип струна
Значения default

MemoryStoreObject

Хранилище памяти, которое может хранить и извлекать воспоминания пользователя.

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Временная метка Unix (в секундах) на момент создания хранилища памяти. Да
Определение MemoryStoreDefinition Базовое определение для конфигураций хранилища памяти. Да
└️ вид MemoryStoreKind Вид хранилища памяти. Да
описание струна Удобочитаемое описание хранилища памяти.
Ограничения: maxLength: 512
нет
id струна Уникальный идентификатор хранилища памяти. Да
metadata объект Произвольные метаданные типа "ключ-значение" для связи с хранилищем памяти. нет
имя струна Имя хранилища памяти.
Ограничения: maxLength: 256
Да
объект перечисление Тип объекта, который всегда равен 'memory_store'.
Возможные значения: memory_store
Да
updated_at целое число Временная метка Unix (в секундах) при последнем обновлении хранилища памяти. Да

MemoryStoreOperationUsage

Статистика использования операции с хранилищем памяти.

Имя. Тип Description Обязательно По умолчанию
embedding_tokens целое число Количество токенов встраивания. Да
input_tokens OpenAI.integer Да
input_tokens_details OpenAI.ResponseUsageInputTokensDetails Да
└ cached_tokens OpenAI.integer Да
output_tokens OpenAI.integer Да
output_tokens_details OpenAI.ResponseUsageOutputTokensDetails Да
└️ reasoning_tokens OpenAI.integer Да
общее количество токенов OpenAI.integer Да

MemoryStoreSearchResponse

Реакция на поиск в памяти.

Имя. Тип Description Обязательно По умолчанию
Воспоминания массив MemorySearchItem Связанные элементы памяти, найденные во время операции поиска. Да
search_id струна Уникальный идентификатор этого поискового запроса. Используйте это значение в качестве previous_search_id в последующих запросах для выполнения добавочного поиска. Да
использование MemoryStoreOperationUsage Статистика использования операции с хранилищем памяти. Да
└embedding_tokens целое число Количество токенов встраивания. Да
└input_tokens OpenAI.integer Количество входных токенов. Да
└─ данные_входных_токенов OpenAI.ResponseUsageInputTokensDetails Подробная разбивка входных токенов. Да
└─ выходные_токены (output_tokens) OpenAI.integer Количество выходных токенов. Да
└️ output_tokens_details OpenAI.ResponseUsageOutputTokensDetails Подробная разбивка выходных маркеров. Да
└️ всего_токенов OpenAI.integer Общее количество используемых токенов. Да

MemoryStoreUpdateCompletedResult

Результат обновления памяти.

Имя. Тип Description Обязательно По умолчанию
memory_operations массив MemoryOperation Список отдельных операций с памятью, которые были выполнены во время обновления. Да
использование MemoryStoreOperationUsage Статистика использования операции с хранилищем памяти. Да
└embedding_tokens целое число Количество токенов встраивания. Да
└input_tokens OpenAI.integer Количество входных токенов. Да
└─ данные_входных_токенов OpenAI.ResponseUsageInputTokensDetails Подробная разбивка входных токенов. Да
└─ выходные_токены (output_tokens) OpenAI.integer Количество выходных токенов. Да
└️ output_tokens_details OpenAI.ResponseUsageOutputTokensDetails Подробная разбивка выходных маркеров. Да
└️ всего_токенов OpenAI.integer Общее количество используемых токенов. Да

MemoryStoreUpdateResponse

Предоставляет состояние операции обновления хранилища памяти.

Имя. Тип Description Обязательно По умолчанию
ошибка OpenAI.Error нет
└️ additionalInfo объект нет
└─ Код Строка (нулевая) Да
└️ debugInfo объект нет
└️ подробности массив OpenAI.Error нет
Сообщение └️ струна Да
└─ параметр Строка (нулевая) нет
└─ Тип струна нет
результат MemoryStoreUpdateCompletedResult Результат обновления памяти. нет
└memory_operations массив MemoryOperation Список отдельных операций с памятью, которые были выполнены во время обновления. Да
└─ использование MemoryStoreOperationUsage Статистика использования, связанная с операцией обновления памяти. Да
статус MemoryStoreUpdateStatus Состояние операции обновления хранилища памяти. Да
superseded_by струна В update_id операция была заменена на когда статус "Заменено". нет
update_id струна Уникальный идентификатор этого запроса на обновление. Используйте это значение в качестве previous_update_id в последующих запросах на выполнение добавочных обновлений. Да

MemoryStoreUpdateStatus

Состояние операции обновления хранилища памяти.

Недвижимость Ценность
Тип струна
Значения queued
in_progress
completed
failed
superseded

MicrosoftFabricPreviewTool

Информация о определении ввода инструмента Microsoft Fabric, используемая для настройки агента.

Имя. Тип Description Обязательно По умолчанию
fabric_dataagent_preview FabricDataAgentToolParameters Параметры инструмента агента данных набора данных. Да
└project_connections project_connections массив ToolProjectConnection Соединения project, подключённые к этому инструменту. Может быть не более 1 подключения
ресурс, подключенный к средству.
Ограничения: maxItems: 1
нет
type перечисление Тип объекта, который всегда «fabric_dataagent_preview».
Возможные значения: fabric_dataagent_preview
Да

ModelDeployment

Определение развертывания модели

Имя. Тип Description Обязательно По умолчанию
capabilities object (только для чтения) Возможности развернутой модели Да
connectionName строка (только для чтения) Имя подключения, из которого происходит развертывание нет
modelName строка (только для чтения) Publisher-специфическое название развернутой модели Да
modelPublisher строка (только для чтения) Название publisher развернутой модели Да
modelVersion строка (только для чтения) Publisher-специфичная версия модели развертывания Да
имя строка (только для чтения) Название развертывания Да
sku Sku (только для чтения) Сведения о номере SKU Да
Емкость └️ целое число Емкость SKU Да
Семья └️ струна Семья Ску Да
└️ имя струна Имя SKU Да
└️ размер струна Размер SKU Да
Уровень └️ струна Уровень SKU Да
type перечисление Тип развертывания
Возможные значения: ModelDeployment
Да

ModelSamplingParams

Представляет набор параметров, используемых для управления поведением выборки языковой модели во время создания текста.

Имя. Тип Description Обязательно По умолчанию
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное число маркеров, разрешенных в завершении. Да
seed целое число Случайное начальное значение для воспроизведения. Да
Температура число/номер Параметр температуры для выборки. Да
top_p число/номер Параметр top-p для выборки ядра. Да

ModelSamplingParamsUpdate

Представляет набор параметров, используемых для управления поведением выборки языковой модели во время создания текста.

Имя. Тип Description Обязательно По умолчанию
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное число маркеров, разрешенных в завершении. нет
seed целое число Случайное начальное значение для воспроизведения. нет
Температура число/номер Параметр температуры для выборки. нет
top_p число/номер Параметр top-p для выборки ядра. нет

MonthlyRecurrenceSchedule

Ежемесячный график повторения.

Имя. Тип Description Обязательно По умолчанию
daysOfMonth массив целых чисел Дни месяца для графика повторения. Да
type перечисление Тип ежемесячного рецидива.
Возможные значения: Monthly
Да

NoAuthenticationCredentials

Учетные данные, не требующие аутентификации

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип учетных данных
Возможные значения: None
Да

OAuthConsentRequestOutputItem

Запрос от службы для пользователя для выполнения согласия OAuth.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
consent_link струна Ссылка, используемая пользователем для выполнения согласия OAuth. Да
id струна Да
response_id струна Ответ, на котором создается элемент. нет
метка сервера струна Метка сервера для запроса на согласие OAuth. Да
type перечисление
Возможные значения: oauth_consent_request
Да

OneTimeTrigger

Одноразовый спусковой крючок.

Имя. Тип Description Обязательно По умолчанию
часовой пояс струна Часовой пояс для одноразового триггера. нет UTC
triggerAt струна Дата и время для одноразового запуска в формате ISO 8601. Да
type перечисление
Возможные значения: OneTime
Да

OpenAI.Annotation

Заметка, которая применяется к диапазону выходного текста.

Дискриминатор для OpenAI.Annotation

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
file_citation OpenAI.FileCitationBody
url_citation OpenAI.UrlCitationBody
container_file_citation OpenAI.ContainerFileCitationBody
file_path OpenAI.FilePath
Имя. Тип Description Обязательно По умолчанию
type OpenAI.AnnotationType Да

OpenAI.AnnotationType

Недвижимость Ценность
Тип струна
Значения file_citation
url_citation
container_file_citation
file_path

OpenAI.ApplyPatchCallOutputStatus

Недвижимость Ценность
Тип струна
Значения completed
failed

OpenAI.ApplyPatchCallOutputStatusParam

Значения результатов, представленные для выходов apply_patch вызовов инструмента.

Недвижимость Ценность
Тип струна
Значения completed
failed

OpenAI.ApplyPatchCallStatus

Недвижимость Ценность
Тип струна
Значения in_progress
completed

OpenAI.ApplyPatchCallStatusParam

Значения статуса, указанные для apply_patch вызовов инструментов.

Недвижимость Ценность
Тип струна
Значения in_progress
completed

OpenAI.ApplyPatchCreateFileOperation

Инструкция, описывающая создание файла с помощью средства apply_patch.

Имя. Тип Description Обязательно По умолчанию
дифф струна Дифф для применения. Да
путь струна Путь к создаваемому файлу. Да
type перечисление Создайте файл с предоставленным диффом.
Возможные значения: create_file
Да

OpenAI.ApplyPatchCreateFileOperationParam

Инструкция по созданию нового файла через инструмент apply_patch.

Имя. Тип Description Обязательно По умолчанию
дифф струна Унифицированный дифференциальный контент для использования при создании файла.
Ограничения: maxLength: 10485760
Да
путь струна Путь для создания файла относительно корня рабочего пространства.
Ограничения: minLength: 1
Да
type перечисление Тип операции. Всегда create_file.
Возможные значения: create_file
Да

OpenAI.ApplyPatchDeleteFileOperation

Инструкция, описывающая удаление файла с помощью средства apply_patch.

Имя. Тип Description Обязательно По умолчанию
путь струна Путь к удаленному файлу. Да
type перечисление Удалите указанный файл.
Возможные значения: delete_file
Да

OpenAI.ApplyPatchDeleteFileOperationParam

Инструкция по удалению существующего файла через инструмент apply_patch.

Имя. Тип Description Обязательно По умолчанию
путь струна Путь файла для удаления относительно корня рабочего пространства.
Ограничения: minLength: 1
Да
type перечисление Тип операции. Всегда delete_file.
Возможные значения: delete_file
Да

OpenAI.ApplyPatchFileOperation

Одна из операций create_file, delete_file или update_file, применяемых через apply_patch.

Дискриминация для OpenAI.ApplyPatchFileOperation

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
create_file OpenAI.ApplyPatchCreateFileOperation
delete_file OpenAI.ApplyPatchDeleteFileOperation
update_file OpenAI.ApplyPatchUpdateFileOperation
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ApplyPatchFileOperationType Да

OpenAI.ApplyPatchFileOperationType

Недвижимость Ценность
Тип струна
Значения create_file
delete_file
update_file

OpenAI.ApplyPatchOperationParam

Одна из create_file, delete_file или update_file операций, поставляемых на инструмент apply_patch.

Дискриминация для OpenAI.ApplyPatchOperationParam

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
create_file OpenAI.ApplyPatchCreateFileOperationParam
delete_file OpenAI.ApplyPatchDeleteFileOperationParam
update_file OpenAI.ApplyPatchUpdateFileOperationParam
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ApplyPatchOperationParamType Да

OpenAI.ApplyPatchOperationParamType

Недвижимость Ценность
Тип струна
Значения create_file
delete_file
update_file

OpenAI.ApplyPatchToolParam

Позволяет ассистенту создавать, удалять или обновлять файлы с помощью унифицированных дифференциальностей.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип средства. Всегда apply_patch.
Возможные значения: apply_patch
Да

OpenAI.ApplyPatchUpdateFileOperation

Инструкция, описывающая обновление файла с помощью средства apply_patch.

Имя. Тип Description Обязательно По умолчанию
дифф струна Дифф для применения. Да
путь струна Путь к файлу для обновления. Да
type перечисление Обновите существующий файл с предоставленным диффом.
Возможные значения: update_file
Да

OpenAI.ApplyPatchUpdateFileOperationParam

Инструкция по обновлению существующего файла через инструмент apply_patch.

Имя. Тип Description Обязательно По умолчанию
дифф струна Унифицированное diff-содержимое для применения к существующему файлу.
Ограничения: maxLength: 10485760
Да
путь струна Путь файла к обновлению относительно корня рабочего пространства.
Ограничения: minLength: 1
Да
type перечисление Тип операции. Всегда update_file.
Возможные значения: update_file
Да

OpenAI.ПримерноеМестоположение

Имя. Тип Description Обязательно По умолчанию
city Строка (нулевая) нет
country Строка (нулевая) нет
region Строка (нулевая) нет
timezone Строка (нулевая) нет
type перечисление Тип приближения к расположению. Всегда approximate.
Возможные значения: approximate
Да

Инструмент завершения чата OpenAI

Средство функции, которое можно использовать для создания ответа.

Имя. Тип Description Обязательно По умолчанию
function OpenAI.FunctionObject Да
type перечисление Тип средства. В настоящее время поддерживается только function .
Возможные значения: function
Да

OpenAI.ChatModel

Недвижимость Ценность
Тип струна
Значения gpt-5.2
gpt-5.2-2025-12-11
gpt-5.2-chat-latest
gpt-5.2-pro
gpt-5.2-pro-2025-12-11
gpt-5.1
gpt-5.1-2025-11-13
gpt-5.1-codex
gpt-5.1-mini
gpt-5.1-chat-latest
gpt-5
gpt-5-mini
gpt-5-nano
gpt-5-2025-08-07
gpt-5-mini-2025-08-07
gpt-5-nano-2025-08-07
gpt-5-chat-latest
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
gpt-4.1-2025-04-14
gpt-4.1-mini-2025-04-14
gpt-4.1-nano-2025-04-14
o4-mini
o4-mini-2025-04-16
o3
o3-2025-04-16
o3-mini
o3-mini-2025-01-31
o1
o1-2024-12-17
o1-preview
o1-preview-2024-09-12
o1-mini
o1-mini-2024-09-12
gpt-4o
gpt-4o-2024-11-20
gpt-4o-2024-08-06
gpt-4o-2024-05-13
gpt-4o-audio-preview
gpt-4o-audio-preview-2024-10-01
gpt-4o-audio-preview-2024-12-17
gpt-4o-audio-preview-2025-06-03
gpt-4o-mini-audio-preview
gpt-4o-mini-audio-preview-2024-12-17
gpt-4o-search-preview
gpt-4o-mini-search-preview
gpt-4o-search-preview-2025-03-11
gpt-4o-mini-search-preview-2025-03-11
chatgpt-4o-latest
codex-mini-latest
gpt-4o-mini
gpt-4o-mini-2024-07-18
gpt-4-turbo
gpt-4-turbo-2024-04-09
gpt-4-0125-preview
gpt-4-turbo-preview
gpt-4-1106-preview
gpt-4-vision-preview
gpt-4
gpt-4-0314
gpt-4-0613
gpt-4-32k
gpt-4-32k-0314
gpt-4-32k-0613
gpt-3.5-turbo
gpt-3.5-turbo-16k
gpt-3.5-turbo-0301
gpt-3.5-turbo-0613
gpt-3.5-turbo-1106
gpt-3.5-turbo-0125
gpt-3.5-turbo-16k-0613

OpenAI.ClickButtonType

Недвижимость Ценность
Тип струна
Значения left
right
wheel
back
forward

OpenAI.ClickParam

Действие щелчка.

Имя. Тип Description Обязательно По умолчанию
button OpenAI.ClickButtonType Да
type перечисление Указывает тип события. Для действия клика это свойство всегда click.
Возможные значения: click
Да
x OpenAI.integer Да
и OpenAI.integer Да

OpenAI.CodeInterpreterContainerAuto

Настройка контейнера интерпретатора кода. При необходимости укажите идентификаторы файлов для запуска кода.

Имя. Тип Description Обязательно По умолчанию
идентификаторы_файлов Массив строк Необязательный список загруженных файлов для использования в вашем коде. нет
предел памяти OpenAI.ContainerMemoryLimit (nullable) нет
type перечисление Всегда auto.
Возможные значения: auto
Да

OpenAI.CodeInterpreterOutputImage

Выходные данные изображения интерпретатора кода.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип выходных данных. Всегда image.
Возможные значения: image
Да
URL-адрес струна URL-адрес выходных данных изображения из интерпретатора кода. Да

OpenAI.CodeInterpreterOutputLogs

Журналы, выходные данные интерпретатора кода.

Имя. Тип Description Обязательно По умолчанию
logs струна Журналы, выходные данные интерпретатора кода. Да
type перечисление Тип выходных данных. Всегда logs.
Возможные значения: logs
Да

OpenAI.CodeInterpreterTool

Средство, которое запускает код Python для создания ответа на запрос.

Имя. Тип Description Обязательно По умолчанию
container string или OpenAI.CodeInterpreterContainerAuto Контейнер интерпретатора кода. Может быть идентификатором контейнера или объектом, который
указывает идентификаторы отправленных файлов, чтобы предоставить доступ к коду, а также
необязательный memory_limit параметр.
Если эта служба не указана, служба предполагает автоматическое использование.
нет
type перечисление Тип средства интерпретатора кода. Всегда code_interpreter.
Возможные значения: code_interpreter
Да

OpenAI.CompactResource

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) при создании сжатой беседы. Да
id струна Уникальный идентификатор компактного ответа. Да
объект перечисление Тип объекта. Всегда response.compaction.
Возможные значения: response.compaction
Да
output массив OpenAI.OutputItem Сжатый список выходных элементов. Это список всех сообщений пользователей, за которым следует один элемент сжатия. Да
использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
Да
└input_tokens OpenAI.integer Количество входных токенов. Да
└─ данные_входных_токенов OpenAI.ResponseUsageInputTokensDetails Подробная разбивка входных токенов. Да
└─ выходные_токены (output_tokens) OpenAI.integer Количество выходных токенов. Да
└️ output_tokens_details OpenAI.ResponseUsageOutputTokensDetails Подробная разбивка выходных маркеров. Да
└️ всего_токенов OpenAI.integer Общее количество используемых токенов. Да

OpenAI.CompactResponseMethodPublicBody

Имя. Тип Description Обязательно По умолчанию
ввод строка или массив OpenAI.InputItem нет
instructions Строка (нулевая) нет
модель OpenAI.ModelIdsCompaction Идентификатор модели, используемый для создания ответа, например gpt-5 или o3. OpenAI предлагает широкий спектр моделей с разными возможностями, характеристиками производительности и ценами. Ознакомьтесь с руководством по модели для просмотра и сравнения доступных моделей. Да
previous_response_id Строка (нулевая) нет

OpenAI.ComparisonFilter (фильтр сравнения)

Фильтр, используемый для сравнения указанного ключа атрибута с заданным значением с помощью определенной операции сравнения.

Имя. Тип Description Обязательно По умолчанию
ключ струна Ключ для сопоставления со значением. Да
type перечисление Задаёт оператор сравнения: eq, ne, gt, gte, lt, lteinnin.
- eq: Равно
- ne: не равно
- gt: больше чем
- gte: больше или равно
- lt:Менее
- lte: меньше или равно
- in
- nin: не в
Возможные значения: eq, ne, gt, gte, lt, lte
Да
value string или OpenAI.numeric или boolean или массив OpenAI.ComparisonFilterValueItems Значение для сравнения с ключом атрибута; поддерживает типы строк, чисел или логических типов. Да

OpenAI.ComparisonFilterValueItems

Тип: string или OpenAI.numeric

OpenAI.CompoundFilter

Объединение нескольких фильтров с помощью and или or.

Имя. Тип Description Обязательно По умолчанию
filters массив OpenAI.ComparisonFilter или object Массив фильтров для объединения. Элементы могут быть ComparisonFilter или CompoundFilter. Да
type перечисление Тип операции: and или or.
Возможные значения: and, or
Да

OpenAI.ComputerAction

Дискриминатор для OpenAI.ComputerAction

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
click OpenAI.ClickParam
double_click OpenAI.DoubleClickAction
drag OpenAI.Drag
keypress OpenAI.KeyPressAction
move OpenAI.Move
screenshot OpenAI.Screenshot
scroll OpenAI.Scroll
type OpenAI.Type
wait OpenAI.Wait
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ComputerActionType Да

OpenAI.ComputerActionType

Недвижимость Ценность
Тип струна
Значения click
double_click
drag
keypress
move
screenshot
scroll
type
wait

OpenAI.ComputerCallSafetyCheckParam

Ожидается проверка безопасности для компьютерного вызова.

Имя. Тип Description Обязательно По умолчанию
код Строка (нулевая) нет
id струна Идентификатор ожидающей проверки безопасности. Да
сообщение Строка (нулевая) нет

OpenAI.ComputerEnvironment

Недвижимость Ценность
Тип струна
Значения windows
mac
linux
ubuntu
browser

OpenAI.ComputerScreenshotContent

Снимок экрана: компьютер.

Имя. Тип Description Обязательно По умолчанию
идентификатор_файла Строка (нулевая) Да
ссылка_на_изображение струна Да
type перечисление Указывает тип события. Для снимка экрана компьютера это свойство всегда имеет значение computer_screenshot.
Возможные значения: computer_screenshot
Да

OpenAI.ComputerScreenshotImage

Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера.

Имя. Тип Description Обязательно По умолчанию
идентификатор_файла струна Идентификатор отправленного файла, содержащего снимок экрана. нет
ссылка_на_изображение струна URL-адрес изображения снимка экрана. нет
type перечисление Указывает тип события. Снимок экрана компьютера: это свойство
всегда задано значение computer_screenshot.
Возможные значения: computer_screenshot
Да

OpenAI.ИнструментПредварительногоПросмотраИспользованияКомпьютера

Средство управления виртуальным компьютером.

Имя. Тип Description Обязательно По умолчанию
высота дисплея OpenAI.integer Да
ширина дисплея OpenAI.integer Да
environment OpenAI.ComputerEnvironment Да
type перечисление Тип средства использования компьютера. Всегда computer_use_preview.
Возможные значения: computer_use_preview
Да

OpenAI.ContainerFileCitationBody

Цитирование контейнерного файла, используемого для генерации ответа модели.

Имя. Тип Description Обязательно По умолчанию
container_id струна ID файла контейнера. Да
end_index OpenAI.integer Да
идентификатор_файла струна Идентификатор файла. Да
filename струна Имя файла контейнера, указанного на сайте. Да
start_index OpenAI.integer Да
type перечисление Тип цитирования контейнерного файла. Всегда container_file_citation.
Возможные значения: container_file_citation
Да

OpenAI.ContainerMemoryLimit

Недвижимость Ценность
Тип струна
Значения 1g
4g
16g
64g

OpenAI.ConversationItem

Один элемент в беседе. Набор возможных типов совпадает с output типом объекта Response.

Дискриминация для OpenAI.ConversationItem

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
message OpenAI.ConversationItemMessage
function_call OpenAI.ConversationItemFunctionToolCallResource
function_call_output OpenAI.ConversationItemFunctionToolCallOutputResource
file_search_call OpenAI.ConversationItemFileSearchToolCall
web_search_call OpenAI.ConversationItemWebSearchToolCall
image_generation_call OpenAI.ConversationItemImageGenToolCall
computer_call OpenAI.ConversationItemComputerToolCall
computer_call_output OpenAI.ConversationItemComputerToolCallOutputResource
reasoning OpenAI.ConversationItemReasoningItem
code_interpreter_call OpenAI.ConversationItemCodeInterpreterToolCall
local_shell_call OpenAI.ConversationItemLocalShellToolCall
local_shell_call_output OpenAI.ConversationItemLocalShellToolCallOutput
shell_call OpenAI.ConversationItemFunctionShellCall
shell_call_output OpenAI.ConversationItemFunctionShellCallOutput
apply_patch_call OpenAI.ConversationItemApplyPatchToolCall
apply_patch_call_output OpenAI.ConversationItemApplyPatchToolCallOutput
mcp_list_tools OpenAI.ConversationItemMcpListTools
mcp_approval_request OpenAI.ConversationItemMcpApprovalRequest
mcp_approval_response OpenAI.ConversationItemMcpApprovalResponseResource
mcp_call OpenAI.ConversationItemMcpToolCall
custom_tool_call OpenAI.ConversationItemCustomToolCall
custom_tool_call_output OpenAI.ConversationItemCustomToolCallOutput
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ConversationItemType Да

OpenAI.ConversationItemApplyPatchToolCall

Вызов средства, который применяет диффы файлов, создавая, удаляя или обновляя файлы.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью. Да
создано пользователем струна Идентификатор сущности, созданной этим средством. нет
id струна Уникальный идентификатор вызова средства исправления. Заполняется, когда этот элемент возвращается через API. Да
Операция OpenAI.ApplyPatchFileOperation Одна из операций create_file, delete_file или update_file, применяемых через apply_patch. Да
└─ Тип OpenAI.ApplyPatchFileOperationType Да
статус OpenAI.ApplyPatchCallStatus Да
type перечисление Тип элемента. Всегда apply_patch_call.
Возможные значения: apply_patch_call
Да

OpenAI.ConversationItemApplyPatchToolCallOutput

Выходные данные, создаваемые вызовом средства исправления.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью. Да
создано пользователем струна Идентификатор сущности, создающей выходные данные вызова этого средства. нет
id струна Уникальный идентификатор выходных данных вызова средства исправления. Заполняется, когда этот элемент возвращается через API. Да
output Строка (нулевая) нет
статус OpenAI.ApplyPatchCallOutputStatus Да
type перечисление Тип элемента. Всегда apply_patch_call_output.
Возможные значения: apply_patch_call_output
Да

OpenAI.ConversationItemCodeInterpreterToolCall

Вызов инструмента для выполнения кода.

Имя. Тип Description Обязательно По умолчанию
код Строка (нулевая) Да
container_id струна Идентификатор контейнера, используемого для запуска кода. Да
id струна Уникальный идентификатор вызова средства интерпретатора кода. Да
выходные данные массив OpenAI.CodeInterpreterOutputLogs или OpenAI.CodeInterpreterOutputImage Да
статус перечисление Состояние вызова средства интерпретатора кода. Допустимые значения: in_progress, completed, incomplete, interpreting, и failed.
Возможные значения: in_progress, completed, incomplete, interpreting, failed
Да
type перечисление Тип вызова средства интерпретатора кода. Всегда code_interpreter_call.
Возможные значения: code_interpreter_call
Да

OpenAI.ConversationItemComputerToolCall

Вызов инструмента для работы с компьютером. См. руководство по использованию компьютеров компьютера для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.ComputerAction Да
call_id струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. Да
id струна Уникальный идентификатор вызова компьютера. Да
pending_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Ожидающие проверки безопасности для компьютеризированного процесса. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип компьютерного вызова. Всегда computer_call.
Возможные значения: computer_call
Да

OpenAI.ConversationItemComputerToolCallOutputResource

Имя. Тип Description Обязательно По умолчанию
acknowledged_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Проверки безопасности, сообщаемые API, которые были подтверждены
разработчик.
нет
call_id струна Идентификатор вызова средства компьютера, создающего выходные данные. Да
id струна Идентификатор данных, полученных в результате вызова компьютерного инструмента. нет
output OpenAI.ComputerScreenshotImage Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера. Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completedили
incomplete. Заполняется при возврате входных элементов через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выходных данных компьютерного средства вызова. Всегда computer_call_output.
Возможные значения: computer_call_output
Да

OpenAI.ConversationItemCustomToolCall

Вызов пользовательского инструмента, созданного моделью.

Имя. Тип Description Обязательно По умолчанию
call_id струна Идентификатор, используемый для сопоставления этого пользовательского вызова инструмента с выходом вызова инструмента. Да
id струна Уникальный идентификатор пользовательского инструмента вызывает платформу OpenAI. нет
ввод струна Вход для пользовательского вызова инструмента, генерируемого моделью. Да
имя струна Имя вызываемого пользовательского инструмента. Да
type перечисление Тип пользовательского вызова инструмента. Всегда custom_tool_call.
Возможные значения: custom_tool_call
Да

OpenAI.ConversationItemCustomToolCallOutput

Вывод пользовательского вызова инструмента из вашего кода возвращается в модель.

Имя. Тип Description Обязательно По умолчанию
call_id струна Идентификатор вызова, используемый для сопоставления этого вывода пользовательского вызова инструмента в пользовательский вызов инструмента. Да
id струна Уникальный идентификатор вывода пользовательского вызова инструмента на платформе OpenAI. нет
output строка или массив OpenAI.FunctionAndCustomToolCallOutput Результат из пользовательского вызова инструмента, сгенерированного вашим кодом.
Это может быть строка или список выходного контента.
Да
type перечисление Тип вывода пользовательского вызова инструмента. Всегда custom_tool_call_output.
Возможные значения: custom_tool_call_output
Да

OpenAI.ConversationItemFileSearchToolCall

Результаты вызова средства поиска файлов. Смотрите руководство по поиску файл для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова средства поиска файлов. Да
queries Массив строк Запросы, используемые для поиска файлов. Да
results массив OpenAI.FileSearchToolCallResults нет
статус перечисление Состояние вызова средства поиска файлов. Один из in_progress,
searching, incomplete или failed,
Возможные значения: in_progress, searching, completed, incomplete, failed
Да
type перечисление Тип вызова средства поиска файлов. Всегда file_search_call.
Возможные значения: file_search_call
Да

OpenAI.ConversationItemFunctionShellCall

Вызов средства, выполняющий одну или несколько команд оболочки в управляемой среде.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.FunctionShellAction Выполните команду оболочки. Да
Команды └️ Массив строк Да
└max_output_length OpenAI.integer (nullable) Да
└️ timeout_ms OpenAI.integer (nullable) Да
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью. Да
создано пользователем струна Идентификатор сущности, созданной этим средством. нет
id струна Уникальный идентификатор вызова средства оболочки. Заполняется, когда этот элемент возвращается через API. Да
статус OpenAI.LocalShellCallStatus Да
type перечисление Тип элемента. Всегда shell_call.
Возможные значения: shell_call
Да

OpenAI.ConversationItemFunctionShellCallOutput

Выходные данные вызова средства оболочки, который был создан.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью. Да
создано пользователем струна Идентификатор субъекта, создавшего элемент. нет
id струна Уникальный идентификатор выходных данных вызова оболочки. Заполняется, когда этот элемент возвращается через API. Да
max_output_length OpenAI.integer (nullable) Да
output массив OpenAI.FunctionShellCallOutputContent Массив содержимого вывода вызова оболочки Да
type перечисление Тип выходных данных вызова оболочки. Всегда shell_call_output.
Возможные значения: shell_call_output
Да

OpenAI.ConversationItemFunctionToolCallOutputResource

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор выходных данных вызова средства функции. Заполнено, когда этот элемент
возвращается через API.
нет
output строка или массив OpenAI.FunctionAndCustomToolCallOutput Выходные данные вызова функции, созданного кодом.
Это может быть строка или список выходного контента.
Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выходных данных вызова функции. Всегда function_call_output.
Возможные значения: function_call_output
Да

OpenAI.ConversationItemFunctionToolCallResource

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON аргументов для передачи функции. Да
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор вызова средства функции. нет
имя струна Имя выполняемой функции. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип вызова инструмента функции. Всегда function_call.
Возможные значения: function_call
Да

OpenAI.ConversationItemImageGenToolCall

Запрос на создание изображения, сделанный моделью.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова генерации изображений. Да
результат Строка (нулевая) Да
статус перечисление Статус вызова генерации изображений.
Возможные значения: in_progress, , completedgeneratingfailed
Да
type перечисление Тип вызова для генерации изображений. Всегда image_generation_call.
Возможные значения: image_generation_call
Да

OpenAI.ConversationItemList

Список элементов беседы.

Имя. Тип Description Обязательно По умолчанию
данные массив OpenAI.ConversationItem Список элементов беседы. Да
первый_идентификатор струна Идентификатор первого элемента в списке. Да
есть_еще булевый Доступны ли дополнительные элементы. Да
last_id струна Идентификатор последнего элемента в списке. Да
объект перечисление Тип возвращаемого объекта должен быть list.
Возможные значения: list
Да

OpenAI.ConversationItemLocalShellToolCall

Вызов средства для выполнения команды в локальной оболочке.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.LocalShellExecAction Выполните команду оболочки на сервере. Да
call_id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
id струна Уникальный идентификатор локального вызова shell. Да
статус перечисление Статус местного звонка shell.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип локального вызова shell. Всегда local_shell_call.
Возможные значения: local_shell_call
Да

OpenAI.ConversationItemLocalShellToolCallOutput

Выходные данные вызова локального средства оболочки.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
output струна Строка JSON выходных данных вызова локального средства оболочки. Да
статус перечисление
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выхода локального вызова инструмента shell. Всегда local_shell_call_output.
Возможные значения: local_shell_call_output
Да

OpenAI.ConversationItemMcpApprovalRequest

Запрос на одобрение человеком вызова инструмента.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON с аргументами для средства. Да
id струна Уникальный идентификатор запроса на одобрение. Да
имя струна Имя запускаемого средства. Да
метка сервера струна Метка сервера MCP, выполняющего запрос. Да
type перечисление Тип элемента. Всегда mcp_approval_request.
Возможные значения: mcp_approval_request
Да

OpenAI.ConversationItemMcpApprovalResponseResource

Ответ на запрос на утверждение MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id струна Идентификатор запроса на утверждение, на который даётся ответ. Да
Утвердить булевый Будет ли утвержден запрос. Да
id струна Уникальный идентификатор ответа на утверждение Да
причина Строка (нулевая) нет
type перечисление Тип элемента. Всегда mcp_approval_response.
Возможные значения: mcp_approval_response
Да

OpenAI.ConversationItemMcpListTools

Список средств, доступных на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор списка. Да
метка сервера струна Метка сервера MCP. Да
инструменты массив OpenAI.MCPListToolsTools Средства, доступные на сервере. Да
type перечисление Тип элемента. Всегда mcp_list_tools.
Возможные значения: mcp_list_tools
Да

OpenAI.ConversationItemMcpToolCall

Вызов инструмента на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id Строка (нулевая) нет
arguments струна Строка JSON аргументов, переданных средству. Да
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор вызова инструмента. Да
имя струна Имя запущенного инструмента. Да
output Строка (нулевая) нет
метка сервера струна Метка сервера MCP, на котором работает инструмент. Да
статус OpenAI.MCPToolCallStatus нет
type перечисление Тип элемента. Всегда mcp_call.
Возможные значения: mcp_call
Да

OpenAI.ConversationItemMessage

Сообщение в модель или из нее.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.MessageContent Содержимое сообщения Да
id струна Уникальный идентификатор сообщения. Да
роль OpenAI.MessageRole Да
статус OpenAI.MessageStatus Да
type перечисление Тип сообщения. Всегда задано значение message.
Возможные значения: message
Да

OpenAI.ConversationItemReasoningItem

Описание цепочки мысли, используемой моделью причин при создании ответа. Обязательно включите эти элементы в input в API ответов для последующих ходов разговора, если вы вручную управляете контекстом.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.ReasoningTextContent Текст с рассуждением. нет
encrypted_content Строка (нулевая) нет
id струна Уникальный идентификатор контента рассуждений. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
summary массив OpenAI.Summary Содержание с резюме аргументов. Да
type перечисление Тип объекта . Всегда reasoning.
Возможные значения: reasoning
Да

OpenAI.ConversationItemType

Недвижимость Ценность
Тип струна
Значения message
function_call
function_call_output
file_search_call
web_search_call
image_generation_call
computer_call
computer_call_output
reasoning
code_interpreter_call
local_shell_call
local_shell_call_output
shell_call
shell_call_output
apply_patch_call
apply_patch_call_output
mcp_list_tools
mcp_approval_request
mcp_approval_response
mcp_call
custom_tool_call
custom_tool_call_output

OpenAI.ConversationItemWebSearchToolCall

Результаты вызова инструмента веб-поиска. Смотрите руководство по поиску web для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.WebSearchActionSearch или OpenAI.WebSearchActionOpenPage или OpenAI.WebSearchActionFind Объект, описывающий конкретное действие, выполняемое в этом вызове веб-поиска.
Содержит сведения о том, как модель использовала Интернет (поиск, open_page, поиск).
Да
id струна Уникальный идентификатор инструмента поиска в интернете. Да
статус перечисление Состояние вызова функции средства поиска в Интернете.
Возможные значения: in_progress, , searchingcompletedfailed
Да
type перечисление Тип вызова инструмента поиска в интернете. Всегда web_search_call.
Возможные значения: web_search_call
Да

OpenAI.ConversationParam

Беседа, к которой относится этот ответ. Элементы из этой беседы предопределяются input_items для этого запроса ответа. Входные элементы и выходные элементы из этого ответа автоматически добавляются в эту беседу после завершения этого ответа.

Тип: string или OpenAI.ConversationParam-2

Беседа, к которой относится этот ответ. Элементы из этой беседы предопределяются input_items для этого запроса ответа. Входные элементы и выходные элементы из этого ответа автоматически добавляются в эту беседу после завершения этого ответа.

OpenAI.ConversationParam-2

Беседа, к которой относится этот ответ.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный ИД беседы. Да

OpenAI.ConversationReference

Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор беседы, с которым связан этот ответ. Да

OpenAI.ConversationResource

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Время создания беседы измеряется в секундах с эпохи Unix. Да
id струна Уникальный ИД беседы. Да
metadata OpenAI.Metadata Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
Да
объект перечисление Тип объекта, который всегда conversationявляется .
Возможные значения: conversation
Да

OpenAI.CreateChatCompletionRequestResponseFormat

Объект, указывающий формат, который должен выводить модель. Параметр для { "type": "json_schema", "json_schema": {...} } включения структурированных выходных данных, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Узнайте больше в руководстве Structured Outputs. Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.

Дискриминация для OpenAI.CreateChatCompletionRequestResponseFormat

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
text OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatText
json_object OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatJsonObject
Имя. Тип Description Обязательно По умолчанию
type OpenAI.CreateChatCompletionRequestResponseFormatType Да

OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatJsonObject

Формат отклика объекта JSON. Старый метод создания ответов JSON. Рекомендуется использовать json_schema для моделей, поддерживающих его. Обратите внимание, что модель не генерирует JSON без указания системы или пользовательского сообщения to e.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип определяемого формата ответа. Всегда json_object.
Возможные значения: json_object
Да

OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatText

Формат ответа по умолчанию. Используется для создания текстовых ответов.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип определяемого формата ответа. Всегда text.
Возможные значения: text
Да

OpenAI.CreateChatCompletionRequestResponseFormatType

Недвижимость Ценность
Тип струна
Значения text
json_schema
json_object

OpenAI.CreateConversationBody

Имя. Тип Description Обязательно По умолчанию
items массив OpenAI.InputItem нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет

OpenAI.CreateEvalCompletionsRunDataSource

Объект CompletionsRunDataSource, описывающий конфигурацию выборки модели.

Имя. Тип Description Обязательно По умолчанию
входные_сообщения OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesTemplate или OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference Используется при выборке из модели. Определяет структуру сообщений, передаваемых в модель. Может быть ссылка на предварительно созданную траекторию (т. е. item.input_trajectory) или шаблон с переменными ссылками на item пространство имен. нет
модель струна Имя модели, используемой для создания завершений (например, o3-mini). нет
параметры выборки OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams нет
Источник OpenAI.EvalJsonlFileContentSource или OpenAI.EvalJsonlFileIdSource или OpenAI.EvalStoredCompletionsSource Определяет, что заполняет item пространство имен в источнике данных этого запуска. Да
type перечисление Тип источника данных запуска. Всегда completions.
Возможные значения: completions
Да

OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference

Имя. Тип Description Обязательно По умолчанию
item_reference струна Да
type перечисление
Возможные значения: item_reference
Да

OpenAI.CreateEvalCompletionsRunDataSourceInputMessagessTemplate

Имя. Тип Description Обязательно По умолчанию
шаблон массив OpenAI.EasyInputMessage или OpenAI.EvalItem Да
type перечисление
Возможные значения: template
Да

OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams

Имя. Тип Description Обязательно По умолчанию
max_completion_tokens (максимальное количество токенов завершения) OpenAI.integer нет
усилия на рассуждение OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
формат_ответа OpenAI.ResponseFormatText или OpenAI.ResponseFormatJsonSchema или OpenAI.ResponseFormatJsonObject нет
seed OpenAI.integer нет 42
Температура OpenAI.numeric нет 1
инструменты массив OpenAI.ChatCompletionTool нет
top_p OpenAI.numeric нет 1

OpenAI.CreateEvalCustomDataSourceConfig

Объект CustomDataSourceConfig, определяющий схему источника данных, используемого для выполнения оценки. Эта схема используется для определения формы данных, которые будут:

  • Используется для определения критериев тестирования и
  • Какие данные требуются при создании запуска
Имя. Тип Description Обязательно По умолчанию
включить_пример_схемы булевый Должен ли eval ожидать, что вы заполните пространство имен образца (т. е. создавая ответы на основе вашего источника данных) нет
схема_элемента объект Схема JSON для каждой строки в источнике данных. Да
type перечисление Тип источника данных. Всегда custom.
Возможные значения: custom
Да

OpenAI.CreateEvalJsonlRunDataSource

Объект JsonlRunDataSource, указывающий JSONL-файл, соответствующий оценке.

Имя. Тип Description Обязательно По умолчанию
Источник OpenAI.EvalJsonlFileContentSource или OpenAI.EvalJsonlFileIdSource Определяет, что заполняет item пространство имен в источнике данных. Да
type перечисление Тип источника данных. Всегда jsonl.
Возможные значения: jsonl
Да

OpenAI.CreateEvalLogsDataSourceConfig

Конфигурация источника данных, указывающая свойство метаданных запроса журналов. Обычно это метаданные, такие как usecase=chatbot или prompt-version=v2и т. д.

Имя. Тип Description Обязательно По умолчанию
metadata объект Фильтры метаданных для источника данных журналов. нет
type перечисление Тип источника данных. Всегда logs.
Возможные значения: logs
Да

OpenAI.CreateEvalResponsesRunDataSource

Объект ResponsesRunDataSource, описывающий конфигурацию выборки модели.

Имя. Тип Description Обязательно По умолчанию
входные_сообщения OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate или OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference Используется при выборке из модели. Определяет структуру сообщений, передаваемых в модель. Может быть ссылка на предварительно созданную траекторию (т. е. item.input_trajectory) или шаблон с переменными ссылками на item пространство имен. нет
модель струна Имя модели, используемой для создания завершений (например, o3-mini). нет
параметры выборки OpenAI.CreateEvalResponsesRunDataSourceSamplingParams нет
Источник OpenAI.EvalJsonlFileContentSource или OpenAI.EvalJsonlFileIdSource или OpenAI.EvalResponsesSource Определяет, что заполняет item пространство имен в источнике данных этого запуска. Да
type перечисление Тип источника данных запуска. Всегда responses.
Возможные значения: responses
Да

OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference

Имя. Тип Description Обязательно По умолчанию
item_reference струна Да
type перечисление
Возможные значения: item_reference
Да

OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate

Имя. Тип Description Обязательно По умолчанию
шаблон массив объекта или OpenAI.EvalItem Да
type перечисление
Возможные значения: template
Да

OpenAI.CreateEvalResponsesRunDataSourceSamplingParams

Имя. Тип Description Обязательно По умолчанию
max_completion_tokens (максимальное количество токенов завершения) OpenAI.integer нет
усилия на рассуждение OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
seed OpenAI.integer нет 42
Температура OpenAI.numeric нет 1
текст OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText нет
инструменты массив OpenAI.Tool нет
top_p OpenAI.numeric нет 1

OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText

Имя. Тип Description Обязательно По умолчанию
format OpenAI.TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.
{ "type": "json_schema" } Настройка включает структурированные выходные данные,
это гарантирует, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в разделе

Формат по умолчанию — это { "type": "text" } без дополнительных параметров.
*Не рекомендуется для gpt-4o и более новых моделей:**
Установка { "type": "json_object" } включает старый режим JSON, который
гарантирует, что сообщение, которое создает модель, является допустимым JSON. С использованием json_schema
предпочтителен для моделей, поддерживающих его.
нет

OpenAI.CreateEvalStoredCompletionsDataSourceConfig

Не рекомендуется использовать LogsDataSourceConfig.

Имя. Тип Description Обязательно По умолчанию
metadata объект Фильтры метаданных для источника данных хранимых завершений. нет
type перечисление Тип источника данных. Всегда stored_completions.
Возможные значения: stored_completions
Да

OpenAI.CreateFineTuningJobRequest

Допустимые модели:

babbage-002
davinci-002
gpt-3.5-turbo
gpt-4o-mini
Имя. Тип Description Обязательно По умолчанию
гиперпараметры OpenAI.CreateFineTuningJobRequestHyperparameters нет
└batch_size string или OpenAI.integer нет авто
└learning_rate_multiplier learning_rate_multiplier string или OpenAI.numeric нет
└️ n_epochs string или OpenAI.integer нет авто
Интеграции массив OpenAI.CreateFineTuningJobRequestIntegrations Список интеграции для задания тонкой настройки. нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
method OpenAI.FineTuneMethod Метод, используемый для точной настройки. нет
модель строка (см. допустимые модели ниже) Имя модели для точной настройки. Вы можете выбрать один из них.
поддерживаемые модели.
Да
seed OpenAI.integer (nullable) нет
Суффикс Строка (нулевая) Строка до 64 символов, которые будут добавлены в имя настраиваемой модели.
Например, suffix в поле "Custom-model-name" будет производиться имя модели, например ft:gpt-4o-mini:openai:custom-model-name:7p4lURel.
Ограничения: minLength: 1, maxLength: 64
нет
файл_обучения струна Идентификатор отправленного файла, содержащего данные обучения.
Сведения о том, как отправить файл, см. в разделе "Отправка файла ".
Набор данных должен быть отформатирован в формате JSONL-файла. Кроме того, необходимо передать файл с целью fine-tune.
Содержимое файла должно отличаться в зависимости от того, использует ли модель чат, формат завершения или использует ли метод тонкой настройки формат предпочтения .
Подробнее смотрите руководство по fine-tuning для подробностей.
Да
Файл_валидации Строка (нулевая) Идентификатор отправленного файла, содержащего данные проверки.
Если этот файл предоставлен, данные используются для создания проверки
Метрики периодически во время тонкой настройки. Эти метрики можно просмотреть в
файл результатов тонкой настройки.
Одни и те же данные не должны присутствовать в файлах обучения и проверки.
Набор данных должен быть отформатирован в формате JSONL-файла. Необходимо отправить файл с целью fine-tune.
Подробнее смотрите руководство по fine-tuning для подробностей.
нет

OpenAI.CreateFineTuningJobRequestHyperparameters

Имя. Тип Description Обязательно По умолчанию
размер пакета string или OpenAI.integer нет
множитель скорости обучения string или OpenAI.numeric нет
количество эпох string или OpenAI.integer нет

OpenAI.CreateFineTuningJobRequestIntegrations

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: wandb
Да
wandb OpenAI.CreateFineTuningJobRequestIntegrationsWandb Да

OpenAI.CreateFineTuningJobRequestIntegrationsWandb

Имя. Тип Description Обязательно По умолчанию
Объект Строка (нулевая) нет
имя Строка (нулевая) нет
project струна Да
tags Массив строк нет

OpenAI.CreateResponseStreamingResponse

Тип: OpenAI.ResponseAudioDeltaEvent или OpenAI.ResponseAudioTranscriptDeltaEvent или OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent или OpenAI.ResponseCodeInterpreterCallInProgressEvent или OpenAI.ResponseCodeInterpreterCallInterpretingEvent или OpenAI.ResponseContentPartAddedEvent или OpenAI.ResponseCreatedEvent или OpenAI.ResponseErrorEvent или OpenAI.ResponseFileSearchCallInProgressEvent или OpenAI.ResponseFileSearchCallSearchingEvent или OpenAI.ResponseFunctionCallArgumentsDeltaEvent или OpenAI.ResponseInProgressEvent или OpenAI.ResponseFailedEvent или OpenAI.ResponseIncompleteEvent или OpenAI.ResponseOutputItemAddedEvent или OpenAI.ResponseReasoningSummaryPartAddedEvent или OpenAI.ResponseReasoningSummaryTextDeltaEvent или OpenAI.ResponseReasoningTextDeltaEvent или OpenAI.ResponseRefusalDeltaEvent или OpenAI.ResponseTextDeltaEvent или OpenAI.ResponseWebSearchCallInProgressEvent или OpenAI.ResponseWebSearchCallSearchingEvent или OpenAI.ResponseImageGenCallGeneratingEvent или OpenAI.ResponseImageGenCallInProgressEvent или OpenAI.ResponseImageGenCallPartialImageEvent или OpenAI.ResponseMCPCallArgumentsDeltaEvent или OpenAI.ResponseMCPCallFailedEvent или OpenAI.ResponseMCPCallInProgressEvent или OpenAI.ResponseMCPListToolsFailedEvent или OpenAI.ResponseMCPListToolsInProgressEvent или OpenAI.ResponseOutputTextAnnotationAddedEvent или OpenAI.ResponseQueuedEvent или OpenAI.ResponseCustomToolCallInputDeltaEvent или OpenAI.ResponseAudioDoneEvent или OpenAI.ResponseAudioTranscriptDoneEvent или OpenAI.ResponseCodeInterpreterCallCodeDoneEvent или OpenAI.ResponseCodeInterpreterCallCompletedEvent или OpenAI.ResponseCompletedEvent или OpenAI.ResponseContentPartDoneEvent или OpenAI.ResponseFileSearchCallCompletedEvent или OpenAI.ResponseFunctionCallArgumentsDoneEvent или OpenAI.ResponseOutputItemDoneEvent или OpenAI.ResponseReasoningSummaryPartDoneEvent или OpenAI.ResponseReasoningSummaryTextDoneEvent или OpenAI.ResponseReasoningTextDoneEvent или OpenAI.ResponseRefusalDoneEvent или OpenAI.ResponseTextDoneEvent или OpenAI.ResponseWebSearchCallCompletedEvent или OpenAI.ResponseImageGenCallCompletedEvent или OpenAI.ResponseMCPCallArgumentsDoneEvent или OpenAI.ResponseMCPCallCompletedEvent или OpenAI.ResponseMCPListToolsCompletedEvent или OpenAI.ResponseCustomToolCallInputDoneEvent

OpenAI.CustomGrammarFormatParam

Грамматика, определяемая пользователем.

Имя. Тип Description Обязательно По умолчанию
Определение струна Грамматическое определение. Да
syntax OpenAI.GrammarSyntax1 Да
type перечисление Грамматический формат. Всегда grammar.
Возможные значения: grammar
Да

OpenAI.CustomTextFormatParam

Неограниченный свободный текст.

Имя. Тип Description Обязательно По умолчанию
type перечисление Неограниченный формат текста. Всегда text.
Возможные значения: text
Да

OpenAI.CustomToolParam

Пользовательский инструмент, который обрабатывает вводные данные в заданном формате. Узнайте больше о кастомных инструментах

Имя. Тип Description Обязательно По умолчанию
описание струна Необязательное описание пользовательского инструмента, используемое для получения дополнительного контекста. нет
format OpenAI.CustomToolParamFormat Формат ввода для пользовательского инструмента. По умолчанию текст без ограничений. нет
└─ Тип OpenAI.CustomToolParamFormatType Да
имя струна Название пользовательского инструмента, используемого для его идентификации в вызовах инструментов. Да
type перечисление Тип кастомного инструмента. Всегда custom.
Возможные значения: custom
Да

OpenAI.CustomToolParamFormat

Формат ввода для пользовательского инструмента. По умолчанию текст без ограничений.

Дискриминация для OpenAI.CustomToolParamFormat

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
text OpenAI.CustomTextFormatParam
grammar OpenAI.CustomGrammarFormatParam
Имя. Тип Description Обязательно По умолчанию
type OpenAI.CustomToolParamFormatType Да

OpenAI.CustomToolParamFormatType

Недвижимость Ценность
Тип струна
Значения text
grammar

OpenAI.DeletedConversationResource

Имя. Тип Description Обязательно По умолчанию
удалено булевый Да
id струна Да
объект перечисление
Возможные значения: conversation.deleted
Да

OpenAI.DetailEnum

Недвижимость Ценность
Тип струна
Значения low
high
auto

OpenAI.DoubleClickAction

Действие двойного щелчка.

Имя. Тип Description Обязательно По умолчанию
type перечисление Указывает тип события. Для действия двойного щелчка это свойство всегда имеет значение double_click.
Возможные значения: double_click
Да
x OpenAI.integer Да
и OpenAI.integer Да

OpenAI.Drag

Действие перетаскивания.

Имя. Тип Description Обязательно По умолчанию
путь массив OpenAI.DragPoint Массив координат, представляющий путь действия перетаскивания. Координаты будут отображаться как массив
объектов, например
<br> [<br> { x: 100, y: 200 },<br> { x: 200, y: 300 }<br> ]<br>
Да
type перечисление Указывает тип события. Для действия перетаскивания это свойство имеет значение
всегда задано значение drag.
Возможные значения: drag
Да

OpenAI.DragPoint

Пара координат x/y, например { x: 100, y: 200 }.

Имя. Тип Description Обязательно По умолчанию
x OpenAI.integer Да
и OpenAI.integer Да

OpenAI.EasyInputMessage

Входное сообщение модели с ролью, указывающей на следование иерархии инструкций. Инструкции с ролью developer или system имеют приоритет над инструкциями с ролью user. Предполагается, что сообщения с assistant ролью были созданы моделью в предыдущих взаимодействиях.

Имя. Тип Description Обязательно По умолчанию
содержимое string или OpenAI.InputMessageContentList Текст, изображение или звуковой вход в модель, используемый для создания ответа.
Также может содержать предыдущие ответы помощника.
Да
роль перечисление Роль входных данных сообщения. Одно из user, assistantили system
developer.
Возможные значения: user, , assistantsystemdeveloper
Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип входных данных сообщения. Всегда message.
Возможные значения: message
Да

OpenAI.Error

Имя. Тип Description Обязательно По умолчанию
дополнительная информация объект нет
код Строка (нулевая) Да
debugInfo объект нет
details массив OpenAI.Error нет
сообщение струна Да
параметр Строка (нулевая) нет
type струна нет

OpenAI.EvalApiError

Объект, представляющий ответ об ошибке из API Eval.

Имя. Тип Description Обязательно По умолчанию
код струна Код ошибки. Да
сообщение струна Сообщение об ошибке. Да

OpenAI.EvalGraderLabelModel

Имя. Тип Description Обязательно По умолчанию
ввод массив OpenAI.EvalItem Да
labels Массив строк Метки, назначенные каждому элементу в оценке. Да
модель струна Модель, используемая для оценки. Должен поддерживать структурированные выходные данные. Да
имя струна Имя классировщика. Да
передача_меток Массив строк Метки, указывающие на успешный результат. Должно быть подмножеством этих меток. Да
type перечисление Тип объекта, который всегда label_modelявляется .
Возможные значения: label_model
Да

OpenAI.EvalGraderPython

Имя. Тип Description Обязательно По умолчанию
image_tag струна Тег изображения, используемый для скрипта Python. нет
имя струна Имя классировщика. Да
порог_прохода OpenAI.numeric нет
Источник струна Исходный код скрипта Python. Да
type перечисление Тип объекта, который всегда pythonявляется .
Возможные значения: python
Да

OpenAI.EvalGraderScoreModel

Имя. Тип Description Обязательно По умолчанию
ввод массив OpenAI.EvalItem Входные сообщения, вычисляемые классировщиком. Поддерживает текстовые, выходные тексты, входные изображения и блоки звукового содержимого ввода и могут включать строки шаблона. Да
модель струна Модель, используемая для оценки. Да
имя струна Имя классировщика. Да
порог_прохода OpenAI.numeric нет
диапазон массив OpenAI.numeric Диапазон оценки. По умолчанию — [0, 1]. нет
параметры выборки OpenAI.EvalGraderScoreModelSamplingParams нет
└max_completions_tokens OpenAI.integer (nullable) нет
└reasoning_effort OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
Начальное значение └️ OpenAI.integer (nullable) нет
└─ Температура OpenAI.numeric (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
type перечисление Тип объекта, который всегда score_modelявляется .
Возможные значения: score_model
Да

OpenAI.EvalGraderScoreModelSamplingParams

Имя. Тип Description Обязательно По умолчанию
max_completions_tokens OpenAI.integer (nullable) нет
усилия на рассуждение OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
seed OpenAI.integer (nullable) нет
Температура OpenAI.numeric (nullable) нет
top_p OpenAI.numeric (nullable) нет 1

OpenAI.EvalGraderStringCheck

Имя. Тип Description Обязательно По умолчанию
ввод струна Входной текст. Это может включать строки шаблона. Да
имя струна Имя классировщика. Да
Операция перечисление Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.
Возможные значения: eq, , nelikeilike
Да
Ссылка струна Текст ссылки. Это может включать строки шаблона. Да
type перечисление Тип объекта, который всегда string_checkявляется .
Возможные значения: string_check
Да

OpenAI.EvalGraderTextSimilarity

Имя. Тип Description Обязательно По умолчанию
метрика оценки перечисление Используемая метрика оценки. Один из cosine, fuzzy_matchbleu
gleu, meteor, rouge_1rouge_2rouge_3rouge_4rouge_5
или rouge_l.
Возможные значения: cosine, , fuzzy_matchbleugleumeteorrouge_1rouge_2rouge_3rouge_4rouge_5rouge_l
Да
ввод струна Текст, оцениваемый. Да
имя струна Имя классировщика. Да
порог_прохода OpenAI.numeric Да
Ссылка струна Текст, классируемый против. Да
type перечисление Тип классировщика.
Возможные значения: text_similarity
Да

OpenAI.EvalItem

Входное сообщение модели с ролью, указывающей на следование иерархии инструкций. Инструкции с ролью developer или system имеют приоритет над инструкциями с ролью user. Предполагается, что сообщения с assistant ролью были созданы моделью в предыдущих взаимодействиях.

Имя. Тип Description Обязательно По умолчанию
содержимое OpenAI.EvalItemContent Входные данные в модель могут содержать строки шаблона. Поддерживает текст, выходной текст, входные изображения и входной звук как один элемент или массив элементов. Да
роль перечисление Роль входных данных сообщения. Одно из user, assistantили system
developer.
Возможные значения: user, , assistantsystemdeveloper
Да
type перечисление Тип входных данных сообщения. Всегда message.
Возможные значения: message
нет

OpenAI.EvalItemContent

Входные данные в модель могут содержать строки шаблона. Поддерживает текст, выходной текст, входные изображения и входной звук как один элемент или массив элементов.

Тип: OpenAI.EvalItemContentItem или OpenAI.EvalItemContentArray

Входные данные в модель могут содержать строки шаблона. Поддерживает текст, выходной текст, входные изображения и входной звук как один элемент или массив элементов.

OpenAI.EvalItemContentArray

Список входных данных, каждый из которых может быть входным текстом, выходным текстом, входным изображением или входным звуковым объектом.

Массив: OpenAI.EvalItemContentItem

OpenAI.EvalItemContentItem

Один элемент содержимого: входной текст, выходной текст, входной образ или входной звук.

Тип: OpenAI.EvalItemContentText или OpenAI.EvalItemContentItemObject

Один элемент содержимого: входной текст, выходной текст, входной образ или входной звук.

OpenAI.EvalItemContentItemObject

Один элемент содержимого: входной текст, выходной текст, входной образ или входной звук.

Дискриминация для OpenAI.EvalItemContentItemObject

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
output_text OpenAI.EvalItemContentOutputText
input_image OpenAI.EvalItemInputImage
input_audio OpenAI.InputAudio
input_text OpenAI.EvalItemContentItemObjectInputTextContent
Имя. Тип Description Обязательно По умолчанию
type OpenAI.EvalItemContentItemObjectType Да

OpenAI.EvalItemContentItemObjectInputTextContent

Текстовые входные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые входные данные модели. Да
type перечисление Тип входного элемента. Всегда input_text.
Возможные значения: input_text
Да

OpenAI.EvalItemContentItemObjectType

Недвижимость Ценность
Тип струна
Значения input_text
output_text
input_image
input_audio

OpenAI.EvalItemContentOutputText

Текстовые выходные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые выходные данные модели. Да
type перечисление Тип выходного текста. Всегда output_text.
Возможные значения: output_text
Да

OpenAI.EvalItemContentText

Текстовые входные данные модели.

Тип: string.

OpenAI.EvalItemInputImage

Входной блок изображения, используемый в массивах содержимого EvalItem.

Имя. Тип Description Обязательно По умолчанию
detail струна Уровень детализации изображения, отправляемого в модель. Один из high, low, или auto. По умолчанию — auto. нет
ссылка_на_изображение струна URL-адрес входных данных изображения. Да
type перечисление Тип входных данных изображения. Всегда input_image.
Возможные значения: input_image
Да

OpenAI.EvalJsonlFileContentSource

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.EvalJsonlFileContentSourceContent Содержимое jsonl-файла. Да
type перечисление Тип источника jsonl. Всегда file_content.
Возможные значения: file_content
Да

OpenAI.EvalJsonlFileContentSourceContent

Имя. Тип Description Обязательно По умолчанию
item объект Да
образец объект нет

OpenAI.EvalJsonlFileIdSource

Имя. Тип Description Обязательно По умолчанию
id струна Идентификатор файла. Да
type перечисление Тип источника jsonl. Всегда file_id.
Возможные значения: file_id
Да

OpenAI.EvalResponsesSource

Объект EvalResponsesSource, описывающий конфигурацию источника данных запуска.

Имя. Тип Description Обязательно По умолчанию
создано после OpenAI.integer (nullable) нет
создано до OpenAI.integer (nullable) нет
instructions_search Строка (нулевая) нет
metadata Объект (нулируемый) нет
модель Строка (нулевая) нет
усилия на рассуждение OpenAI.ReasoningEffort (nullable) Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
Температура OpenAI.numeric (nullable) нет
инструменты Массив строк нет
top_p OpenAI.numeric (nullable) нет
type перечисление Тип источника данных запуска. Всегда responses.
Возможные значения: responses
Да
users Массив строк нет

OpenAI.EvalRunOutputItemSample

Имя. Тип Description Обязательно По умолчанию
ошибка OpenAI.EvalApiError Объект, представляющий ответ об ошибке из API Eval. Да
причина окончания струна Да
ввод массив EvalRunOutputItemSampleInput Да
max_completion_tokens (максимальное количество токенов завершения) OpenAI.integer Да
модель струна Да
output массив EvalRunOutputItemSampleOutputOutput Да
seed OpenAI.integer Да
Температура OpenAI.numeric Да
top_p OpenAI.numeric Да
использование OpenAI.EvalRunOutputItemSampleUsage Да

OpenAI.EvalRunOutputItemSampleUsage

Имя. Тип Description Обязательно По умолчанию
cached_tokens OpenAI.integer Да
токены завершения OpenAI.integer Да
подсказывающие токены OpenAI.integer Да
общее количество токенов OpenAI.integer Да

OpenAI.EvalRunPerModelUsage

Имя. Тип Description Обязательно По умолчанию
cached_tokens OpenAI.integer Да
токены завершения OpenAI.integer Да
invocation_count OpenAI.integer Да
model_name струна Да
подсказывающие токены OpenAI.integer Да
общее количество токенов OpenAI.integer Да

OpenAI.EvalRunPerTestingCriteriaResults

Имя. Тип Description Обязательно По умолчанию
ошибка OpenAI.integer Да
пройденный OpenAI.integer Да
критерии тестирования струна Да

OpenAI.EvalRunResultCounts

Имя. Тип Description Обязательно По умолчанию
Ошибка OpenAI.integer Да
ошибка OpenAI.integer Да
пройденный OpenAI.integer Да
итог OpenAI.integer Да

OpenAI.EvalStoredCompletionsSource

Конфигурация StoredCompletionsRunDataSource, описывающая набор фильтров

Имя. Тип Description Обязательно По умолчанию
создано после OpenAI.integer (nullable) нет
создано до OpenAI.integer (nullable) нет
limit OpenAI.integer (nullable) нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
модель Строка (нулевая) нет
type перечисление Тип источника . Всегда stored_completions.
Возможные значения: stored_completions
Да

OpenAI.FileCitationBody

Ссылка на файл.

Имя. Тип Description Обязательно По умолчанию
идентификатор_файла струна Идентификатор файла. Да
filename струна Имя файла, на который ссылается файл. Да
index OpenAI.integer Да
type перечисление Тип ссылки на файл. Всегда file_citation.
Возможные значения: file_citation
Да

OpenAI.FilePath

Путь к файлу.

Имя. Тип Description Обязательно По умолчанию
идентификатор_файла струна Идентификатор файла. Да
index OpenAI.integer Да
type перечисление Тип пути к файлу. Всегда file_path.
Возможные значения: file_path
Да

OpenAI.FileSearchTool

Средство, которое ищет соответствующее содержимое из отправленных файлов.

Имя. Тип Description Обязательно По умолчанию
filters OpenAI.Filters (допускает значение NULL) нет
максимальное_количество_результатов OpenAI.integer нет
опции рейтинга OpenAI.RankingOptions нет
└️ hybrid_search OpenAI.HybridSearchOptions Веса, контролирующие, как взаимное слияние рангов балансирует совпадения семантического вложения и редких совпадений ключевых слов при включённом гибридном поиске. нет
Рангер └️ OpenAI.RankerVersionType Рангер, используемый для поиска файлов. нет
└─ порог оценки OpenAI.numeric Пороговое значение оценки для поиска файлов — от 0 до 1. Числа ближе к 1 будут пытаться вернуть только наиболее релевантные результаты, но могут возвращать меньше результатов. нет
type перечисление Тип средства поиска файлов. Всегда file_search.
Возможные значения: file_search
Да
vector_store_ids Массив строк Идентификаторы векторных хранилищ для поиска. Да

OpenAI.FileSearchToolCallResults

Имя. Тип Description Обязательно По умолчанию
attributes OpenAI.VectorStoreFileAttributes (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга. Ключи — это строки
с максимальной длиной 64 символов. Значения — это строки с максимальным значением
длина 512 символов, логических значений или чисел.
нет
идентификатор_файла струна нет
filename струна нет
счёт число/номер нет
текст струна нет

OpenAI.Фильтры

Тип: OpenAI.ComparisonFilter или OpenAI.CompoundFilter

OpenAI.FineTuneDPOHyperparameters

Гиперпараметры, используемые для задания точной настройки DPO.

Имя. Тип Description Обязательно По умолчанию
размер пакета string или OpenAI.integer Количество примеров в каждом пакете. Более крупный размер пакета означает, что параметры модели обновляются реже, но с более низкой дисперсией. нет
Бета string или OpenAI.numeric Бета-значение для метода DPO. Более высокое бета-значение увеличит вес штрафа между политикой и эталонной моделью. нет
множитель скорости обучения string или OpenAI.numeric Коэффициент масштабирования для скорости обучения. Меньшая скорость обучения может оказаться полезной, чтобы избежать переобучения. нет
количество эпох string или OpenAI.integer Количество эпох, на которое следует обучать модель. Под эпохой понимается один полный цикл обработки набора данных для обучения. нет

OpenAI.FineTuneDPOMethod

Конфигурация для метода точной настройки DPO.

Имя. Тип Description Обязательно По умолчанию
гиперпараметры OpenAI.FineTuneDPOHyperparameters Гиперпараметры, используемые для задания точной настройки DPO. нет

OpenAI.FineTuneMethod

Метод, используемый для точной настройки.

Имя. Тип Description Обязательно По умолчанию
dpo OpenAI.FineTuneDPOMethod Конфигурация для метода точной настройки DPO. нет
усиление OpenAI.FineTuneReinforcementMethod Конфигурация для метода точной настройки с подкреплением. нет
Под наблюдением OpenAI.FineTuneSupervisedMethod Настройка защищенного метода тонкой настройки. нет
type перечисление Тип метода. supervisedЛибо , dpoлибо reinforcement.
Возможные значения: supervised, dporeinforcement
Да

OpenAI.FineTuneReinforcementHyperparameters

Гиперпараметры, используемые для задания точной настройки с подкреплением.

Имя. Тип Description Обязательно По умолчанию
размер пакета string или OpenAI.integer Количество примеров в каждом пакете. Более крупный размер пакета означает, что параметры модели обновляются реже, но с более низкой дисперсией. нет
compute_multiplier string или OpenAI.numeric Умножитель на объем вычислительных ресурсов, используемых для изучения пространства поиска во время обучения. нет
eval_interval string или OpenAI.integer Количество шагов обучения между запусками оценки. нет
eval_samples string или OpenAI.integer Количество примеров оценки для каждого шага обучения. нет
множитель скорости обучения string или OpenAI.numeric Коэффициент масштабирования для скорости обучения. Меньшая скорость обучения может оказаться полезной, чтобы избежать переобучения. нет
количество эпох string или OpenAI.integer Количество эпох, на которое следует обучать модель. Под эпохой понимается один полный цикл обработки набора данных для обучения. нет
усилия на рассуждение перечисление Уровень усилий по рассуждениям.
Возможные значения: default, , lowmediumhigh
нет

OpenAI.FineTuneReinforcementMethod

Конфигурация для метода точной настройки с подкреплением.

Имя. Тип Description Обязательно По умолчанию
грейдер OpenAI.GraderStringCheck или OpenAI.GraderTextSimilarity или OpenAI.GraderPython или OpenAI.GraderScoreModel или OpenAI.GraderMulti Классировщик, используемый для задания тонкой настройки. Да
гиперпараметры OpenAI.FineTuneReinforcementHyperparameters Гиперпараметры, используемые для задания точной настройки с подкреплением. нет

OpenAI.FineTuneSupervisedHyperparameters

Гиперпараметры, используемые для задания тонкой настройки.

Имя. Тип Description Обязательно По умолчанию
размер пакета string или OpenAI.integer Количество примеров в каждом пакете. Более крупный размер пакета означает, что параметры модели обновляются реже, но с более низкой дисперсией. нет
множитель скорости обучения string или OpenAI.numeric Коэффициент масштабирования для скорости обучения. Меньшая скорость обучения может оказаться полезной, чтобы избежать переобучения. нет
количество эпох string или OpenAI.integer Количество эпох, на которое следует обучать модель. Под эпохой понимается один полный цикл обработки набора данных для обучения. нет

OpenAI.FineTuneSupervisedMethod

Настройка защищенного метода тонкой настройки.

Имя. Тип Description Обязательно По умолчанию
гиперпараметры OpenAI.FineTuneSupervisedHyperparameters Гиперпараметры, используемые для задания тонкой настройки. нет

OpenAI.FineTuningIntegration

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип интеграции, включенной для задания тонкой настройки
Возможные значения: wandb
Да
wandb OpenAI.FineTuningIntegrationWandb Да
Сущность └️ Строка (нулевая) нет
└️ имя Строка (нулевая) нет
└─ Project струна Да
Теги └️ Массив строк нет

OpenAI.FineTuningIntegrationWandb

Имя. Тип Description Обязательно По умолчанию
Объект Строка (нулевая) нет
имя Строка (нулевая) нет
project струна Да
tags Массив строк нет

OpenAI.FineTuningJob

Объект fine_tuning.job представляет задание тонкой настройки, созданное с помощью API.

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для создания задания тонкой настройки. Да
ошибка OpenAI.FineTuningJobError (nullable) Да
└─ Код струна Да
Сообщение └️ струна Да
└─ параметр Строка (нулевая) Да
предполагаемое завершение целое число нет
fine_tuned_model Строка (нулевая) Да
завершено_в целое число Да
гиперпараметры OpenAI.FineTuningJobHyperparameters Да
└batch_size string или OpenAI.integer нет авто
└learning_rate_multiplier learning_rate_multiplier string или OpenAI.numeric нет
└️ n_epochs string или OpenAI.integer нет авто
id струна Идентификатор объекта, на который можно ссылаться в конечных точках API. Да
Интеграции массив OpenAI.FineTuningIntegration нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
method OpenAI.FineTuneMethod Метод, используемый для точной настройки. нет
модель струна Базовая модель, которая настраивается. Да
объект перечисление Тип объекта, который всегда является "fine_tuning.job".
Возможные значения: fine_tuning.job
Да
organization_id струна Организация, которая владеет заданием тонкой настройки. Да
файлы_результатов Массив строк Скомпилированные идентификаторы файлов результатов для задания тонкой настройки. Результаты можно получить с помощью API файлов. Да
seed OpenAI.integer Да
статус перечисление Текущее состояние задания тонкой настройки, которое может быть validating_filesлибо , , queued, runningsucceededfailedcancelledлибо .
Возможные значения: validating_files, queued, running, succeeded, failed, cancelled
Да
обученные_токены OpenAI.integer (nullable) Да
файл_обучения струна Идентификатор файла, используемый для обучения. Вы можете получить обучающие данные с помощью API файлов. Да
Файл_валидации Строка (нулевая) Да

OpenAI.FineTuningJobCheckpoint

Объект fine_tuning.job.checkpoint представляет контрольную точку модели для задания тонкой настройки, готового к использованию.

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для момента создания контрольной точки. Да
контрольная точка тонко настроенной модели струна Имя созданной модели точно настроенной контрольной точки. Да
идентификатор_задания_тончайшей_настройки струна Имя задания тонкой настройки, из которого был создан этот контрольный пункт. Да
id струна Идентификатор контрольной точки, на который можно ссылаться в конечных точках API. Да
metrics OpenAI.FineTuningJobCheckpointMetrics Да
└️ full_valid_loss OpenAI.numeric нет
└full_valid_mean_token_accuracy OpenAI.numeric нет
Шаг └️ OpenAI.numeric нет
└train_loss OpenAI.numeric нет
└train_mean_token_accuracy OpenAI.numeric нет
└️ valid_loss OpenAI.numeric нет
└valid_mean_token_accuracy valid_mean_token_accuracy OpenAI.numeric нет
объект перечисление Тип объекта, который всегда является "fine_tuning.job.checkpoint".
Возможные значения: fine_tuning.job.checkpoint
Да
номер_шага OpenAI.integer Да

OpenAI.FineTuningJobCheckpointMetrics

Имя. Тип Description Обязательно По умолчанию
full_valid_loss OpenAI.numeric нет
full_valid_mean_token_accuracy OpenAI.numeric нет
шаг OpenAI.numeric нет
train_loss OpenAI.numeric нет
train_mean_token_accuracy OpenAI.numeric нет
valid_loss OpenAI.numeric нет
valid_mean_token_accuracy OpenAI.numeric нет

OpenAI.FineTuningJobError

Имя. Тип Description Обязательно По умолчанию
код струна Да
сообщение струна Да
параметр Строка (нулевая) Да

OpenAI.FineTuningJobEvent

Объект события задания точной настройки

Имя. Тип Description Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для создания задания тонкой настройки. Да
данные OpenAI.FineTuningJobEventData нет
id струна Идентификатор объекта. Да
уровень перечисление Уровень журнала события.
Возможные значения: info, warnerror
Да
сообщение струна Сообщение события. Да
объект перечисление Тип объекта, который всегда является "fine_tuning.job.event".
Возможные значения: fine_tuning.job.event
Да
type перечисление Тип события.
Возможные значения: message, metrics
нет

OpenAI.FineTuningJobEventData

Тип: объект

OpenAI.FineTuningJobHyperparameters

Имя. Тип Description Обязательно По умолчанию
размер пакета string или OpenAI.integer нет
множитель скорости обучения string или OpenAI.numeric нет
количество эпох string или OpenAI.integer нет

OpenAI.FunctionAndCustomToolCallOutput

Дискриминация для OpenAI.FunctionAndCustomToolCallOutput

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
input_text OpenAI.FunctionAndCustomToolCallOutputInputTextContent
input_image OpenAI.FunctionAndCustomToolCallOutputInputImageContent
input_file OpenAI.FunctionAndCustomToolCallOutputInputFileContent
Имя. Тип Description Обязательно По умолчанию
type OpenAI.FunctionAndCustomToolCallOutputType Да

OpenAI.FunctionAndCustomToolCallOutputInputFileContent

Файл в качестве входных данных для модели.

Имя. Тип Description Обязательно По умолчанию
file_data струна Содержимое файла, отправляемого в модель. нет
идентификатор_файла Строка (нулевая) нет
file_url струна URL файла, который должен быть отправлен модели. нет
filename струна Имя файла, отправляемого в модель. нет
type перечисление Тип входного элемента. Всегда input_file.
Возможные значения: input_file
Да

OpenAI.FunctionAndCustomToolCallOutputInputImageContent

Изображение в качестве входных данных для модели. Узнайте о входных изображениях.

Имя. Тип Description Обязательно По умолчанию
detail OpenAI.ImageDetail Да
идентификатор_файла Строка (нулевая) нет
ссылка_на_изображение струна нет
type перечисление Тип входного элемента. Всегда input_image.
Возможные значения: input_image
Да

OpenAI.FunctionAndCustomToolCallOutputInputTextContent

Текстовые входные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые входные данные модели. Да
type перечисление Тип входного элемента. Всегда input_text.
Возможные значения: input_text
Да

OpenAI.FunctionAndCustomToolCallOutputType

Недвижимость Ценность
Тип струна
Значения input_text
input_image
input_file

OpenAI.FunctionCallItemStatus

Недвижимость Ценность
Тип струна
Значения in_progress
completed
incomplete

OpenAI.FunctionObject

Имя. Тип Description Обязательно По умолчанию
описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
имя струна Имя вызываемой функции. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. Да
параметры OpenAI.FunctionParameters Параметры, которые принимают функции, описаны как объект схемы JSON. См. guide для примеров и справочник JSON Schema для документации по формату.
Опущение parameters определяет функцию с пустым списком параметров.
нет
строгий Булев (нулируемый) нет

OpenAI.FunctionParameters

Параметры, которые принимают функции, описаны как объект схемы JSON. См. guide для примеров и справочник JSON Schema для документации по формату. Опущение parameters определяет функцию с пустым списком параметров.

Тип: объект

OpenAI.FunctionShellAction

Выполните команду оболочки.

Имя. Тип Description Обязательно По умолчанию
commands Массив строк Да
max_output_length OpenAI.integer (nullable) Да
таймаут_мс OpenAI.integer (nullable) Да

OpenAI.FunctionShellActionParam

Команды и ограничения, описывающие, как запускать вызов инструмента shell.

Имя. Тип Description Обязательно По умолчанию
commands Массив строк Приказал команды shell для запуска среды выполнения. Да
max_output_length OpenAI.integer (nullable) нет
таймаут_мс OpenAI.integer (nullable) нет

OpenAI.FunctionShellCallItemStatus

Значения статуса, указанные для вызовов оболочки.

Недвижимость Ценность
Тип струна
Значения in_progress
completed
incomplete

OpenAI.FunctionShellCallOutputContent

Содержимое выходных данных вызова средства оболочки, которое было создано.

Имя. Тип Description Обязательно По умолчанию
создано пользователем струна Идентификатор субъекта, создавшего элемент. нет
результат OpenAI.FunctionShellCallOutputOutcome Представляет результат выхода (с кодом выхода) или результат ожидания для блока вывода вызова оболочки. Да
└─ Тип OpenAI.FunctionShellCallOutputOutcomeType Да
Stderr струна Стандартные выходные данные ошибок, которые были записаны. Да
stdout струна Стандартные выходные данные, которые были записаны. Да

OpenAI.FunctionShellCallOutputContentParam

Захвачен stdout и stderr для части выхода shell tool call.

Имя. Тип Description Обязательно По умолчанию
результат OpenAI.FunctionShellCallOutputOutcomeParam Исход или тайм-аут, связанный с этим шелл-коллом. Да
└─ Тип OpenAI.FunctionShellCallOutputOutcomeParamType Да
Stderr струна Зафиксирован выход stderr для shell-вызова.
Ограничения: maxLength: 10485760
Да
stdout струна Зафиксирован выход stdout для shell call.
Ограничения: maxLength: 10485760
Да

OpenAI.FunctionShellCallOutputExitOutcome

Указывает, что команды shell завершились и вернули код выхода.

Имя. Тип Description Обязательно По умолчанию
exit_code OpenAI.integer Да
type перечисление Тип результата. Всегда exit.
Возможные значения: exit
Да

OpenAI.FunctionShellCallOutputExitOutcomeParam

Указывает, что команды shell завершились и вернули код выхода.

Имя. Тип Description Обязательно По умолчанию
exit_code OpenAI.integer Да
type перечисление Тип результата. Всегда exit.
Возможные значения: exit
Да

OpenAI.FunctionShellCallOutputOutcome

Представляет результат выхода (с кодом выхода) или результат ожидания для блока вывода вызова оболочки.

Дискриминация для OpenAI.FunctionShellCallOutputOutcome

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
timeout OpenAI.FunctionShellCallOutputTimeoutOutcome
exit OpenAI.FunctionShellCallOutputExitOutcome
Имя. Тип Description Обязательно По умолчанию
type OpenAI.FunctionShellCallOutputOutcomeType Да

OpenAI.FunctionShellCallOutputOutcomeParam

Исход или тайм-аут, связанный с этим шелл-коллом.

Дискриминация для OpenAI.FunctionShellCallOutputOutcomeParam

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
timeout OpenAI.FunctionShellCallOutputTimeoutOutcomeParam
exit OpenAI.FunctionShellCallOutputExitOutcomeParam
Имя. Тип Description Обязательно По умолчанию
type OpenAI.FunctionShellCallOutputOutcomeParamType Да

OpenAI.FunctionShellCallOutputOutcomeParamType

Недвижимость Ценность
Тип струна
Значения timeout
exit

OpenAI.FunctionShellCallOutputOutcomeType

Недвижимость Ценность
Тип струна
Значения timeout
exit

OpenAI.FunctionShellCallOutputTimeoutOutcome

Указывает, что вызов оболочки превысил установленный лимит времени.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип результата. Всегда timeout.
Возможные значения: timeout
Да

OpenAI.FunctionShellCallOutputTimeoutOutcomeParam

Указывает, что вызов оболочки превысил установленный лимит времени.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип результата. Всегда timeout.
Возможные значения: timeout
Да

OpenAI.FunctionShellToolParam

Инструмент, позволяющий модели выполнять команды оболочки.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип снаряда-снаряда. Всегда shell.
Возможные значения: shell
Да

OpenAI.FunctionTool

Определяет функцию в собственном коде, которую модель может вызвать.

Имя. Тип Description Обязательно По умолчанию
описание Строка (нулевая) нет
имя струна Имя вызываемой функции. Да
параметры Объект (нулируемый) Да
строгий Булев (нулируемый) Да
type перечисление Тип средства функции. Всегда function.
Возможные значения: function
Да

OpenAI.GraderLabelModel

Объект LabelModelGrader, использующий модель для назначения меток каждому элементу в оценке.

Имя. Тип Description Обязательно По умолчанию
ввод массив OpenAI.EvalItem Да
labels Массив строк Метки, назначенные каждому элементу в оценке. Да
модель струна Модель, используемая для оценки. Должен поддерживать структурированные выходные данные. Да
имя струна Имя классировщика. Да
передача_меток Массив строк Метки, указывающие на успешный результат. Должно быть подмножеством этих меток. Да
type перечисление Тип объекта, который всегда label_modelявляется .
Возможные значения: label_model
Да

OpenAI.GraderMulti

Объект MultiGrader объединяет выходные данные нескольких классировщиков для создания одной оценки.

Имя. Тип Description Обязательно По умолчанию
calculate_output струна Формула для вычисления выходных данных на основе результатов оценки. Да
Грейдеры OpenAI.GraderStringCheck или OpenAI.GraderTextSimilarity или OpenAI.GraderPython или OpenAI.GraderScoreModel или OpenAI.GraderLabelModel Да
имя струна Имя классировщика. Да
type перечисление Тип объекта, который всегда multiявляется .
Возможные значения: multi
Да

OpenAI.GraderPython

Объект PythonGrader, который запускает скрипт Python на входных данных.

Имя. Тип Description Обязательно По умолчанию
image_tag струна Тег изображения, используемый для скрипта Python. нет
имя струна Имя классировщика. Да
Источник струна Исходный код скрипта Python. Да
type перечисление Тип объекта, который всегда pythonявляется .
Возможные значения: python
Да

OpenAI.GraderScoreModel

Объект ScoreModelGrader, использующий модель для назначения оценки входным данным.

Имя. Тип Description Обязательно По умолчанию
ввод массив OpenAI.EvalItem Входные сообщения, вычисляемые классировщиком. Поддерживает текстовые, выходные тексты, входные изображения и блоки звукового содержимого ввода и могут включать строки шаблона. Да
модель струна Модель, используемая для оценки. Да
имя струна Имя классировщика. Да
диапазон массив OpenAI.numeric Диапазон оценки. По умолчанию — [0, 1]. нет
параметры выборки OpenAI.EvalGraderScoreModelSamplingParams нет
└max_completions_tokens OpenAI.integer (nullable) нет
└reasoning_effort OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
Начальное значение └️ OpenAI.integer (nullable) нет
└─ Температура OpenAI.numeric (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
type перечисление Тип объекта, который всегда score_modelявляется .
Возможные значения: score_model
Да

OpenAI.GraderStringCheck

Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции.

Имя. Тип Description Обязательно По умолчанию
ввод струна Входной текст. Это может включать строки шаблона. Да
имя струна Имя классировщика. Да
Операция перечисление Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.
Возможные значения: eq, , nelikeilike
Да
Ссылка струна Текст ссылки. Это может включать строки шаблона. Да
type перечисление Тип объекта, который всегда string_checkявляется .
Возможные значения: string_check
Да

OpenAI.GraderTextSimilarity

Объект TextSimilarityGrader, который классирует текст на основе метрик сходства.

Имя. Тип Description Обязательно По умолчанию
метрика оценки перечисление Используемая метрика оценки. Один из cosine, fuzzy_matchbleu
gleu, meteor, rouge_1rouge_2rouge_3rouge_4rouge_5
или rouge_l.
Возможные значения: cosine, , fuzzy_matchbleugleumeteorrouge_1rouge_2rouge_3rouge_4rouge_5rouge_l
Да
ввод струна Текст, оцениваемый. Да
имя струна Имя классировщика. Да
Ссылка струна Текст, классируемый против. Да
type перечисление Тип классировщика.
Возможные значения: text_similarity
Да

OpenAI.GrammarSyntax1

Недвижимость Ценность
Тип струна
Значения lark
regex

OpenAI.HybridSearchOptions

Имя. Тип Description Обязательно По умолчанию
embedding_weight OpenAI.numeric Да
text_weight OpenAI.numeric Да

OpenAI.ImageDetail

Недвижимость Ценность
Тип струна
Значения low
high
auto

OpenAI.ImageGenTool

Инструмент, который генерирует изображения с использованием моделей GPT.

Допустимые модели:

gpt-image-1
gpt-image-1-mini
Имя. Тип Description Обязательно По умолчанию
фон перечисление Тип фона для созданного изображения. Один из transparent,
opaque или auto. По умолчанию: auto.
Возможные значения: transparent, opaqueauto
нет
Входная точность OpenAI.InputFidelity (nullable) Контролируйте усилия модели для соответствия стилю и особенностям, в частности, чертам лица, на входных изображениях. Этот параметр поддерживается только для gpt-image-1. Неподдерживаемый для gpt-image-1-mini. Поддерживает high и low. По умолчанию — low. нет
входная маска изображения OpenAI.ImageGenToolInputImageMask нет
└ file_id струна нет
└image_url струна нет
модель строка (см. допустимые модели ниже) нет
moderation перечисление Уровень модерации для созданного образа. По умолчанию: auto.
Возможные значения: auto, low
нет
сжатие вывода OpenAI.integer нет 100
формат_выходных_данных перечисление Формат выходных данных созданного изображения. Один из png, webpили
jpeg. По умолчанию: png.
Возможные значения: png, webpjpeg
нет
частичные_изображения OpenAI.integer нет
качество перечисление Качество созданного изображения. Один из low, mediumhigh
или auto. По умолчанию: auto.
Возможные значения: low, , mediumhighauto
нет
size перечисление Размер созданного изображения. Один из 1024x1024, 1024x1536
1536x1024 или auto. По умолчанию: auto.
Возможные значения: 1024x1024, , 1024x15361536x1024auto
нет
type перечисление Тип средства создания изображений. Всегда image_generation.
Возможные значения: image_generation
Да

OpenAI.ImageGenToolInputImageMask

Имя. Тип Description Обязательно По умолчанию
идентификатор_файла струна нет
ссылка_на_изображение струна нет

OpenAI.IncludeEnum

Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения:

  • web_search_call.action.sources: включите источники вызова средства поиска в Интернете.
  • code_interpreter_call.outputs: включает выходные данные выполнения кода Python в элементах вызова средства интерпретатора кода кода.
  • computer_call_output.output.image_url: добавьте URL-адреса изображения из результата выполнения команды на компьютере.
  • file_search_call.results: включите результаты поиска запроса средства поиска файлов.
  • message.input_image.image_url: включите URL-адреса изображения из входного сообщения.
  • message.output_text.logprobs: включите журналы с сообщениями помощника.
  • reasoning.encrypted_content: включает зашифрованную версию токенов рассуждения в выходных данных элемента. Это позволяет использовать элементы рассуждений в многоэтапных беседах при статическом использовании API ответов (например, если store параметр задан false, или когда организация зарегистрирована в программе нулевого хранения данных).
Недвижимость Ценность
Описание Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения:
  • web_search_call.action.sources: включите источники вызова средства поиска в Интернете.
  • code_interpreter_call.outputs: включает выходные данные выполнения кода Python в элементах вызова средства интерпретатора кода кода.
  • computer_call_output.output.image_url: добавьте URL-адреса изображения из результата выполнения команды на компьютере.
  • file_search_call.results: включите результаты поиска запроса средства поиска файлов.
  • message.input_image.image_url: включите URL-адреса изображения из входного сообщения.
  • message.output_text.logprobs: включите журналы с сообщениями помощника.
  • reasoning.encrypted_content: включает зашифрованную версию токенов рассуждения в выходных данных элемента. Это позволяет использовать элементы рассуждений в многоэтапных беседах при статическом использовании API ответов (например, если store параметр задан false, или когда организация зарегистрирована в программе нулевого хранения данных). | | Тип | string | | Значения | file_search_call.results
    web_search_call.results
    web_search_call.action.sources
    message.input_image.image_url
    computer_call_output.output.image_url
    code_interpreter_call.outputs
    reasoning.encrypted_content
    message.output_text.logprobs
    memory_search_call.results |

OpenAI.InputAudio

Аудиовход для модели.

Имя. Тип Description Обязательно По умолчанию
input_audio OpenAI.InputAudioInputAudioAudio Да
type перечисление Тип входного элемента. Всегда input_audio.
Возможные значения: input_audio
Да

OpenAI.InputAudioInputAudioAudio

Имя. Тип Description Обязательно По умолчанию
данные струна Да
format перечисление
Возможные значения: mp3, wav
Да

OpenAI.InputContent

Дискриминация для OpenAI.InputContent

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
input_text OpenAI.InputContentInputTextContent
input_image OpenAI.InputContentInputImageContent
input_file OpenAI.InputContentInputFileContent
Имя. Тип Description Обязательно По умолчанию
type OpenAI.InputContentType Да

OpenAI.InputContentInputFileContent

Файл в качестве входных данных для модели.

Имя. Тип Description Обязательно По умолчанию
file_data струна Содержимое файла, отправляемого в модель. нет
идентификатор_файла Строка (нулевая) нет
file_url струна URL файла, который должен быть отправлен модели. нет
filename струна Имя файла, отправляемого в модель. нет
type перечисление Тип входного элемента. Всегда input_file.
Возможные значения: input_file
Да

OpenAI.InputContentInputImageContent

Изображение в качестве входных данных для модели. Узнайте о входных изображениях.

Имя. Тип Description Обязательно По умолчанию
detail OpenAI.ImageDetail Да
идентификатор_файла Строка (нулевая) нет
ссылка_на_изображение струна нет
type перечисление Тип входного элемента. Всегда input_image.
Возможные значения: input_image
Да

OpenAI.InputContentInputTextContent

Текстовые входные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые входные данные модели. Да
type перечисление Тип входного элемента. Всегда input_text.
Возможные значения: input_text
Да

OpenAI.InputContentType

Недвижимость Ценность
Тип струна
Значения input_text
input_image
input_file

OpenAI.InputFidelity

Контролируйте усилия модели для соответствия стилю и особенностям, в частности, чертам лица, на входных изображениях. Этот параметр поддерживается только для gpt-image-1. Неподдерживаемый для gpt-image-1-mini. Поддерживает high и low. По умолчанию — low.

Недвижимость Ценность
Тип струна
Значения high
low

OpenAI.InputFileContent

Файл в качестве входных данных для модели.

Имя. Тип Description Обязательно По умолчанию
file_data струна Содержимое файла, отправляемого в модель. нет
идентификатор_файла Строка (нулевая) нет
file_url струна URL файла, который должен быть отправлен модели. нет
filename струна Имя файла, отправляемого в модель. нет
type перечисление Тип входного элемента. Всегда input_file.
Возможные значения: input_file
Да

OpenAI.InputFileContentParam

Файл в качестве входных данных для модели.

Имя. Тип Description Обязательно По умолчанию
file_data Строка (нулевая) нет
идентификатор_файла Строка (нулевая) нет
file_url струна нет
filename Строка (нулевая) нет
type перечисление Тип входного элемента. Всегда input_file.
Возможные значения: input_file
Да

OpenAI.InputImageContent

Изображение в качестве входных данных для модели. Узнайте о входных изображениях.

Имя. Тип Description Обязательно По умолчанию
detail OpenAI.ImageDetail Да
идентификатор_файла Строка (нулевая) нет
ссылка_на_изображение струна нет
type перечисление Тип входного элемента. Всегда input_image.
Возможные значения: input_image
Да

OpenAI.InputImageContentParamAutoParam

Изображение в качестве входных данных для модели. Узнайте о входах image input

Имя. Тип Description Обязательно По умолчанию
detail OpenAI.DetailEnum (nullable) нет
идентификатор_файла Строка (нулевая) нет
ссылка_на_изображение струна нет
type перечисление Тип входного элемента. Всегда input_image.
Возможные значения: input_image
Да

OpenAI.InputItem

Элемент, представляющий часть контекста для ответа, создаваемого моделью. Может содержать текст, изображения и звуковые входные данные, а также предыдущие ответы помощника и выходные данные вызова средства.

Дискриминация для OpenAI.InputItem

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
message OpenAI.EasyInputMessage
item_reference OpenAI.ItemReferenceParam
output_message OpenAI.InputItemOutputMessage
file_search_call OpenAI.InputItemFileSearchToolCall
computer_call OpenAI.InputItemComputerToolCall
computer_call_output OpenAI.InputItemComputerCallOutputItemParam
web_search_call OpenAI.InputItemWebSearchToolCall
function_call OpenAI.InputItemFunctionToolCall
function_call_output OpenAI.InputItemFunctionCallOutputItemParam
reasoning OpenAI.InputItemReasoningItem
compaction OpenAI.InputItemCompactionSummaryItemParam
image_generation_call OpenAI.InputItemImageGenToolCall
code_interpreter_call OpenAI.InputItemCodeInterpreterToolCall
local_shell_call OpenAI.InputItemLocalShellToolCall
local_shell_call_output OpenAI.InputItemLocalShellToolCallOutput
shell_call OpenAI.InputItemFunctionShellCallItemParam
shell_call_output OpenAI.InputItemFunctionShellCallOutputItemParam
apply_patch_call OpenAI.InputItemApplyPatchToolCallItemParam
apply_patch_call_output OpenAI.InputItemApplyPatchToolCallOutputItemParam
mcp_list_tools OpenAI.InputItemMcpListTools
mcp_approval_request OpenAI.InputItemMcpApprovalRequest
mcp_approval_response OpenAI.InputItemMcpApprovalResponse
mcp_call OpenAI.InputItemMcpToolCall
custom_tool_call_output OpenAI.InputItemCustomToolCallOutput
custom_tool_call OpenAI.InputItemCustomToolCall
Имя. Тип Description Обязательно По умолчанию
type OpenAI.InputItemType Да

OpenAI.InputItemApplyPatchToolCallItemParam

Вызов инструмента, представляющий запрос на создание, удаление или обновление файлов с помощью дифференциальных патчей.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
Операция OpenAI.ApplyPatchOperationParam Одна из create_file, delete_file или update_file операций, поставляемых на инструмент apply_patch. Да
└─ Тип OpenAI.ApplyPatchOperationParamType Да
статус OpenAI.ApplyPatchCallStatusParam Значения статуса, указанные для apply_patch вызовов инструментов. Да
type перечисление Тип элемента. Всегда apply_patch_call.
Возможные значения: apply_patch_call
Да

OpenAI.InputItemApplyPatchToolCallOutputItemParam

Потоковый выход, исходящий через вызов инструмента apply patch.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
output Строка (нулевая) нет
статус OpenAI.ApplyPatchCallOutputStatusParam Значения результатов, представленные для выходов apply_patch вызовов инструмента. Да
type перечисление Тип элемента. Всегда apply_patch_call_output.
Возможные значения: apply_patch_call_output
Да

OpenAI.InputItemCodeInterpreterToolCall

Вызов инструмента для выполнения кода.

Имя. Тип Description Обязательно По умолчанию
код Строка (нулевая) Да
container_id струна Идентификатор контейнера, используемого для запуска кода. Да
id струна Уникальный идентификатор вызова средства интерпретатора кода. Да
выходные данные массив OpenAI.CodeInterpreterOutputLogs или OpenAI.CodeInterpreterOutputImage Да
статус перечисление Состояние вызова средства интерпретатора кода. Допустимые значения: in_progress, completed, incomplete, interpreting, и failed.
Возможные значения: in_progress, completed, incomplete, interpreting, failed
Да
type перечисление Тип вызова средства интерпретатора кода. Всегда code_interpreter_call.
Возможные значения: code_interpreter_call
Да

OpenAI.InputItemCompactionSummaryItemParam

Элемент уплотнения, сгенерированный APIv1/responses/compact.

Имя. Тип Description Обязательно По умолчанию
encrypted_content струна Зашифрованное содержимое сводки сжатия.
Ограничения: maxLength: 10485760
Да
id Строка (нулевая) нет
type перечисление Тип элемента. Всегда compaction.
Возможные значения: compaction
Да

OpenAI.InputItemComputerCallOutputItemParam

Выходные данные запуска компьютерного инструмента.

Имя. Тип Description Обязательно По умолчанию
acknowledged_safety_checks массив OpenAI.ComputerCallSafetyCheckParam нет
call_id струна Идентификатор вызова средства компьютера, создающего выходные данные.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
output OpenAI.ComputerScreenshotImage Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера. Да
статус OpenAI.FunctionCallItemStatus (nullable) нет
type перечисление Тип выходных данных компьютерного средства вызова. Всегда computer_call_output.
Возможные значения: computer_call_output
Да

OpenAI.InputItemComputerToolCall

Вызов инструмента для работы с компьютером. См. руководство по использованию компьютеров компьютера для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.ComputerAction Да
call_id струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. Да
id струна Уникальный идентификатор вызова компьютера. Да
pending_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Ожидающие проверки безопасности для компьютеризированного процесса. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип компьютерного вызова. Всегда computer_call.
Возможные значения: computer_call
Да

OpenAI.InputItemCustomToolCall

Вызов пользовательского инструмента, созданного моделью.

Имя. Тип Description Обязательно По умолчанию
call_id струна Идентификатор, используемый для сопоставления этого пользовательского вызова инструмента с выходом вызова инструмента. Да
id струна Уникальный идентификатор пользовательского инструмента вызывает платформу OpenAI. нет
ввод струна Вход для пользовательского вызова инструмента, генерируемого моделью. Да
имя струна Имя вызываемого пользовательского инструмента. Да
type перечисление Тип пользовательского вызова инструмента. Всегда custom_tool_call.
Возможные значения: custom_tool_call
Да

OpenAI.InputItemCustomToolCallOutput

Вывод пользовательского вызова инструмента из вашего кода возвращается в модель.

Имя. Тип Description Обязательно По умолчанию
call_id струна Идентификатор вызова, используемый для сопоставления этого вывода пользовательского вызова инструмента в пользовательский вызов инструмента. Да
id струна Уникальный идентификатор вывода пользовательского вызова инструмента на платформе OpenAI. нет
output строка или массив OpenAI.FunctionAndCustomToolCallOutput Результат из пользовательского вызова инструмента, сгенерированного вашим кодом.
Это может быть строка или список выходного контента.
Да
type перечисление Тип вывода пользовательского вызова инструмента. Всегда custom_tool_call_output.
Возможные значения: custom_tool_call_output
Да

OpenAI.InputItemFileSearchToolCall

Результаты вызова средства поиска файлов. Смотрите руководство по поиску файл для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова средства поиска файлов. Да
queries Массив строк Запросы, используемые для поиска файлов. Да
results массив OpenAI.FileSearchToolCallResults нет
статус перечисление Состояние вызова средства поиска файлов. Один из in_progress,
searching, incomplete или failed,
Возможные значения: in_progress, searching, completed, incomplete, failed
Да
type перечисление Тип вызова средства поиска файлов. Всегда file_search_call.
Возможные значения: file_search_call
Да

OpenAI.InputItemFunctionCallOutputItemParam

Выходные данные вызова инструмента функции.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова функции, созданного моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
output строка или массив OpenAI.InputTextContentParam или OpenAI.InputImageContentParamAutoParam или OpenAI.InputFileContentParam Текст, изображение или файл вывода вызова инструмента функции. Да
статус OpenAI.FunctionCallItemStatus (nullable) нет
type перечисление Тип выходных данных вызова функции. Всегда function_call_output.
Возможные значения: function_call_output
Да

OpenAI.InputItemFunctionShellCallItemParam

Инструмент, представляющий запрос на выполнение одной или нескольких команд shell.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.FunctionShellActionParam Команды и ограничения, описывающие, как запускать вызов инструмента shell. Да
Команды └️ Массив строк Приказал команды shell для запуска среды выполнения. Да
└max_output_length OpenAI.integer (nullable) нет
└️ timeout_ms OpenAI.integer (nullable) нет
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
статус OpenAI.FunctionShellCallItemStatus (nullable) Значения статуса, указанные для вызовов оболочки. нет
type перечисление Тип элемента. Всегда shell_call.
Возможные значения: shell_call
Да

OpenAI.InputItemFunctionShellCallOutputItemParam

Потоковые выходные элементы, исходящие от вызова инструмента shell.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
max_output_length OpenAI.integer (nullable) нет
output массив OpenAI.FunctionShellCallOutputContentParam Зафиксированы куски выработки stdout и stderr, а также связанные с ними результаты. Да
type перечисление Тип элемента. Всегда shell_call_output.
Возможные значения: shell_call_output
Да

OpenAI.InputItemFunctionToolCall

Вызов средства для запуска функции. См. руководство по вызову функций function call для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON аргументов для передачи функции. Да
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор вызова средства функции. нет
имя струна Имя выполняемой функции. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип вызова инструмента функции. Всегда function_call.
Возможные значения: function_call
Да

OpenAI.InputItemImageGenToolCall

Запрос на создание изображения, сделанный моделью.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова генерации изображений. Да
результат Строка (нулевая) Да
статус перечисление Статус вызова генерации изображений.
Возможные значения: in_progress, , completedgeneratingfailed
Да
type перечисление Тип вызова для генерации изображений. Всегда image_generation_call.
Возможные значения: image_generation_call
Да

OpenAI.InputItemLocalShellToolCall

Вызов средства для выполнения команды в локальной оболочке.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.LocalShellExecAction Выполните команду оболочки на сервере. Да
call_id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
id струна Уникальный идентификатор локального вызова shell. Да
статус перечисление Статус местного звонка shell.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип локального вызова shell. Всегда local_shell_call.
Возможные значения: local_shell_call
Да

OpenAI.InputItemLocalShellToolCallOutput

Выходные данные вызова локального средства оболочки.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
output струна Строка JSON выходных данных вызова локального средства оболочки. Да
статус перечисление
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выхода локального вызова инструмента shell. Всегда local_shell_call_output.
Возможные значения: local_shell_call_output
Да

OpenAI.InputItemMcpApprovalRequest

Запрос на одобрение человеком вызова инструмента.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON с аргументами для средства. Да
id струна Уникальный идентификатор запроса на одобрение. Да
имя струна Имя запускаемого средства. Да
метка сервера струна Метка сервера MCP, выполняющего запрос. Да
type перечисление Тип элемента. Всегда mcp_approval_request.
Возможные значения: mcp_approval_request
Да

OpenAI.InputItemMcpApprovalResponse

Ответ на запрос на утверждение MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id струна Идентификатор запроса на утверждение, на который даётся ответ. Да
Утвердить булевый Будет ли утвержден запрос. Да
id Строка (нулевая) нет
причина Строка (нулевая) нет
type перечисление Тип элемента. Всегда mcp_approval_response.
Возможные значения: mcp_approval_response
Да

OpenAI.InputItemMcpListTools

Список средств, доступных на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор списка. Да
метка сервера струна Метка сервера MCP. Да
инструменты массив OpenAI.MCPListToolsTools Средства, доступные на сервере. Да
type перечисление Тип элемента. Всегда mcp_list_tools.
Возможные значения: mcp_list_tools
Да

OpenAI.InputItemMcpToolCall

Вызов инструмента на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id Строка (нулевая) нет
arguments струна Строка JSON аргументов, переданных средству. Да
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор вызова инструмента. Да
имя струна Имя запущенного инструмента. Да
output Строка (нулевая) нет
метка сервера струна Метка сервера MCP, на котором работает инструмент. Да
статус OpenAI.MCPToolCallStatus нет
type перечисление Тип элемента. Всегда mcp_call.
Возможные значения: mcp_call
Да

OpenAI.InputItemOutputMessage

Выходное сообщение из модели.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.OutputMessageContent Содержимое выходного сообщения. Да
id струна Уникальный идентификатор выходного сообщения. Да
роль перечисление Роль выходного сообщения. Всегда assistant.
Возможные значения: assistant
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completedили
incomplete. Заполняется при возврате входных элементов через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип выходного сообщения. Всегда message.
Возможные значения: output_message
Да

OpenAI.InputItemReasoningItem

Описание цепочки мысли, используемой моделью причин при создании ответа. Обязательно включите эти элементы в input в API ответов для последующих ходов разговора, если вы вручную управляете контекстом.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.ReasoningTextContent Текст с рассуждением. нет
encrypted_content Строка (нулевая) нет
id струна Уникальный идентификатор контента рассуждений. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
summary массив OpenAI.Summary Содержание с резюме аргументов. Да
type перечисление Тип объекта . Всегда reasoning.
Возможные значения: reasoning
Да

OpenAI.InputItemType

Недвижимость Ценность
Тип струна
Значения message
output_message
file_search_call
computer_call
computer_call_output
web_search_call
function_call
function_call_output
reasoning
compaction
image_generation_call
code_interpreter_call
local_shell_call
local_shell_call_output
shell_call
shell_call_output
apply_patch_call
apply_patch_call_output
mcp_list_tools
mcp_approval_request
mcp_approval_response
mcp_call
custom_tool_call_output
custom_tool_call
item_reference

OpenAI.InputItemWebSearchToolCall

Результаты вызова инструмента веб-поиска. Смотрите руководство по поиску web для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.WebSearchActionSearch или OpenAI.WebSearchActionOpenPage или OpenAI.WebSearchActionFind Объект, описывающий конкретное действие, выполняемое в этом вызове веб-поиска.
Содержит сведения о том, как модель использовала Интернет (поиск, open_page, поиск).
Да
id струна Уникальный идентификатор инструмента поиска в интернете. Да
статус перечисление Состояние вызова функции средства поиска в Интернете.
Возможные значения: in_progress, , searchingcompletedfailed
Да
type перечисление Тип вызова инструмента поиска в интернете. Всегда web_search_call.
Возможные значения: web_search_call
Да

OpenAI.InputMessage

Входное сообщение модели с ролью, указывающей на следование иерархии инструкций. Инструкции с ролью developer или system имеют приоритет над инструкциями с ролью user.

Имя. Тип Description Обязательно По умолчанию
содержимое OpenAI.InputMessageContentList Список одного или нескольких входных элементов модели, содержащий другое содержимое.
types.
Да
роль перечисление Роль входных данных сообщения. Один из user, system, или developer.
Возможные значения: user, systemdeveloper
Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип входных данных сообщения. Всегда задано значение message.
Возможные значения: message
Да

OpenAI.InputMessageContentList

Список одного или нескольких входных элементов модели, содержащий различные типы контента.

Массив: OpenAI.InputContent

OpenAI.InputMessageResource

Имя. Тип Description Обязательно По умолчанию
содержимое OpenAI.InputMessageContentList Список одного или нескольких входных элементов модели, содержащий другое содержимое.
types.
Да
id струна Уникальный идентификатор входных данных сообщения. Да
роль перечисление Роль входных данных сообщения. Один из user, system, или developer.
Возможные значения: user, systemdeveloper
Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип входных данных сообщения. Всегда задано значение message.
Возможные значения: message
Да

OpenAI.InputParam

Входные данные, такие как текст, изображения или файлы, в модель, используемые для генерации ответа. Подробнее:

Тип: строка или массив OpenAI.InputItem

Входные данные, такие как текст, изображения или файлы, в модель, используемые для генерации ответа. Подробнее:

OpenAI.InputTextContent

Текстовые входные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые входные данные модели. Да
type перечисление Тип входного элемента. Всегда input_text.
Возможные значения: input_text
Да

OpenAI.InputTextContentParam

Текстовые входные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые входные данные модели.
Ограничения: maxLength: 10485760
Да
type перечисление Тип входного элемента. Всегда input_text.
Возможные значения: input_text
Да

OpenAI.Item

Элемент содержимого, используемый для создания ответа.

Дискриминация для OpenAI.Item

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
memory_search_call MemorySearchToolCallItemParam
message OpenAI.InputMessage
output_message OpenAI.ItemOutputMessage
file_search_call OpenAI.ItemFileSearchToolCall
computer_call OpenAI.ItemComputerToolCall
computer_call_output OpenAI.ItemComputerCallOutputItemParam
web_search_call OpenAI.ItemWebSearchToolCall
function_call OpenAI.ItemFunctionToolCall
function_call_output OpenAI.ItemFunctionCallOutputItemParam
reasoning OpenAI.ItemReasoningItem
compaction OpenAI.ItemCompactionSummaryItemParam
image_generation_call OpenAI.ItemImageGenToolCall
code_interpreter_call OpenAI.ItemCodeInterpreterToolCall
local_shell_call OpenAI.ItemLocalShellToolCall
local_shell_call_output OpenAI.ItemLocalShellToolCallOutput
shell_call OpenAI.ItemFunctionShellCallItemParam
shell_call_output OpenAI.ItemFunctionShellCallOutputItemParam
apply_patch_call OpenAI.ItemApplyPatchToolCallItemParam
apply_patch_call_output OpenAI.ItemApplyPatchToolCallOutputItemParam
mcp_list_tools OpenAI.ItemMcpListTools
mcp_approval_request OpenAI.ItemMcpApprovalRequest
mcp_approval_response OpenAI.ItemMcpApprovalResponse
mcp_call OpenAI.ItemMcpToolCall
custom_tool_call_output OpenAI.ItemCustomToolCallOutput
custom_tool_call OpenAI.ItemCustomToolCall
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ItemType Да

OpenAI.ItemApplyPatchToolCallItemParam

Вызов инструмента, представляющий запрос на создание, удаление или обновление файлов с помощью дифференциальных патчей.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
Операция OpenAI.ApplyPatchOperationParam Одна из create_file, delete_file или update_file операций, поставляемых на инструмент apply_patch. Да
└─ Тип OpenAI.ApplyPatchOperationParamType Да
статус OpenAI.ApplyPatchCallStatusParam Значения статуса, указанные для apply_patch вызовов инструментов. Да
type перечисление Тип элемента. Всегда apply_patch_call.
Возможные значения: apply_patch_call
Да

OpenAI.ItemApplyPatchToolCallOutputItemParam

Потоковый выход, исходящий через вызов инструмента apply patch.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
output Строка (нулевая) нет
статус OpenAI.ApplyPatchCallOutputStatusParam Значения результатов, представленные для выходов apply_patch вызовов инструмента. Да
type перечисление Тип элемента. Всегда apply_patch_call_output.
Возможные значения: apply_patch_call_output
Да

OpenAI.ItemCodeInterpreterToolCall

Вызов инструмента для выполнения кода.

Имя. Тип Description Обязательно По умолчанию
код Строка (нулевая) Да
container_id струна Идентификатор контейнера, используемого для запуска кода. Да
id струна Уникальный идентификатор вызова средства интерпретатора кода. Да
выходные данные массив OpenAI.CodeInterpreterOutputLogs или OpenAI.CodeInterpreterOutputImage Да
статус перечисление Состояние вызова средства интерпретатора кода. Допустимые значения: in_progress, completed, incomplete, interpreting, и failed.
Возможные значения: in_progress, completed, incomplete, interpreting, failed
Да
type перечисление Тип вызова средства интерпретатора кода. Всегда code_interpreter_call.
Возможные значения: code_interpreter_call
Да

OpenAI.ItemCompactionSummaryItemParam

Элемент уплотнения, сгенерированный APIv1/responses/compact.

Имя. Тип Description Обязательно По умолчанию
encrypted_content струна Зашифрованное содержимое сводки сжатия.
Ограничения: maxLength: 10485760
Да
id Строка (нулевая) нет
type перечисление Тип элемента. Всегда compaction.
Возможные значения: compaction
Да

OpenAI.ItemComputerCallOutputItemParam

Выходные данные запуска компьютерного инструмента.

Имя. Тип Description Обязательно По умолчанию
acknowledged_safety_checks массив OpenAI.ComputerCallSafetyCheckParam нет
call_id струна Идентификатор вызова средства компьютера, создающего выходные данные.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
output OpenAI.ComputerScreenshotImage Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера. Да
статус OpenAI.FunctionCallItemStatus (nullable) нет
type перечисление Тип выходных данных компьютерного средства вызова. Всегда computer_call_output.
Возможные значения: computer_call_output
Да

OpenAI.ItemComputerToolCall

Вызов инструмента для работы с компьютером. См. руководство по использованию компьютеров компьютера для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.ComputerAction Да
call_id струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. Да
id струна Уникальный идентификатор вызова компьютера. Да
pending_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Ожидающие проверки безопасности для компьютеризированного процесса. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип компьютерного вызова. Всегда computer_call.
Возможные значения: computer_call
Да

OpenAI.ItemCustomToolCall

Вызов пользовательского инструмента, созданного моделью.

Имя. Тип Description Обязательно По умолчанию
call_id струна Идентификатор, используемый для сопоставления этого пользовательского вызова инструмента с выходом вызова инструмента. Да
id струна Уникальный идентификатор пользовательского инструмента вызывает платформу OpenAI. нет
ввод струна Вход для пользовательского вызова инструмента, генерируемого моделью. Да
имя струна Имя вызываемого пользовательского инструмента. Да
type перечисление Тип пользовательского вызова инструмента. Всегда custom_tool_call.
Возможные значения: custom_tool_call
Да

OpenAI.ItemCustomToolCallOutput

Вывод пользовательского вызова инструмента из вашего кода возвращается в модель.

Имя. Тип Description Обязательно По умолчанию
call_id струна Идентификатор вызова, используемый для сопоставления этого вывода пользовательского вызова инструмента в пользовательский вызов инструмента. Да
id струна Уникальный идентификатор вывода пользовательского вызова инструмента на платформе OpenAI. нет
output строка или массив OpenAI.FunctionAndCustomToolCallOutput Результат из пользовательского вызова инструмента, сгенерированного вашим кодом.
Это может быть строка или список выходного контента.
Да
type перечисление Тип вывода пользовательского вызова инструмента. Всегда custom_tool_call_output.
Возможные значения: custom_tool_call_output
Да

OpenAI.ItemFileSearchToolCall

Результаты вызова средства поиска файлов. Смотрите руководство по поиску файл для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова средства поиска файлов. Да
queries Массив строк Запросы, используемые для поиска файлов. Да
results массив OpenAI.FileSearchToolCallResults нет
статус перечисление Состояние вызова средства поиска файлов. Один из in_progress,
searching, incomplete или failed,
Возможные значения: in_progress, searching, completed, incomplete, failed
Да
type перечисление Тип вызова средства поиска файлов. Всегда file_search_call.
Возможные значения: file_search_call
Да

OpenAI.ItemFunctionCallOutputItemParam

Выходные данные вызова инструмента функции.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова функции, созданного моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
output строка или массив OpenAI.InputTextContentParam или OpenAI.InputImageContentParamAutoParam или OpenAI.InputFileContentParam Текст, изображение или файл вывода вызова инструмента функции. Да
статус OpenAI.FunctionCallItemStatus (nullable) нет
type перечисление Тип выходных данных вызова функции. Всегда function_call_output.
Возможные значения: function_call_output
Да

OpenAI.ItemFunctionShellCallItemParam

Инструмент, представляющий запрос на выполнение одной или нескольких команд shell.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.FunctionShellActionParam Команды и ограничения, описывающие, как запускать вызов инструмента shell. Да
Команды └️ Массив строк Приказал команды shell для запуска среды выполнения. Да
└max_output_length OpenAI.integer (nullable) нет
└️ timeout_ms OpenAI.integer (nullable) нет
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
статус OpenAI.FunctionShellCallItemStatus (nullable) Значения статуса, указанные для вызовов оболочки. нет
type перечисление Тип элемента. Всегда shell_call.
Возможные значения: shell_call
Да

OpenAI.ItemFunctionShellCallOutputItemParam

Потоковые выходные элементы, исходящие от вызова инструмента shell.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью.
Ограничения: minLength: 1, maxLength: 64
Да
id Строка (нулевая) нет
max_output_length OpenAI.integer (nullable) нет
output массив OpenAI.FunctionShellCallOutputContentParam Зафиксированы куски выработки stdout и stderr, а также связанные с ними результаты. Да
type перечисление Тип элемента. Всегда shell_call_output.
Возможные значения: shell_call_output
Да

OpenAI.ItemFunctionToolCall

Вызов средства для запуска функции. См. руководство по вызову функций function call для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON аргументов для передачи функции. Да
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор вызова средства функции. нет
имя струна Имя выполняемой функции. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип вызова инструмента функции. Всегда function_call.
Возможные значения: function_call
Да

OpenAI.ItemImageGenToolCall

Запрос на создание изображения, сделанный моделью.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова генерации изображений. Да
результат Строка (нулевая) Да
статус перечисление Статус вызова генерации изображений.
Возможные значения: in_progress, , completedgeneratingfailed
Да
type перечисление Тип вызова для генерации изображений. Всегда image_generation_call.
Возможные значения: image_generation_call
Да

OpenAI.ItemLocalShellToolCall

Вызов средства для выполнения команды в локальной оболочке.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.LocalShellExecAction Выполните команду оболочки на сервере. Да
call_id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
id струна Уникальный идентификатор локального вызова shell. Да
статус перечисление Статус местного звонка shell.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип локального вызова shell. Всегда local_shell_call.
Возможные значения: local_shell_call
Да

OpenAI.ItemLocalShellToolCallOutput

Выходные данные вызова локального средства оболочки.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
output струна Строка JSON выходных данных вызова локального средства оболочки. Да
статус перечисление
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выхода локального вызова инструмента shell. Всегда local_shell_call_output.
Возможные значения: local_shell_call_output
Да

OpenAI.ItemMcpApprovalRequest

Запрос на одобрение человеком вызова инструмента.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON с аргументами для средства. Да
id струна Уникальный идентификатор запроса на одобрение. Да
имя струна Имя запускаемого средства. Да
метка сервера струна Метка сервера MCP, выполняющего запрос. Да
type перечисление Тип элемента. Всегда mcp_approval_request.
Возможные значения: mcp_approval_request
Да

OpenAI.ItemMcpApprovalResponse

Ответ на запрос на утверждение MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id струна Идентификатор запроса на утверждение, на который даётся ответ. Да
Утвердить булевый Будет ли утвержден запрос. Да
id Строка (нулевая) нет
причина Строка (нулевая) нет
type перечисление Тип элемента. Всегда mcp_approval_response.
Возможные значения: mcp_approval_response
Да

OpenAI.ItemMcpListTools

Список средств, доступных на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор списка. Да
метка сервера струна Метка сервера MCP. Да
инструменты массив OpenAI.MCPListToolsTools Средства, доступные на сервере. Да
type перечисление Тип элемента. Всегда mcp_list_tools.
Возможные значения: mcp_list_tools
Да

OpenAI.ItemMcpToolCall

Вызов инструмента на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id Строка (нулевая) нет
arguments струна Строка JSON аргументов, переданных средству. Да
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор вызова инструмента. Да
имя струна Имя запущенного инструмента. Да
output Строка (нулевая) нет
метка сервера струна Метка сервера MCP, на котором работает инструмент. Да
статус OpenAI.MCPToolCallStatus нет
type перечисление Тип элемента. Всегда mcp_call.
Возможные значения: mcp_call
Да

OpenAI.ItemOutputMessage

Выходное сообщение из модели.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.OutputMessageContent Содержимое выходного сообщения. Да
id струна Уникальный идентификатор выходного сообщения. Да
роль перечисление Роль выходного сообщения. Всегда assistant.
Возможные значения: assistant
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completedили
incomplete. Заполняется при возврате входных элементов через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип выходного сообщения. Всегда message.
Возможные значения: output_message
Да

OpenAI.ItemReasoningItem

Описание цепочки мысли, используемой моделью причин при создании ответа. Обязательно включите эти элементы в input в API ответов для последующих ходов разговора, если вы вручную управляете контекстом.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.ReasoningTextContent Текст с рассуждением. нет
encrypted_content Строка (нулевая) нет
id струна Уникальный идентификатор контента рассуждений. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
summary массив OpenAI.Summary Содержание с резюме аргументов. Да
type перечисление Тип объекта . Всегда reasoning.
Возможные значения: reasoning
Да

OpenAI.ItemReferenceParam

Внутренний идентификатор для ссылки на элемент.

Имя. Тип Description Обязательно По умолчанию
id струна Идентификатор элемента для ссылки. Да
type перечисление Тип элемента для ссылки. Всегда item_reference.
Возможные значения: item_reference
Да

OpenAI.ItemResource

Элемент содержимого, используемый для создания ответа.

Дискриминатор для OpenAI.ItemResource

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
message OpenAI.InputMessageResource
output_message OpenAI.ItemResourceOutputMessage
file_search_call OpenAI.ItemResourceFileSearchToolCall
computer_call OpenAI.ItemResourceComputerToolCall
computer_call_output OpenAI.ItemResourceComputerToolCallOutputResource
web_search_call OpenAI.ItemResourceWebSearchToolCall
function_call OpenAI.ItemResourceFunctionToolCallResource
function_call_output OpenAI.ItemResourceFunctionToolCallOutputResource
image_generation_call OpenAI.ItemResourceImageGenToolCall
code_interpreter_call OpenAI.ItemResourceCodeInterpreterToolCall
local_shell_call OpenAI.ItemResourceLocalShellToolCall
local_shell_call_output OpenAI.ItemResourceLocalShellToolCallOutput
shell_call OpenAI.ItemResourceFunctionShellCall
shell_call_output OpenAI.ItemResourceFunctionShellCallOutput
apply_patch_call OpenAI.ItemResourceApplyPatchToolCall
apply_patch_call_output OpenAI.ItemResourceApplyPatchToolCallOutput
mcp_list_tools OpenAI.ItemResourceMcpListTools
mcp_approval_request OpenAI.ItemResourceMcpApprovalRequest
mcp_approval_response OpenAI.ItemResourceMcpApprovalResponseResource
mcp_call OpenAI.ItemResourceMcpToolCall
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ItemResourceType Да

OpenAI.ItemResourceApplyPatchToolCall

Вызов средства, который применяет диффы файлов, создавая, удаляя или обновляя файлы.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью. Да
создано пользователем струна Идентификатор сущности, созданной этим средством. нет
id струна Уникальный идентификатор вызова средства исправления. Заполняется, когда этот элемент возвращается через API. Да
Операция OpenAI.ApplyPatchFileOperation Одна из операций create_file, delete_file или update_file, применяемых через apply_patch. Да
└─ Тип OpenAI.ApplyPatchFileOperationType Да
статус OpenAI.ApplyPatchCallStatus Да
type перечисление Тип элемента. Всегда apply_patch_call.
Возможные значения: apply_patch_call
Да

OpenAI.ItemResourceApplyPatchToolCallOutput

Выходные данные, создаваемые вызовом средства исправления.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью. Да
создано пользователем струна Идентификатор сущности, создающей выходные данные вызова этого средства. нет
id струна Уникальный идентификатор выходных данных вызова средства исправления. Заполняется, когда этот элемент возвращается через API. Да
output Строка (нулевая) нет
статус OpenAI.ApplyPatchCallOutputStatus Да
type перечисление Тип элемента. Всегда apply_patch_call_output.
Возможные значения: apply_patch_call_output
Да

OpenAI.ItemResourceCodeInterpreterToolCall

Вызов инструмента для выполнения кода.

Имя. Тип Description Обязательно По умолчанию
код Строка (нулевая) Да
container_id струна Идентификатор контейнера, используемого для запуска кода. Да
id струна Уникальный идентификатор вызова средства интерпретатора кода. Да
выходные данные массив OpenAI.CodeInterpreterOutputLogs или OpenAI.CodeInterpreterOutputImage Да
статус перечисление Состояние вызова средства интерпретатора кода. Допустимые значения: in_progress, completed, incomplete, interpreting, и failed.
Возможные значения: in_progress, completed, incomplete, interpreting, failed
Да
type перечисление Тип вызова средства интерпретатора кода. Всегда code_interpreter_call.
Возможные значения: code_interpreter_call
Да

OpenAI.ItemResourceComputerToolCall

Вызов инструмента для работы с компьютером. См. руководство по использованию компьютеров компьютера для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.ComputerAction Да
call_id струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. Да
id струна Уникальный идентификатор вызова компьютера. Да
pending_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Ожидающие проверки безопасности для компьютеризированного процесса. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип компьютерного вызова. Всегда computer_call.
Возможные значения: computer_call
Да

OpenAI.ItemResourceComputerToolCallOutputResource

Имя. Тип Description Обязательно По умолчанию
acknowledged_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Проверки безопасности, сообщаемые API, которые были подтверждены
разработчик.
нет
call_id струна Идентификатор вызова средства компьютера, создающего выходные данные. Да
id струна Идентификатор данных, полученных в результате вызова компьютерного инструмента. нет
output OpenAI.ComputerScreenshotImage Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера. Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completedили
incomplete. Заполняется при возврате входных элементов через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выходных данных компьютерного средства вызова. Всегда computer_call_output.
Возможные значения: computer_call_output
Да

OpenAI.ItemResourceFileSearchToolCall

Результаты вызова средства поиска файлов. Смотрите руководство по поиску файл для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова средства поиска файлов. Да
queries Массив строк Запросы, используемые для поиска файлов. Да
results массив OpenAI.FileSearchToolCallResults нет
статус перечисление Состояние вызова средства поиска файлов. Один из in_progress,
searching, incomplete или failed,
Возможные значения: in_progress, searching, completed, incomplete, failed
Да
type перечисление Тип вызова средства поиска файлов. Всегда file_search_call.
Возможные значения: file_search_call
Да

OpenAI.ItemResourceFunctionShellCall

Вызов средства, выполняющий одну или несколько команд оболочки в управляемой среде.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.FunctionShellAction Выполните команду оболочки. Да
Команды └️ Массив строк Да
└max_output_length OpenAI.integer (nullable) Да
└️ timeout_ms OpenAI.integer (nullable) Да
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью. Да
создано пользователем струна Идентификатор сущности, созданной этим средством. нет
id струна Уникальный идентификатор вызова средства оболочки. Заполняется, когда этот элемент возвращается через API. Да
статус OpenAI.LocalShellCallStatus Да
type перечисление Тип элемента. Всегда shell_call.
Возможные значения: shell_call
Да

OpenAI.ItemResourceFunctionShellCallOutput

Выходные данные вызова средства оболочки, который был создан.

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью. Да
создано пользователем струна Идентификатор субъекта, создавшего элемент. нет
id струна Уникальный идентификатор выходных данных вызова оболочки. Заполняется, когда этот элемент возвращается через API. Да
max_output_length OpenAI.integer (nullable) Да
output массив OpenAI.FunctionShellCallOutputContent Массив содержимого вывода вызова оболочки Да
type перечисление Тип выходных данных вызова оболочки. Всегда shell_call_output.
Возможные значения: shell_call_output
Да

OpenAI.ItemResourceFunctionToolCallOutputResource

Имя. Тип Description Обязательно По умолчанию
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор выходных данных вызова средства функции. Заполнено, когда этот элемент
возвращается через API.
нет
output строка или массив OpenAI.FunctionAndCustomToolCallOutput Выходные данные вызова функции, созданного кодом.
Это может быть строка или список выходного контента.
Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выходных данных вызова функции. Всегда function_call_output.
Возможные значения: function_call_output
Да

OpenAI.ItemResourceFunctionToolCallResource

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON аргументов для передачи функции. Да
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор вызова средства функции. нет
имя струна Имя выполняемой функции. Да
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип вызова инструмента функции. Всегда function_call.
Возможные значения: function_call
Да

OpenAI.ItemResourceImageGenToolCall

Запрос на создание изображения, сделанный моделью.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова генерации изображений. Да
результат Строка (нулевая) Да
статус перечисление Статус вызова генерации изображений.
Возможные значения: in_progress, , completedgeneratingfailed
Да
type перечисление Тип вызова для генерации изображений. Всегда image_generation_call.
Возможные значения: image_generation_call
Да

OpenAI.ItemResourceLocalShellToolCall

Вызов средства для выполнения команды в локальной оболочке.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.LocalShellExecAction Выполните команду оболочки на сервере. Да
call_id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
id струна Уникальный идентификатор локального вызова shell. Да
статус перечисление Статус местного звонка shell.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип локального вызова shell. Всегда local_shell_call.
Возможные значения: local_shell_call
Да

OpenAI.ItemResourceLocalShellToolCallOutput

Выходные данные вызова локального средства оболочки.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
output струна Строка JSON выходных данных вызова локального средства оболочки. Да
статус перечисление
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип выхода локального вызова инструмента shell. Всегда local_shell_call_output.
Возможные значения: local_shell_call_output
Да

OpenAI.ItemResourceMcpApprovalRequest

Запрос на одобрение человеком вызова инструмента.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON с аргументами для средства. Да
id струна Уникальный идентификатор запроса на одобрение. Да
имя струна Имя запускаемого средства. Да
метка сервера струна Метка сервера MCP, выполняющего запрос. Да
type перечисление Тип элемента. Всегда mcp_approval_request.
Возможные значения: mcp_approval_request
Да

OpenAI.ItemResourceMcpApprovalResponseResource

Ответ на запрос на утверждение MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id струна Идентификатор запроса на утверждение, на который даётся ответ. Да
Утвердить булевый Будет ли утвержден запрос. Да
id струна Уникальный идентификатор ответа на утверждение Да
причина Строка (нулевая) нет
type перечисление Тип элемента. Всегда mcp_approval_response.
Возможные значения: mcp_approval_response
Да

OpenAI.ItemResourceMcpListTools

Список средств, доступных на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор списка. Да
метка сервера струна Метка сервера MCP. Да
инструменты массив OpenAI.MCPListToolsTools Средства, доступные на сервере. Да
type перечисление Тип элемента. Всегда mcp_list_tools.
Возможные значения: mcp_list_tools
Да

OpenAI.ItemResourceMcpToolCall

Вызов инструмента на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
approval_request_id Строка (нулевая) нет
arguments струна Строка JSON аргументов, переданных средству. Да
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор вызова инструмента. Да
имя струна Имя запущенного инструмента. Да
output Строка (нулевая) нет
метка сервера струна Метка сервера MCP, на котором работает инструмент. Да
статус OpenAI.MCPToolCallStatus нет
type перечисление Тип элемента. Всегда mcp_call.
Возможные значения: mcp_call
Да

OpenAI.ItemResourceOutputMessage

Выходное сообщение из модели.

Имя. Тип Description Обязательно По умолчанию
содержимое массив OpenAI.OutputMessageContent Содержимое выходного сообщения. Да
id струна Уникальный идентификатор выходного сообщения. Да
роль перечисление Роль выходного сообщения. Всегда assistant.
Возможные значения: assistant
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completedили
incomplete. Заполняется при возврате входных элементов через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип выходного сообщения. Всегда message.
Возможные значения: output_message
Да

OpenAI.ItemResourceType

Недвижимость Ценность
Тип струна
Значения message
output_message
file_search_call
computer_call
computer_call_output
web_search_call
function_call
function_call_output
image_generation_call
code_interpreter_call
local_shell_call
local_shell_call_output
shell_call
shell_call_output
apply_patch_call
apply_patch_call_output
mcp_list_tools
mcp_approval_request
mcp_approval_response
mcp_call
structured_outputs
oauth_consent_request
memory_search_call
workflow_action

OpenAI.ItemResourceWebSearchToolCall

Результаты вызова инструмента веб-поиска. Смотрите руководство по поиску web для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.WebSearchActionSearch или OpenAI.WebSearchActionOpenPage или OpenAI.WebSearchActionFind Объект, описывающий конкретное действие, выполняемое в этом вызове веб-поиска.
Содержит сведения о том, как модель использовала Интернет (поиск, open_page, поиск).
Да
id струна Уникальный идентификатор инструмента поиска в интернете. Да
статус перечисление Состояние вызова функции средства поиска в Интернете.
Возможные значения: in_progress, , searchingcompletedfailed
Да
type перечисление Тип вызова инструмента поиска в интернете. Всегда web_search_call.
Возможные значения: web_search_call
Да

OpenAI.ItemType

Недвижимость Ценность
Тип струна
Значения message
output_message
file_search_call
computer_call
computer_call_output
web_search_call
function_call
function_call_output
reasoning
compaction
image_generation_call
code_interpreter_call
local_shell_call
local_shell_call_output
shell_call
shell_call_output
apply_patch_call
apply_patch_call_output
mcp_list_tools
mcp_approval_request
mcp_approval_response
mcp_call
custom_tool_call_output
custom_tool_call
structured_outputs
oauth_consent_request
memory_search_call
workflow_action

OpenAI.ItemWebSearchToolCall

Результаты вызова инструмента веб-поиска. Смотрите руководство по поиску web для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.WebSearchActionSearch или OpenAI.WebSearchActionOpenPage или OpenAI.WebSearchActionFind Объект, описывающий конкретное действие, выполняемое в этом вызове веб-поиска.
Содержит сведения о том, как модель использовала Интернет (поиск, open_page, поиск).
Да
id струна Уникальный идентификатор инструмента поиска в интернете. Да
статус перечисление Состояние вызова функции средства поиска в Интернете.
Возможные значения: in_progress, , searchingcompletedfailed
Да
type перечисление Тип вызова инструмента поиска в интернете. Всегда web_search_call.
Возможные значения: web_search_call
Да

OpenAI.KeyPressAction

Коллекция нажатий клавиш, которые модель хотела бы выполнить.

Имя. Тип Description Обязательно По умолчанию
ключи Массив строк Сочетание клавиш, которые модель просит нажать. Это массив строк, каждый из которых представляет ключ. Да
type перечисление Указывает тип события. Для действия keypress это свойство всегда имеет значение keypress.
Возможные значения: keypress
Да

OpenAI.ListFineTuningJobCheckpointsResponse

Имя. Тип Description Обязательно По умолчанию
данные массив OpenAI.FineTuningJobCheckpoint Да
первый_идентификатор Строка (нулевая) нет
есть_еще булевый Да
last_id Строка (нулевая) нет
объект перечисление
Возможные значения: list
Да

OpenAI.ListFineTuningJobEventsResponse

Имя. Тип Description Обязательно По умолчанию
данные массив OpenAI.FineTuningJobEvent Да
есть_еще булевый Да
объект перечисление
Возможные значения: list
Да

OpenAI.ListPaginatedFineTuningJobsResponse

Имя. Тип Description Обязательно По умолчанию
данные массив OpenAI.FineTuningJob Да
есть_еще булевый Да
объект перечисление
Возможные значения: list
Да

OpenAI.LocalShellCallStatus

Недвижимость Ценность
Тип струна
Значения in_progress
completed
incomplete

OpenAI.LocalShellExecAction

Выполните команду оболочки на сервере.

Имя. Тип Description Обязательно По умолчанию
command Массив строк Выполняемая команда Да
окружение объект Переменные среды, заданные для команды. Да
таймаут_мс OpenAI.integer (nullable) нет
type перечисление Тип действия локальной оболочки. Всегда exec.
Возможные значения: exec
Да
Пользователь Строка (нулевая) нет
working_directory Строка (нулевая) нет

OpenAI.LocalShellToolParam

Средство, позволяющее модели выполнять команды оболочки в локальной среде.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип локального средства оболочки. Всегда local_shell.
Возможные значения: local_shell
Да

OpenAI.LogProb

Вероятность использования маркера в журнале.

Имя. Тип Description Обязательно По умолчанию
байт массив OpenAI.integer Да
logprob OpenAI.numeric Да
token струна Да
top_logprobs массив OpenAI.TopLogProb Да

OpenAI.MCPListToolsTool

Средство, доступное на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
аннотации OpenAI.MCPListToolsToolAnnotations (nullable) нет
описание Строка (нулевая) нет
input_schema OpenAI.MCPListToolsToolInputSchema Да
имя струна Имя средства. Да

OpenAI.MCPListToolsToolAnnotations

Тип: объект

OpenAI.MCPListToolsToolInputSchema

Тип: объект

OpenAI.MCPTool

Дайте модели access к дополнительным инструментам через удалённые серверы Model Context Protocol (MCP). Узнайте больше о MCP.

Имя. Тип Description Обязательно По умолчанию
разрешённые_инструменты массив строк или OpenAI.MCPToolFilter нет
авторизация струна Токен access OAuth, который может использоваться с удалённым MCP-сервером
с настраиваемым URL-адресом сервера MCP или соединителем службы. Ваше приложение
должен обработать поток авторизации OAuth и указать здесь маркер.
нет
connector_id перечисление Идентификатор для сервисных разъёмов, подобных тем, что доступны в ChatGPT. Один из
server_url или connector_id должно быть предоставлено. Дополнительные сведения о службе
Разъёмы здесь.
В настоящее время поддерживаемые connector_id значения:
-Dropbox: connector_dropbox
-Gmail: connector_gmail
— Google Calendar: connector_googlecalendar
— Google Drive: connector_googledrive
- Microsoft Teams: connector_microsoftteams
- Календарь Outlook: connector_outlookcalendar
— Электронная почта Outlook: connector_outlookemail
-Sharepoint: connector_sharepoint
Возможные значения: connector_dropbox, connector_gmail, connector_googlecalendar, connector_googledrive, connector_microsoftteams, connector_outlookcalendar, connector_outlookemail, connector_sharepoint
нет
headers Объект (нулируемый) нет
project_connection_id струна Идентификатор соединения в project для MCP-сервера. В подключении хранятся данные аутентификации и другие сведения о подключении, необходимые для подключения к серверу MCP. нет
требовать_одобрение object (см. допустимые модели ниже) нет
server_description струна Необязательное описание сервера MCP, используемое для получения дополнительного контекста. нет
метка сервера струна Метка для этого сервера MCP, используемая для идентификации его в вызовах инструментов. Да
URL сервера струна URL-адрес сервера MCP. Одно из server_url или connector_id должно быть
Предоставляются.
нет
type перечисление Тип средства MCP. Всегда mcp.
Возможные значения: mcp
Да

OpenAI.MCPToolCallStatus

Недвижимость Ценность
Тип струна
Значения in_progress
completed
incomplete
calling
failed

OpenAI.MCPToolFilter

Объект фильтра, указывающий, какие инструменты разрешены.

Имя. Тип Description Обязательно По умолчанию
read_only булевый Указывает, изменяет ли инструмент данные или является только для чтения. Если
Сервер MCP аннотирован с помощью < a0/&a0>.
он будет соответствовать этому фильтру.
нет
tool_names Массив строк Список разрешенных имен инструментов. нет

OpenAI.MCPToolRequireApproval

Имя. Тип Description Обязательно По умолчанию
всегда OpenAI.MCPToolFilter Объект фильтра, указывающий, какие инструменты разрешены. нет
никогда OpenAI.MCPToolFilter Объект фильтра, указывающий, какие инструменты разрешены. нет

OpenAI.MessageContent

Часть содержимого, которая состоит из входного или выходного элемента.

Дискриминация для OpenAI.MessageContent

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
text OpenAI.TextContent
summary_text OpenAI.SummaryTextContent
computer_screenshot OpenAI.ComputerScreenshotContent
input_text OpenAI.MessageContentInputTextContent
output_text OpenAI.MessageContentOutputTextContent
reasoning_text OpenAI.MessageContentReasoningTextContent
refusal OpenAI.MessageContentRefusalContent
input_image OpenAI.MessageContentInputImageContent
input_file OpenAI.MessageContentInputFileContent
Имя. Тип Description Обязательно По умолчанию
type OpenAI.MessageContentType Да

OpenAI.MessageContentInputFileContent

Файл в качестве входных данных для модели.

Имя. Тип Description Обязательно По умолчанию
file_data струна Содержимое файла, отправляемого в модель. нет
идентификатор_файла Строка (нулевая) нет
file_url струна URL файла, который должен быть отправлен модели. нет
filename струна Имя файла, отправляемого в модель. нет
type перечисление Тип входного элемента. Всегда input_file.
Возможные значения: input_file
Да

OpenAI.MessageContentInputImageContent

Изображение в качестве входных данных для модели. Узнайте о входных изображениях.

Имя. Тип Description Обязательно По умолчанию
detail OpenAI.ImageDetail Да
идентификатор_файла Строка (нулевая) нет
ссылка_на_изображение струна нет
type перечисление Тип входного элемента. Всегда input_image.
Возможные значения: input_image
Да

OpenAI.MessageContentInputTextContent

Текстовые входные данные модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текстовые входные данные модели. Да
type перечисление Тип входного элемента. Всегда input_text.
Возможные значения: input_text
Да

OpenAI.MessageContentOutputTextContent

Текстовые выходные данные модели.

Имя. Тип Description Обязательно По умолчанию
аннотации массив OpenAI.Annotation Заметки к выходным данным текста. Да
logprobs массив OpenAI.LogProb нет
текст струна Текстовые выходные данные модели. Да
type перечисление Тип выходного текста. Всегда output_text.
Возможные значения: output_text
Да

OpenAI.MessageContentReasoningTextContent

Текст рассуждения из модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текст рассуждения из модели. Да
type перечисление Тип текста рассуждения. Всегда reasoning_text.
Возможные значения: reasoning_text
Да

OpenAI.MessageContentRefusalContent

Отказ модели.

Имя. Тип Description Обязательно По умолчанию
отказ струна Объяснение отказа модели. Да
type перечисление Тип отказа. Всегда refusal.
Возможные значения: refusal
Да

OpenAI.MessageContentType

Недвижимость Ценность
Тип струна
Значения input_text
output_text
text
summary_text
reasoning_text
refusal
input_image
computer_screenshot
input_file

OpenAI.MessageRole

Недвижимость Ценность
Тип струна
Значения unknown
user
assistant
system
critic
discriminator
developer
tool

OpenAI.MessageStatus

Недвижимость Ценность
Тип струна
Значения in_progress
completed
incomplete

OpenAI.Metadata

Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.

Тип: объект

OpenAI.ModelIdsCompaction

Идентификатор модели, используемый для создания ответа, например gpt-5 или o3. OpenAI предлагает широкий спектр моделей с разными возможностями, характеристиками производительности и ценами. Ознакомьтесь с руководством по модели для просмотра и сравнения доступных моделей.

Тип: OpenAI.ModelIdsResponses или string

Идентификатор модели, используемый для создания ответа, например gpt-5 или o3. OpenAI предлагает широкий спектр моделей с разными возможностями, характеристиками производительности и ценами. Ознакомьтесь с руководством по модели для просмотра и сравнения доступных моделей.

OpenAI.ModelIdsResponses

Недвижимость Ценность
Тип струна
Значения o1-pro
o1-pro-2025-03-19
o3-pro
o3-pro-2025-06-10
o3-deep-research
o3-deep-research-2025-06-26
o4-mini-deep-research
o4-mini-deep-research-2025-06-26
computer-use-preview
computer-use-preview-2025-03-11
gpt-5-codex
gpt-5-pro
gpt-5-pro-2025-10-06
gpt-5.1-codex-max

OpenAI.ModelIdsShared

Тип: string или OpenAI.ChatModel

OpenAI.Move

Операция перемещения мыши.

Имя. Тип Description Обязательно По умолчанию
type перечисление Указывает тип события. Для действия перемещения это свойство имеет значение
всегда задано значение move.
Возможные значения: move
Да
x OpenAI.integer Да
и OpenAI.integer Да

OpenAI.OutputContent

Дискриминация для OpenAI.OutputContent

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
output_text OpenAI.OutputContentOutputTextContent
refusal OpenAI.OutputContentRefusalContent
reasoning_text OpenAI.OutputContentReasoningTextContent
Имя. Тип Description Обязательно По умолчанию
type OpenAI.OutputContentType Да

OpenAI.OutputContentOutputTextContent

Текстовые выходные данные модели.

Имя. Тип Description Обязательно По умолчанию
аннотации массив OpenAI.Annotation Заметки к выходным данным текста. Да
logprobs массив OpenAI.LogProb нет
текст струна Текстовые выходные данные модели. Да
type перечисление Тип выходного текста. Всегда output_text.
Возможные значения: output_text
Да

OpenAI.OutputContentReasoningTextContent

Текст рассуждения из модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текст рассуждения из модели. Да
type перечисление Тип текста рассуждения. Всегда reasoning_text.
Возможные значения: reasoning_text
Да

OpenAI.OutputContentRefusalContent

Отказ модели.

Имя. Тип Description Обязательно По умолчанию
отказ струна Объяснение отказа модели. Да
type перечисление Тип отказа. Всегда refusal.
Возможные значения: refusal
Да

OpenAI.OutputContentType

Недвижимость Ценность
Тип струна
Значения output_text
refusal
reasoning_text

OpenAI.OutputItem

Дискриминация для OpenAI.OutputItem

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
structured_outputs StructuredOutputsOutputItem
workflow_action WorkflowActionOutputItem
oauth_consent_request OAuthConsentRequestOutputItem
memory_search_call MemorySearchToolCallItemResource
output_message OpenAI.OutputItemOutputMessage
file_search_call OpenAI.OutputItemFileSearchToolCall
function_call OpenAI.OutputItemFunctionToolCall
web_search_call OpenAI.OutputItemWebSearchToolCall
computer_call OpenAI.OutputItemComputerToolCall
reasoning OpenAI.OutputItemReasoningItem
compaction OpenAI.OutputItemCompactionBody
image_generation_call OpenAI.OutputItemImageGenToolCall
code_interpreter_call OpenAI.OutputItemCodeInterpreterToolCall
local_shell_call OpenAI.OutputItemLocalShellToolCall
shell_call OpenAI.OutputItemFunctionShellCall
shell_call_output OpenAI.OutputItemFunctionShellCallOutput
apply_patch_call OpenAI.OutputItemApplyPatchToolCall
apply_patch_call_output OpenAI.OutputItemApplyPatchToolCallOutput
mcp_call OpenAI.OutputItemMcpToolCall
mcp_list_tools OpenAI.OutputItemMcpListTools
mcp_approval_request OpenAI.OutputItemMcpApprovalRequest
custom_tool_call OpenAI.OutputItemCustomToolCall
Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
response_id струна Ответ, на котором создается элемент. нет
type OpenAI.OutputItemType Да

OpenAI.OutputItemApplyPatchToolCall

Вызов средства, который применяет диффы файлов, создавая, удаляя или обновляя файлы.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью. Да
создано пользователем струна Идентификатор сущности, созданной этим средством. нет
id струна Уникальный идентификатор вызова средства исправления. Заполняется, когда этот элемент возвращается через API. Да
Операция OpenAI.ApplyPatchFileOperation Одна из операций create_file, delete_file или update_file, применяемых через apply_patch. Да
└─ Тип OpenAI.ApplyPatchFileOperationType Да
response_id струна Ответ, на котором создается элемент. нет
статус OpenAI.ApplyPatchCallStatus Да
type перечисление Тип элемента. Всегда apply_patch_call.
Возможные значения: apply_patch_call
Да

OpenAI.OutputItemApplyPatchToolCallOutput

Выходные данные, создаваемые вызовом средства исправления.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Уникальный идентификатор вызова инструмента применить патч, сгенерированного моделью. Да
создано пользователем струна Идентификатор сущности, создающей выходные данные вызова этого средства. нет
id струна Уникальный идентификатор выходных данных вызова средства исправления. Заполняется, когда этот элемент возвращается через API. Да
output Строка (нулевая) нет
response_id струна Ответ, на котором создается элемент. нет
статус OpenAI.ApplyPatchCallOutputStatus Да
type перечисление Тип элемента. Всегда apply_patch_call_output.
Возможные значения: apply_patch_call_output
Да

OpenAI.OutputItemCodeInterpreterToolCall

Вызов инструмента для выполнения кода.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
код Строка (нулевая) Да
container_id струна Идентификатор контейнера, используемого для запуска кода. Да
id струна Уникальный идентификатор вызова средства интерпретатора кода. Да
выходные данные массив OpenAI.CodeInterpreterOutputLogs или OpenAI.CodeInterpreterOutputImage Да
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Состояние вызова средства интерпретатора кода. Допустимые значения: in_progress, completed, incomplete, interpreting, и failed.
Возможные значения: in_progress, completed, incomplete, interpreting, failed
Да
type перечисление Тип вызова средства интерпретатора кода. Всегда code_interpreter_call.
Возможные значения: code_interpreter_call
Да

OpenAI.OutputItemCompactionBody

Элемент уплотнения, сгенерированный APIv1/responses/compact.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
создано пользователем струна Идентификатор субъекта, создавшего элемент. нет
encrypted_content струна Зашифрованное содержимое, созданное с помощью сжатия. Да
id струна Уникальный идентификатор уплотнения. Да
response_id струна Ответ, на котором создается элемент. нет
type перечисление Тип элемента. Всегда compaction.
Возможные значения: compaction
Да

OpenAI.OutputItemComputerToolCall

Вызов инструмента для работы с компьютером. См. руководство по использованию компьютеров компьютера для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.ComputerAction Да
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. Да
id струна Уникальный идентификатор вызова компьютера. Да
pending_safety_checks массив OpenAI.ComputerCallSafetyCheckParam Ожидающие проверки безопасности для компьютеризированного процесса. Да
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип компьютерного вызова. Всегда computer_call.
Возможные значения: computer_call
Да

OpenAI.OutputItemCustomToolCall

Вызов пользовательского инструмента, созданного моделью.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Идентификатор, используемый для сопоставления этого пользовательского вызова инструмента с выходом вызова инструмента. Да
id струна Уникальный идентификатор пользовательского инструмента вызывает платформу OpenAI. нет
ввод струна Вход для пользовательского вызова инструмента, генерируемого моделью. Да
имя струна Имя вызываемого пользовательского инструмента. Да
response_id струна Ответ, на котором создается элемент. нет
type перечисление Тип пользовательского вызова инструмента. Всегда custom_tool_call.
Возможные значения: custom_tool_call
Да

OpenAI.OutputItemFileSearchToolCall

Результаты вызова средства поиска файлов. Смотрите руководство по поиску файл для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
id струна Уникальный идентификатор вызова средства поиска файлов. Да
queries Массив строк Запросы, используемые для поиска файлов. Да
response_id струна Ответ, на котором создается элемент. нет
results массив OpenAI.FileSearchToolCallResults нет
статус перечисление Состояние вызова средства поиска файлов. Один из in_progress,
searching, incomplete или failed,
Возможные значения: in_progress, searching, completed, incomplete, failed
Да
type перечисление Тип вызова средства поиска файлов. Всегда file_search_call.
Возможные значения: file_search_call
Да

OpenAI.OutputItemFunctionShellCall

Вызов средства, выполняющий одну или несколько команд оболочки в управляемой среде.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.FunctionShellAction Выполните команду оболочки. Да
Команды └️ Массив строк Да
└max_output_length OpenAI.integer (nullable) Да
└️ timeout_ms OpenAI.integer (nullable) Да
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью. Да
создано пользователем струна Идентификатор сущности, созданной этим средством. нет
id струна Уникальный идентификатор вызова средства оболочки. Заполняется, когда этот элемент возвращается через API. Да
response_id струна Ответ, на котором создается элемент. нет
статус OpenAI.LocalShellCallStatus Да
type перечисление Тип элемента. Всегда shell_call.
Возможные значения: shell_call
Да

OpenAI.OutputItemFunctionShellCallOutput

Выходные данные вызова средства оболочки, который был создан.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Уникальный идентификатор вызова оболочки, генерируемого моделью. Да
создано пользователем струна Идентификатор субъекта, создавшего элемент. нет
id струна Уникальный идентификатор выходных данных вызова оболочки. Заполняется, когда этот элемент возвращается через API. Да
max_output_length OpenAI.integer (nullable) Да
output массив OpenAI.FunctionShellCallOutputContent Массив содержимого вывода вызова оболочки Да
response_id струна Ответ, на котором создается элемент. нет
type перечисление Тип выходных данных вызова оболочки. Всегда shell_call_output.
Возможные значения: shell_call_output
Да

OpenAI.OutputItemFunctionToolCall

Вызов средства для запуска функции. См. руководство по вызову функций function call для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
arguments струна Строка JSON аргументов для передачи функции. Да
call_id струна Уникальный идентификатор вызова функции, созданного моделью. Да
id струна Уникальный идентификатор вызова средства функции. нет
имя струна Имя выполняемой функции. Да
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
type перечисление Тип вызова инструмента функции. Всегда function_call.
Возможные значения: function_call
Да

OpenAI.OutputItemImageGenToolCall

Запрос на создание изображения, сделанный моделью.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
id струна Уникальный идентификатор вызова генерации изображений. Да
response_id струна Ответ, на котором создается элемент. нет
результат Строка (нулевая) Да
статус перечисление Статус вызова генерации изображений.
Возможные значения: in_progress, , completedgeneratingfailed
Да
type перечисление Тип вызова для генерации изображений. Всегда image_generation_call.
Возможные значения: image_generation_call
Да

OpenAI.OutputItemLocalShellToolCall

Вызов средства для выполнения команды в локальной оболочке.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.LocalShellExecAction Выполните команду оболочки на сервере. Да
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
call_id струна Уникальный идентификатор вызова локального средства оболочки, созданного моделью. Да
id струна Уникальный идентификатор локального вызова shell. Да
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Статус местного звонка shell.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип локального вызова shell. Всегда local_shell_call.
Возможные значения: local_shell_call
Да

OpenAI.OutputItemMcpApprovalRequest

Запрос на одобрение человеком вызова инструмента.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
arguments струна Строка JSON с аргументами для средства. Да
id струна Уникальный идентификатор запроса на одобрение. Да
имя струна Имя запускаемого средства. Да
response_id струна Ответ, на котором создается элемент. нет
метка сервера струна Метка сервера MCP, выполняющего запрос. Да
type перечисление Тип элемента. Всегда mcp_approval_request.
Возможные значения: mcp_approval_request
Да

OpenAI.OutputItemMcpListTools

Список средств, доступных на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор списка. Да
response_id струна Ответ, на котором создается элемент. нет
метка сервера струна Метка сервера MCP. Да
инструменты массив OpenAI.MCPListToolsTools Средства, доступные на сервере. Да
type перечисление Тип элемента. Всегда mcp_list_tools.
Возможные значения: mcp_list_tools
Да

OpenAI.OutputItemMcpToolCall

Вызов инструмента на сервере MCP.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
approval_request_id Строка (нулевая) нет
arguments струна Строка JSON аргументов, переданных средству. Да
ошибка Строка (нулевая) нет
id струна Уникальный идентификатор вызова инструмента. Да
имя струна Имя запущенного инструмента. Да
output Строка (нулевая) нет
response_id струна Ответ, на котором создается элемент. нет
метка сервера струна Метка сервера MCP, на котором работает инструмент. Да
статус OpenAI.MCPToolCallStatus нет
type перечисление Тип элемента. Всегда mcp_call.
Возможные значения: mcp_call
Да

OpenAI.OutputItemOutputMessage

Выходное сообщение из модели.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
содержимое массив OpenAI.OutputMessageContent Содержимое выходного сообщения. Да
id струна Уникальный идентификатор выходного сообщения. Да
response_id струна Ответ, на котором создается элемент. нет
роль перечисление Роль выходного сообщения. Всегда assistant.
Возможные значения: assistant
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completedили
incomplete. Заполняется при возврате входных элементов через API.
Возможные значения: in_progress, completedincomplete
Да
type перечисление Тип выходного сообщения. Всегда message.
Возможные значения: output_message
Да

OpenAI.OutputItemReasoningItem

Описание цепочки мысли, используемой моделью причин при создании ответа. Обязательно включите эти элементы в input в API ответов для последующих ходов разговора, если вы вручную управляете контекстом.

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
содержимое массив OpenAI.ReasoningTextContent Текст с рассуждением. нет
encrypted_content Строка (нулевая) нет
id струна Уникальный идентификатор контента рассуждений. Да
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Состояние элемента. Один из in_progress, completedили
incomplete. Заполняется, когда элементы возвращаются через API.
Возможные значения: in_progress, completedincomplete
нет
summary массив OpenAI.Summary Содержание с резюме аргументов. Да
type перечисление Тип объекта . Всегда reasoning.
Возможные значения: reasoning
Да

OpenAI.OutputItemType

Недвижимость Ценность
Тип струна
Значения output_message
file_search_call
function_call
web_search_call
computer_call
reasoning
compaction
image_generation_call
code_interpreter_call
local_shell_call
shell_call
shell_call_output
apply_patch_call
apply_patch_call_output
mcp_call
mcp_list_tools
mcp_approval_request
custom_tool_call
structured_outputs
oauth_consent_request
memory_search_call
workflow_action

OpenAI.OutputItemWebSearchToolCall

Результаты вызова инструмента веб-поиска. Смотрите руководство по поиску web для получения дополнительной информации.

Имя. Тип Description Обязательно По умолчанию
действие OpenAI.WebSearchActionSearch или OpenAI.WebSearchActionOpenPage или OpenAI.WebSearchActionFind Объект, описывающий конкретное действие, выполняемое в этом вызове веб-поиска.
Содержит сведения о том, как модель использовала Интернет (поиск, open_page, поиск).
Да
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
id струна Уникальный идентификатор инструмента поиска в интернете. Да
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Состояние вызова функции средства поиска в Интернете.
Возможные значения: in_progress, , searchingcompletedfailed
Да
type перечисление Тип вызова инструмента поиска в интернете. Всегда web_search_call.
Возможные значения: web_search_call
Да

OpenAI.OutputMessageContent

Дискриминация для OpenAI.OutputMessageContent

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
output_text OpenAI.OutputMessageContentOutputTextContent
refusal OpenAI.OutputMessageContentRefusalContent
Имя. Тип Description Обязательно По умолчанию
type OpenAI.OutputMessageContentType Да

OpenAI.OutputMessageContentOutputTextContent

Текстовые выходные данные модели.

Имя. Тип Description Обязательно По умолчанию
аннотации массив OpenAI.Annotation Заметки к выходным данным текста. Да
logprobs массив OpenAI.LogProb нет
текст струна Текстовые выходные данные модели. Да
type перечисление Тип выходного текста. Всегда output_text.
Возможные значения: output_text
Да

OpenAI.OutputMessageContentRefusalContent

Отказ модели.

Имя. Тип Description Обязательно По умолчанию
отказ струна Объяснение отказа модели. Да
type перечисление Тип отказа. Всегда refusal.
Возможные значения: refusal
Да

OpenAI.OutputMessageContentType

Недвижимость Ценность
Тип струна
Значения output_text
refusal

OpenAI.Prompt

Ссылка на шаблон запроса и его переменные. Узнать больше.

Имя. Тип Description Обязательно По умолчанию
id струна Уникальный идентификатор используемого шаблона запроса. Да
переменные OpenAI.ResponsePromptVariables (nullable ) Необязательное сопоставление значений для замены переменных в переменных
подсказывать. Значения подстановки могут быть строками или другими
Типы входных данных ответа, такие как изображения или файлы.
нет
version Строка (нулевая) нет

OpenAI.RankerVersionType

Недвижимость Ценность
Тип струна
Значения auto
default-2024-11-15

OpenAI.RankingOptions

Имя. Тип Description Обязательно По умолчанию
hybrid_search OpenAI.HybridSearchOptions нет
└️ embedding_weight OpenAI.numeric Вес вложения в обратное ранжирование слияния. Да
└text_weight OpenAI.numeric Вес текста в обратном ранжировании слияния. Да
офицер OpenAI.RankerVersionType нет
порог оценки OpenAI.numeric нет

OpenAI.Reasoning

Только модели GPT-5 и O-Series Опции конфигурации моделей рассуждения.

Имя. Тип Description Обязательно По умолчанию
effort OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
generate_summary перечисление
Возможные значения: auto, concisedetailed
нет
summary перечисление
Возможные значения: auto, concisedetailed
нет

OpenAI.ReasoningEffort

Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.

  • gpt-5.1 по умолчанию — none, что не выполняет рассуждение. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
  • Все модели до gpt-5.1 стандартного использования medium усилия рассуждения и не поддерживают none.
  • gpt-5-pro Модель по умолчанию использует (и поддерживает только) high усилия по рассуждениям.
  • xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
Недвижимость Ценность
Тип струна
Nullable Да
Значения none
minimal
low
medium
high
xhigh

OpenAI.ReasoningTextContent

Текст рассуждения из модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Текст рассуждения из модели. Да
type перечисление Тип текста рассуждения. Всегда reasoning_text.
Возможные значения: reasoning_text
Да

OpenAI.Response

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference (nullable) Да
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
фон Булев (нулируемый) нет
завершено_в целое число нет
разговор OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
Идентификатор └️ струна Уникальный идентификатор беседы, с которым связан этот ответ. Да
создано_в целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
└─ Код OpenAI.ResponseErrorCode Код ошибки для ответа. Да
Сообщение └️ струна Описание ошибки, доступной для чтения человеком. Да
id струна Уникальный идентификатор для этого ответа. Да
incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└─ Причина перечисление
Возможные значения: max_output_tokens, content_filter
нет
instructions строка или массив OpenAI.InputItem Да
max_output_tokens OpenAI.integer (nullable) нет
max_tool_calls OpenAI.integer (nullable) нет
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
модель струна Развертывание модели, используемое для создания этого ответа. нет
объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
output массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
output_text Строка (нулевая) нет
вызовы инструмента в параллельном режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
previous_response_id Строка (нулевая) нет
prompt OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
reasoning OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
- усилия OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
└─generate_summary перечисление
Возможные значения: auto, concisedetailed
нет
└️ сводка перечисление
Возможные значения: auto, concisedetailed
нет
safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
уровень обслуживания OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
статус перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
Температура OpenAI.numeric (nullable) нет 1
текст OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
выбор инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
top_logprobs OpenAI.integer (nullable) нет
top_p OpenAI.numeric (nullable) нет 1
truncation перечисление
Возможные значения: auto, disabled
нет
использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет

OpenAI.ResponseAudioDeltaEvent

Выдается при наличии частичного аудиореспонса.

Имя. Тип Description Обязательно По умолчанию
delta струна Блок аудиобайтов, закодированных в формате Base64. Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.audio.delta.
Возможные значения: response.audio.delta
Да

OpenAI.ResponseAudioDoneEvent

Излучается при завершении аудиоответа.

Имя. Тип Description Обязательно По умолчанию
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.audio.done.
Возможные значения: response.audio.done
Да

OpenAI.ResponseAudioTranscriptDeltaEvent

Выдается при частичной расшифровке звука.

Имя. Тип Description Обязательно По умолчанию
delta струна Частичная расшифровка аудиоответа. Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.audio.transcript.delta.
Возможные значения: response.audio.transcript.delta
Да

OpenAI.ResponseAudioTranscriptDoneEvent

Издается при завершении полной расшифровки аудио.

Имя. Тип Description Обязательно По умолчанию
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.audio.transcript.done.
Возможные значения: response.audio.transcript.done
Да

OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent

Создается при потоковой передаче фрагмента частичного кода интерпретатором кода.

Имя. Тип Description Обязательно По умолчанию
delta струна Фрагмент частичного кода, передаваемый интерпретатором кода. Да
item_id струна Уникальный идентификатор элемента вызова средства интерпретатора кода. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.code_interpreter_call_code.delta.
Возможные значения: response.code_interpreter_call_code.delta
Да

OpenAI.ResponseCodeInterpreterCallCodeDoneEvent

Создается при завершении фрагмента кода интерпретатором кода.

Имя. Тип Description Обязательно По умолчанию
код струна Окончательный фрагмент кода выводится интерпретатором кода. Да
item_id струна Уникальный идентификатор элемента вызова средства интерпретатора кода. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.code_interpreter_call_code.done.
Возможные значения: response.code_interpreter_call_code.done
Да

OpenAI.ResponseCodeInterpreterCallCompletedEvent

Эмитируется при завершении вызова интерпретатора кода.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор элемента вызова средства интерпретатора кода. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.code_interpreter_call.completed.
Возможные значения: response.code_interpreter_call.completed
Да

OpenAI.ResponseCodeInterpreterCallInProgressEvent

Срабатывает при выполнении вызова интерпретатора кода.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор элемента вызова средства интерпретатора кода. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.code_interpreter_call.in_progress.
Возможные значения: response.code_interpreter_call.in_progress
Да

OpenAI.ResponseCodeInterpreterCallInterpretingEvent

Создается, когда интерпретатор кода активно интерпретирует фрагмент кода.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор элемента вызова средства интерпретатора кода. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.code_interpreter_call.interpreting.
Возможные значения: response.code_interpreter_call.interpreting
Да

OpenAI.ResponseCompletedEvent

Выдается при завершении ответа модели.

Имя. Тип Description Обязательно По умолчанию
response OpenAI.Response Да
└agent_reference AgentReference (nullable) Агент, используемый для этого ответа Да
└─ Фон Булев (нулируемый) нет
└️ completed_at целое число (nullable) нет
Беседа └️ OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
└️ created_at целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
└─ Ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
Идентификатор └️ струна Уникальный идентификатор для этого ответа. Да
└️ incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└ Инструкции строка или массив OpenAI.InputItem (nullable) Да
└️ max_output_tokens OpenAI.integer (nullable) нет
└️ max_tool_calls OpenAI.integer (nullable) нет
└─ Метаданные OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
└─ Модель струна Развертывание модели, используемое для создания этого ответа. нет
└─ Объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
вывод └─ массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
└️ output_text Строка (нулевая) нет
└─ вызовы_инструментов_в_параллельном_режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
└previous_response_id Строка (нулевая) нет
└─ Запрос OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
└prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
└prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
└─ рассуждения OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
└safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
└service_tier OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
└─ Состояние перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
└─ Температура OpenAI.numeric (nullable) нет 1
Текст └️ OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
└─ выбор_инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
└─ Инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
└️ top_logprobs OpenAI.integer (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
└️ усечение перечисление
Возможные значения: auto, disabled
нет
└─ использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь └️ string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.completed.
Возможные значения: response.completed
Да

OpenAI.ResponseContentPartAddedEvent

Вызывается при добавлении новой части содержимого.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
item_id струна Идентификатор выходного элемента, к которому была добавлена часть содержимого. Да
output_index OpenAI.integer Да
part OpenAI.OutputContent Да
└─ Тип OpenAI.OutputContentType Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.content_part.added.
Возможные значения: response.content_part.added
Да

OpenAI.ResponseContentPartDoneEvent

Выдается при завершении части содержимого.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
item_id струна Идентификатор выходного элемента, к которому была добавлена часть содержимого. Да
output_index OpenAI.integer Да
part OpenAI.OutputContent Да
└─ Тип OpenAI.OutputContentType Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.content_part.done.
Возможные значения: response.content_part.done
Да

OpenAI.ResponseCreatedEvent

Событие, которое эмитируется при создании ответа.

Имя. Тип Description Обязательно По умолчанию
response OpenAI.Response Да
└agent_reference AgentReference (nullable) Агент, используемый для этого ответа Да
└─ Фон Булев (нулируемый) нет
└️ completed_at целое число (nullable) нет
Беседа └️ OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
└️ created_at целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
└─ Ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
Идентификатор └️ струна Уникальный идентификатор для этого ответа. Да
└️ incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└ Инструкции строка или массив OpenAI.InputItem (nullable) Да
└️ max_output_tokens OpenAI.integer (nullable) нет
└️ max_tool_calls OpenAI.integer (nullable) нет
└─ Метаданные OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
└─ Модель струна Развертывание модели, используемое для создания этого ответа. нет
└─ Объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
вывод └─ массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
└️ output_text Строка (нулевая) нет
└─ вызовы_инструментов_в_параллельном_режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
└previous_response_id Строка (нулевая) нет
└─ Запрос OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
└prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
└prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
└─ рассуждения OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
└safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
└service_tier OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
└─ Состояние перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
└─ Температура OpenAI.numeric (nullable) нет 1
Текст └️ OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
└─ выбор_инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
└─ Инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
└️ top_logprobs OpenAI.integer (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
└️ усечение перечисление
Возможные значения: auto, disabled
нет
└─ использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь └️ string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.created.
Возможные значения: response.created
Да

OpenAI.ResponseCustomToolCallInputDeltaEvent

Событие, представляющее разностное (частичное обновление) для ввода пользовательского вызова средства.

Имя. Тип Description Обязательно По умолчанию
delta струна Добавочные входные данные (delta) для вызова пользовательского средства. Да
item_id струна Уникальный идентификатор элемента API, связанного с этим событием. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление Идентификатор типа события.
Возможные значения: response.custom_tool_call_input.delta
Да

OpenAI.ResponseCustomToolCallInputDoneEvent

Событие, указывающее, что входные данные для вызова пользовательского средства завершены.

Имя. Тип Description Обязательно По умолчанию
ввод струна Полные входные данные для вызова пользовательского средства. Да
item_id струна Уникальный идентификатор элемента API, связанного с этим событием. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление Идентификатор типа события.
Возможные значения: response.custom_tool_call_input.done
Да

OpenAI.ResponseError

Объект ошибки, возвращаемый, когда модель не сможет создать ответ.

Имя. Тип Description Обязательно По умолчанию
код OpenAI.ResponseErrorCode Код ошибки для ответа. Да
сообщение струна Описание ошибки, доступной для чтения человеком. Да

OpenAI.ResponseErrorCode

Код ошибки для ответа.

Недвижимость Ценность
Тип струна
Значения server_error
rate_limit_exceeded
invalid_prompt
vector_store_timeout
invalid_image
invalid_image_format
invalid_base64_image
invalid_image_url
image_too_large
image_too_small
image_parse_error
image_content_policy_violation
invalid_image_mode
image_file_too_large
unsupported_image_media_type
empty_image_file
failed_to_download_image
image_file_not_found

OpenAI.ResponseErrorEvent

Эмитируется при возникновении ошибки.

Имя. Тип Description Обязательно По умолчанию
код Строка (нулевая) Да
сообщение струна Сообщение об ошибке. Да
параметр Строка (нулевая) Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда error.
Возможные значения: error
Да

OpenAI.ResponseFailedEvent

Событие, которое возникает при сбое ответа.

Имя. Тип Description Обязательно По умолчанию
response OpenAI.Response Да
└agent_reference AgentReference (nullable) Агент, используемый для этого ответа Да
└─ Фон Булев (нулируемый) нет
└️ completed_at целое число (nullable) нет
Беседа └️ OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
└️ created_at целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
└─ Ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
Идентификатор └️ струна Уникальный идентификатор для этого ответа. Да
└️ incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└ Инструкции строка или массив OpenAI.InputItem (nullable) Да
└️ max_output_tokens OpenAI.integer (nullable) нет
└️ max_tool_calls OpenAI.integer (nullable) нет
└─ Метаданные OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
└─ Модель струна Развертывание модели, используемое для создания этого ответа. нет
└─ Объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
вывод └─ массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
└️ output_text Строка (нулевая) нет
└─ вызовы_инструментов_в_параллельном_режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
└previous_response_id Строка (нулевая) нет
└─ Запрос OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
└prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
└prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
└─ рассуждения OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
└safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
└service_tier OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
└─ Состояние перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
└─ Температура OpenAI.numeric (nullable) нет 1
Текст └️ OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
└─ выбор_инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
└─ Инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
└️ top_logprobs OpenAI.integer (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
└️ усечение перечисление
Возможные значения: auto, disabled
нет
└─ использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь └️ string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.failed.
Возможные значения: response.failed
Да

OpenAI.ResponseFileSearchCallCompletedEvent

Создается при завершении вызова поиска файлов (найденные результаты).

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор выходного элемента, инициируемого вызовом поиска файлов. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.file_search_call.completed.
Возможные значения: response.file_search_call.completed
Да

OpenAI.ResponseFileSearchCallInProgressEvent

Срабатывает при инициализации вызова поиска файлов.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор выходного элемента, инициируемого вызовом поиска файлов. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.file_search_call.in_progress.
Возможные значения: response.file_search_call.in_progress
Да

OpenAI.ResponseFileSearchCallSearchingEvent

Генерируется во время текущего поиска файла.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор выходного элемента, инициируемого вызовом поиска файлов. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.file_search_call.searching.
Возможные значения: response.file_search_call.searching
Да

OpenAI.ResponseFormatJsonObject

Формат отклика объекта JSON. Старый метод создания ответов JSON. Рекомендуется использовать json_schema для моделей, поддерживающих его. Обратите внимание, что модель не генерирует JSON без указания системы или пользовательского сообщения to e.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип определяемого формата ответа. Всегда json_object.
Возможные значения: json_object
Да

OpenAI.ResponseFormatJsonSchema

Формат ответа схемы JSON. Используется для создания структурированных ответов JSON. Узнайте больше о Structured Outputs.

Имя. Тип Description Обязательно По умолчанию
JSON-схема OpenAI.ResponseFormatJsonSchemaJsonSchemaSchema Да
└─ Описание струна нет
└️ имя струна Да
└─ Схема OpenAI.ResponseFormatJsonSchema Схема формата ответа, описанная как объект схемы JSON.
Узнайте, как создать схемы JSON здесь.
нет
└─ строгий Булев (нулируемый) нет
type перечисление Тип определяемого формата ответа. Всегда json_schema.
Возможные значения: json_schema
Да

OpenAI.ResponseFormatJsonSchemaJsonSchemaSchema

Имя. Тип Description Обязательно По умолчанию
описание струна нет
имя струна Да
schema OpenAI.ResponseFormatJsonSchema Схема формата ответа, описанная как объект схемы JSON.
Узнайте, как создать схемы JSON здесь.
нет
строгий Булев (нулируемый) нет

OpenAI.ResponseFormatJsonSchema

Схема формата ответа, описанная как объект схемы JSON. Узнайте, как создать схемы JSON здесь.

Тип: объект

OpenAI.ResponseFormatText

Формат ответа по умолчанию. Используется для создания текстовых ответов.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип определяемого формата ответа. Всегда text.
Возможные значения: text
Да

OpenAI.ResponseFunctionCallArgumentsDeltaEvent

Создается при наличии разностных аргументов вызова функции.

Имя. Тип Description Обязательно По умолчанию
delta струна Добавлен аргумент вызова функции, представляющий дельту. Да
item_id струна Идентификатор выходного элемента, к которому добавляется дельта аргументов вызова функции. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.function_call_arguments.delta.
Возможные значения: response.function_call_arguments.delta
Да

OpenAI.ResponseFunctionCallArgumentsDoneEvent

Вызывается, когда аргументы вызова функции завершены.

Имя. Тип Description Обязательно По умолчанию
arguments струна Аргументы вызова функции. Да
item_id струна Идентификатор элемента. Да
имя струна Имя вызываемой функции. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление
Возможные значения: response.function_call_arguments.done
Да

OpenAI.ResponseImageGenCallCompletedEvent

Сигнализируется при завершении вызова инструмента генерации изображений и доступности окончательного изображения.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор обрабатываемого элемента создания изображения. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.image_generation_call.completed".
Возможные значения: response.image_generation_call.completed
Да

OpenAI.ResponseImageGenCallGeneratingEvent

При вызове средства генерации изображений происходит генерация изображения (промежуточное состояние).

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор обрабатываемого элемента создания изображения. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда «response.image_generation_call.generating».
Возможные значения: response.image_generation_call.generating
Да

OpenAI.ResponseImageGenCallInProgressEvent

Излучается, когда происходит вызов средства создания изображений.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор обрабатываемого элемента создания изображения. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда «response.image_generation_call.in_progress».
Возможные значения: response.image_generation_call.in_progress
Да

OpenAI.ResponseImageGenCallPartialImageEvent

Создается при наличии частичного образа во время потоковой передачи изображений.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор обрабатываемого элемента создания изображения. Да
output_index OpenAI.integer Да
partial_image_b64 струна Данные частичного изображения в кодировке Base64, которые могут быть отображены как изображение. Да
partial_image_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.image_generation_call.partial_image".
Возможные значения: response.image_generation_call.partial_image
Да

OpenAI.ResponseInProgressEvent

Генерируется во время обработки ответа.

Имя. Тип Description Обязательно По умолчанию
response OpenAI.Response Да
└agent_reference AgentReference (nullable) Агент, используемый для этого ответа Да
└─ Фон Булев (нулируемый) нет
└️ completed_at целое число (nullable) нет
Беседа └️ OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
└️ created_at целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
└─ Ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
Идентификатор └️ струна Уникальный идентификатор для этого ответа. Да
└️ incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└ Инструкции строка или массив OpenAI.InputItem (nullable) Да
└️ max_output_tokens OpenAI.integer (nullable) нет
└️ max_tool_calls OpenAI.integer (nullable) нет
└─ Метаданные OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
└─ Модель струна Развертывание модели, используемое для создания этого ответа. нет
└─ Объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
вывод └─ массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
└️ output_text Строка (нулевая) нет
└─ вызовы_инструментов_в_параллельном_режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
└previous_response_id Строка (нулевая) нет
└─ Запрос OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
└prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
└prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
└─ рассуждения OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
└safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
└service_tier OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
└─ Состояние перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
└─ Температура OpenAI.numeric (nullable) нет 1
Текст └️ OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
└─ выбор_инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
└─ Инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
└️ top_logprobs OpenAI.integer (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
└️ усечение перечисление
Возможные значения: auto, disabled
нет
└─ использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь └️ string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.in_progress.
Возможные значения: response.in_progress
Да

OpenAI.ResponseIncompleteDetails

Имя. Тип Description Обязательно По умолчанию
причина перечисление
Возможные значения: max_output_tokens, content_filter
нет

OpenAI.ResponseIncompleteEvent

Событие, которое возникает, когда ответ завершается неполным.

Имя. Тип Description Обязательно По умолчанию
response OpenAI.Response Да
└agent_reference AgentReference (nullable) Агент, используемый для этого ответа Да
└─ Фон Булев (нулируемый) нет
└️ completed_at целое число (nullable) нет
Беседа └️ OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
└️ created_at целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
└─ Ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
Идентификатор └️ струна Уникальный идентификатор для этого ответа. Да
└️ incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└ Инструкции строка или массив OpenAI.InputItem (nullable) Да
└️ max_output_tokens OpenAI.integer (nullable) нет
└️ max_tool_calls OpenAI.integer (nullable) нет
└─ Метаданные OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
└─ Модель струна Развертывание модели, используемое для создания этого ответа. нет
└─ Объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
вывод └─ массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
└️ output_text Строка (нулевая) нет
└─ вызовы_инструментов_в_параллельном_режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
└previous_response_id Строка (нулевая) нет
└─ Запрос OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
└prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
└prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
└─ рассуждения OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
└safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
└service_tier OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
└─ Состояние перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
└─ Температура OpenAI.numeric (nullable) нет 1
Текст └️ OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
└─ выбор_инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
└─ Инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
└️ top_logprobs OpenAI.integer (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
└️ усечение перечисление
Возможные значения: auto, disabled
нет
└─ использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь └️ string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.incomplete.
Возможные значения: response.incomplete
Да

OpenAI.ResponseLogProb

Logprob — это логарифмическая вероятность того, что модель назначает определенному маркеру по заданной позиции в последовательности. Менее отрицательные (более высокие) значения logprob указывают на большее доверие модели к выбору маркера.

Имя. Тип Description Обязательно По умолчанию
logprob OpenAI.numeric Да
token струна Возможный текстовый маркер. Да
top_logprobs массив OpenAI.ResponseLogProbTopLogprobs Вероятность ведения журнала наиболее вероятных маркеров из 20 лучших. нет

OpenAI.ResponseLogProbTopLogprobs

Имя. Тип Description Обязательно По умолчанию
logprob OpenAI.numeric нет
token струна нет

OpenAI.ResponseMCPCallArgumentsDeltaEvent

Выдается, когда происходит разностное (частичное) обновление аргументов вызова средства MCP.

Имя. Тип Description Обязательно По умолчанию
delta струна Строка JSON, содержащая частичное обновление аргументов для вызова средства MCP. Да
item_id струна Уникальный идентификатор обрабатываемого элемента вызова средства MCP. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_call_arguments.delta".
Возможные значения: response.mcp_call_arguments.delta
Да

OpenAI.ResponseMCPCallArgumentsDoneEvent

Генерируется, когда аргументы для вызова инструмента MCP завершены.

Имя. Тип Description Обязательно По умолчанию
arguments струна Строка JSON, содержащая завершенные аргументы для вызова средства MCP. Да
item_id струна Уникальный идентификатор обрабатываемого элемента вызова средства MCP. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_call_arguments.готово".
Возможные значения: response.mcp_call_arguments.done
Да

OpenAI.ResponseMCPCallCompletedEvent

Срабатывает при успешном выполнении вызова средства MCP.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор завершенного элемента вызова средства MCP. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда «response.mcp_call.completed».
Возможные значения: response.mcp_call.completed
Да

OpenAI.ResponseMCPCallFailedEvent

Создается при сбое вызова средства MCP.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор элемента вызова средства MCP, который завершился сбоем. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_call.failed".
Возможные значения: response.mcp_call.failed
Да

OpenAI.ResponseMCPCallInProgressEvent

Испускается в процессе выполнения вызова средства MCP.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор обрабатываемого элемента вызова средства MCP. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_call.in_progress".
Возможные значения: response.mcp_call.in_progress
Да

OpenAI.ResponseMCPListToolsCompletedEvent

Инициируется при успешном получении списка доступных средств MCP.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор элемента вызова средства MCP, создающего эти выходные данные. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_list_tools.completed".
Возможные значения: response.mcp_list_tools.completed
Да

OpenAI.ResponseMCPListToolsFailedEvent

Возникает при сбое попытки перечисления доступных средств MCP.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор элемента вызова средства MCP, который завершился сбоем. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_list_tools.failed".
Возможные значения: response.mcp_list_tools.failed
Да

OpenAI.ResponseMCPListToolsInProgressEvent

Подается сигнал, когда система находится в процессе получения списка доступных инструментов MCP.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор обрабатываемого элемента вызова средства MCP. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.mcp_list_tools.in_progress".
Возможные значения: response.mcp_list_tools.in_progress
Да

OpenAI.ResponseOutputItemAddedEvent

Создается при добавлении нового выходного элемента.

Имя. Тип Description Обязательно По умолчанию
item OpenAI.OutputItem Да
└agent_reference AgentReference Агент, создавший элемент. нет
└️ response_id струна Ответ, на котором создается элемент. нет
└─ Тип OpenAI.OutputItemType Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.output_item.added.
Возможные значения: response.output_item.added
Да

OpenAI.ResponseOutputItemDoneEvent

Излучается, когда выходной элемент помечен как завершенный.

Имя. Тип Description Обязательно По умолчанию
item OpenAI.OutputItem Да
└agent_reference AgentReference Агент, создавший элемент. нет
└️ response_id струна Ответ, на котором создается элемент. нет
└─ Тип OpenAI.OutputItemType Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.output_item.done.
Возможные значения: response.output_item.done
Да

OpenAI.ResponseOutputTextAnnotationAddedEvent

Создается при добавлении заметки в выходное текстовое содержимое.

Имя. Тип Description Обязательно По умолчанию
annotation OpenAI.Annotation Заметка, которая применяется к диапазону выходного текста. Да
└─ Тип OpenAI.AnnotationType Да
annotation_index OpenAI.integer Да
content_index OpenAI.integer Да
item_id струна Уникальный идентификатор элемента, к которому добавляется заметка. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда "response.output_text.annotation.added".
Возможные значения: response.output_text.annotation.added
Да

OpenAI.ResponsePromptVariables

Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы.

Тип: объект

OpenAI.ResponseQueuedEvent

Возникает, когда ответ поставлен в очередь и ожидает обработки.

Имя. Тип Description Обязательно По умолчанию
response OpenAI.Response Да
└agent_reference AgentReference (nullable) Агент, используемый для этого ответа Да
└─ Фон Булев (нулируемый) нет
└️ completed_at целое число (nullable) нет
Беседа └️ OpenAI.ConversationReference (допускает значение NULL) Беседа, к которой относится этот ответ. Входные элементы и выходные элементы из этого ответа были автоматически добавлены в эту беседу. нет
└️ created_at целое число Метка времени в формате Unix (в секундах), когда был создан этот ответ. Да
└─ Ошибка OpenAI.ResponseError (nullable) Объект ошибки, возвращаемый, когда модель не сможет создать ответ. Да
Идентификатор └️ струна Уникальный идентификатор для этого ответа. Да
└️ incomplete_details OpenAI.ResponseIncompleteDetails (nullable) Да
└ Инструкции строка или массив OpenAI.InputItem (nullable) Да
└️ max_output_tokens OpenAI.integer (nullable) нет
└️ max_tool_calls OpenAI.integer (nullable) нет
└─ Метаданные OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
└─ Модель струна Развертывание модели, используемое для создания этого ответа. нет
└─ Объект перечисление Тип объекта этого ресурса — всегда установлено response.
Возможные значения: response
Да
вывод └─ массив OpenAI.OutputItem Массив элементов контента, созданных моделью.
— Длина и порядок элементов в массиве output зависят
в ответе модели.
— Вместо доступа к первому элементу в массиве output и
Предположим, что это assistant сообщение с содержанием, созданным
Вы можете рассмотреть возможность использования свойства output_text модели, если
поддерживается в пакетах SDK.
Да
└️ output_text Строка (нулевая) нет
└─ вызовы_инструментов_в_параллельном_режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно. Да True
└previous_response_id Строка (нулевая) нет
└─ Запрос OpenAI.Prompt Ссылка на шаблон запроса и его переменные.
Узнать больше.
нет
└prompt_cache_key струна Используется OpenAI для кэширования ответов для аналогичных запросов для оптимизации частоты попаданий кэша. Заменяет user поле. Узнать больше. нет
└prompt_cache_retention перечисление
Возможные значения: in-memory, 24h
нет
└─ рассуждения OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
└safety_identifier струна Стабильный идентификатор, используемый для обнаружения пользователей приложения, которые могут нарушать политики использования OpenAI.
Идентификаторы должны быть строкой, которая однозначно идентифицирует каждого пользователя. Мы рекомендуем хэшировать имя пользователя или адрес электронной почты, чтобы избежать отправки нам каких-либо сведений об идентификации. Узнать больше.
нет
└service_tier OpenAI.ServiceTier Указывает тип обработки, используемый для обслуживания запроса.
- Если установлено на 'auto', то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
— Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установить 'flex' или 'priority', запрос будет обработан с соответствующим уровнем сервиса.
— Если не задано, поведение по умолчанию — auto.
service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
нет
└─ Состояние перечисление Статус формирования ответа. Один из completed, failed
in_progress, cancelled, queued или incomplete.
Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete
нет
└─ Температура OpenAI.numeric (nullable) нет 1
Текст └️ OpenAI.ResponseTextParam Параметры конфигурации для текстового ответа модели. Может быть простым
текстовые или структурированные данные JSON. Подробнее:
- Текстовые входы и выходы
- структурированные выходы
нет
└─ выбор_инструмента OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceParam нет
└─ Инструменты OpenAI.ToolsArray Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
Мы поддерживаем следующие категории инструментов:
- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели, такие как веб-поиск
или файл поиск. Дополнительные сведения
встроенные инструменты.
- Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP
или предопределенные соединители, такие как Google Drive и SharePoint. Дополнительные сведения
MCP Tools.
- Вызовы функций (пользовательские средства): функции, определенные вами,
включение модели для вызова собственного кода с строго типизированными аргументами
и выходные данные. Дополнительные сведения
вызов функций. Вы также можете использовать
пользовательские средства для вызова собственного кода.
нет
└️ top_logprobs OpenAI.integer (nullable) нет
└️ top_p OpenAI.numeric (nullable) нет 1
└️ усечение перечисление
Возможные значения: auto, disabled
нет
└─ использование OpenAI.ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры,
разбивка выходных маркеров и общих используемых маркеров.
нет
Пользователь └️ string (не рекомендуется) Это поле заменяется safety_identifier и prompt_cache_key. Вместо этого используйте prompt_cache_key для поддержания оптимизации кэширования.
Стабильный идентификатор для конечных пользователей.
Используется для повышения скорости попадания кэша в более эффективное сегментирование аналогичных запросов и помогает OpenAI обнаруживать и предотвращать злоупотребление. Узнать больше.
нет
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда «response.queued».
Возможные значения: response.queued
Да

OpenAI.ResponseReasoningSummaryPartAddedEvent

Выдается при добавлении нового раздела резюме рассуждений.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор элемента, с которым связана эта сводная часть. Да
output_index OpenAI.integer Да
part OpenAI.ResponseReasoningSummaryPartAddedEventPart Да
Текст └️ струна Да
└─ Тип перечисление
Возможные значения: summary_text
Да
sequence_number OpenAI.integer Да
summary_index OpenAI.integer Да
type перечисление тип события; Всегда response.reasoning_summary_part.added.
Возможные значения: response.reasoning_summary_part.added
Да

OpenAI.ResponseReasoningSummaryPartAddedEventPart

Имя. Тип Description Обязательно По умолчанию
текст струна Да
type перечисление
Возможные значения: summary_text
Да

OpenAI.ResponseReasoningSummaryPartDoneEvent

Испускается при завершении части обоснования.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор элемента, с которым связана эта сводная часть. Да
output_index OpenAI.integer Да
part OpenAI.ResponseReasoningSummaryPartDoneEventPart Да
Текст └️ струна Да
└─ Тип перечисление
Возможные значения: summary_text
Да
sequence_number OpenAI.integer Да
summary_index OpenAI.integer Да
type перечисление тип события; Всегда response.reasoning_summary_part.done.
Возможные значения: response.reasoning_summary_part.done
Да

OpenAI.ResponseReasoningSummaryPartDoneEventPart

Имя. Тип Description Обязательно По умолчанию
текст струна Да
type перечисление
Возможные значения: summary_text
Да

OpenAI.ResponseReasoningSummaryTextDeltaEvent

Создается при добавлении разностного изменения в текст сводной информации.

Имя. Тип Description Обязательно По умолчанию
delta струна Изменения текста, добавленные в сводку. Да
item_id струна Идентификатор элемента, с которым связана разность текста сводки. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
summary_index OpenAI.integer Да
type перечисление тип события; Всегда response.reasoning_summary_text.delta.
Возможные значения: response.reasoning_summary_text.delta
Да

OpenAI.ResponseReasoningSummaryTextDoneEvent

Генерируется при завершении сводного текста аргументирования.

Имя. Тип Description Обязательно По умолчанию
item_id струна Идентификатор элемента, с которым связан текст сводки. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
summary_index OpenAI.integer Да
текст струна Полный текст завершенной сводки об обосновании. Да
type перечисление тип события; Всегда response.reasoning_summary_text.done.
Возможные значения: response.reasoning_summary_text.done
Да

OpenAI.ResponseReasoningTextDeltaEvent

Создается при добавлении разностного изменения в текст причины.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
delta струна Разностный текст, добавленный в содержимое причины. Да
item_id струна Идентификатор элемента, с которым связан разностный текст. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.reasoning_text.delta.
Возможные значения: response.reasoning_text.delta
Да

OpenAI.ResponseReasoningTextDoneEvent

Создается при завершении текста причины.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
item_id струна Идентификатор элемента, с которым связан текст причины. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
текст струна Полный текст завершенного содержимого аргументирования. Да
type перечисление тип события; Всегда response.reasoning_text.done.
Возможные значения: response.reasoning_text.done
Да

OpenAI.ResponseRefusalDeltaEvent

Срабатывает при наличии частичного текста отказа.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
delta струна Добавлен текст отказа. Да
item_id струна Идентификатор выходного элемента, к которому добавляется текст отказа. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.refusal.delta.
Возможные значения: response.refusal.delta
Да

OpenAI.ResponseRefusalDoneEvent

Воспроизводится, когда текст отказа окончательно сформирован.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
item_id струна Идентификатор выходного элемента, имеющего окончательный текст отказа. Да
output_index OpenAI.integer Да
отказ струна Текст отказа, завершенный. Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.refusal.done.
Возможные значения: response.refusal.done
Да

OpenAI.ResponseStreamOptions

Параметры потоковых ответов. Этот параметр устанавливается только при установке stream: true.

Имя. Тип Description Обязательно По умолчанию
include_obfuscation булевый Если задано значение true, будет включена обфускация потока. Добавляется скрытие потока
случайные символы в поле потоковой передачи obfuscation событий разностных событий в
нормализованные размеры полезных данных в качестве устранения определенных атак на стороне канала.
Эти поля маскировки включены по умолчанию, но добавьте небольшое количество.
затраты на поток данных. Можно задать значение include_obfuscation
False для оптимизации пропускной способности, если вы доверяете сетевым каналам между
приложение и API OpenAI.
нет

OpenAI.ResponseTextDeltaEvent

Создается при наличии дополнительного разностного текста.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
delta струна Добавлена разностная строка текста. Да
item_id струна Идентификатор выходного элемента, к которому была добавлена текстовая дельта. Да
logprobs массив OpenAI.ResponseLogProb Вероятности журналов маркеров в разностном формате. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.output_text.delta.
Возможные значения: response.output_text.delta
Да

OpenAI.ResponseTextDoneEvent

Излучается при завершении работы с текстовым содержимым.

Имя. Тип Description Обязательно По умолчанию
content_index OpenAI.integer Да
item_id струна Идентификатор выходного элемента, для которого завершается текстовое содержимое. Да
logprobs массив OpenAI.ResponseLogProb Вероятности журналов маркеров в разностном формате. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
текст струна Текстовое содержимое, завершенное. Да
type перечисление тип события; Всегда response.output_text.done.
Возможные значения: response.output_text.done
Да

OpenAI.ResponseTextParam

Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. Подробнее:

Имя. Тип Description Обязательно По умолчанию
format OpenAI.TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.
{ "type": "json_schema" } Настройка включает структурированные выходные данные,
это гарантирует, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в разделе

Формат по умолчанию — это { "type": "text" } без дополнительных параметров.
*Не рекомендуется для gpt-4o и более новых моделей:**
Установка { "type": "json_object" } включает старый режим JSON, который
гарантирует, что сообщение, которое создает модель, является допустимым JSON. С использованием json_schema
предпочтителен для моделей, поддерживающих его.
нет
многословие OpenAI.Verbosity Ограничивает многословность ответа модели. Более низкие значения будут приводить к
более краткие ответы, в то время как более высокие значения приводят к более подробным ответам.
В настоящее время поддерживаются lowзначения , mediumи high.
нет

OpenAI.ResponseUsage

Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры.

Имя. Тип Description Обязательно По умолчанию
input_tokens OpenAI.integer Да
input_tokens_details OpenAI.ResponseUsageInputTokensDetails Да
└ cached_tokens OpenAI.integer Да
output_tokens OpenAI.integer Да
output_tokens_details OpenAI.ResponseUsageOutputTokensDetails Да
└️ reasoning_tokens OpenAI.integer Да
общее количество токенов OpenAI.integer Да

OpenAI.ResponseUsageInputTokensDetails

Имя. Тип Description Обязательно По умолчанию
cached_tokens OpenAI.integer Да

OpenAI.ResponseUsageOutputTokensDetails

Имя. Тип Description Обязательно По умолчанию
токены рассуждений OpenAI.integer Да

OpenAI.ResponseWebSearchCallCompletedEvent

Создается при завершении вызова веб-поиска.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор выходного элемента, связанного с вызовом веб-поиска. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.web_search_call.completed.
Возможные значения: response.web_search_call.completed
Да

OpenAI.ResponseWebSearchCallInProgressEvent

Создается при инициировании вызова поиска в Интернете.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор выходного элемента, связанного с вызовом веб-поиска. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.web_search_call.in_progress.
Возможные значения: response.web_search_call.in_progress
Да

OpenAI.ResponseWebSearchCallSearchingEvent

Создается при выполнении вызова веб-поиска.

Имя. Тип Description Обязательно По умолчанию
item_id струна Уникальный идентификатор выходного элемента, связанного с вызовом веб-поиска. Да
output_index OpenAI.integer Да
sequence_number OpenAI.integer Да
type перечисление тип события; Всегда response.web_search_call.searching.
Возможные значения: response.web_search_call.searching
Да

OpenAI.Screenshot

Действие с снимком экрана.

Имя. Тип Description Обязательно По умолчанию
type перечисление Указывает тип события. Для действия с снимка экрана это свойство
всегда задано значение screenshot.
Возможные значения: screenshot
Да

OpenAI.Scroll

Действие прокрутки.

Имя. Тип Description Обязательно По умолчанию
scroll_x OpenAI.integer Да
scroll_y OpenAI.integer Да
type перечисление Указывает тип события. Для действия прокрутки это свойство имеет значение
всегда задано значение scroll.
Возможные значения: scroll
Да
x OpenAI.integer Да
и OpenAI.integer Да

OpenAI.SearchContextSize

Недвижимость Ценность
Тип струна
Значения low
medium
high

OpenAI.ServiceTier

Указывает тип обработки, используемый для обслуживания запроса.

  • Если настроено на «auto», то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
  • Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
  • Если установлен на 'flex' или 'priority', то запрос будет обработан с соответствующим уровнем сервиса.
  • Если не задано, поведение по умолчанию — "auto". service_tier Если параметр задан, текст ответа будет включать service_tier значение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
Недвижимость Ценность
Тип струна
Nullable Да
Значения auto
default
flex
scale
priority

OpenAI.SpecificApplyPatchParam

Заставляет модель вызывать средство apply_patch при выполнении вызова средства.

Имя. Тип Description Обязательно По умолчанию
type перечисление Средство для вызова. Всегда apply_patch.
Возможные значения: apply_patch
Да

OpenAI.SpecificFunctionShellParam

Заставляет модель вызывать средство оболочки при необходимости вызова средства.

Имя. Тип Description Обязательно По умолчанию
type перечисление Средство для вызова. Всегда shell.
Возможные значения: shell
Да

OpenAI.Summary

Краткий текст из модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Краткое изложение результатов рассуждения модели на данный момент. Да
type перечисление Тип объекта . Всегда summary_text.
Возможные значения: summary_text
Да

OpenAI.SummaryTextContent

Краткий текст из модели.

Имя. Тип Description Обязательно По умолчанию
текст струна Краткое изложение результатов рассуждения модели на данный момент. Да
type перечисление Тип объекта . Всегда summary_text.
Возможные значения: summary_text
Да

OpenAI.TextContent

Текстовое содержимое.

Имя. Тип Description Обязательно По умолчанию
текст струна Да
type перечисление
Возможные значения: text
Да

OpenAI.TextResponseFormatConfiguration

Объект, указывающий формат, который должен выводить модель. Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в разделе

Формат по умолчанию — это { "type": "text" } без дополнительных параметров. Не рекомендуется для GPT-4o и более новых моделей:* Настройка для { "type": "json_object" } включения старого режима JSON, который гарантирует, что сообщение, которое генерирует модель, является действительным JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.

Дискриминация для OpenAI.TextResponseFormatConfiguration

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
json_schema OpenAI.TextResponseFormatJsonSchema
text OpenAI.TextResponseFormatConfigurationResponseFormatText
json_object OpenAI.TextResponseFormatConfigurationResponseFormatJsonObject
Имя. Тип Description Обязательно По умолчанию
type OpenAI.TextResponseFormatConfigurationType Да

OpenAI.TextResponseFormatConfigurationResponseFormatJsonObject

Формат отклика объекта JSON. Старый метод создания ответов JSON. Рекомендуется использовать json_schema для моделей, поддерживающих его. Обратите внимание, что модель не генерирует JSON без указания системы или пользовательского сообщения to e.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип определяемого формата ответа. Всегда json_object.
Возможные значения: json_object
Да

OpenAI.TextResponseFormatConfigurationResponseFormatText

Формат ответа по умолчанию. Используется для создания текстовых ответов.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип определяемого формата ответа. Всегда text.
Возможные значения: text
Да

OpenAI.TextResponseFormatConfigurationType

Недвижимость Ценность
Тип струна
Значения text
json_schema
json_object

OpenAI.TextResponseFormatJsonSchema

Формат ответа схемы JSON. Используется для создания структурированных ответов JSON. Узнайте больше о Structured Outputs.

Имя. Тип Description Обязательно По умолчанию
описание струна Описание формата ответа, который модель использует для выполнения своих задач.
определите, как реагировать в рамках заданного формата.
нет
имя струна Имя формата ответа. Должен содержать латинские буквы a-z, A-Z или цифры 0-9.
символы подчеркивания и дефисы с максимальной длиной 64.
Да
schema OpenAI.ResponseFormatJsonSchema Схема формата ответа, описанная как объект схемы JSON.
Узнайте, как создать схемы JSON здесь.
Да
строгий Булев (нулируемый) нет
type перечисление Тип определяемого формата ответа. Всегда json_schema.
Возможные значения: json_schema
Да

OpenAI.Tool

Средство, которое можно использовать для создания ответа.

Дискриминатор для OpenAI.Инструмент

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
bing_grounding BingGroundingTool
fabric_dataagent_preview MicrosoftFabricPreviewTool
sharepoint_grounding_preview SharepointPreviewTool
azure_ai_search AzureAISearchTool
openapi OpenApiTool
bing_custom_search_preview BingCustomSearchPreviewTool
browser_automation_preview BrowserAutomationPreviewTool
azure_function AzureFunctionTool
capture_structured_outputs CaptureStructuredOutputsTool
a2a_preview A2APreviewTool
memory_search_preview MemorySearchPreviewTool
code_interpreter OpenAI.CodeInterpreterTool
function OpenAI.FunctionTool
file_search OpenAI.FileSearchTool
computer_use_preview OpenAI.ComputerUsePreviewTool
web_search OpenAI.WebSearchTool
mcp OpenAI.MCPTool
image_generation OpenAI.ImageGenTool
local_shell OpenAI.LocalShellToolParam
shell OpenAI.FunctionShellToolParam
custom OpenAI.CustomToolParam
web_search_preview OpenAI.WebSearchPreviewTool
apply_patch OpenAI.ApplyPatchToolParam
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ToolType Да

OpenAI.ToolChoiceAllowed

Ограничивает средства, доступные для модели, предварительно определенным набором.

Имя. Тип Description Обязательно По умолчанию
mode перечисление Ограничивает средства, доступные для модели, предварительно определенным набором.
auto позволяет модели выбирать из разрешенных средств и создавать
Сообщение.
required требуется, чтобы модель вызывала один или несколько разрешенных средств.
Возможные значения: auto, required
Да
инструменты массив объекта Список определений инструментов, которые модель должна быть разрешена для вызова.
Для API ответов список определений инструментов может выглядеть следующим образом:
json<br> [<br> { "type": "function", "name": "get_weather" },<br> { "type": "mcp", "server_label": "deepwiki" },<br> { "type": "image_generation" }<br> ]<br>
Да
type перечисление Разрешенный тип конфигурации средства. Всегда allowed_tools.
Возможные значения: allowed_tools
Да

OpenAI.ToolChoiceCodeInterpreter

Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: code_interpreter
Да

OpenAI.ToolChoiceComputerUsePreview

Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: computer_use_preview
Да

OpenAI.ToolChoiceCustom

Используйте этот параметр для принудительного вызова модели определенного пользовательского инструмента.

Имя. Тип Description Обязательно По умолчанию
имя струна Имя вызываемого пользовательского средства. Да
type перечисление Для вызова пользовательского инструмента всегда используется customтип.
Возможные значения: custom
Да

OpenAI.ToolChoiceFileSearch

Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: file_search
Да

OpenAI.ToolChoiceFunction

Используйте этот параметр, чтобы принудительно вызвать определенную функцию.

Имя. Тип Description Обязательно По умолчанию
имя струна Имя вызываемой функции. Да
type перечисление Для вызова функции тип всегда function.
Возможные значения: function
Да

OpenAI.ToolChoiceImageGeneration

Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: image_generation
Да

OpenAI.ToolChoiceMCP

Используйте этот параметр, чтобы принудительно вызвать определенное средство на удаленном сервере MCP.

Имя. Тип Description Обязательно По умолчанию
имя Строка (нулевая) нет
метка сервера струна Метка используемого сервера MCP. Да
type перечисление Для инструментов MCP всегда используется mcpтип.
Возможные значения: mcp
Да

OpenAI.ToolChoiceOptions

Определяет, какое средство (если таковое) вызывается моделью. none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение. auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов. required означает, что модель должна вызывать один или несколько инструментов.

Недвижимость Ценность
Тип струна
Значения none
auto
required

OpenAI.ToolChoiceParam

Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать.

Дискриминация для OpenAI.ToolChoiceParam

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
allowed_tools OpenAI.ToolChoiceAllowed
function OpenAI.ToolChoiceFunction
mcp OpenAI.ToolChoiceMCP
custom OpenAI.ToolChoiceCustom
apply_patch OpenAI.SpecificApplyPatchParam
shell OpenAI.SpecificFunctionShellParam
file_search OpenAI.ToolChoiceFileSearch
web_search_preview OpenAI.ToolChoiceWebSearchPreview
computer_use_preview OpenAI.ToolChoiceComputerUsePreview
web_search_preview_2025_03_11 OpenAI.ToolChoiceWebSearchPreview20250311
image_generation OpenAI.ToolChoiceImageGeneration
code_interpreter OpenAI.ToolChoiceCodeInterpreter
Имя. Тип Description Обязательно По умолчанию
type OpenAI.ToolChoiceParamType Да

OpenAI.ToolChoiceParamType

Недвижимость Ценность
Тип струна
Значения allowed_tools
function
mcp
custom
apply_patch
shell
file_search
web_search_preview
computer_use_preview
web_search_preview_2025_03_11
image_generation
code_interpreter

OpenAI.ToolChoiceWebSearchPreview

Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: web_search_preview
Да

OpenAI.ToolChoiceWebSearchPreview20250311

Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: web_search_preview_2025_03_11
Да

OpenAI.ToolType

Недвижимость Ценность
Тип струна
Значения function
file_search
computer_use_preview
web_search
mcp
code_interpreter
image_generation
local_shell
shell
custom
web_search_preview
apply_patch
a2a_preview
bing_custom_search_preview
browser_automation_preview
fabric_dataagent_preview
sharepoint_grounding_preview
memory_search_preview
azure_ai_search
azure_function
bing_grounding
capture_structured_outputs
openapi

OpenAI.ToolsArray

Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр. Мы поддерживаем следующие категории инструментов:

  • встроенные инструменты: инструменты, предоставляемые OpenAI и расширяющие возможности модели, такие как веб-поиск или файлный поиск. Узнайте больше о встроенных инструментах.
  • Инструменты MCP: интеграция с сторонними системами с помощью пользовательских серверов MCP или предопределенных соединителей, таких как Google Drive и SharePoint. Узнайте больше о инструментах MCP.
  • Вызовы функций (пользовательские средства): функции, определенные вами, что позволяет модели вызывать собственный код с строго типизированными аргументами и выходными данными. Узнайте больше о function calling. Вы также можете использовать пользовательские средства для вызова собственного кода.

Массив: OpenAI.Tool

OpenAI.TopLogProb

Верхняя вероятность использования маркера в журнале.

Имя. Тип Description Обязательно По умолчанию
байт массив OpenAI.integer Да
logprob OpenAI.numeric Да
token струна Да

OpenAI.Type

Действие для ввода текста.

Имя. Тип Description Обязательно По умолчанию
текст струна Текст для набора. Да
type перечисление Указывает тип события. Для действия типа это свойство имеет значение
всегда задано значение type.
Возможные значения: type
Да

OpenAI.UpdateConversationBody

Имя. Тип Description Обязательно По умолчанию
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
Да

OpenAI.UrlCitationBody

Ссылка на веб-ресурс, используемый для создания ответа модели.

Имя. Тип Description Обязательно По умолчанию
end_index OpenAI.integer Да
start_index OpenAI.integer Да
title струна Заголовок веб-ресурса. Да
type перечисление Тип URL-ссылки. Всегда url_citation.
Возможные значения: url_citation
Да
URL-адрес струна URL-адрес веб-ресурса. Да

OpenAI.VectorStoreFileAttributes

Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами.

Тип: объект

OpenAI.Verbosity

Ограничивает многословность ответа модели. Более низкие значения приведут к более кратким ответам, а более высокие — к более многословным ответам. В настоящее время поддерживаются lowзначения , mediumи high.

Недвижимость Ценность
Тип струна
Nullable Да
Значения low
medium
high

OpenAI.Wait

Действие ожидания.

Имя. Тип Description Обязательно По умолчанию
type перечисление Указывает тип события. Для действия ожидания это свойство имеет значение
всегда задано значение wait.
Возможные значения: wait
Да

OpenAI.WebSearchActionFind

Тип действия "find": выполняет поиск шаблона на загруженной странице.

Имя. Тип Description Обязательно По умолчанию
шаблон струна Шаблон или текст для поиска на странице. Да
type перечисление Тип действия.
Возможные значения: find_in_page
Да
URL-адрес струна URL-адрес страницы, найдите шаблон. Да

OpenAI.WebSearchActionOpenPage

Тип действия "open_page" — открывает определенный URL-адрес из результатов поиска.

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип действия.
Возможные значения: open_page
Да
URL-адрес струна URL-адрес, открытый моделью. Да

OpenAI.WebSearchActionSearch

Тип действия "поиск" — выполняет запрос веб-поиска.

Имя. Тип Description Обязательно По умолчанию
queries Массив строк Поисковые запросы. нет
query string (не рекомендуется) [НЕ РЕКОМЕНДУЕТСЯ] Поисковый запрос. Да
Источников массив OpenAI.WebSearchActionSearchSources Источники, использованные при поиске. нет
type перечисление Тип действия.
Возможные значения: search
Да

OpenAI.WebSearchActionSearchSources

Имя. Тип Description Обязательно По умолчанию
type перечисление
Возможные значения: url
Да
URL-адрес струна Да

OpenAI.WebSearchApproximateLocation

Приблизительное местоположение пользователя.

Имя. Тип Description Обязательно По умолчанию
city Строка (нулевая) нет
country Строка (нулевая) нет
region Строка (нулевая) нет
timezone Строка (нулевая) нет
type перечисление Тип приближения к расположению. Всегда approximate.
Возможные значения: approximate
нет

OpenAI.WebSearchPreviewTool

Этот инструмент ищет в интернете релевантные результаты для ответа. Узнайте больше об инструменте поиска веб.

Имя. Тип Description Обязательно По умолчанию
размер_контекста_поиска OpenAI.SearchContextSize нет
type перечисление Тип средства поиска в Интернете. Один из web_search_preview или web_search_preview_2025_03_11.
Возможные значения: web_search_preview
Да
местоположение пользователя OpenAI.ApproximateLocation (допустимое значение NULL) нет
└️ город Строка (нулевая) нет
└️ страна Строка (нулевая) нет
└️ регион Строка (нулевая) нет
└️ часовой пояс Строка (нулевая) нет
└─ Тип перечисление Тип приближения к расположению. Всегда approximate.
Возможные значения: approximate
Да

OpenAI.WebSearchTool

Ищите в Интернете источники, связанные с этим заданием. Узнайте больше об инструменте поиска веб.

Имя. Тип Description Обязательно По умолчанию
custom_search_configuration WebSearchConfiguration Конфигурация веб-поиска для пользовательского поиска bing нет
└instance_name instance_name струна Имя настраиваемого экземпляра конфигурации, заданного для конфигурации. Да
└project_connection_id струна Project connection id для заземления с пользовательским поиском bing Да
filters OpenAI.WebSearchToolFilters (nullable) нет
└allowed_domains массив строк (допускающий значение NULL) нет
размер_контекста_поиска перечисление Рекомендации высокого уровня для объема пространства контекстного окна, используемого для поиска. Один из low, medium, или high. medium — это значение по умолчанию.
Возможные значения: low, mediumhigh
нет
type перечисление Тип средства поиска в Интернете. Один из web_search или web_search_2025_08_26.
Возможные значения: web_search
Да
местоположение пользователя OpenAI.WebSearchApproximateLocation (nullable) Приблизительное местоположение пользователя. нет
└️ город Строка (нулевая) нет
└️ страна Строка (нулевая) нет
└️ регион Строка (нулевая) нет
└️ часовой пояс Строка (нулевая) нет
└─ Тип перечисление Тип приближения к расположению. Всегда approximate.
Возможные значения: approximate
нет

OpenAI.WebSearchToolFilters

Имя. Тип Description Обязательно По умолчанию
allowed_domains Массив строк нет

OpenAI.integer

Тип: целое число

Формат: int64

OpenAI.numeric

Тип: число

Формат: double

OpenApiAnonymousAuthDetails

Сведения о безопасности для анонимной проверки подлинности OpenApi

Имя. Тип Description Обязательно По умолчанию
type перечисление Тип объекта, который всегда является анонимным.
Возможные значения: anonymous
Да

OpenApiAuthDetails

сведения о проверке подлинности для OpenApiFunctionDefinition

Дискриминация для OpenApiAuthDetails

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
anonymous OpenApiAnonymousAuthDetails
project_connection OpenApiProjectConnectionAuthDetails
managed_identity OpenApiManagedAuthDetails
Имя. Тип Description Обязательно По умолчанию
type OpenApiAuthType Тип аутентификации для конечной точки OpenApi. Допустимые типы:
— анонимный (проверка подлинности не требуется)
- Project Соединение (требует project_connection_id для конечной точки, как это установлено в AI Foundry)
— Managed_Identity (требуется аудитория для проверки подлинности на основе удостоверений)
Да

OpenApiAuthType

Тип аутентификации для конечной точки OpenApi. Допустимые типы:

  • Анонимный (аутентификация не требуется)
  • Project Соединение (требует project_connection_id для конечной точки, как это установлено в AI Foundry)
  • Managed_Identity (требуется аудитория для аутентификации на основе удостоверений)
Недвижимость Ценность
Описание Тип аутентификации для конечной точки OpenApi. Допустимые типы:
— анонимный (проверка подлинности не требуется)
- Project Соединение (требует project_connection_id для конечной точки, как это установлено в AI Foundry)
— Managed_Identity (требуется аудитория для проверки подлинности на основе удостоверений)
Тип струна
Значения anonymous
project_connection
managed_identity

OpenApiFunctionDefinition

Сведения об определении входных данных для функции openapi.

Имя. Тип Description Обязательно По умолчанию
auth OpenApiAuthDetails сведения о проверке подлинности для OpenApiFunctionDefinition Да
└─ Тип OpenApiAuthType Тип проверки подлинности должен быть анонимным/project_connection/managed_identity Да
default_params Массив строк Список параметров спецификации OpenAPI, которые будут использовать предоставленные пользователем значения по умолчанию нет
описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
functions массив объекта Список определений функций, используемых инструментом OpenApi нет
имя струна Имя вызываемой функции. Да
spec объект Фигура функции openapi, описанная как объект схемы JSON. Да

OpenApiManagedAuthDetails

Сведения о безопасности для проверки подлинности OpenApi managed_identity

Имя. Тип Description Обязательно По умолчанию
security_scheme OpenApiManagedSecurityScheme Схема безопасности для проверки подлинности OpenApi managed_identity Да
Аудитория └️ струна Область проверки подлинности для типа проверки подлинности managed_identity Да
type перечисление Тип объекта, который всегда является "managed_identity".
Возможные значения: managed_identity
Да

OpenApiManagedSecurityScheme

Схема безопасности для проверки подлинности OpenApi managed_identity

Имя. Тип Description Обязательно По умолчанию
audience струна Область проверки подлинности для типа проверки подлинности managed_identity Да

OpenApiProjectConnectionAuthDetails

Данные безопасности для аутентификации соединения OpenApi project

Имя. Тип Description Обязательно По умолчанию
security_scheme OpenApiProjectConnectionSecurityScheme Схема безопасности для проверки подлинности OpenApi managed_identity Да
└project_connection_id струна Project connection id для типа аутентификации Project Connection Да
type перечисление Тип объекта, который всегда равен 'project_connection'.
Возможные значения: project_connection
Да

OpenApiProjectConnectionSecurityScheme

Схема безопасности для проверки подлинности OpenApi managed_identity

Имя. Тип Description Обязательно По умолчанию
project_connection_id струна Project connection id для типа аутентификации Project Connection Да

OpenApiTool

Сведения об определении входных данных для средства OpenAPI, используемого для настройки агента.

Имя. Тип Description Обязательно По умолчанию
openapi OpenApiFunctionDefinition Сведения об определении входных данных для функции openapi. Да
└️ аутентификация OpenApiAuthDetails Сведения о проверке подлинности API Да
└️ default_params Массив строк Список параметров спецификации OpenAPI, которые будут использовать предоставленные пользователем значения по умолчанию нет
└─ Описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
Функции └️ массив объекта (только для чтения) Список определений функций, используемых инструментом OpenApi нет
└─ Описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
└️ имя струна Имя вызываемой функции. Да
└️ Параметры объект Параметры, которые принимают функции, описаны как объект схемы JSON. Да
└️ имя струна Имя вызываемой функции. Да
└️ спецификация объект Фигура функции openapi, описанная как объект схемы JSON. Да
type перечисление Тип объекта, которым всегда является 'openapi'.
Возможные значения: openapi
Да

PageOrder

Недвижимость Ценность
Тип струна
Значения asc
desc

PagedConnection

Страничная коллекция элементов Connection

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив подключения Элементы подключения на этой странице Да

PagedDatasetVersion

Выгруженная коллекция элементов DatasetVersion

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив DatasetVersion Элементы DatasetVersion на этой странице Да

PagedDeployment

Постраничная коллекция элементов развертывания

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив развертывания Элементы развертывания на этой странице Да

PagedEvaluationRule

Коллекция paged элементов EvaluationRule

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив EvaluationRule Элементы EvaluationRule на этой странице Да

PagedEvaluationTaxonomy

Коллекция paged элементов EvaluationTaxonomy

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив EvaluationTaxonomy Элементы EvaluationTaxonomy на этой странице Да

PagedEvaluatorVersion

Коллекция paged элементов ScoreorVersion

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив оценкиVersion Элементы ScoreorVersion на этой странице Да

PagedIndex

Страничная коллекция элементов указателя

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив индекса Элементы указателя на этой странице Да

PagedInsight

Коллекция элементов Аналитики со страницами

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив аналитических сведений Элементы аналитики на этой странице Да

PagedRedTeam

Страничная коллекция предметов RedTeam

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив RedTeam Элементы RedTeam на этой странице Да

PagedSchedule

Страничная коллекция элементов Schedule

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив schedule Элементы расписания на этой странице Да

PagedScheduleRun

Постраничная коллекция элементов ScheduleRun

Имя. Тип Description Обязательно По умолчанию
nextLink струна Ссылка на следующую страницу элементов нет
value массив ScheduleRun Элементы ScheduleRun на этой странице Да

PendingUploadRequest

Представляет запрос на ожидающую загрузку.

Имя. Тип Description Обязательно По умолчанию
connectionName струна Имя соединения Azure Storage Account для генерации временного токена SAS нет
pendingUploadId струна Если PendingUploadId не указан, будет использоваться случайный идентификатор GUID. нет
pendingUploadType перечисление BlobReference является единственным поддерживаемым типом.
Возможные значения: BlobReference
Да

ОжиданиеUploadResponse

Представляет ответ на ожидающий запрос на загрузку

Имя. Тип Description Обязательно По умолчанию
BLOBReference BlobReference Сведения о ссылке на BLOB-объекты. Да
└️ blobUri струна Путь URI большого двоичного объекта для клиента для отправки данных. Пример: https://blob.windows.core.net/Container/Path Да
Учетные данные └️ SasCredential Информация о учетных данных для access к аккаунту storage. Да
└️ storageAccountArmId струна ARM ID аккаунта storage для использования. Да
pendingUploadId струна ID для этого запроса на загрузку. Да
pendingUploadType перечисление BlobReference является единственным поддерживаемым типом
Возможные значения: BlobReference
Да
version струна Версия актива, которая должна быть создана, если пользователь не указал версию при первоначальном создании загрузки нет

PromptAgentDefinition

Определение агента запроса

Имя. Тип Description Обязательно По умолчанию
instructions Строка (нулевая) Сообщение системы (или разработчика), вставленное в контекст модели. нет
добрый перечисление
Возможные значения: prompt
Да
модель струна Модель развертывания, используемая для этого агента. Да
rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
└rai_policy_name струна Название политики RAI, которую необходимо применить. Да
reasoning OpenAI.Reasoning (nullable) Только модели gpt-5 и o-series
Параметры конфигурации для
модели рассуждений.
нет
- усилия OpenAI.ReasoningEffort Сдерживание усилий по поводу причины
модели рассуждений.
В настоящее время поддерживаемые значения — none, minimal, lowmediumhigh, , и xhigh. Уменьшение
Усилия рассуждения могут привести к более быстрым ответам и меньшему использованию маркеров.
о рассуждении в ответе.
- gpt-5.1 по умолчанию используется noneзначение , которое не выполняет причину. Поддерживаемые значения рассуждения для gpt-5.1 — , nonelow, medium, и high. Вызовы инструментов поддерживаются для всех значений причин в gpt-5.1.
— Все модели до выполнения действий по gpt-5.1 умолчанию medium и не поддерживаются none.
— Модель gpt-5-pro по умолчанию используется (и поддерживает только) high усилия по поводу.
- xhigh поддерживается для всех моделей после gpt-5.1-codex-max.
нет
└─generate_summary перечисление
Возможные значения: auto, concisedetailed
нет
└️ сводка перечисление
Возможные значения: auto, concisedetailed
нет
structured_inputs объект Набор структурированных входных данных, которые могут участвовать в подстановке шаблона или привязке аргументов инструмента. нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
текст PromptAgentDefinitionTextOptions Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. нет
└─ Формат OpenAI.TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.
{ "type": "json_schema" } Настройка включает структурированные выходные данные,
это гарантирует, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в разделе

Формат по умолчанию — это { "type": "text" } без дополнительных параметров.
*Не рекомендуется для gpt-4o и более новых моделей:**
Установка { "type": "json_object" } включает старый режим JSON, который
гарантирует, что сообщение, которое создает модель, является допустимым JSON. С использованием json_schema
предпочтителен для моделей, поддерживающих его.
нет
выбор инструмента string или OpenAI.ToolChoiceParam Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа.
Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать.
нет
инструменты массив OpenAI.Tool Массив инструментов, которые модель может вызывать при создании ответа. Вы
может указать, какое средство следует использовать, задав tool_choice параметр.
нет
top_p число/номер Альтернатива выборке с температурой, называемой выборкой ядра,
где модель рассматривает результаты маркеров с вероятностью top_p
масса. Таким образом, 0,1 означает только токены, составляющие верхние 10% массы вероятности%.
считаются.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1

PromptAgentDefinitionTextOptions

Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON.

Имя. Тип Description Обязательно По умолчанию
format OpenAI.TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.
{ "type": "json_schema" } Настройка включает структурированные выходные данные,
это гарантирует, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в разделе

Формат по умолчанию — это { "type": "text" } без дополнительных параметров.
*Не рекомендуется для gpt-4o и более новых моделей:**
Установка { "type": "json_object" } включает старый режим JSON, который
гарантирует, что сообщение, которое создает модель, является допустимым JSON. С использованием json_schema
предпочтителен для моделей, поддерживающих его.
нет

PromptBasedEvaluatorDefinition

Оценщик на основе подсказок

Имя. Тип Description Обязательно По умолчанию
data_schema объект Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
init_parameters объект Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. нет
metrics объект Список выходных метрик, полученных данным оценщиком нет
prompt_text струна Текст подсказки, используемый для оценки Да
type перечисление
Возможные значения: prompt
Да

ProtocolVersionRecord

Сопоставление записей для одного протокола и его версии.

Имя. Тип Description Обязательно По умолчанию
protocol AgentProtocol Да
version струна Строка версии для протокола, например 'v0.1.1'. Да

RaiConfig

Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI).

Имя. Тип Description Обязательно По умолчанию
rai_policy_name струна Название политики RAI, которую необходимо применить. Да

RecurrenceSchedule

Модель графика повторения.

Дискриминация для повторенияSchedule

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
Hourly HourlyRecurrenceSchedule
Daily DailyRecurrenceSchedule
Weekly WeeklyRecurrenceSchedule
Monthly MonthlyRecurrenceSchedule
Имя. Тип Description Обязательно По умолчанию
type RecurrenceType Тип рецидива. Да

RecurrenceTrigger

Триггер на основе рецидива.

Имя. Тип Description Обязательно По умолчанию
endTime струна Время окончания графика повторения в формате ISO 8601. нет
interval целое число Интервал для графика повторения. Да
планирование RecurrenceSchedule Модель графика повторения. Да
└─ Тип RecurrenceType Тип повторения для расписания повторения. Да
startTime струна Время начала составления графика повторения в формате ISO 8601. нет
часовой пояс струна Часовой пояс для расписания повторения. нет UTC
type перечисление Тип спускового крючка.
Возможные значения: Recurrence
Да

RecurrenceType

Тип рецидива.

Недвижимость Ценность
Описание Тип рецидива.
Тип струна
Значения Hourly
Daily
Weekly
Monthly

RedTeam

Красная команда.

Имя. Тип Description Обязательно По умолчанию
applicationScenario струна Сценарий приложения для операции красной команды для генерации атак, специфичных для конкретного сценария. нет
атакиStrategies массив АтакStrategy Список стратегий атак или вложенные списки стратегий атак. нет
отображаемое имя струна Название забега красной команды. нет
id строка (только для чтения) Идентификатор красной команды пробега. Да
numTurns целое число Количество раундов моделирования. нет
свойства объект Свойства красной команды. В отличие от тегов, свойства являются только надстройками. После добавления свойство невозможно удалить. нет
Категории рисков массив RiskCategory Список категорий риска для создания целей атаки. нет
имитацияOnly булевый Только симуляция или симуляция + оценка. По умолчанию false, если true, сканирование выводит диалог, а не результат оценки. нет Неправда
статус строка (только для чтения) Статус красной команды. Он задается сервисом и доступен только для чтения. нет
tags объект Метки красной команды. В отличие от свойств, теги полностью изменяются. нет
target TargetConfig Абстрактный класс для целевой конфигурации. Да
└─ Тип струна Тип конфигурации модели. Да

RedTeamEvalRunDataSource

Имя. Тип Description Обязательно По умолчанию
item_generation_params ItemGenerationParams Представляет набор параметров, используемых для управления операциями создания элементов. Да
└─ Тип ItemGenerationParamsType Тип параметров создания элементов, используемых. Да
target Цель Базовый класс для целей с поддержкой дискриминаторов. Да
└─ Тип струна Тип целевого объекта. Да
type перечисление Тип источника данных. Всегда azure_ai_red_team.
Возможные значения: azure_ai_red_team
Да

RedTeamItemGenerationParams

Имя. Тип Description Обязательно По умолчанию
attack_strategies массив АтакStrategy Коллекция стратегий атак, которые следует использовать. Да
num_turns целое число Количество поворотов, разрешенных в игре. Да 20
type перечисление Тип параметров создания элементов.
Возможные значения: red_team
Да

RedTeamSeedPromptsItemGenerationParams

Представляет параметры для создания элементов с начальным значением красной команды.

Имя. Тип Description Обязательно По умолчанию
attack_strategies массив АтакStrategy Коллекция стратегий атак, которые следует использовать. Да
num_turns целое число Количество поворотов, разрешенных в игре. Да 20
Источник OpenAI.EvalJsonlFileContentSource Да
└─ Содержимое массив OpenAI.EvalJsonlFileContentSourceContent Содержимое jsonl-файла. Да
└─ Тип перечисление Тип источника jsonl. Всегда file_content.
Возможные значения: file_content
Да
type перечисление Тип параметров создания элементов всегда red_team_seed_prompts.
Возможные значения: red_team_seed_prompts
Да

RedTeamTaxonomyItemGenerationParams

Представляет параметры для создания элементов таксономии красной команды.

Имя. Тип Description Обязательно По умолчанию
attack_strategies массив АтакStrategy Коллекция стратегий атак, которые следует использовать. Да
num_turns целое число Количество поворотов, разрешенных в игре. Да 20
Источник OpenAI.EvalJsonlFileContentSource Да
└─ Содержимое массив OpenAI.EvalJsonlFileContentSourceContent Содержимое jsonl-файла. Да
└─ Тип перечисление Тип источника jsonl. Всегда file_content.
Возможные значения: file_content
Да
type перечисление Тип параметров создания элементов всегда red_team_taxonomy.
Возможные значения: red_team_taxonomy
Да

ResponseRetrievalItemGenerationParams

Представляет параметры для создания элемента извлечения ответа.

Имя. Тип Description Обязательно По умолчанию
сопоставление данных объект Сопоставление из исходных полей в поле response_id, необходимое для получения журнала чата. Да
max_num_turns целое число Максимальное количество поворотов журнала чата для вычисления. Да
Источник OpenAI.EvalJsonlFileContentSource или OpenAI.EvalJsonlFileIdSource Источник, из которого считывается содержимое JSONL. Да
type перечисление Тип параметров создания элементов всегда response_retrieval.
Возможные значения: response_retrieval
Да

RiskCategory

Категория риска для цели атаки.

Недвижимость Ценность
Описание Категория риска для цели атаки.
Тип струна
Значения HateUnfairness
Violence
Sexual
SelfHarm
ProtectedMaterial
CodeVulnerability
UngroundedAttributes
ProhibitedActions
SensitiveDataLeakage
TaskAdherence

SASCredentials

Определение учетных данных Shared Access Signature (SAS)

Имя. Тип Description Обязательно По умолчанию
SAS строка (только для чтения) Маркер SAS нет
type перечисление Тип учетных данных
Возможные значения: SAS
Да

SampleType

Тип пробы, используемой при анализе.

Недвижимость Ценность
Описание Тип пробы, используемой при анализе.
Тип струна
Значения EvaluationResultSample

SasCredential

Определение учетных данных SAS

Имя. Тип Description Обязательно По умолчанию
sasUri строка (только для чтения) Универсальный код ресурса (URI) SAS Да
type перечисление Тип учетных данных
Возможные значения: SAS
Да

Расписание

Модель расписания.

Имя. Тип Description Обязательно По умолчанию
описание струна Описание расписания. нет
отображаемое имя струна Имя расписания. нет
enabled булевый Включен статус расписания. Да
id строка (только для чтения) Идентификатор расписания. Да
свойства объект Свойства расписания. В отличие от тегов, свойства являются только надстройками. После добавления свойство невозможно удалить. нет
provisioningStatus ScheduleProvisioningStatus (только для чтения) Состояние подготовки расписания. нет
данные системы object (только для чтения) Системные метаданные для ресурса. Да
tags объект Теги расписания. В отличие от свойств, теги полностью изменяются. нет
Задача ScheduleTask Модель задачи планирования. Да
Конфигурация └️ объект Конфигурация под задачу. нет
└─ Тип ScheduleTaskType Тип задачи. Да
trigger Trigger Базовая модель для триггера расписания. Да
└─ Тип TriggerType Тип спускового крючка. Да

ScheduleProvisioningStatus

Состояние подготовки расписания.

Недвижимость Ценность
Описание Состояние подготовки расписания.
Тип струна
Значения Creating
Updating
Deleting
Succeeded
Failed

ScheduleRun

Модель прогона по расписанию.

Имя. Тип Description Обязательно По умолчанию
ошибка строка (только для чтения) Информация об ошибках при выполнении расписания. нет
id строка (только для чтения) Идентификатор запланированного прогона. Да
свойства object (только для чтения) Свойства расписания прогона. Да
scheduleId струна Идентификатор расписания. Да
success boolean (только для чтения) Активация состояния успешного выполнения расписания. Да
triggerTime струна Время запуска прогона по расписанию. нет

Запланированная задача

Модель задачи планирования.

Дискриминация для ScheduleTask

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
Evaluation EvaluationScheduleTask
Insight InsightsScheduleTask
Имя. Тип Description Обязательно По умолчанию
configuration объект Конфигурация под задачу. нет
type ScheduleTaskType Тип задачи. Да

ScheduleTaskType

Тип задачи.

Недвижимость Ценность
Описание Тип задачи.
Тип струна
Значения Evaluation
Insight

SharepointGroundingToolParameters

Параметры инструмента заземления SharePoint.

Имя. Тип Description Обязательно По умолчанию
project_connections массив ToolProjectConnection Соединения project, подключённые к этому инструменту. Может быть не более 1 подключения
ресурс, подключенный к средству.
нет

SharepointPreviewTool

Сведения об определении входных данных для инструмента SharePoint, используемого для настройки агента.

Имя. Тип Description Обязательно По умолчанию
sharepoint_grounding_preview SharepointGroundingToolParameters Параметры инструмента заземления SharePoint. Да
└project_connections project_connections массив ToolProjectConnection Соединения project, подключённые к этому инструменту. Может быть не более 1 подключения
ресурс, подключенный к средству.
Ограничения: maxItems: 1
нет
type перечисление Тип объекта, который всегда является «sharepoint_grounding_preview».
Возможные значения: sharepoint_grounding_preview
Да

Sku

Сведения о номере SKU

Имя. Тип Description Обязательно По умолчанию
capacity целое число Емкость SKU Да
family струна Семья Ску Да
имя струна Имя SKU Да
size струна Размер SKU Да
уровень струна Уровень SKU Да

StructuredInputDefinition

Структурированные входные данные, которые могут участвовать в подстановках шаблонов и привязке аргументов инструмента.

Имя. Тип Description Обязательно По умолчанию
default_value Значение по умолчанию для входных данных, если значение времени выполнения не указано. нет
описание струна Удобочитаемое описание входных данных. нет
required булевый Является ли входное свойство обязательным при вызове агента. нет Неправда
schema объект Схема JSON для структурированных входных данных (необязательно). нет

StructuredOutputDefinition

Структурированные выходные данные, которые можно создать агентом.

Имя. Тип Description Обязательно По умолчанию
описание струна Описание выходных данных, которые будут выдаваться. Используется моделью для определения времени выдачи выходных данных. Да
имя струна Имя структурированного выходного документа. Да
schema объект Схема JSON для структурированных выходных данных. Да
строгий Булев (нулируемый) Следует ли применять строгую валидацию. trueпо умолчанию. Да

StructuredOutputsOutputItem

Имя. Тип Description Обязательно По умолчанию
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
output Структурированные выходные данные, захваченные во время ответа. Да
response_id струна Ответ, на котором создается элемент. нет
type перечисление
Возможные значения: structured_outputs
Да

SyntheticDataGenerationPreviewEvalRunDataSource

Представляет источник данных для выполнения оценки, который оценивается на основе созданных искусственных данных для тестирования.

Имя. Тип Description Обязательно По умолчанию
входные_сообщения OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate нет
└─ Шаблон массив объекта или OpenAI.EvalItem Да
└─ Тип перечисление
Возможные значения: template
Да
item_generation_params SyntheticDataGenerationPreviewItemGenerationParams Да
└️ model_deployment_name струна Имя развертывания модели, используемого для создания синтетических данных. Да
└output_dataset_id строка (только для чтения) Идентификатор выходного набора данных, в котором хранятся созданные искусственные данные. Созданные данные — это jsonl-файл с идентификатором столбцов, запросом и test_description. нет
└️ output_dataset_name струна Имя выходного набора данных, в котором будут храниться созданные искусственные данные. Если оно не указано, служба автоматически создает имя набора данных. нет
└─ Запрос струна Запрос, используемый для создания синтетических данных. Это параметр, если целевой объект имеет тип "azure_ai_agent" с инструкциями, настроенными в агенте. нет
└samples_count целое число Максимальное количество генерируемых примеров данных. Да
Источники └️ массив OpenAI.EvalJsonlFileIdSource Необязательные файлы источника содержимого начального содержимого для создания данных. Да
└─ Тип перечисление Тип параметров создания элементов.
Возможные значения: synthetic_data_gen_preview
Да
target Цель Базовый класс для целей с поддержкой дискриминаторов. Да
└─ Тип струна Тип целевого объекта. Да
type перечисление Тип источника данных всегда azure_ai_synthetic_data_gen_preview.
Возможные значения: azure_ai_synthetic_data_gen_preview
Да

SyntheticDataGenerationPreviewItemGenerationParams

Имя. Тип Description Обязательно По умолчанию
model_deployment_name струна Имя развертывания модели, используемого для создания синтетических данных. Да
output_dataset_id строка (только для чтения) Идентификатор выходного набора данных, в котором хранятся созданные искусственные данные. Созданные данные — это jsonl-файл с идентификатором столбцов, запросом и test_description. нет
output_dataset_name струна Имя выходного набора данных, в котором будут храниться созданные искусственные данные. Если оно не указано, служба автоматически создает имя набора данных. нет
prompt струна Запрос, используемый для создания синтетических данных. Это параметр, если целевой объект имеет тип "azure_ai_agent" с инструкциями, настроенными в агенте. нет
samples_count целое число Максимальное количество генерируемых примеров данных. Да
Источников массив OpenAI.EvalJsonlFileIdSource Необязательные файлы источника содержимого начального содержимого для создания данных. Да
type перечисление Тип параметров создания элементов.
Возможные значения: synthetic_data_gen_preview
Да

Цель

Базовый класс для целей с поддержкой дискриминаторов.

Дискриминация для целевого объекта

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
azure_ai_model AzureAIModelTarget
azure_ai_agent AzureAIAgentTarget
Имя. Тип Description Обязательно По умолчанию
type струна Тип целевого объекта. Да

TargetCompletionEvalRunDataSource

Представляет источник данных для целевой конфигурации оценки завершения.

Имя. Тип Description Обязательно По умолчанию
входные_сообщения OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference нет
└─ ссылка_на_элемент струна Да
└─ Тип перечисление
Возможные значения: item_reference
Да
Источник OpenAI.EvalJsonlFileContentSource или OpenAI.EvalJsonlFileIdSource Исходная конфигурация для встроенных или файловой данных. Да
target Цель Базовый класс для целей с поддержкой дискриминаторов. Да
└─ Тип струна Тип целевого объекта. Да
type перечисление Тип источника данных всегда azure_ai_target_completions.
Возможные значения: azure_ai_target_completions
Да

TargetConfig

Абстрактный класс для целевой конфигурации.

Дискриминация для TargetConfig

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
AzureOpenAIModel AzureOpenAIModelConfiguration
Имя. Тип Description Обязательно По умолчанию
type струна Тип конфигурации модели. Да

TargetUpdate

Базовый класс для целей с поддержкой дискриминаторов.

Дискриминация для TargetUpdate

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
azure_ai_model AzureAIModelTargetUpdate
azure_ai_agent AzureAIAgentTargetUpdate
Имя. Тип Description Обязательно По умолчанию
type струна Тип целевого объекта. Да

ТаксономияCategory

Определение категории таксономии.

Имя. Тип Description Обязательно По умолчанию
описание струна Описание категории таксономии. нет
id струна Уникальный идентификатор категории таксономии. Да
имя струна Название категории таксономии. Да
свойства объект Дополнительные свойства для категории таксономии. нет
riskCategory RiskCategory Категория риска для цели атаки. Да
Подкатегории массив TaxonomySubCategory Список подкатегорий таксономии. Да

ТаксономияSubCategory

Определение подкатегории таксономии.

Имя. Тип Description Обязательно По умолчанию
описание струна Описание подкатегории таксономии. нет
enabled булевый Список элементов таксономии в этой подкатегории. Да
id струна Уникальный идентификатор подкатегории таксономии. Да
имя струна Название подкатегории таксономии. Да
свойства объект Дополнительные свойства для подкатегории таксономии. нет

ToolDescription

Описание инструмента, который может быть использован агентом.

Имя. Тип Description Обязательно По умолчанию
описание струна Краткое описание назначения инструмента. нет
имя струна Имя средства. нет

ToolProjectConnection

Ресурс для подключения project.

Имя. Тип Description Обязательно По умолчанию
project_connection_id струна Соединение project в ToolProjectConnectionList, привязанном к этому инструменту. Да

TracesPreviewEvalRunDataSource

Представляет источник данных для вычислений, работающих над трассировками агента, хранящимися в Application Insights.

Имя. Тип Description Обязательно По умолчанию
agent_id струна Идентификатор агента, используемый для фильтрации трассировок для оценки. нет
agent_name струна Имя агента, используемое для фильтрации трассировок для оценки. нет
время окончания целое число Метка времени Unix (в секундах) помечает конец окна запроса трассировки. По умолчанию используется текущее время. нет
ingestion_delay_seconds целое число Задержка, применяемая к приему при запросе трассировок. нет 300
lookback_hours целое число Окно обратного просмотра (в часах) применяется при получении трассировок из Application Insights.
Для запланированных вычислений это выводится из интервала повторения.
нет 168
max_traces целое число Ограничение выборки, применяемое к трассировкам, извлеченным для оценки. нет 1000
trace_ids Массив строк Коллекция идентификаторов трассировки агента, которые следует оценить. нет
type перечисление Тип источника данных всегда azure_ai_traces_preview.
Возможные значения: azure_ai_traces_preview
Да

TreatmentEffectType

Тип эффекта лечения.

Недвижимость Ценность
Описание Тип эффекта лечения.
Тип струна
Значения TooFewSamples
Inconclusive
Changed
Improved
Degraded

Триггер

Базовая модель для триггера расписания.

Дискриминация для триггера

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
Cron КранТриггер
Recurrence повторения
OneTime OneTimeTrigger
Имя. Тип Description Обязательно По умолчанию
type TriggerType Тип спускового крючка. Да

TriggerType

Тип спускового крючка.

Недвижимость Ценность
Описание Тип спускового крючка.
Тип струна
Значения Cron
Recurrence
OneTime

UpdateAgentFromManifestRequest

Имя. Тип Description Обязательно По умолчанию
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
manifest_id струна Идентификатор манифеста для импорта версии агента из. Да
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
parameter_values объект Входные данные манифеста, которые будут приводить к полностью материализованному агенту. Да

UpdateAgentRequest

Имя. Тип Description Обязательно По умолчанию
Определение AgentDefinition Да
└️ вид AgentKind Да
└️ rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
описание струна Понятное описание агента.
Ограничения: maxLength: 512
нет
metadata объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет

UpdateEvalParametersBody

Имя. Тип Description Обязательно По умолчанию
metadata OpenAI.Metadata (nullable) Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть
Полезно для хранения дополнительных сведений об объекте в структурированном виде.
форматирование и запрос объектов через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — строки
с максимальной длиной 512 символов.
нет
имя струна нет
свойства объект Набор неизменяемых пар "ключ-значение", которые могут быть присоединены к объекту для хранения дополнительных сведений.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет

UserProfileMemoryItem

Элемент памяти, содержащий информацию профиля пользователя, извлеченную из бесед, такую как предпочтения, интересы и личные данные.

Имя. Тип Description Обязательно По умолчанию
содержимое струна Содержимое памяти. Да
добрый перечисление Вид объекта памяти.
Возможные значения: user_profile
Да
memory_id струна Уникальный идентификатор элемента памяти. Да
scope струна Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. Да
updated_at целое число Время последнего обновления элемента памяти. Да

WebSearchConfiguration

Конфигурация веб-поиска для пользовательского поиска bing

Имя. Тип Description Обязательно По умолчанию
instance_name струна Имя настраиваемого экземпляра конфигурации, заданного для конфигурации. Да
project_connection_id струна Project connection id для заземления с пользовательским поиском bing Да

WeeklyRecurrenceSchedule

Еженедельный график повторения.

Имя. Тип Description Обязательно По умолчанию
daysOfWeek массив DayOfWeek Дни недели для графика повторения. Да
type перечисление Тип еженедельного рецидива.
Возможные значения: Weekly
Да

WorkflowActionOutputItem

Имя. Тип Description Обязательно По умолчанию
action_id струна Уникальный идентификатор действия. Да
agent_reference AgentReference нет
└️ имя струна Имя агента.
Ограничения: maxLength: 256
Да
└─ Тип перечисление
Возможные значения: agent_reference
Да
Версия └️ струна Идентификатор версии агента. нет
добрый струна Тип действия CSDL (например, SetVariable, InvokeAzureAgent). Да
parent_action_id струна Идентификатор родительского действия, если это вложенное действие. нет
previous_action_id струна Идентификатор предыдущего действия, если это действие следует другому. нет
response_id струна Ответ, на котором создается элемент. нет
статус перечисление Состояние действия (например, "in_progress", "завершено", "не удалось", "отменено".
Возможные значения: completed, , failedin_progresscancelled
Да
type перечисление
Возможные значения: workflow_action
Да

WorkflowAgentDefinition

Определение агента рабочего процесса.

Имя. Тип Description Обязательно По умолчанию
добрый перечисление
Возможные значения: workflow
Да
rai_config RaiConfig Конфигурация для фильтрации содержимого и функций безопасности Responsible AI (RAI). нет
└rai_policy_name струна Название политики RAI, которую необходимо применить. Да
workflow струна Определение рабочего процесса в формате CSDL YAML. нет

целое число

Тип: целое число

Формат: int64