Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Версия 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_obfuscationFalse для оптимизации пропускной способности, если вы доверяете сетевым каналам между приложение и 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
Состояние операции контейнера для определенной версии агента.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | NotStartedInProgressSucceededFailed |
AgentContainerStatus
Состояние контейнера определенной версии агента.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | StartingRunningStoppingStoppedFailedDeletingDeletedUpdating |
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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | prompthostedcontainer_appworkflow |
AgentObject
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| id | струна | Уникальный идентификатор агента. | Да | |
| имя | струна | Имя агента. Ограничения: maxLength: 63 |
Да | |
| объект | перечисление | Тип объекта, которым всегда является 'agent'. Возможные значения: agent |
Да | |
| versions | объект | Актуальная версия агента. | Да | |
| └️ последняя версия | AgentVersionObject | Да |
AgentProtocol
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | activity_protocolresponses |
Справочник агента
| Имя. | Тип | 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
Стратегии атак.
| Недвижимость | Ценность |
|---|---|
| Описание | Стратегии атак. |
| Тип | струна |
| Значения | easymoderatedifficultascii_artascii_smuggleratbashbase64binarycaesarcharacter_spacejailbreakansi_attackcharacter_swapsuffix_appendstring_joinunicode_confusableunicode_substitutiondiacriticflipleetspeakrot13morseurlbaselineindirect_jailbreaktensemulti_turncrescendo |
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. Ядро.Основы.ОперацияСостояние
Перечисление, описывающее разрешенные состояния операций.
| Недвижимость | Ценность |
|---|---|
| Описание | Перечисление, описывающее разрешенные состояния операций. |
| Тип | струна |
| Значения | NotStartedRunningSucceededFailedCanceled |
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. |
| Тип | струна |
| Значения | simplesemanticvectorvector_simple_hybridvector_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 (только для чтения) | Тип (или категория) подключения | Да |
Тип соединения
Тип (или категория) подключения
| Недвижимость | Ценность |
|---|---|
| Описание | Тип (или категория) подключения |
| Тип | струна |
| Значения | AzureOpenAIAzureBlobAzureStorageAccountCognitiveSearchCosmosDBApiKeyAppConfigAppInsightsCustomKeysRemoteTool_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
Тип логов для потока из контейнера.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | consolesystem |
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
Тип учетных данных, используемых подключением
| Недвижимость | Ценность |
|---|---|
| Описание | Тип учетных данных, используемых подключением |
| Тип | струна |
| Значения | ApiKeyAADSASCustomKeysNoneAgenticIdentityToken_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_fileuri_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 | Перечисление для определения типа данных. | Да |
ДеньНедели
Дни недели для графика повторения.
| Недвижимость | Ценность |
|---|---|
| Описание | Дни недели для графика повторения. |
| Тип | струна |
| Значения | SundayMondayTuesdayWednesdayThursdayFridaySaturday |
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
Тип действия по оценке.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип действия по оценке. |
| Тип | струна |
| Значения | continuousEvaluationhumanEvaluationPreview |
EvaluationRuleEventType
Тип события правила оценки.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип события правила оценки. |
| Тип | струна |
| Значения | responseCompletedmanual |
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
Тип входных данных таксономии оценки.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип входных данных таксономии оценки. |
| Тип | струна |
| Значения | agentpolicy |
EvaluationTaxonomyInputUpdate
Входная конфигурация для таксономии оценки.
Дискриминация для EvaluationTaxonomyInputUpdate
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
agent |
AgentTaxonomyInputUpdate |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | EvaluationTaxonomyInputType | Тип входных данных таксономии оценки. | Да |
EvaluationTaxonomyUpdate
Определение таксономии оценки
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| описание | струна | Текст описания ресурса. | нет | |
| свойства | объект | Дополнительные свойства для таксономии оценки. | нет | |
| tags | объект | Словарь тегов. Теги можно добавлять, удалять и обновлять. | нет | |
| категории таксономии | массив ТаксономииCategory | Список категорий таксономии. | нет | |
| таксономияInput | EvaluationTaxonomyInputUpdate | Входная конфигурация для таксономии оценки. | нет | |
| └─ Тип | EvaluationTaxonomyInputType | Тип входных данных таксономии оценки. | Да |
ОценщикCategory
Категория оценщика
| Недвижимость | Ценность |
|---|---|
| Описание | Категория оценщика |
| Тип | струна |
| Значения | qualitysafetyagents |
ScoreorDefinition
Конфигурация базового оценщика с дискриминатором
Дискриминация для scoreorDefinition
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
code |
CodeBasedEvaluatorDefinition |
prompt |
PromptBasedEvaluatorDefinition |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| data_schema | объект | Схема JSON (проект 2020-12) для входных данных оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. | нет | |
| init_parameters | объект | Схема JSON (проект 2020-12) для входных параметров оценщика. Это включает в себя такие параметры, как тип, свойства, обязательные. | нет | |
| metrics | объект | Список выходных метрик, полученных данным оценщиком | нет | |
| type | ScoreorDefinitionType | Тип определения оценщика | Да |
ScoreorDefinitionType
Тип определения оценщика
| Недвижимость | Ценность |
|---|---|
| Описание | Тип определения оценщика |
| Тип | струна |
| Значения | promptcodeprompt_and_codeserviceopenai_graders |
Оценка метрик
Метрика Evaluator
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| desirable_direction | ScoreorMetricDirection | Направление метрики, указывающее, является ли более высокое значение лучше, более низкое значение лучше или нейтральным | нет | |
| is_primary | булевый | Указывает, является ли эта метрика основной при наличии нескольких метрик. | нет | |
| max_value | число/номер | Максимальное значение метрики. Если не указано, предполагается, что оно не ограничено. | нет | |
| min_value | число/номер | Минимальное значение метрики | нет | |
| type | ScoreorMetricType | Тип оценщика | нет |
ScoreorMetricDirection
Направление метрики, указывающее, является ли более высокое значение лучше, более низкое значение лучше или нейтральным
| Недвижимость | Ценность |
|---|---|
| Описание | Направление метрики, указывающее, является ли более высокое значение лучше, более низкое значение лучше или нейтральным |
| Тип | струна |
| Значения | increasedecreaseneutral |
ScoreorMetricType
Тип оценщика
| Недвижимость | Ценность |
|---|---|
| Описание | Тип оценщика |
| Тип | струна |
| Значения | ordinalcontinuousboolean |
ScoreorType
Тип оценщика
| Недвижимость | Ценность |
|---|---|
| Описание | Тип оценщика |
| Тип | струна |
| Значения | builtincustom |
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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | AzureSearchCosmosDBNoSqlVectorStoreManagedAzureSearch |
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
Запрос инсайтов.
| Недвижимость | Ценность |
|---|---|
| Описание | Запрос инсайтов. |
| Тип | струна |
| Значения | EvaluationRunClusterInsightAgentClusterInsightEvaluationComparison |
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_teamresponse_retrievalred_team_seed_promptsred_team_taxonomysynthetic_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_profilechat_summary |
MemoryOperation
Представляет собой одну операцию памяти (создание, обновление или удаление), выполненную над элементом памяти.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| добрый | MemoryOperationKind | Вид операций с памятью. | Да | |
| memory_item | MemoryItem | Один элемент памяти, хранящийся в хранилище памяти и содержащий содержимое и метаданные. | Да | |
| └─ Содержимое | струна | Содержимое памяти. | Да | |
| └️ вид | MemoryItemKind | Вид объекта памяти. | Да | |
| └️ memory_id | струна | Уникальный идентификатор элемента памяти. | Да | |
| Область └️ | струна | Пространство имен, которое логически группирует и изолирует воспоминания, например идентификатор пользователя. | Да | |
| └updated_at updated_at | целое число | Время последнего обновления элемента памяти. | Да |
MemoryOperationKind
Вид операций с памятью.
| Недвижимость | Ценность |
|---|---|
| Описание | Вид операций с памятью. |
| Тип | струна |
| Значения | createupdatedelete |
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
Состояние операции обновления хранилища памяти.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | queuedin_progresscompletedfailedsuperseded |
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_citationurl_citationcontainer_file_citationfile_path |
OpenAI.ApplyPatchCallOutputStatus
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | completedfailed |
OpenAI.ApplyPatchCallOutputStatusParam
Значения результатов, представленные для выходов apply_patch вызовов инструмента.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | completedfailed |
OpenAI.ApplyPatchCallStatus
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | in_progresscompleted |
OpenAI.ApplyPatchCallStatusParam
Значения статуса, указанные для apply_patch вызовов инструментов.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | in_progresscompleted |
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_filedelete_fileupdate_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_filedelete_fileupdate_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.2gpt-5.2-2025-12-11gpt-5.2-chat-latestgpt-5.2-progpt-5.2-pro-2025-12-11gpt-5.1gpt-5.1-2025-11-13gpt-5.1-codexgpt-5.1-minigpt-5.1-chat-latestgpt-5gpt-5-minigpt-5-nanogpt-5-2025-08-07gpt-5-mini-2025-08-07gpt-5-nano-2025-08-07gpt-5-chat-latestgpt-4.1gpt-4.1-minigpt-4.1-nanogpt-4.1-2025-04-14gpt-4.1-mini-2025-04-14gpt-4.1-nano-2025-04-14o4-minio4-mini-2025-04-16o3o3-2025-04-16o3-minio3-mini-2025-01-31o1o1-2024-12-17o1-previewo1-preview-2024-09-12o1-minio1-mini-2024-09-12gpt-4ogpt-4o-2024-11-20gpt-4o-2024-08-06gpt-4o-2024-05-13gpt-4o-audio-previewgpt-4o-audio-preview-2024-10-01gpt-4o-audio-preview-2024-12-17gpt-4o-audio-preview-2025-06-03gpt-4o-mini-audio-previewgpt-4o-mini-audio-preview-2024-12-17gpt-4o-search-previewgpt-4o-mini-search-previewgpt-4o-search-preview-2025-03-11gpt-4o-mini-search-preview-2025-03-11chatgpt-4o-latestcodex-mini-latestgpt-4o-minigpt-4o-mini-2024-07-18gpt-4-turbogpt-4-turbo-2024-04-09gpt-4-0125-previewgpt-4-turbo-previewgpt-4-1106-previewgpt-4-vision-previewgpt-4gpt-4-0314gpt-4-0613gpt-4-32kgpt-4-32k-0314gpt-4-32k-0613gpt-3.5-turbogpt-3.5-turbo-16kgpt-3.5-turbo-0301gpt-3.5-turbo-0613gpt-3.5-turbo-1106gpt-3.5-turbo-0125gpt-3.5-turbo-16k-0613 |
OpenAI.ClickButtonType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | leftrightwheelbackforward |
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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | clickdouble_clickdragkeypressmovescreenshotscrolltypewait |
OpenAI.ComputerCallSafetyCheckParam
Ожидается проверка безопасности для компьютерного вызова.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | Строка (нулевая) | нет | ||
| id | струна | Идентификатор ожидающей проверки безопасности. | Да | |
| сообщение | Строка (нулевая) | нет |
OpenAI.ComputerEnvironment
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | windowsmaclinuxubuntubrowser |
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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | 1g4g16g64g |
OpenAI.ConversationItem
Один элемент в беседе. Набор возможных типов совпадает с output типом объекта Response.
Дискриминация для OpenAI.ConversationItem
Этот компонент использует свойство type для дискриминации между различными типами:
| Имя. | Тип | 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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | messagefunction_callfunction_call_outputfile_search_callweb_search_callimage_generation_callcomputer_callcomputer_call_outputreasoningcode_interpreter_calllocal_shell_calllocal_shell_call_outputshell_callshell_call_outputapply_patch_callapply_patch_call_outputmcp_list_toolsmcp_approval_requestmcp_approval_responsemcp_callcustom_tool_callcustom_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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | textjson_schemajson_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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | textgrammar |
OpenAI.DeletedConversationResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| удалено | булевый | Да | ||
| id | струна | Да | ||
| объект | перечисление | Возможные значения: conversation.deleted |
Да |
OpenAI.DetailEnum
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | lowhighauto |
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или systemdeveloper.Возможные значения: 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_matchbleugleu, 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или systemdeveloper.Возможные значения: 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_textoutput_textinput_imageinput_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_textinput_imageinput_file |
OpenAI.FunctionCallItemStatus
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | in_progresscompletedincomplete |
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_progresscompletedincomplete |
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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | timeoutexit |
OpenAI.FunctionShellCallOutputOutcomeType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | timeoutexit |
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_matchbleugleu, meteor, rouge_1rouge_2rouge_3rouge_4rouge_5или rouge_l.Возможные значения: cosine, , fuzzy_matchbleugleumeteorrouge_1rouge_2rouge_3rouge_4rouge_5rouge_l |
Да | |
| ввод | струна | Текст, оцениваемый. | Да | |
| имя | струна | Имя классировщика. | Да | |
| Ссылка | струна | Текст, классируемый против. | Да | |
| type | перечисление | Тип классировщика. Возможные значения: text_similarity |
Да |
OpenAI.GrammarSyntax1
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | larkregex |
OpenAI.HybridSearchOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| embedding_weight | OpenAI.numeric | Да | ||
| text_weight | OpenAI.numeric | Да |
OpenAI.ImageDetail
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | lowhighauto |
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, 1024x15361536x1024 или 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.resultsweb_search_call.resultsweb_search_call.action.sourcesmessage.input_image.image_urlcomputer_call_output.output.image_urlcode_interpreter_call.outputsreasoning.encrypted_contentmessage.output_text.logprobsmemory_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_textinput_imageinput_file |
OpenAI.InputFidelity
Контролируйте усилия модели для соответствия стилю и особенностям, в частности, чертам лица, на входных изображениях. Этот параметр поддерживается только для gpt-image-1. Неподдерживаемый для gpt-image-1-mini. Поддерживает high и low. По умолчанию — low.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | highlow |
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 для дискриминации между различными типами:
| Имя. | Тип | 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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | messageoutput_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_callitem_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 для дискриминации между различными типами:
| Имя. | Тип | 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 для дискриминации между различными типами:
| Имя. | Тип | 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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | messageoutput_messagefile_search_callcomputer_callcomputer_call_outputweb_search_callfunction_callfunction_call_outputimage_generation_callcode_interpreter_calllocal_shell_calllocal_shell_call_outputshell_callshell_call_outputapply_patch_callapply_patch_call_outputmcp_list_toolsmcp_approval_requestmcp_approval_responsemcp_callstructured_outputsoauth_consent_requestmemory_search_callworkflow_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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | messageoutput_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 |
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_progresscompletedincomplete |
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_progresscompletedincompletecallingfailed |
OpenAI.MCPToolFilter
Объект фильтра, указывающий, какие инструменты разрешены.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| read_only | булевый | Указывает, изменяет ли инструмент данные или является только для чтения. Если Сервер MCP он будет соответствовать этому фильтру. |
нет | |
| 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_textoutput_texttextsummary_textreasoning_textrefusalinput_imagecomputer_screenshotinput_file |
OpenAI.MessageRole
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | unknownuserassistantsystemcriticdiscriminatordevelopertool |
OpenAI.MessageStatus
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | in_progresscompletedincomplete |
OpenAI.Metadata
Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
Тип: объект
OpenAI.ModelIdsCompaction
Идентификатор модели, используемый для создания ответа, например gpt-5 или o3. OpenAI предлагает широкий спектр моделей с разными возможностями, характеристиками производительности и ценами. Ознакомьтесь с руководством по модели для просмотра и сравнения доступных моделей.
Тип: OpenAI.ModelIdsResponses или string
Идентификатор модели, используемый для создания ответа, например gpt-5 или o3. OpenAI предлагает широкий спектр моделей с разными возможностями, характеристиками производительности и ценами. Ознакомьтесь с руководством по модели для просмотра и сравнения доступных моделей.
OpenAI.ModelIdsResponses
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | o1-proo1-pro-2025-03-19o3-proo3-pro-2025-06-10o3-deep-researcho3-deep-research-2025-06-26o4-mini-deep-researcho4-mini-deep-research-2025-06-26computer-use-previewcomputer-use-preview-2025-03-11gpt-5-codexgpt-5-progpt-5-pro-2025-10-06gpt-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_textrefusalreasoning_text |
OpenAI.OutputItem
Дискриминация для OpenAI.OutputItem
Этот компонент использует свойство type для дискриминации между различными типами:
| Имя. | Тип | 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_messagefile_search_callfunction_callweb_search_callcomputer_callreasoningcompactionimage_generation_callcode_interpreter_calllocal_shell_callshell_callshell_call_outputapply_patch_callapply_patch_call_outputmcp_callmcp_list_toolsmcp_approval_requestcustom_tool_callstructured_outputsoauth_consent_requestmemory_search_callworkflow_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_textrefusal |
OpenAI.Prompt
Ссылка на шаблон запроса и его переменные. Узнать больше.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| id | струна | Уникальный идентификатор используемого шаблона запроса. | Да | |
| переменные | OpenAI.ResponsePromptVariables (nullable ) | Необязательное сопоставление значений для замены переменных в переменных подсказывать. Значения подстановки могут быть строками или другими Типы входных данных ответа, такие как изображения или файлы. |
нет | |
| version | Строка (нулевая) | нет |
OpenAI.RankerVersionType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | autodefault-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 | Да |
| Значения | noneminimallowmediumhighxhigh |
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, failedin_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, failedin_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, failedin_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_errorrate_limit_exceededinvalid_promptvector_store_timeoutinvalid_imageinvalid_image_formatinvalid_base64_imageinvalid_image_urlimage_too_largeimage_too_smallimage_parse_errorimage_content_policy_violationinvalid_image_modeimage_file_too_largeunsupported_image_media_typeempty_image_filefailed_to_download_imageimage_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, failedin_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, failedin_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, failedin_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, failedin_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_obfuscationFalse для оптимизации пропускной способности, если вы доверяете сетевым каналам между приложение и 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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | lowmediumhigh |
OpenAI.ServiceTier
Указывает тип обработки, используемый для обслуживания запроса.
- Если настроено на «auto», то запрос будет обработан с помощью сервисного уровня, настроенного в настройках Project. Если не настроено иное, Project будет использовать 'default'.
- Если задано значение "по умолчанию", запрос будет обработан со стандартными ценами и производительностью выбранной модели.
- Если установлен на 'flex' или 'priority', то запрос будет обработан с соответствующим уровнем сервиса.
- Если не задано, поведение по умолчанию — "auto".
service_tierЕсли параметр задан, текст ответа будет включатьservice_tierзначение на основе режима обработки, который фактически использовался для обслуживания запроса. Это значение ответа может отличаться от значения, заданного в параметре.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Nullable | Да |
| Значения | autodefaultflexscalepriority |
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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | textjson_schemajson_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 означает, что модель должна вызывать один или несколько инструментов.
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | noneautorequired |
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_toolsfunctionmcpcustomapply_patchshellfile_searchweb_search_previewcomputer_use_previewweb_search_preview_2025_03_11image_generationcode_interpreter |
OpenAI.ToolChoiceWebSearchPreview
Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: web_search_preview |
Да |
OpenAI.ToolChoiceWebSearchPreview20250311
Указывает, что модель должна использовать встроенное средство для создания ответа. Узнайте больше об встроенных инструментах.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: web_search_preview_2025_03_11 |
Да |
OpenAI.ToolType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | functionfile_searchcomputer_use_previewweb_searchmcpcode_interpreterimage_generationlocal_shellshellcustomweb_search_previewapply_patcha2a_previewbing_custom_search_previewbrowser_automation_previewfabric_dataagent_previewsharepoint_grounding_previewmemory_search_previewazure_ai_searchazure_functionbing_groundingcapture_structured_outputsopenapi |
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 | Да |
| Значения | lowmediumhigh |
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 (требуется аудитория для проверки подлинности на основе удостоверений) |
| Тип | струна |
| Значения | anonymousproject_connectionmanaged_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
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | ascdesc |
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
Тип рецидива.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип рецидива. |
| Тип | струна |
| Значения | HourlyDailyWeeklyMonthly |
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
Категория риска для цели атаки.
| Недвижимость | Ценность |
|---|---|
| Описание | Категория риска для цели атаки. |
| Тип | струна |
| Значения | HateUnfairnessViolenceSexualSelfHarmProtectedMaterialCodeVulnerabilityUngroundedAttributesProhibitedActionsSensitiveDataLeakageTaskAdherence |
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
Состояние подготовки расписания.
| Недвижимость | Ценность |
|---|---|
| Описание | Состояние подготовки расписания. |
| Тип | струна |
| Значения | CreatingUpdatingDeletingSucceededFailed |
ScheduleRun
Модель прогона по расписанию.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ошибка | строка (только для чтения) | Информация об ошибках при выполнении расписания. | нет | |
| id | строка (только для чтения) | Идентификатор запланированного прогона. | Да | |
| свойства | object (только для чтения) | Свойства расписания прогона. | Да | |
| scheduleId | струна | Идентификатор расписания. | Да | |
| success | boolean (только для чтения) | Активация состояния успешного выполнения расписания. | Да | |
| triggerTime | струна | Время запуска прогона по расписанию. | нет |
Запланированная задача
Модель задачи планирования.
Дискриминация для ScheduleTask
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
Evaluation |
EvaluationScheduleTask |
Insight |
InsightsScheduleTask |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| configuration | объект | Конфигурация под задачу. | нет | |
| type | ScheduleTaskType | Тип задачи. | Да |
ScheduleTaskType
Тип задачи.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип задачи. |
| Тип | струна |
| Значения | EvaluationInsight |
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
Тип эффекта лечения.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип эффекта лечения. |
| Тип | струна |
| Значения | TooFewSamplesInconclusiveChangedImprovedDegraded |
Триггер
Базовая модель для триггера расписания.
Дискриминация для триггера
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
Cron |
КранТриггер |
Recurrence |
повторения |
OneTime |
OneTimeTrigger |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | TriggerType | Тип спускового крючка. | Да |
TriggerType
Тип спускового крючка.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип спускового крючка. |
| Тип | струна |
| Значения | CronRecurrenceOneTime |
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