Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
API Sürümü: v1
Authentication
Akış: örtük
Yetkilendirme URL'si:https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Kapsam:
https://ai.azure.com/.default
Agents
Aracılar - aracı oluşturma
POST {endpoint}/agents?api-version=v1
Aracıyı oluşturur.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview, HostedAgents=V1Preview, WorkflowAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | AgentDefinition | Evet | ||
| └─ tür | AgentKind | Evet | ||
| └─ rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Aracıyı tanımlayan benzersiz ad. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. - Alfasayısal karakterlerle başlayıp bitmelidir, - Ortada kısa çizgi içerebilir - 63 karakteri aşmamalıdır. Kısıtlamalar: maxLength: 63 |
Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - liste aracıları
GET {endpoint}/agents?api-version=v1
Tüm müşteri temsilcilerinin listesini döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| tür | soru | Hayı | String Olası değerler: prompt, hosted, container_app, workflow |
Ajanları türlerine göre filtreleyin. Sağlanmazsa, tüm temsilciler iade edilir. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracı alma
GET {endpoint}/agents/{agent_name}?api-version=v1
Aracıyı alır.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Alınacak aracının adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracıyı güncelleştirme
POST {endpoint}/agents/{agent_name}?api-version=v1
Aracı tanımında herhangi bir değişiklik olması durumunda yeni bir sürüm ekleyerek aracıyı güncelleştirir. Değişiklik yoksa mevcut aracı sürümünü döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Alınacak aracının adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview, HostedAgents=V1Preview, WorkflowAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | AgentDefinition | Evet | ||
| └─ tür | AgentKind | Evet | ||
| └─ rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracıyı silme
DELETE {endpoint}/agents/{agent_name}?api-version=v1
Aracıyı siler.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Silinecek aracının adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DeleteAgentResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - bildirimden aracıyı güncelleştirme
POST {endpoint}/agents/{agent_name}/import?api-version=v1
Aracı tanımında herhangi bir değişiklik varsa yeni bir sürüm ekleyerek bir bildirimden aracıyı güncelleştirir. Değişiklik yoksa mevcut aracı sürümünü döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Güncelleştirilecek aracının adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| manifest_id | String | Aracı sürümünü içeri aktaracak bildirim kimliği. | Evet | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| parameter_values | nesne | Bildirime yapılan ve tam olarak gerçekleştirilmiş bir Aracı ile sonuçlanacak girişler. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracı sürümü oluşturma
POST {endpoint}/agents/{agent_name}/versions?api-version=v1
Yeni bir aracı sürümü oluşturun.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracıyı tanımlayan benzersiz ad. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. - Alfasayısal karakterlerle başlayıp bitmelidir, - Ortada kısa çizgi içerebilir - 63 karakteri aşmamalıdır. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview, HostedAgents=V1Preview, WorkflowAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | AgentDefinition | Evet | ||
| └─ tür | AgentKind | Evet | ||
| └─ rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentVersionObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracı sürümlerini listeleme
GET {endpoint}/agents/{agent_name}/versions?api-version=v1
Bir aracının sürümlerinin listesini döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Sürümleri alınacak aracının adı. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracı sürümünü alma
GET {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=v1
Bir aracının belirli bir sürümünü alır.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Alınacak aracının adı. |
| agent_version | path | Evet | String | Alınacak aracı sürümü. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentVersionObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - aracı sürümünü silme
DELETE {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=v1
Bir aracının belirli bir sürümünü siler.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Silinecek aracının adı. |
| agent_version | path | Evet | String | Silinecek aracı sürümü |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DeleteAgentVersionResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - bildirimden aracı sürümü oluşturma
POST {endpoint}/agents/{agent_name}/versions:import?api-version=v1
Bildirimden yeni bir aracı sürümü oluşturun.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracıyı tanımlayan benzersiz ad. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. - Alfasayısal karakterlerle başlayıp bitmelidir, - Ortada kısa çizgi içerebilir - 63 karakteri aşmamalıdır. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| manifest_id | String | Aracı sürümünü içeri aktaracak bildirim kimliği. | Evet | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| parameter_values | nesne | Bildirime yapılan ve tam olarak gerçekleştirilmiş bir Aracı ile sonuçlanacak girişler. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentVersionObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracılar - bildirimden aracı oluşturma
POST {endpoint}/agents:import?api-version=v1
Bildirimden bir aracı oluşturur.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| manifest_id | String | Aracı sürümünü içeri aktaracak bildirim kimliği. | Evet | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Aracıyı tanımlayan benzersiz ad. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. - Alfasayısal karakterlerle başlayıp bitmelidir, - Ortada kısa çizgi içerebilir - 63 karakteri aşmamalıdır. Kısıtlamalar: maxLength: 63 |
Evet | |
| parameter_values | nesne | Bildirime yapılan ve tam olarak gerçekleştirilmiş bir Aracı ile sonuçlanacak girişler. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı Kapsayıcıları
Aracı kapsayıcıları - aracı kapsayıcı işlemlerini listeleme
GET {endpoint}/agents/{agent_name}/operations?api-version=v1
Bir aracı için kapsayıcı işlemlerini listeleme.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı kapsayıcısı işlemini alma
GET {endpoint}/agents/{agent_name}/operations/{operation_id}?api-version=v1
Bir aracı için kapsayıcı işleminin durumunu alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| operation_id | path | Evet | String | İşlem kimliği. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentContainerOperationObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı kapsayıcısı alma
GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default?api-version=v1
Aracının belirli bir sürümü için kapsayıcı alma.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentContainerObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı sürümü kapsayıcı işlemlerini listeleme
GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default/operations?api-version=v1
Bir aracının belirli bir sürümü için kapsayıcı işlemlerini listeleme.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı kapsayıcısı silme
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:delete?api-version=v1
Bir aracının belirli bir sürümü için kapsayıcıyı silin. Kapsayıcı yoksa, işlem no-opolur. İşlem uzun süre çalışan bir işlemdir. Azure REST API'lerinde uzun süreli işlemler için tasarım yönergelerine uymak. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 202
Açıklama: İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentContainerOperationObject |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| İşlem Konumu | String |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - akış aracısı kapsayıcı günlükleri
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:logstream?api-version=v1
Konteyner log girişi, konteynerden metin parçaları olarak akış yapar. Her parça, akış yapılan konteyner logu türüne bağlı olarak ya düz metin log satırı ya da JSON formatlı log girişi olabilecek bir UTF-8 dizisidir. İstemciler her parçayı opak metin olarak ele almalı ve gerekirse loglama gereksinimlerine göre JSON olarak ayrıştırmaya çalışmalı.
Sistem kayıtları için format JSON'dur ve şu yapıya sahiptir: {"TimeStamp":"2025-12-15T16:51:33Z","Type":"Normal","ContainerAppName":null,"RevisionName":null,"ReplicaName":null,"Msg":"Olay toplayıcısına bağlanıyor...","Reason":"StartingGettingEvents","EventSource":"ContainerAppController","Count":1} {"TimeStamp":"2025-12-15T16:51:34Z","Type":"Normal","ContainerAppName":null,"RevisionName":null,"ReplicaName":null,"Msg":"Başarıyla olaylara bağlandı sunucu","Reason":"ConnectedToEventsServer","EventSource":"ContainerAppController","Count":1}
Konsol logları için format konteynerin stdout/stderr tarafından yayımlanan düz metindir. 2025-12-15T08:43:48.72656 Konteynere bağlanıyor 'ajan-konteyner'... 2025-12-15T08:43:48.75451 Konteynere Başarıyla Bağlandı: 'ajan-konteyner' [Revizyon: 'je90fe655aa742ef9a188b9fd14d6764--7tca06b', Replika: 'je90fe655aa742ef9a188b9fd14d6764--7tca06b-6898b9c89f-mpkjc'] 2025-12-15T08:33:59.0671054Z stdout F BILGI: 127.0.0.1:42588 - "GET /readyiness HTTP/1.1" 200 OK 2025-12-15T08:34:29.0649033Z stdout F BILGI: 127.0.0.1:60246 - "GET /readyiness HTTP/1.1" 200 OK 2025-12-15T08:34:59.0644467Z stdout F BILGI: 127.0.0.1:43994 - "GET /readyiness HTTP/1.1" 200 OK
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| tür | soru | Hayı | String Olası değerler: console, system |
konsol konteyner stdout/stderr döndürür, sistem konteyner uygulaması olay akışını döndürür. Konsola varsayılan |
| replica_name | soru | Hayı | String | Eksik bırakıldığında, sunucu konsol günlükleri için ilk replikayı seçer. Belirli bir çoğaltmayı hedeflemek için gereklidir. |
| kuyruk | soru | Hayı | tamsayı | Döndürülen sondaki satır sayısı. 1-300'e kadar zorunlu tutuldu. Varsayılan değer: 20 |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı kapsayıcısı başlatma
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:start?api-version=v1
Bir aracının belirli bir sürümü için kapsayıcı başlatın. Kapsayıcı zaten çalışıyorsa, işlem no-opolur. İşlem uzun süre çalışan bir işlemdir. Azure REST API'lerinde uzun süreli işlemler için tasarım yönergelerine uymak. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_replicas | tamsayı | En fazla çoğaltma sayısı. Varsayılan değer 1'tir. | Hayı | 1 |
| min_replicas | tamsayı | En az çoğaltma sayısı. Varsayılan değer 1'tir. | Hayı | 1 |
Yanıtlar
Durum Kodu: 202
Açıklama: İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentContainerOperationObject |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| İşlem Konumu | String |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı kapsayıcısını durdurma
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:stop?api-version=v1
Aracının belirli bir sürümü için kapsayıcıyı durdurun. Kapsayıcı çalışmıyorsa veya zaten durdurulmuşsa, işlem no-opolur. İşlem uzun süre çalışan bir işlemdir. Azure REST API'lerinde uzun süreli işlemler için tasarım yönergelerine uymak. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 202
Açıklama: İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentContainerOperationObject |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| İşlem Konumu | String |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Aracı kapsayıcıları - aracı kapsayıcısı güncelleştirme
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:update?api-version=v1
Bir aracının belirli bir sürümü için kapsayıcıyı güncelleştirme. Kapsayıcı çalışmıyorsa, işlem no-opolur. İşlem uzun süre çalışan bir işlemdir. Azure REST API'lerinde uzun süreli işlemler için tasarım yönergelerine uymak. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| agent_name | path | Evet | String | Aracının adı. |
| agent_version | path | Evet | String | Aracının sürümü. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: ContainerAgents=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_replicas | tamsayı | En fazla çoğaltma sayısı. | Hayı | |
| min_replicas | tamsayı | En az çoğaltma sayısı. | Hayı |
Yanıtlar
Durum Kodu: 202
Açıklama: İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AgentContainerOperationObject |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| İşlem Konumu | String |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Bağlantılar
Bağlantılar - liste
GET {endpoint}/connections?api-version=v1
Bağlantı bilgilerini doldurmadan proje'deki tüm bağlantıları listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| connectionType | soru | Hayı | String Olası değerler: AzureOpenAI, AzureBlob, AzureStorageAccount, , CognitiveSearch, CosmosDB, , ApiKey, AppConfigAppInsights, CustomKeys,RemoteTool_Preview |
Bu belirli türdeki bağlantıları listeleme |
| defaultConnection | soru | Hayı | Boolean | Varsayılan bağlantı olan bağlantıları listeleme |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| x-ms-client-request-id | Yanlış | String | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedConnection |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-client-request-id | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Bağlantılar - get
GET {endpoint}/connections/{name}?api-version=v1
Bağlantı kimlik bilgilerini doldurmadan ada göre bağlantı alma
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kullanıcı tarafından sağlanan bağlantının kolay adı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| x-ms-client-request-id | Yanlış | String | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Bağlantı |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-client-request-id | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Bağlantılar - kimlik bilgileriyle alma
POST {endpoint}/connections/{name}/getConnectionWithCredentials?api-version=v1
Bağlantı kimlik bilgileriyle ada göre bir bağlantı alın
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kullanıcı tarafından sağlanan bağlantının kolay adı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| x-ms-client-request-id | Yanlış | String | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Bağlantı |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-client-request-id | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri Setleri
Veri kümeleri - en son liste
GET {endpoint}/datasets?api-version=v1
Her DatasetVersion'ın en son sürümünü listeleme
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedDatasetVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri kümeleri - liste sürümleri
GET {endpoint}/datasets/{name}/versions?api-version=v1
Verilen DatasetVersion'ın tüm sürümlerini listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedDatasetVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri kümeleri - sürüm alma
GET {endpoint}/datasets/{name}/versions/{version}?api-version=v1
DatasetVersion'ın belirli bir sürümünü alın. DatasetVersion yoksa hizmet 404 Bulunamadı hatası döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Alınacak DatasetVersion'ın belirli sürüm kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DatasetVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri kümeleri - sürümü silme
DELETE {endpoint}/datasets/{name}/versions/{version}?api-version=v1
DatasetVersion'ın belirli bir sürümünü silin. DatasetVersion başarıyla silindiyse veya DatasetVersion yoksa hizmet 204 İçerik Yok döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Silinecek DatasetVersion sürümü. |
Yanıtlar
Durum Kodu: 204
Açıklama: Bu istek için gönderilecek içerik yok, ancak üst bilgiler yararlı olabilir.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri kümeleri - sürüm oluşturma veya güncelleştirme
PATCH {endpoint}/datasets/{name}/versions/{version}?api-version=v1
Verilen sürüm kimliğiyle yeni bir DatasetVersion oluşturun veya mevcut bir DatasetVersion'ı güncelleştirin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Oluşturulacak veya güncelleştirilecek DatasetVersion'ın belirli sürüm kimliği. |
İstek Gövdesi
İçerik Türü: application/merge-patch+json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | DatasetType | Veri türünü belirlemek için sabit listesi. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DatasetVersion |
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DatasetVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri kümeleri - kimlik bilgilerini alma
POST {endpoint}/datasets/{name}/versions/{version}/credentials?api-version=v1
Veri seti sürümüyle ilişkili storage hesabı access SAS kimlik bilgilerini alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Üzerinde çalışılacak DatasetVersion'ın belirli sürüm kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | AssetCredentialResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Veri kümeleri - bekleyen karşıya yükleme sürümünü başlatma
POST {endpoint}/datasets/{name}/versions/{version}/startPendingUpload?api-version=v1
Belirli bir sürüm için yeni bir veri kümesi başlatın veya mevcut bekleyen bir veri kümesini karşıya yükleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Üzerinde çalışılacak DatasetVersion'ın belirli sürüm kimliği. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| connectionName (bağlantıadı) | String | Azure Storage Account connection name to use for generate temporary SAS token | Hayı | |
| pendingUploadId | String | PendingUploadId sağlanmazsa, rastgele bir GUID kullanılır. | Hayı | |
| pendingUploadType | enum | BlobReference desteklenen tek türdür. Olası değerler: BlobReference |
Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PendingUploadResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dağıtımlar
Dağıtımlar - liste
GET {endpoint}/deployments?api-version=v1
Projede tüm dağıtılan modelleri listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| modelPublisher | soru | Hayı | String | Modelleri filtreleyen model publisher |
| modelName | soru | Hayı | String | Modelleri filtrelemek için model adı (publisher özel adı) |
| deploymentType | soru | Hayı | String Olası değerler: ModelDeployment |
Listeyi filtreleme ölçütü olarak kullanılacak dağıtım türü |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| x-ms-client-request-id | Yanlış | String | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedDeployment |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-client-request-id | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dağıtımlar - get
GET {endpoint}/deployments/{name}?api-version=v1
Dağıtılan bir model edinin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Dağıtımın adı |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| x-ms-client-request-id | Yanlış | String | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Dağıtım |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-client-request-id | İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme Taksonomileri
Değerlendirme taksonomileri - liste
GET {endpoint}/evaluationtaxonomies?api-version=v1
Liste değerlendirme taksonomileri
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| inputName | soru | Hayı | String | Değerlendirme giriş adına göre filtreleyin. |
| inputType | soru | Hayı | String | Taksonomi giriş türüne göre filtreleyin. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedEvaluationTaxonomy |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme taksonomileri - get
GET {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Ada göre çalıştırılan bir değerlendirme alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationTaxonomy |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme taksonomileri - silme
DELETE {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Bir değerlendirme taksonomisini ada göre silin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 204
Açıklama: Bu istek için gönderilecek içerik yok, ancak üst bilgiler yararlı olabilir.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme taksonomileri - oluşturma
PUT {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Bir değerlendirme taksonomisi oluşturun.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Değerlendirme taksonomisinin adı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| properties | nesne | Değerlendirme taksonomisi için ek özellikler. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| taksonomi Kategorileri | TaxonomyCategory dizisi | Taksonomi kategorilerinin listesi. | Hayı | |
| taksonomiInput | EvaluationTaxonomyInput | Değerlendirme taksonomisi için giriş yapılandırması. | Evet | |
| └─ türü | EvaluationTaxonomyInputType | Değerlendirme taksonomisinin giriş türü. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationTaxonomy |
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationTaxonomy |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme taksonomileri - güncelleştirme
PATCH {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Değerlendirme taksonomisini güncelleştirin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Değerlendirme taksonomisinin adı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| properties | nesne | Değerlendirme taksonomisi için ek özellikler. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| taksonomi Kategorileri | TaxonomyCategory dizisi | Taksonomi kategorilerinin listesi. | Hayı | |
| taksonomiInput | EvaluationTaxonomyInputUpdate | Değerlendirme taksonomisi için giriş yapılandırması. | Hayı | |
| └─ türü | EvaluationTaxonomyInputType | Değerlendirme taksonomisinin giriş türü. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationTaxonomy |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme Kuralları
Değerlendirme kuralları - liste
GET {endpoint}/evaluationrules?api-version=v1
Tüm değerlendirme kurallarını listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| actionType | soru | Hayı | String Olası değerler: continuousEvaluation, humanEvaluationPreview |
Değerlendirme kuralı türüne göre filtreleyin. |
| ajan adı | soru | Hayı | String | Temsilci adına göre filtreleyin. |
| etkinleştirildi | soru | Hayı | Boolean | Etkin duruma göre filtreleyin. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedEvaluationRule |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme kuralları - get
GET {endpoint}/evaluationrules/{id}?api-version=v1
Bir değerlendirme kuralı alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Değerlendirme kuralı için benzersiz tanımlayıcı. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationRule |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme kuralları - silme
DELETE {endpoint}/evaluationrules/{id}?api-version=v1
Değerlendirme kuralını silin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Değerlendirme kuralı için benzersiz tanımlayıcı. |
Yanıtlar
Durum Kodu: 204
Açıklama: Bu istek için gönderilecek içerik yok, ancak üst bilgiler yararlı olabilir.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendirme kuralları - oluşturma veya güncelleştirme
PUT {endpoint}/evaluationrules/{id}?api-version=v1
Değerlendirme kuralı oluşturun veya güncelleştirin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Değerlendirme kuralı için benzersiz tanımlayıcı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Yanlış | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | EvaluationRuleAction | Değerlendirme eylem modeli. | Evet | |
| └─ türü | EvaluationRuleActionType | Değerlendirme eyleminin türü. | Evet | |
| açıklama | String | Değerlendirme kuralının açıklaması. | Hayı | |
| ekran adı | String | Değerlendirme kuralı için Görünen Ad. | Hayı | |
| etkinleştirildi | Boolean | Değerlendirme kuralının etkin olup olmadığını gösterir. Varsayılan değer doğrudur | Evet | |
| eventType | EvaluationRuleEventType | Değerlendirme kuralı olayının türü. | Evet | |
| filtre | EvaluationRuleFilter | Değerlendirme filtresi modeli. | Hayı | |
| └─ ajanName | String | Müşteri temsilcisi adına göre filtreleyin. | Evet | |
| kimlik | dize (salt okunur) | Değerlendirme kuralı için benzersiz tanımlayıcı. | Evet | |
| sistem verileri | object (salt okunur) | Değerlendirme kuralı için sistem meta verileri. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationRule |
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluationRule |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendiriciler
Değerlendiriciler - en son sürümleri listeleme
GET {endpoint}/evaluators?api-version=v1
Her değerlendiricinin en son sürümünü listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| type | soru | Hayı | String Olası değerler: builtin, custom, all |
Değerlendiricileri türe göre filtreleyin. Olası değerler: 'all', 'custom', 'builtin'. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedEvaluatorVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendiriciler - liste sürümleri
GET {endpoint}/evaluators/{name}/versions?api-version=v1
Verilen değerlendiricinin tüm sürümlerini listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| type | soru | Hayı | String Olası değerler: builtin, custom, all |
Değerlendiricileri türe göre filtreleyin. Olası değerler: 'all', 'custom', 'builtin'. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedEvaluatorVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendiriciler - sürüm oluşturma
POST {endpoint}/evaluators/{name}/versions?api-version=v1
Otomatik artırılmış sürüm kimliğiyle yeni bir EvaluatorVersion oluşturma
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| categories | DeğerlendiriciKatgorisi dizisi | Değerlendiricinin kategorileri | Evet | |
| tanım | DeğerlendiriciDefinition | Ayırıcılı temel değerlendirici konfigürasyonu | Evet | |
| └─ data_schema | nesne | Değerlendiricinin giriş verileri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| └─ init_parameters | nesne | Değerlendiricinin giriş parametreleri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| └─ ölçümler | nesne | Bu değerlendirici tarafından üretilen çıktı metriklerinin listesi | Hayı | |
| └─ türü | EvaluatorDefinitionType | Değerlendirici tanımının türü | Evet | |
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| display_name | String | Değerlendirici için Görünen Ad. AI Foundry'de değerlendiriciyi kolayca bulmak yardımcı olur. Benzersiz olması gerekmez. | Hayı | |
| evaluator_type | Değerlendirici Türü | Değerlendiricinin türü | Evet | |
| metadata | nesne | Değerlendirici hakkında meta veriler | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı |
Yanıtlar
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluatorVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendiriciler - sürümü alma
GET {endpoint}/evaluators/{name}/versions/{version}?api-version=v1
EvaluatorVersion'ın belirli sürümünü edinin. EvaluatorVersion yoksa hizmet 404 Not Found hatası döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Alınacak EvaluatorVersion'ın belirli sürüm kimliği. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluatorVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendiriciler - sürümü silme
DELETE {endpoint}/evaluators/{name}/versions/{version}?api-version=v1
EvaluatorVersion'ın belirli sürümünü silin. EvaluatorVersion başarıyla silindiyse veya EvaluatorVersion mevcut değilse hizmet 204 İçerik Yok döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Silinecek EvaluatorVersion sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 204
Açıklama: Bu istek için gönderilecek içerik yok, ancak üst bilgiler yararlı olabilir.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Değerlendiriciler - güncelleştirme sürümü
PATCH {endpoint}/evaluators/{name}/versions/{version}?api-version=v1
Mevcut bir EvaluatorVersion'ı verilen sürüm kimliğiyle güncelleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Güncelleştirilecek EvaluatorVersion sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Evaluations=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| categories | DeğerlendiriciKatgorisi dizisi | Değerlendiricinin kategorileri | Hayı | |
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| display_name | String | Değerlendirici için Görünen Ad. AI Foundry'de değerlendiriciyi kolayca bulmak yardımcı olur. Benzersiz olması gerekmez. | Hayı | |
| metadata | nesne | Değerlendirici hakkında meta veriler | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvaluatorVersion |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dizinler
Dizinler - en son liste
GET {endpoint}/indexes?api-version=v1
Her Dizinin en son sürümünü listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedIndex |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dizinler - liste sürümleri
GET {endpoint}/indexes/{name}/versions?api-version=v1
Verilen Dizinin tüm sürümlerini listeleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedIndex |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dizinler - sürüm alma
GET {endpoint}/indexes/{name}/versions/{version}?api-version=v1
Dizinin belirli bir sürümünü edinin. Dizin yoksa hizmet 404 Bulunamadı hatası döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Alınacak Dizinin belirli sürüm kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Dizin |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dizinler - sürümü silme
DELETE {endpoint}/indexes/{name}/versions/{version}?api-version=v1
Dizinin belirli bir sürümünü silin. Hizmet, Dizin başarıyla silindiyse veya Dizin mevcut değilse 204 İçerik Yok döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Silinecek Dizin sürümü. |
Yanıtlar
Durum Kodu: 204
Açıklama: Bu istek için gönderilecek içerik yok, ancak üst bilgiler yararlı olabilir.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Dizinler - sürüm oluşturma veya güncelleştirme
PATCH {endpoint}/indexes/{name}/versions/{version}?api-version=v1
Verilen sürüm kimliğiyle yeni bir Dizin oluşturun veya mevcut bir Dizini güncelleyin
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kaynağın adı |
| version | path | Evet | String | Oluşturulacak veya güncelleştirilecek Dizinin belirli sürüm kimliği. |
İstek Gövdesi
İçerik Türü: application/merge-patch+json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | IndexType | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Dizin |
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Dizin |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Insights
İçgörüler - oluşturma
POST {endpoint}/insights?api-version=v1
İçgörüler Oluşturun
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Insights=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
| Yinelenebilirlik-Request-ID | Yanlış | String | İstek iktidarını sağlamak için benzersiz, istemci tarafından oluşturulan tanımlayıcı. Yinelenen değerlendirmeleri önlemek için yeniden denemeler için aynı kimliği kullanın. |
| Yinelenebilirlik-First-Sent | Yanlış | String | Bu isteğin ilk kez ne zaman başlatıldığını gösteren zaman damgası. İdempotens kontrolü için repeatability-request-id ile birlikte kullanılır. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| ekran adı | String | İçgörü için kullanıcı dostu görünen ad. | Evet | |
| kimlik | dize (salt okunur) | İçgörüler raporunun benzersiz tanımlayıcısı. | Evet | |
| metadata | InsightsMetadata (salt okunur) | İçgörülerle ilgili meta veriler. | Evet | |
| └─ tamamlandıAt | String | İçgörülerin tamamlandığı zaman damgası. | Hayı | |
| └─ oluşturuldu | String | İçgörülerin oluşturulduğu zaman damgası. | Evet | |
| request | InsightRequest | İçgörüler raporunun isteği. | Evet | |
| └─ türü | InsightType | İstek türü. | Evet | |
| sonuç | InsightResult (salt okunur) | İçgörülerin sonucu. | Hayı | |
| └─ türü | InsightType | İçgörülerin türü sonucu. | Evet | |
| state | Azure. Core.Foundations.OperationState (yalnızca okunabilir) | İzin verilen işlem durumlarını açıklayan sabit listesi. | Evet |
Yanıtlar
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Insight |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
İçgörüler - liste
GET {endpoint}/insights?api-version=v1
Tüm içgörüleri ters kronolojik sırayla listeleyin (önce en yeni).
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| type | soru | Hayı | String Olası değerler: EvaluationRunClusterInsight, AgentClusterInsight, EvaluationComparison |
Analiz türüne göre filtreleyin. |
| evalId | soru | Hayı | String | Değerlendirme kimliğine göre filtreleyin. |
| runId | soru | Hayı | String | Değerlendirme çalıştırma kimliğine göre filtreleyin. |
| ajan adı | soru | Hayı | String | Temsilci adına göre filtreleyin. |
| includeCoordinates | soru | Hayı | Boolean | Yanıta görselleştirme için koordinatların dahil edilip edilmeyeceği. Varsayılan değer false'tur. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Insights=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedInsight |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
İçgörüler - get
GET {endpoint}/insights/{id}?api-version=v1
Kimliğe göre belirli bir içgörü elde edin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | İçgörüler raporunun benzersiz tanımlayıcısı. |
| includeCoordinates | soru | Hayı | Boolean | Yanıta görselleştirme için koordinatların dahil edilip edilmeyeceği. Varsayılan değer false'tur. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Insights=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Insight |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Bellek Depoları
Bellek deposu oluşturma
POST {endpoint}/memory_stores?api-version=v1
Bir bellek deposu oluşturun.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | MemoryStoreDefinition | Bellek deposu yapılandırmaları için temel tanım. | Evet | |
| └─ tür | MemoryStoreKind | Bellek deposunun türü. | Evet | |
| açıklama | String | Bellek deposunun okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bellek deposuyla ilişkilendirilecek rastgele anahtar-değer meta verileri. | Hayı | |
| name | String | Bellek deposunun adı. Kısıtlamalar: maxLength: 256 |
Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Bellek depolarını listeleme
GET {endpoint}/memory_stores?api-version=v1
Tüm bellek depolarını listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Bellek depolarını güncelleştirme
POST {endpoint}/memory_stores/{name}?api-version=v1
Bellek deposunu güncelleştirin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Güncelleştirilecek bellek deposunun adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Bellek deposunun okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bellek deposuyla ilişkilendirilecek rastgele anahtar-değer meta verileri. | Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Bellek deposu alma
GET {endpoint}/memory_stores/{name}?api-version=v1
Bir bellek deposu alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Alınacak bellek deposunun adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreObject |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Bellek depolarını silme
DELETE {endpoint}/memory_stores/{name}?api-version=v1
Bellek deposunu silin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Silinecek bellek deposunun adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DeleteMemoryStoreResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Güncelleştirme sonucunu alma
GET {endpoint}/memory_stores/{name}/updates/{update_id}?api-version=v1
Bellek deposu güncelleme sonucunu alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Bellek deposunun adı. |
| update_id | path | Evet | String | Bellek güncelleştirme işleminin kimliği. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreUpdateResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Kapsam belleklerini silme
POST {endpoint}/memory_stores/{name}:delete_scope?api-version=v1
Belirli bir kapsamla ilişkili tüm anıları bir bellek deposundan silin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Bellek deposunun adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kapsam | String | Kullanıcı kimliği gibi silinecek bellekleri mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreDeleteScopeResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Anılarda arama
POST {endpoint}/memory_stores/{name}:search_memories?api-version=v1
Konuşma bağlamına göre bir bellek deposundan ilgili anıları arayın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Aranacak bellek deposunun adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nesneler | OpenAI.InputItem dizisi | İlgili anıların aranacağı öğeler. | Hayı | |
| options | MemorySearchOptions | Bellek arama seçenekleri. | Hayı | |
| └─ max_memories | tamsayı | Döndürülecek en fazla bellek öğesi sayısı. | Hayı | |
| previous_search_id | String | Önceki arama isteğinin benzersiz kimliği, son işlemin kaldığı yerden artımlı bellek aramasını etkinleştirir. | Hayı | |
| kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreSearchResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Bellekleri güncelleştirme
POST {endpoint}/memory_stores/{name}:update_memories?api-version=v1
Bellek deposunu konuşma anılarıyla güncelleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| name | path | Evet | String | Güncelleştirilecek bellek deposunun adı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: MemoryStores=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nesneler | OpenAI.InputItem dizisi | Anıların çıkarılacağı konuşma öğeleri. | Hayı | |
| previous_update_id | String | Önceki güncelleştirme isteğinin benzersiz kimliği, son işlemin kaldığı yerden artımlı bellek güncelleştirmelerini etkinleştirir. | Hayı | |
| kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet | |
| update_delay | tamsayı | Bellek güncellemesini saniye cinsinden işlemeden önceki zaman aşımı süresi. Bu süre içinde yeni bir güncelleme isteği alınırsa, mevcut isteği iptal edecek ve zaman aşımını sıfırlayacaktır. Güncellemeyi gecikmeden hemen tetiklemek için 0 olarak ayarlayın. Varsayılan olarak 300'dür (5 dakika). |
Hayı | 300 |
Yanıtlar
Durum Kodu: 202
Açıklama: İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | MemoryStoreUpdateResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| İşlem Konumu | String | İşlem durumunu izleme konumu. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşma
Konuşma oluşturma
POST {endpoint}/openai/v1/conversations
Konuşma oluşturma.
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nesneler | OpenAI.InputItem dizisi | Hayı | ||
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ConversationResource |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşmaları listeleme
GET {endpoint}/openai/v1/conversations
Tüm konuşmaların listesini döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| agent_name | soru | Hayı | String | Müşteri temsilcisi adına göre filtreleyin. Sağlanırsa, yalnızca belirtilen aracıyla ilişkilendirilmiş öğeler döndürülür. |
| agent_id | soru | Hayı | String | Aracı kimliğine göre biçiminde name:versionfiltreleyin. Sağlanırsa, yalnızca belirtilen aracı kimliğiyle ilişkilendirilmiş öğeler döndürülür. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşmayı güncelleştirme
POST {endpoint}/openai/v1/conversations/{conversation_id}
Bir konuşmayı güncelleştirme.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Güncelleştirilecek konuşmanın kimliği. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ConversationResource |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşma alma
GET {endpoint}/openai/v1/conversations/{conversation_id}
Bir konuşmayı alır.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Alınacak konuşmanın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ConversationResource |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşmayı silme
DELETE {endpoint}/openai/v1/conversations/{conversation_id}
Bir konuşmayı siler.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Silinecek konuşmanın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.DeletedConversationResource |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşma öğeleri oluşturma
POST {endpoint}/openai/v1/conversations/{conversation_id}/items
Verilen kimlikle bir konuşmada öğeler oluşturun.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Öğenin oluşturulması gereken konuşmanın kimliği. |
| include | soru | Hayı | dizi | Yanıta eklenecek ek alanlar.include Daha fazla bilgi için Konuşma öğelerini listeleme parametresine bakın. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nesneler | OpenAI.Item dizisi | Konuşmaya eklenecek öğeler. Bir kerede en fazla 20 öğe ekleyebilirsiniz. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ConversationItemList |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşma öğelerini listeleme
GET {endpoint}/openai/v1/conversations/{conversation_id}/items
Verilen kimlikle bir konuşmanın tüm öğelerini listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Öğelerin listelenmesi gereken konuşmanın kimliği. |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| item_type | soru | Hayı | String Olası değerler: message, , , output_message, file_search_call, computer_call, , computer_call_output, web_search_call, function_call, function_call_output, reasoningcompaction, image_generation_callcode_interpreter_call, local_shell_calllocal_shell_call_outputshell_callshell_call_outputapply_patch_call, apply_patch_call_output, mcp_list_tools, , , mcp_approval_request, mcp_approval_response, , , mcp_callcustom_tool_call_outputcustom_tool_callstructured_outputsoauth_consent_requestmemory_search_callworkflow_action |
Öğe türüne göre filtreleyin. Sağlanırsa, yalnızca belirtilen türdeki öğeler döndürülür. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşma öğesini alma
GET {endpoint}/openai/v1/conversations/{conversation_id}/items/{item_id}
Verilen kimliklerle bir konuşmadan tek bir öğe alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Öğeyi içeren konuşmanın kimliği. |
| item_id | path | Evet | String | Alınacak konuşma öğesinin kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.OutputItem |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Konuşma öğesini silme
DELETE {endpoint}/openai/v1/conversations/{conversation_id}/items/{item_id}
Verilen kimliklerle bir konuşmadaki öğeyi silin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| conversation_id | path | Evet | String | Öğenin silinmesi gereken konuşmanın kimliği. |
| item_id | path | Evet | String | Silinecek konuşma öğesinin kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ConversationResource |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler
Değerlendirmeler - değerlendirmeleri listeleme
GET {endpoint}/openai/v1/evals
Tüm değerlendirmeleri listele Bir proje için değerlendirmeleri listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| after | soru | Hayı | String | Önceki sayfalandırma isteğindeki son çalıştırma tanımlayıcısı. |
| limit | soru | Hayı | tamsayı | Alınacak koşu sayısı. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Çalıştırmalar için zaman damgasına göre sıralama düzeni. artan sırayla sıralama için asc veya azalan sırayla sıralama için desc kullanın. Varsayılan olarak asc değerini alır. |
| sırala_göre | soru | Hayı | String Olası değerler: created_at, updated_at |
Değerlendirmeler oluşturma zamanına veya son güncelleştirme zamanına göre sıralanabilir.created_at oluşturma zamanı veya updated_at son güncelleştirme zamanı için kullanın. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme oluşturma
POST {endpoint}/openai/v1/evals
Değerlendirme oluşturma Modelin performansını test etmek için kullanılabilecek bir değerlendirmenin yapısını oluşturun. Değerlendirme, değerlendirmede kullanılan verilerin şemasını belirleyen bir dizi test ölçütü ve veri kaynağı yapılandırmasıdır. Değerlendirme oluşturduktan sonra, bunu farklı modellerde ve model parametrelerinde çalıştırabilirsiniz. Çeşitli türlerde not verenleri ve veri kaynaklarını destekliyoruz. Daha fazla bilgi için bkz.
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veri_kaynağı_yapılandırması | OpenAI.CreateEvalCustomDataSourceConfig veya OpenAI.CreateEvalLogsDataSourceConfig veya OpenAI.CreateEvalStoredCompletionsDataSourceConfig veya AzureAIDataSourceConfig | Değerlendirme için kullanılan veri kaynağının yapılandırması çalışır. Değerlendirmede kullanılan verilerin şemasını dikte eder. | Evet | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Değerlendirmenin adı. | Hayı | |
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı | |
| test kriterleri | OpenAI.EvalGraderLabelModel veya OpenAI.EvalGraderStringCheck ya da OpenAI.EvalGraderTextSimilarity veya OpenAI.EvalGraderPython ya da OpenAI.EvalGraderScoreModel veya EvalGraderAzureAIEvaluator dizisi | Bu gruptaki tüm değerlendirme çalıştırmaları için değerlendirici listesi. Not verenler, gibi {{item.variable_name}}çift küme ayracı gösterimini kullanarak veri kaynağındaki değişkenlere başvurabilir. Modelin çıkışına başvurmak için ad alanını sample (örneğin, {{sample.output_text}}) kullanın. |
Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Değerlendirme |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirmeyi silme
DELETE {endpoint}/openai/v1/evals/{eval_id}
Değerlendirmeyi silme Değerlendirmeyi silin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Silinecek değerlendirmenin kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DeleteEvalResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme alma
GET {endpoint}/openai/v1/evals/{eval_id}
Değerlendirme alma Kimliğine göre değerlendirme alma.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Elde edilecek değerlendirmenin kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Değerlendirme |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirmeyi güncelleştirme
POST {endpoint}/openai/v1/evals/{eval_id}
Değerlendirmeyi güncelleştirme Değerlendirmenin belirli özelliklerini güncelleştirin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Güncelleştirilecek değerlendirmenin kimliği. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Hayı | ||
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Değerlendirme |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - liste çalıştırmaları
GET {endpoint}/openai/v1/evals/{eval_id}/runs
Değerlendirme için çalıştırmaların listesini alma Değerlendirme için çalıştırmaların listesini alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Çalıştırmaları almak için kullanılacak değerlendirmenin kimliği. |
| after | soru | Hayı | String | Önceki sayfalandırma isteğindeki son çalıştırma tanımlayıcısı. |
| limit | soru | Hayı | tamsayı | Alınacak koşu sayısı. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Çalıştırmalar için zaman damgasına göre sıralama düzeni. artan sırayla sıralama için asc veya azalan sırayla sıralama için desc kullanın. Varsayılan olarak asc değerini alır. |
| durum | soru | Hayı | String Olası değerler: queued, in_progress, completed, canceled, failed . Filtre duruma göre çalışır.
queued, , in_progress, failed, completed. canceled |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme çalıştırması oluşturma
POST {endpoint}/openai/v1/evals/{eval_id}/runs
Değerlendirme çalıştırması oluşturma
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Çalıştırma oluşturulacak değerlendirmenin kimliği. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veri_kaynağı | OpenAI.CreateEvalJsonlRunDataSource veya OpenAI.CreateEvalCompletionsRunDataSource veya OpenAI.CreateEvalResponsesRunDataSource veya EvalRunDataSource | Çalıştırmanın veri kaynağıyla ilgili ayrıntılar. | Evet | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Koşunun adı. | Hayı | |
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvalRun |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme çalıştırmayı silme
DELETE {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}
Değerlendirme çalıştırması silme Değerlendirme çalıştırması silme.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Silinmesi istenen çalışmanın değerlendirmenin kimliği. |
| run_id | path | Evet | String | Silinecek çalıştırmanın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DeleteEvalRunResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme çalıştırması alma
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}
Değerlendirme çalıştırması alma Id ile değerlendirme çalıştırması alma.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Çalıştırmaları almak için kullanılacak değerlendirmenin kimliği. |
| run_id | path | Evet | String | Alınacak çalıştırmanın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvalRun |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme çalıştırmayı iptal etme
POST {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}
Değerlendirme çalıştırmayı iptal et Devam eden değerlendirme çalıştırmalarını iptal edin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Çalıştırmasını iptal etmek istediğiniz değerlendirmenin kimliği. |
| run_id | path | Evet | String | İptal edilen çalıştırmanın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvalRun |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme çalıştırma çıkış öğelerini alma
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items
Değerlendirme çalıştırması çıkış öğelerini alma Değerlendirme çalıştırması için çıkış öğelerinin listesini alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | |
| run_id | path | Evet | String | Çıkış öğelerini almak için çalıştırmanın kimliği. |
| after | soru | Hayı | String | Önceki sayfalandırma isteğindeki son çalıştırma tanımlayıcısı. |
| limit | soru | Hayı | tamsayı | Alınacak koşu sayısı. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Çalıştırmalar için zaman damgasına göre sıralama düzeni. artan sırayla sıralama için asc veya azalan sırayla sıralama için desc kullanın. Varsayılan olarak asc değerini alır. |
| durum | soru | Hayı | String Olası değerler: fail, pass |
Çıkış öğelerini duruma göre filtreleyin. Başarısız çıkışa göre filtrelemek için kullanın failedveya pass geçirilen çıkış öğelerine göre filtrelemek için. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Değerlendirmeler - değerlendirme çalıştırması çıkış öğesini alma
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}
Bir değerlendirme çalıştırmasının çıkış öğesini alma Kimliğine göre değerlendirme çalıştırması çıkış öğesi alma.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| eval_id | path | Evet | String | Çalıştırmaları almak için kullanılacak değerlendirmenin kimliği. |
| run_id | path | Evet | String | Alınacak çalıştırmanın kimliği. |
| output_item_id | path | Evet | String | Alınacak çıkış öğesinin kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | EvalRunOutputItem |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Fine-Tuning
İnce ayar işi oluşturma
POST {endpoint}/openai/v1/fine_tuning/jobs?api-version=v1
Belirli bir veri kümesinden yeni model oluşturma işlemine başlayan bir ince ayar işi oluşturur.
Yanıt, iş durumu ve tamamlandıktan sonra ince ayarlı modellerin adı da dahil olmak üzere sıralanan işin ayrıntılarını içerir.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hiper parametreler | OpenAI.CreateFineTuningJobRequestHyperparameters | Hayı | ||
| └─ yığın boyutu | dize veya OpenAI.integer | Hayı | otomatik | |
| └─ öğrenme oranı çarpanı | dize veya OpenAI.numeric | Hayı | ||
| └─ n_epochs | dize veya OpenAI.integer | Hayı | otomatik | |
| Entegrasyonlar | OpenAI.CreateFineTuningJobRequestIntegrations dizisi | İnce ayar işiniz için etkinleştirecek tümleştirmelerin listesi. | Hayı | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| method | OpenAI.FineTuneMethod | İnce ayar için kullanılan yöntem. | Hayı | |
| model | dize (aşağıdaki geçerli modellere bakın) | İnce ayar için modelin adı. Aşağıdakilerden birini seçebilirsiniz: destekli modeller. |
Evet | |
| seed | OpenAI.integer (null atanabilir) | Hayı | ||
| suffix | dize (null atanabilir) | İnce ayarlı model adınıza eklenecek en fazla 64 karakterlik bir dize. Örneğin, suffix "özel model-adı" gibi bir model adı ft:gpt-4o-mini:openai:custom-model-name:7p4lURelüretir.Kısıtlamalar: minLength: 1, maxLength: 64 |
Hayı | |
| eğitim_dosyası | String | Eğitim verilerini içeren karşıya yüklenen bir dosyanın kimliği. Karşıya dosya yükleme hakkında bilgi için bkz. dosyayı karşıya yükleme. Veri kümeniz JSONL dosyası olarak biçimlendirilmelidir. Ayrıca, dosyanızı amacı fine-tuneile karşıya yüklemeniz gerekir.Dosyanın içeriği, modelin sohbet, tamamlanma biçimi veya ince ayar yönteminin tercih biçimini kullanıp kullanmama durumuna bağlı olarak farklılık göstermelidir. Daha fazla detay için ince ayar rehberi sayfasına bakınız. |
Evet | |
| doğrulama_dosyası | dize (null atanabilir) | Doğrulama verilerini içeren karşıya yüklenen bir dosyanın kimliği. Bu dosyayı sağlarsanız, veriler doğrulama oluşturmak için kullanılır ölçümlerini ince ayarlama sırasında düzenli aralıklarla gerçekleştirin. Bu ölçümler ince ayar sonuçları dosyası. Aynı veriler hem eğitme hem de doğrulama dosyalarında bulunmamalıdır. Veri kümeniz JSONL dosyası olarak biçimlendirilmelidir. Dosyanızı amacı fine-tuneile karşıya yüklemeniz gerekir.Daha fazla detay için ince ayar rehberi sayfasına bakınız. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.FineTuningJob |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Sayfalandırılmış ince ayar işlerini listeleme
GET {endpoint}/openai/v1/fine_tuning/jobs?api-version=v1
Kuruluşunuzun ince ayar işlerini listeleme
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| after | soru | Hayı | String | Önceki sayfalandırma isteğindeki son işin tanımlayıcısı. |
| limit | soru | Hayı | tamsayı | Alınacak ince ayar işlerinin sayısı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ListPaginatedFineTuningJobsResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
hassas ayarlama işini alma
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}?api-version=v1
İnce ayar işi hakkında bilgi edinin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| ince_ayarlama_iş_id | path | Evet | String | İnce ayar işinin kimliği. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.FineTuningJob |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
İnce ayarlama işini iptal etme
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel?api-version=v1
Hassas ayarlama işini hemen iptal edin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| ince_ayarlama_iş_id | path | Evet | String | İptal edilecek ince ayar işinin kimliği. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.FineTuningJob |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
İnce ayar iş denetim noktalarını listeleme
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints?api-version=v1
bir ince ayar işi için denetim noktalarını listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| ince_ayarlama_iş_id | path | Evet | String | Denetim noktalarını almak için ince ayar işinin kimliği. |
| after | soru | Hayı | String | Önceki sayfalandırma isteğindeki son denetim noktası kimliğinin tanımlayıcısı. |
| limit | soru | Hayı | tamsayı | Alınacak denetim noktası sayısı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ListFineTuningJobCheckpointsResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
İnce ayar iş olaylarını listeleme
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/events?api-version=v1
hassas ayarlama işi için ayrıntılı durum güncelleştirmeleri alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| ince_ayarlama_iş_id | path | Evet | String | Olay almak için ince ayar işinin kimliği. |
| after | soru | Hayı | String | Önceki sayfalandırma isteğindeki son olayın tanımlayıcısı. |
| limit | soru | Hayı | tamsayı | Alınacak olay sayısı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.ListFineTuningJobEventsResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
İnce ayarlama işini duraklatma
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/pause?api-version=v1
Çalışan bir ince ayar işini duraklatma.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| ince_ayarlama_iş_id | path | Evet | String | Duraklatmak için ince ayar işinin kimliği. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.FineTuningJob |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
hassas ayarlama işini sürdürme
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/resume?api-version=v1
Duraklatılmış ince ayar işini sürdürme.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| ince_ayarlama_iş_id | path | Evet | String | Sürdürülecek ince ayar işinin kimliği. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.FineTuningJob |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Yanıtlar
Yanıt oluşturma - yanıt akışı oluşturma
POST {endpoint}/openai/v1/responses
Model yanıtı oluşturur. Model yanıtı (akış yanıtı) oluşturur.
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| arka plan | boole değeri (null atanabilir) | Hayı | ||
| konuşma | OpenAI.ConversationParam (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu konuşmadaki öğeler, bu yanıt isteği için öğesine input_items eklenir.Bu yanıt tamamlandıktan sonra bu yanıttaki giriş öğeleri ve çıkış öğeleri otomatik olarak bu konuşmaya eklenir. |
Hayı | |
| include | OpenAI.IncludeEnum dizisi | Hayı | ||
| girdi | OpenAI.InputParam | Yanıt oluşturmak için kullanılan modele metin, görüntü veya dosya girişleri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Görüntü girişleri - Dosya girişleri - Konuşma durumu - fonksiyon çağırıyor |
Hayı | |
| instructions | dize (null atanabilir) | Hayı | ||
| max_output_tokens | OpenAI.integer (null atanabilir) | Hayı | ||
| max_tool_calls | OpenAI.integer (null atanabilir) | Hayı | ||
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| model | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| paralel araç çağrıları | boole değeri (null atanabilir) | Hayı | Doğru | |
| previous_response_id | dize (null atanabilir) | Hayı | ||
| prompt | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| reasoning | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ çaba | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| └─ özet oluştur | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| └─ özeti | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| hizmet seviyesi | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| store | boole değeri (null atanabilir) | Hayı | Doğru | |
| veri akışı | boole değeri (null atanabilir) | Hayı | ||
| stream_options | OpenAI.ResponseStreamOptions (null atanabilir) | Akış yanıtları için seçenekler. Bunu yalnızca ayarladığınızda ayarlayın stream: true. |
Hayı | |
| └─ include_obfuscation | Boolean | True olduğunda, akış gizleme etkinleştirilir. Akış gizleme eklemeleri değişiklik olaylarının akışındaki bir obfuscation alana rastgele karakterleryük boyutlarını belirli yan kanal saldırılarına karşı bir azaltma olarak normalleştirin. Bu gizleme alanları varsayılan olarak eklenir, ancak küçük bir miktar eklenir veri akışı için ek yük. Şunu ayarlayabilirsiniz: include_obfuscationarasında ağ bağlantılarına güveniyorsanız bant genişliğini iyileştirmek için false uygulamanızı ve OpenAI API'sini seçin. |
Hayı | |
| structured_inputs | nesne | Yanıta, istem şablonu değiştirme veya araç bağımsız değişkeni bağlamalarına katılabilen yapılandırılmış girişler. | Hayı | |
| sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| text | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| tool_choice | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| araçlar | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| truncation | enum | Olası değerler: auto, disabled |
Hayı | |
| user | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.Response | |
| text/event-stream | OpenAI.CreateResponseStreamingResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Yanıtları listeleme
GET {endpoint}/openai/v1/responses
Tüm yanıtların listesini döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
| agent_name | soru | Hayı | String | Müşteri temsilcisi adına göre filtreleyin. Sağlanırsa, yalnızca belirtilen aracıyla ilişkilendirilmiş öğeler döndürülür. |
| agent_id | soru | Hayı | String | Aracı kimliğine göre biçiminde name:versionfiltreleyin. Sağlanırsa, yalnızca belirtilen aracı kimliğiyle ilişkilendirilmiş öğeler döndürülür. |
| conversation_id | soru | Hayı | String | Konuşma kimliğine göre filtreleyin. Sağlanırsa, yalnızca belirtilen konuşmayla ilişkili yanıtlar döndürülür. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Kısa yanıt konuşması
POST {endpoint}/openai/v1/responses/compact
Yanıtlar konuşmasının sıkıştırması oluşturur.
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | OpenAI.InputItem dizesi veya dizisi | Hayı | ||
| instructions | dize (null atanabilir) | Hayı | ||
| model | OpenAI.ModelIdsCompaction | veya gpt-5gibi o3 yanıtı oluşturmak için kullanılan model kimliği. OpenAI farklı özelliklere, performans özelliklerine ve fiyat noktalarına sahip çok çeşitli modeller sunar. Kullanılabilir modellere göz atmak ve modelleri karşılaştırmak için model kılavuzuna bakın. |
Evet | |
| previous_response_id | dize (null atanabilir) | Hayı |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.CompactResource |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Yanıt alma - yanıt akışı alma
GET {endpoint}/openai/v1/responses/{response_id}
Belirtilen ID numarası ile bir model tepkisi getirir. Verilen kimlikle (akış yanıtı) bir model yanıtı alır.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| response_id | path | Evet | String | |
| include[] | soru | Hayı | dizi | |
| veri akışı | soru | Hayı | Boolean | |
| starting_after | soru | Hayı | tamsayı |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| kabul et | Yanlış | String Olası değerler: text/event-stream |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.Response | |
| text/event-stream | OpenAI.CreateResponseStreamingResponse |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Yanıtı silme
DELETE {endpoint}/openai/v1/responses/{response_id}
Model yanıtlarını siler.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| response_id | path | Evet | String | Silinecek yanıtın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | DeleteResponseResult |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Yanıtı iptal et
POST {endpoint}/openai/v1/responses/{response_id}/cancel
Model yanıtlarını iptal eder.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| response_id | path | Evet | String | İptal edilecek yanıtın kimliği. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | OpenAI.Response |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Giriş öğelerini listeleme
GET {endpoint}/openai/v1/responses/{response_id}/input_items
Belirli bir yanıt için giriş öğelerinin listesini döndürür.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| response_id | path | Evet | String | |
| limit | soru | Hayı | tamsayı | Döndürülecek nesne sayısıyla ilgili bir sınır. Sınır 1 ile 100 arasında olabilir ve varsayılan değer 20'dir. |
| order | soru | Hayı | String Olası değerler: asc, desc |
Düzeni nesnelerin zaman damgasına göre created_at sıralayın.
asc artan sırayla ve descazalan sırayla |
| after | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
after , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin sonraki sayfasını getirmek için after=obj_foo içerebilir. |
| önce | soru | Hayı | String | Sayfalandırmada kullanılacak bir imleç.
before , listedeki yerinizi tanımlayan bir nesne kimliğidir.Örneğin, bir liste isteğinde bulunur ve obj_foo ile biten 100 nesne alırsanız sonraki çağrı, listenin önceki sayfasını getirmek için before=obj_foo içerebilir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | nesne | İstenen öğe listesi için yanıt verileri. |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Redteams
Redteams - liste
GET {endpoint}/redTeams/runs?api-version=v1
Bir kırmızı takımı adına göre listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: RedTeams=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedRedTeam |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Redteams -
GET {endpoint}/redTeams/runs/{name}?api-version=v1
İsme göre bir kırmızı takım alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| name | path | Evet | String | Kırmızı takım koşusunun tanımlayıcısı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: RedTeams=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | RedTeam |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Redteams - oluşturma
POST {endpoint}/redTeams/runs:run?api-version=v1
Bir redteam çalıştırması oluşturur.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: RedTeams=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| applicationScenario | String | Senaryoya özel saldırılar oluşturmak için kırmızı takım operasyonu için uygulama senaryosu. | Hayı | |
| attackStrategies | AttackStrategy dizisi | Saldırı stratejilerinin listesi veya saldırı stratejilerinin iç içe geçmiş listeleri. | Hayı | |
| ekran adı | String | Kırmızı takım koşusunun adı. | Hayı | |
| kimlik | dize (salt okunur) | Kırmızı takım koşusunun tanımlayıcısı. | Evet | |
| numTurns | tamsayı | Simülasyon turlarının sayısı. | Hayı | |
| properties | nesne | Kırmızı takımın özellikleri. Etiketlerden farklı olarak özellikler yalnızca eklentidir. Bir özellik eklendikten sonra kaldırılamaz. | Hayı | |
| risk Kategorileri | RiskCategory dizisi | Saldırı hedefleri oluşturmak için risk kategorilerinin listesi. | Hayı | |
| simulationOnly | Boolean | Yalnızca simülasyon veya Simülasyon + Değerlendirme. Varsayılan olarak false, doğruysa tarama değerlendirme sonucunu değil konuşma çıktısını verir. | Hayı | Yanlış |
| durum | dize (salt okunur) | Kırmızı takımın durumu. Hizmet tarafından ayarlanır ve salt okunurdur. | Hayı | |
| tags | nesne | Kırmızı takımın etiketleri. Özelliklerden farklı olarak etiketler tamamen değişebilir. | Hayı | |
| target | TargetConfig | Hedef yapılandırma için soyut sınıf. | Evet | |
| └─ türü | String | Model yapılandırmasının türü. | Evet |
Yanıtlar
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | RedTeam |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Programlar
Zamanlamalar - liste
GET {endpoint}/schedules?api-version=v1
Tüm programları listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| type | soru | Hayı | String Olası değerler: Evaluation, Insight |
Zamanlama türüne göre filtreleyin. |
| etkinleştirildi | soru | Hayı | Boolean | Etkin duruma göre filtreleyin. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Schedules=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedSchedule |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Zamanlamalar - silme
DELETE {endpoint}/schedules/{id}?api-version=v1
Bir programı sil.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Zamanlamanın tanımlayıcısı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Schedules=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 204
Açıklama: Bu istek için gönderilecek içerik yok, ancak üst bilgiler yararlı olabilir.
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Zamanlamalar - get
GET {endpoint}/schedules/{id}?api-version=v1
Kimliğe göre bir program alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Zamanlamanın tanımlayıcısı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Schedules=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Takvim |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Zamanlamalar - oluşturma veya güncelleştirme
PUT {endpoint}/schedules/{id}?api-version=v1
İşlem şablonu oluşturun veya güncelleştirin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Zamanlamanın tanımlayıcısı. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Schedules=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
İstek Gövdesi
İçerik Türü: application/json
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Zamanlamanın açıklaması. | Hayı | |
| ekran adı | String | Zamanlamanın adı. | Hayı | |
| etkinleştirildi | Boolean | Zamanlamanın etkin durumu. | Evet | |
| kimlik | dize (salt okunur) | Zamanlamanın tanımlayıcısı. | Evet | |
| properties | nesne | Schedule'ın özellikleri. Etiketlerden farklı olarak özellikler yalnızca eklentidir. Bir özellik eklendikten sonra kaldırılamaz. | Hayı | |
| provisioningStatus | ScheduleProvisioningStatus (salt okunur) | Sağlama durumunu zamanlayın. | Hayı | |
| sistem verileri | object (salt okunur) | Kaynak için sistem meta verileri. | Evet | |
| tags | nesne | Schedule'un etiketleri. Özelliklerden farklı olarak etiketler tamamen değişebilir. | Hayı | |
| görev | ScheduleTask | Zamanlama görev modeli. | Evet | |
| └─ yapılandırması | nesne | Görev için yapılandırma. | Hayı | |
| └─ türü | ScheduleTaskType | Görevin türü. | Evet | |
| trigger | Trigger | Zamanlamanın tetikleyicisi için temel model. | Evet | |
| └─ türü | TriggerType | Tetikleyicinin türü. | Evet |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Takvim |
Durum Kodu: 201
Açıklama: İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Takvim |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Zamanlamalar - liste çalıştırmaları
GET {endpoint}/schedules/{id}/runs?api-version=v1
Tüm zamanlama çalıştırmalarını listeleyin.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
| kimlik | path | Evet | String | Zamanlamanın tanımlayıcısı. |
| type | soru | Hayı | String Olası değerler: Evaluation, Insight |
Zamanlama türüne göre filtreleyin. |
| etkinleştirildi | soru | Hayı | Boolean | Etkin duruma göre filtreleyin. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Schedules=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | PagedScheduleRun |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | Azure. Core.Foundations.ErrorResponse |
Yanıt Üst Bilgileri:
| Başlık | Türü | Description |
|---|---|---|
| x-ms-error-code | String | Neyin yanlış gittiğini gösteren dize hata kodu. |
Zamanlamalar - çalıştırmayı alma
GET {endpoint}/schedules/{schedule_id}/runs/{run_id}?api-version=v1
Kimliğe göre çalışan bir program alın.
URI Parametreleri
| İsim | In | Gerekli | Türü | Description |
|---|---|---|---|---|
| endpoint | path | Evet | String | Foundry Project uç noktası şu şekilde "https://{ai-services-account-name}.services.ai. azure.com/api/projects/{project-name}". Eğer Foundry Hub'ınızda sadece bir Project varsa veya varsayılan Project'i hedeflemek istiyorsanız hub'ınızda formu kullanın "https://{ai-services-account-name}.services.ai. azure.com/api/projeler/_project" |
| schedule_id | path | Evet | String | Zamanlamanın benzersiz tanımlayıcısı. |
| run_id | path | Evet | String | Zamanlama çalıştırmasının benzersiz tanımlayıcısı. |
| API-sürümü | soru | Evet | String | Bu işlem için kullanılacak API sürümü. |
İstek Başlığı
| İsim | Gerekli | Türü | Description |
|---|---|---|---|
| Foundry-Features | Doğru | String Olası değerler: Schedules=V1Preview |
Önizleme işlemleri kullanılırken veya kalıcı önizleme kaynaklarını değiştirirken bir özellik bayrağı kabul etmek gerekir. |
Yanıtlar
Durum Kodu: 200
Açıklama: İstek başarılı oldu.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ScheduleRun |
Durum Kodu: varsayılan
Açıklama: Beklenmeyen bir hata yanıtı.
| İçerik Türü | Türü | Açıklama |
|---|---|---|
| uygulama/json | ApiErrorResponse |
Components
A2APreviewTool
A2A protokolünü uygulayan bir aracı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_card_path | String | Temsilci kartına göre base_urlgiden yol.Sağlanmazsa, varsayılan olarak /.well-known/agent-card.json |
Hayı | |
| base_url | String | Aracının temel URL'si. | Hayı | |
| project_connection_id | String | A2A sunucusu için project'teki bağlantı kimliği. Bağlantı, A2A sunucusuna bağlanmak için gereken kimlik doğrulamasını ve diğer bağlantı ayrıntılarını saklar. |
Hayı | |
| type | enum | Aracın türü. Her zaman "a2a_preview.Olası değerler: a2a_preview |
Evet |
AISearchIndexResource
Bir AI Arama Dizini kaynağı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| filtre | String | Arama kaynağı için filtre dizesi. Daha fazlasını buradan öğrenin. | Hayı | |
| index_asset_id | String | Arama kaynağı için dizin varlık kimliği. | Hayı | |
| endeks_adı | String | Bu aracıya bağlı bir IndexResource'taki dizinin adı. | Hayı | |
| project_connection_id | String | Bu aracıya iliştirilmiş bir IndexResource'daki dizin bağlantı kimliği. | Hayı | |
| sorgu_tipi | AzureAISearchQueryType | Azure AI Search tool için mevcut query types. | Hayı | |
| top_k | tamsayı | Aramadan alınacak ve modele sunulacak belge sayısı. | Hayı |
AgentClusterInsightRequest
Temsilci Değerlendirme Sonuçları kümesine ilişkin bilgiler
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| ajan adı | String | Aracının tanımlayıcısı. | Evet | |
| model yapılandırması | InsightModelConfiguration | İçgörü oluşturmada kullanılan modelin yapılandırması. | Hayı | |
| └─ modelDeploymentName | String | Değerlendirilecek model dağıtımı. Dağıtım adını tek başına veya bağlantı adı olarak {connectionName}/<modelDeploymentName>kabul eder. |
Evet | |
| type | enum | İstek türü. Olası değerler: AgentClusterInsight |
Evet |
AgentClusterInsightResult
Aracı küme analizinden elde edilen bilgiler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| clusterInsight | ClusterInsightResult | Küme analizinden elde edilen bilgiler. | Evet | |
| type | enum | İçgörülerin türü sonucu. Olası değerler: AgentClusterInsight |
Evet |
AgentContainerObject
Bir aracının belirli bir sürümünün kapsayıcısının ayrıntıları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| container | ContainerDetails (salt okunur) | Kapsayıcı hakkında ayrıntılı bilgi. | Hayı | |
| └─ health_state | String | Kapsayıcının sistem durumu. | Evet | |
| └─ provisioning_error | String | Varsa kapsayıcının sağlama hatası. | Hayı | |
| └─ provisioning_state | String | Kapsayıcının sağlama durumu. | Evet | |
| └─ çoğaltmaları | ContainerReplica dizisi | Kapsayıcıdaki çoğaltmaların listesi. | Evet | |
| └─ durumu | String | Konteynerin durumu. | Evet | |
| └─ updated_on | String | Kapsayıcının son güncelleştirme zamanı. | Evet | |
| oluşturulma_tarihi | String | Kapsayıcının oluşturma zamanı. | Evet | |
| error_message | dize (salt okunur) | Varsa, kapsayıcı çalışamadıysa hata iletisi. | Hayı | |
| kimlik | dize (salt okunur) | Kapsayıcının tanımlayıcısı. | Hayı | |
| max_replicas | tamsayı | Kapsayıcı için en fazla çoğaltma sayısı. Varsayılan değer 1'dir. | Hayı | |
| min_replicas | tamsayı | Kapsayıcı için en az çoğaltma sayısı. Varsayılan değer 1'dir. | Hayı | |
| nesne | enum | Her zaman 'agent.container' olan nesne türü. Olası değerler: agent.container |
Evet | |
| durum | AgentContainerStatus (salt okunur) | Aracının belirli bir sürümünün kapsayıcısının durumu. | Evet | |
| updated_at | String | Kapsayıcının son güncelleştirme zamanı. | Evet |
AgentContainerOperationError
Varsa kapsayıcı işleminin hata ayrıntıları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | String | Varsa kapsayıcı işleminin hata kodu. | Evet | |
| mesaj | String | Varsa kapsayıcı işleminin hata iletisi. | Evet | |
| type | String | Varsa kapsayıcı işleminin hata türü. | Evet |
AgentContainerOperationObject
Bir aracının belirli bir sürümü için kapsayıcı işlemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_id | String | Aracının kimliği. | Evet | |
| agent_version_id | String | Aracı sürümünün kimliği. | Evet | |
| container | AgentContainerObject | Bir aracının belirli bir sürümünün kapsayıcısının ayrıntıları. | Hayı | |
| └─ kapsayıcı | ContainerDetails (salt okunur) | Ayrıntılı kapsayıcı bilgileri. | Hayı | |
| └─ oluşturulma_tarihi | dize (salt okunur) | Kapsayıcının oluşturma zamanı. | Evet | |
| └─ error_message | dize (salt okunur) | Varsa, kapsayıcı çalışamadıysa hata iletisi. | Hayı | |
| └─ kimlik | dize (salt okunur) | Kapsayıcının tanımlayıcısı. | Hayı | |
| └─ max_replicas | tamsayı | Kapsayıcı için en fazla çoğaltma sayısı. Varsayılan değer 1'dir. | Hayı | |
| └─ min_replicas | tamsayı | Kapsayıcı için en az çoğaltma sayısı. Varsayılan değer 1'dir. | Hayı | |
| └─ nesne | enum | Her zaman 'agent.container' olan nesne türü. Olası değerler: agent.container |
Evet | |
| └─ durumu | AgentContainerStatus (salt okunur) | Aracının belirli bir sürümünün kapsayıcısının durumu. | Evet | |
| └─ updated_at | dize (salt okunur) | Kapsayıcının son güncelleştirme zamanı. | Evet | |
| hata | AgentContainerOperationError | Varsa kapsayıcı işleminin hata ayrıntıları. | Hayı | |
| └─ kod | String | Varsa kapsayıcı işleminin hata kodu. | Evet | |
| └─ ileti | String | Varsa kapsayıcı işleminin hata iletisi. | Evet | |
| └─ türü | String | Varsa kapsayıcı işleminin hata türü. | Evet | |
| kimlik | String | Kapsayıcı işleminin kimliği. Bu kimlik, sistem genelinde benzersiz bir tanımlayıcıdır. | Evet | |
| durum | AgentContainerOperationStatus | Bir aracının belirli bir sürümü için kapsayıcı işleminin durumu. | Evet |
AgentContainerOperationStatus
Bir aracının belirli bir sürümü için kapsayıcı işleminin durumu.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | NotStartedInProgressSucceededFailed |
AgentContainerStatus
Aracının belirli bir sürümünün kapsayıcısının durumu.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | StartingRunningStoppingStoppedFailedDeletingDeletedUpdating |
AgentDefinition
AgentDefinition için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini kind kullanır:
| Tür Değeri | Şema |
|---|---|
prompt |
PromptAgentDefinition |
workflow |
WorkflowAgentDefinition |
hosted |
HostedAgentDefinition |
container_app |
ContainerAppAgentDefinition |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tür | AgentKind | Evet | ||
| rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| └─ rai_policy_name | String | Uygulanacak RAI politikasının adı. | Evet |
AgentKind
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | prompthostedcontainer_appworkflow |
AgentObject
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Aracının benzersiz tanımlayıcısı. | Evet | |
| name | String | Aracının adı. Kısıtlamalar: maxLength: 63 |
Evet | |
| nesne | enum | Her zaman 'aracı' olan nesne türü. Olası değerler: agent |
Evet | |
| versions | nesne | Ajanın en son sürümü. | Evet | |
| └─ en son | AgentVersionObject | Evet |
AgentProtocol
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | activity_protocolresponses |
Temsilci Referansı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| type | enum | Olası değerler: agent_reference |
Evet | |
| version | String | Aracının sürüm tanımlayıcısı. | Hayı |
AgentTaxonomyInput
Giriş türü aracı olduğunda değerlendirme taksonomisi için giriş yapılandırması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| risk Kategorileri | RiskCategory dizisi | Değerlendirilecek risk kategorilerinin listesi. | Evet | |
| target | Hedef | Ayırıcı desteği olan hedefler için temel sınıf. | Evet | |
| └─ türü | String | Hedefin türü. | Evet | |
| type | enum | Değerlendirme taksonomisinin giriş türü. Olası değerler: agent |
Evet |
AgentTaxonomyInputUpdate
Giriş türü aracı olduğunda değerlendirme taksonomisi için giriş yapılandırması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| risk Kategorileri | RiskCategory dizisi | Değerlendirilecek risk kategorilerinin listesi. | Hayı | |
| target | TargetUpdate | Ayırıcı desteği olan hedefler için temel sınıf. | Hayı | |
| └─ türü | String | Hedefin türü. | Evet | |
| type | enum | Değerlendirme taksonomisinin giriş türü. Olası değerler: agent |
Evet |
AgentVersionObject
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Aracının oluşturulduğu Unix zaman damgası (saniye). | Evet | |
| tanım | AgentDefinition | Evet | ||
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| kimlik | String | Aracı sürümünün benzersiz tanımlayıcısı. | Evet | |
| metadata | object (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Evet | |
| name | String | Aracının adı. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. Kısıtlamalar: maxLength: 256 |
Evet | |
| nesne | enum | Her zaman 'agent.version' olan nesne türü. Olası değerler: agent.version |
Evet | |
| version | String | Aracının sürüm tanımlayıcısı. Aracılar değişmezdir ve her güncelleme, adı aynı tutarak yeni bir sürüm oluşturur. | Evet |
AgenticIdentityPreviewCredentials
Aracı kimliği kimlik bilgisi tanımlaması
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Kimlik bilgisi türü Olası değerler: AgenticIdentityToken_Preview |
Evet |
ApiErrorResponse
API hataları için hata yanıtı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | OpenAI.Error | Evet |
ApiKeyCredentials
API Anahtarı Kimlik Bilgisi tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| key | dize (salt okunur) | API Anahtarı | Hayı | |
| type | enum | Kimlik bilgisi türü Olası değerler: ApiKey |
Evet |
AssetCredentialResponse
Tüketim için bir blob başvurusunu temsil eder
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| blobReference | BlobReference | Blob başvuru ayrıntıları. | Evet | |
| └─ blobUri | String | İstemcinin verileri karşıya yüklemesi için Blob URI yolu. Örnek: https://blob.windows.core.net/Container/Path |
Evet | |
| └─ kimlik bilgisi | SasCredential | storage hesabı access kimlik bilgileri. | Evet | |
| └─ storageAccountArmId | String | Kullanılacak storage hesabının ARM ID'si. | Evet |
Varlık Kimliği
Kaydedilmiş bir varlığın tanımlayıcısı.
Tür: dize
AttackStrategy
Saldırılar için stratejiler.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Saldırılar için stratejiler. |
| Türü | String |
| Değerler | easymoderatedifficultascii_artascii_smuggleratbashbase64binarycaesarcharacter_spacejailbreakansi_attackcharacter_swapsuffix_appendstring_joinunicode_confusableunicode_substitutiondiacriticflipleetspeakrot13morseurlbaselineindirect_jailbreaktensemulti_turncrescendo |
Azure. Core.Foundations.Error
Hata nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | String | Sunucu tanımlı hata kodları kümesinden biri. | Evet | |
| details | Azure dizi. Core.Foundations.Error | Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı. | Hayı | |
| innererror | Azure. Core.Foundations.InnerError | Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors. | Hayı | |
| └─ kod | String | Sunucu tanımlı hata kodları kümesinden biri. | Hayı | |
| └─ iç hata | Azure. Core.Foundations.InnerError | İç hata. | Hayı | |
| mesaj | String | Hatanın insan tarafından okunabilir bir gösterimi. | Evet | |
| target | String | Hatanın hedefi. | Hayı |
Azure. Core.Foundations.ErrorResponse
Hata ayrıntılarını içeren bir yanıt.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | Azure. Core.Foundations.Error | Hata nesnesi. | Evet | |
| └─ kod | String | Sunucu tanımlı hata kodları kümesinden biri. | Evet | |
| └─ ayrıntılar | Azure dizi. Core.Foundations.Error | Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı. | Hayı | |
| └─ iç hata | Azure. Core.Foundations.InnerError | Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne. | Hayı | |
| └─ ileti | String | Hatanın insan tarafından okunabilir bir gösterimi. | Evet | |
| └─ hedef | String | Hatanın hedefi. | Hayı |
Azure. Core.Foundations.InnerError
Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | String | Sunucu tanımlı hata kodları kümesinden biri. | Hayı | |
| innererror | Azure. Core.Foundations.InnerError | Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors. | Hayı | |
| └─ kod | String | Sunucu tanımlı hata kodları kümesinden biri. | Hayı | |
| └─ iç hata | Azure. Core.Foundations.InnerError | İç hata. | Hayı |
Azure. Core.Foundations.OperationState
İzin verilen işlem durumlarını açıklayan sabit listesi.
| Mülkiyet | Değer |
|---|---|
| Açıklama | İzin verilen işlem durumlarını açıklayan sabit listesi. |
| Türü | String |
| Değerler | NotStartedRunningSucceededFailedCanceled |
Azure. Core.uuid
Evrensel Olarak Benzersiz Tanımlayıcı
Tür: dize
Biçim: uuid
AzureAIAgentTarget
Bir Azure AI ajanı belirten bir hedefi temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | String | Azure AI ajanının benzersiz tanımlayıcısı. | Evet | |
| tool_descriptions | ToolDescription dizisi | Metin oluşturma sırasında aracının örnekleme davranışını kontrol etmek için kullanılan parametreler. | Hayı | |
| type | enum | Hedefin türü, her zaman azure_ai_agent.Olası değerler: azure_ai_agent |
Evet | |
| version | String | Azure AI ajanının versiyonu. | Hayı |
AzureAIAgentTargetUpdate
Bir Azure AI ajanı belirten bir hedefi temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | String | Azure AI ajanının benzersiz tanımlayıcısı. | Hayı | |
| tool_descriptions | ToolDescription dizisi | Metin oluşturma sırasında aracının örnekleme davranışını kontrol etmek için kullanılan parametreler. | Hayı | |
| type | enum | Hedefin türü, her zaman azure_ai_agent.Olası değerler: azure_ai_agent |
Evet | |
| version | String | Azure AI ajanının versiyonu. | Hayı |
AzureAIDataSourceConfig
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| senaryo | enum | Veri şeması senaryosu. Olası değerler: red_team, responses, traces_preview, synthetic_data_gen_preview |
Evet | |
| şema | nesne | Çalıştırma veri kaynağı öğeleri için genel nesne JSON şeması. | Evet | |
| type | enum | Her zaman azure_ai_sourceolan nesne türü.Olası değerler: azure_ai_source |
Evet |
AzureAIModelTarget
Model seçimi gerektiren işlemler için bir Azure AI modeli belirten bir hedefi temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| model | String | Azure AI modelinin benzersiz tanımlayıcısı. | Hayı | |
| Örnekleme_Parametreleri | ModelÖrnekLemeParamları | Metin oluşturma sırasında dil modelinin örnekleme davranışını denetlemek için kullanılan bir parametre kümesini temsil eder. | Hayı | |
| └─ maksimum_önem_bitim_kodları | tamsayı | Tamamlanmada izin verilen en fazla belirteç sayısı. | Evet | |
| └─ tohum | tamsayı | Yeniden üretilebilirlik için rastgele tohum. | Evet | |
| └─ sıcaklık | Numara | Örnekleme için sıcaklık parametresi. | Evet | |
| └─ top_p | Numara | Çekirdek örnekleme için top-p parametresi. | Evet | |
| type | enum | Hedefin türü, her zaman azure_ai_model.Olası değerler: azure_ai_model |
Evet |
AzureAIModelTargetUpdate
Model seçimi gerektiren işlemler için bir Azure AI modeli belirten bir hedefi temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| model | String | Azure AI modelinin benzersiz tanımlayıcısı. | Hayı | |
| Örnekleme_Parametreleri | ModelSamplingParamsUpdate | Metin oluşturma sırasında dil modelinin örnekleme davranışını denetlemek için kullanılan bir parametre kümesini temsil eder. | Hayı | |
| └─ maksimum_önem_bitim_kodları | tamsayı | Tamamlanmada izin verilen en fazla belirteç sayısı. | Hayı | |
| └─ tohum | tamsayı | Yeniden üretilebilirlik için rastgele tohum. | Hayı | |
| └─ sıcaklık | Numara | Örnekleme için sıcaklık parametresi. | Hayı | |
| └─ top_p | Numara | Çekirdek örnekleme için top-p parametresi. | Hayı | |
| type | enum | Hedefin türü, her zaman azure_ai_model.Olası değerler: azure_ai_model |
Evet |
AzureAIResponsesEvalRunDataSource
Sürekli Değerlendirme senaryolarına özgü değerlendirme çalıştırmaları için bir veri kaynağını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| event_configuration_id | String | Bu değerlendirme çalıştırmasıyla ilişkili olay yapılandırma adı. | Evet | |
| item_generation_params | ResponseRetrievalItemGenerationParams | Yanıt alma öğesi oluşturma parametrelerini temsil eder. | Evet | |
| └─ data_mapping | nesne | Sohbet geçmişini almak için gereken kaynak alanlardan response_id alanına eşleme. | Evet | |
| └─ max_num_turns | tamsayı | Değerlendirilecek sohbet geçmişinin maksimum dönüş sayısı. | Evet | |
| └─ kaynak | OpenAI.EvalJsonlFileContentSource veya OpenAI.EvalJsonlFileIdSource | JSONL içeriğinin okunduğu kaynak. | Evet | |
| └─ türü | enum | Her zaman response_retrievalolan öğe oluşturma parametrelerinin türü.Olası değerler: response_retrieval |
Evet | |
| max_runs_hourly | tamsayı | Saat başına izin verilen en fazla değerlendirme çalıştırması sayısı. | Evet | |
| type | enum | Her zaman azure_ai_responsesveri kaynağı türü.Olası değerler: azure_ai_responses |
Evet |
Azure AISearch Dizini
Azure AI Search Index Definition
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | enum | Endeks türü Olası değerler: AzureSearch |
Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
AzureAISearchIndexUpdate
Azure AI Search Index Definition
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | enum | Endeks türü Olası değerler: AzureSearch |
Evet |
AzureAISearchQueryType
Azure AI Search tool için mevcut query types.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Azure AI Search tool için mevcut query types. |
| Türü | String |
| Değerler | simplesemanticvectorvector_simple_hybridvector_semantic_hybrid |
AzureAISearchTool
Bir ajanı yapılandırmak için kullanılan Azure AI search aracı için giriş tanımı bilgisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| azure_ai_search | AzureAISearchToolResource |
azure_ai_search aracı tarafından kullanılan dizin kaynakları kümesi. |
Evet | |
| └─ dizinler | AISearchIndexResource dizisi | Bu aracıya bağlı dizinler. En fazla 1 dizin olabilir aracıya bağlı kaynak. Kısıtlamalar: maxItems: 1 |
Evet | |
| type | enum | Her zaman 'azure_ai_search' olan nesne türü. Olası değerler: azure_ai_search |
Evet |
AzureAISearchToolResource
azure_ai_search aracı tarafından kullanılan dizin kaynakları kümesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Dizin | AISearchIndexResource dizisi | Bu aracıya bağlı dizinler. En fazla 1 dizin olabilir aracıya bağlı kaynak. |
Evet |
AzureFunctionBinding
storage queue adı ve URI'nin korunması için kullanılan yapı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| storage_queue | AzureFunctionStorageQueue | storage queue adı ve URI'nin korunması için kullanılan yapı. | Evet | |
| └─ queue_name | String | Bir Azure fonksiyon storage kuyruğunun adı. | Evet | |
| └─ queue_service_endpoint | String | Azure Storage Queue hizmetine URI, kuyruğu işlemenizi sağlıyor. | Evet | |
| type | enum | Her zaman 'storage_queue' olan bağlama türü. Olası değerler: storage_queue |
Evet |
AzureFunctionDefinition
Azure fonksiyonunun tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| function | nesne | azure fonksiyonun tanımı ve parametreleri. | Evet | |
| └─ açıklama | String | İşlevin ne zaman ve nasıl çağrıldığını seçmek için model tarafından kullanılan işlevin ne yaptığının açıklaması. | Hayı | |
| └─ ad | String | Çağrılacak işlevin adı. | Evet | |
| └─ parametreler | nesne | İşlevlerin kabullediği, JSON Şeması nesnesi olarak tanımlanan parametreler. | Evet | |
| input_binding | AzureFunctionBinding | storage queue adı ve URI'nin korunması için kullanılan yapı. | Evet | |
| └─ storage_queue | AzureFunctionStorageQueue | Storage kuyruğu. | Evet | |
| └─ türü | enum | Her zaman 'storage_queue' olan bağlama türü. Olası değerler: storage_queue |
Evet | |
| output_binding | AzureFunctionBinding | storage queue adı ve URI'nin korunması için kullanılan yapı. | Evet | |
| └─ storage_queue | AzureFunctionStorageQueue | Storage kuyruğu. | Evet | |
| └─ türü | enum | Her zaman 'storage_queue' olan bağlama türü. Olası değerler: storage_queue |
Evet |
AzureFunctionStorageQueue
storage queue adı ve URI'nin korunması için kullanılan yapı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| queue_name | String | Bir Azure fonksiyon storage kuyruğunun adı. | Evet | |
| queue_service_endpoint | String | Azure Storage Queue hizmetine URI, kuyruğu işlemenizi sağlıyor. | Evet |
AzureFunctionTool
Bir Azure Fonksiyon Aracı için giriş tanım bilgileri, bir Ajanı yapılandırmak için kullanılan bilgiler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| azure_function | AzureFunctionDefinition | Azure fonksiyonunun tanımı. | Evet | |
| └─ işlevi | nesne | azure fonksiyonun tanımı ve parametreleri. | Evet | |
| └─ açıklama | String | İşlevin ne zaman ve nasıl çağrıldığını seçmek için model tarafından kullanılan işlevin ne yaptığının açıklaması. | Hayı | |
| └─ ad | String | Çağrılacak işlevin adı. | Evet | |
| └─ parametreler | nesne | İşlevlerin kabullediği, JSON Şeması nesnesi olarak tanımlanan parametreler. | Evet | |
| └─ input_binding | AzureFunctionBinding | Giriş storage kuyruğu. Queue storage tetikleyicisi, mesajlar eklendikçe bir fonksiyon çalıştırır. | Evet | |
| └─ output_binding | AzureFunctionBinding | Çıkış storage kuyruğu. İşlev, giriş öğeleri işlendiğinde çıkışı bu kuyruğa yazar. | Evet | |
| type | enum | Her zaman 'browser_automation' olan nesne türü. Olası değerler: azure_function |
Evet |
AzureOpenAIModelConfiguration
Azure OpenAI model configuration. API sürümü, modeli sorgulamak için hizmet tarafından seçilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| modelDeploymentName | String | AOAI modeli için dağıtım adı. Örnek: AIServices veya bağlantı tabanlı connection_name/deployment_name ise gpt-4o (örn. my-aoai-connection/gpt-4o |
Evet | |
| type | enum | Olası değerler: AzureOpenAIModel |
Evet |
BaseCredentials
Bağlantı kimlik bilgileri için bir temel sınıf
BaseCredentials için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
ApiKey |
ApiKeyCredentials |
AAD |
EntraIDCredentials |
CustomKeys |
CustomCredential |
SAS |
SASCredentials |
None |
NoAuthenticationCredentials |
AgenticIdentityToken_Preview |
AgenticIdentityPreviewCredentials |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | CredentialType (salt okunur) | Bağlantı tarafından kullanılan kimlik bilgisi türü | Evet |
BingCustomSearchConfiguration
Bir bing özel arama konfigürasyonu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sayı | tamsayı | bing API yanıtında dönecek arama sonuç sayısı | Hayı | |
| freshness | String | Arama sonuçlarını belirli bir zaman aralığına göre filtreleyin. Burada kabul edilen değerlere bakınız. | Hayı | |
| instance_name | String | Yapılandırmaya verilen özel yapılandırma örneğinin adı. | Evet | |
| pazar | String | Sonuçların geldiği pazar. | Hayı | |
| project_connection_id | String | Project bağlantı kimliği bing arama ile topraklama için | Evet | |
| set_lang | String | Bing API çağrılırken kullanıcı arayüzü dizileri için kullanılacak dil. | Hayı |
BingCustomSearchPreviewTool
Bir ajanı yapılandırmak için kullanılan Bing özel arama aracı için giriş tanım bilgisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| bing_custom_search_preview | BingCustomSearchToolParameters | bing özel arama aracı parametreleri. | Evet | |
| └─ search_configurations | BingCustomSearchConfiguration dizisi | Bu araca bağlı proje bağlantıları. En fazla 1 bağlantı olabilir aracına bağlı kaynak. Kısıtlamalar: maxItems: 1 |
Evet | |
| type | enum | Her zaman 'bing_custom_search_preview' olan nesne türü. Olası değerler: bing_custom_search_preview |
Evet |
BingCustomSearchToolParameters
bing özel arama aracı parametreleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| search_configurations | BingCustomSearchConfiguration dizisi | Bu araca bağlı proje bağlantıları. En fazla 1 bağlantı olabilir aracına bağlı kaynak. |
Evet |
BingGroundingSearchConfiguration
Bing Topraklama için arama yapılandırması
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sayı | tamsayı | bing API yanıtında dönecek arama sonuç sayısı | Hayı | |
| freshness | String | Arama sonuçlarını belirli bir zaman aralığına göre filtreleyin. Burada kabul edilen değerlere bakınız. | Hayı | |
| pazar | String | Sonuçların geldiği pazar. | Hayı | |
| project_connection_id | String | Project bağlantı kimliği bing arama ile topraklama için | Evet | |
| set_lang | String | Bing API çağrılırken kullanıcı arayüzü dizileri için kullanılacak dil. | Hayı |
BingGroundingSearchToolParameters
bing topraklama arama aracı parametreleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| search_configurations | BingGroundingSearchConfiguration dizisi | Bu araca eklenen arama yapılandırmaları. En fazla 1 olabilir ara çubuğuna bağlı arama yapılandırma kaynağı. |
Evet |
BingGroundingTool
Bir ajanı yapılandırmak için kullanılan bing topraklama arama aracı için giriş tanım bilgisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| bing_grounding | BingGroundingSearchToolParameters | bing topraklama arama aracı parametreleri. | Evet | |
| └─ search_configurations | BingGroundingSearchConfiguration dizisi | Bu araca eklenen arama yapılandırmaları. En fazla 1 olabilir ara çubuğuna bağlı arama yapılandırma kaynağı. Kısıtlamalar: maxItems: 1 |
Evet | |
| type | enum | Her zaman 'bing_grounding' olan nesne türü. Olası değerler: bing_grounding |
Evet |
BlobReference
Blob başvuru ayrıntıları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| blobUri | String | İstemcinin verileri karşıya yüklemesi için Blob URI yolu. Örnek: https://blob.windows.core.net/Container/Path |
Evet | |
| credential | SasCredential | SAS Kimlik Bilgisi tanımı | Evet | |
| └─ sasUri | dize (salt okunur) | SAS uri'si | Evet | |
| └─ türü | enum | Kimlik bilgisi türü Olası değerler: SAS |
Evet | |
| storageAccountArmId | String | Kullanılacak storage hesabının ARM ID'si. | Evet |
BrowserAutomationPreviewTool
Bir Aracıyı yapılandırmak için kullanılan bir Tarayıcı Otomasyon Aracı için giriş tanımı bilgileri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| browser_automation_preview | BrowserAutomationToolParameters | Tarayıcı Otomasyon Aracı için giriş parametrelerinin tanımı. | Evet | |
| └─ bağlantı | BrowserAutomationToolConnectionParameters | Tarayıcı Otomasyon Aracı ile ilişkili proje bağlantı parametreleri. | Evet | |
| type | enum | Nesne türü, ki bu her zaman 'browser_automation_preview' olur. Olası değerler: browser_automation_preview |
Evet |
BrowserAutomationToolConnectionParameters
Tarayıcı Otomasyon Aracı tarafından kullanılan bağlantı için giriş parametrelerinin tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| project_connection_id | String | Azure Playwright kaynağınıza olan project bağlantısının kimliği. | Evet |
BrowserAutomationToolParameters
Tarayıcı Otomasyon Aracı için giriş parametrelerinin tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| bağlantı | BrowserAutomationToolConnectionParameters | Tarayıcı Otomasyon Aracı tarafından kullanılan bağlantı için giriş parametrelerinin tanımı. | Evet | |
| └─ project_connection_id | String | Azure Playwright kaynağınıza olan project bağlantısının kimliği. | Evet |
CaptureStructuredOutputsTool
Yapılandırılmış çıktıları yakalamak için bir araç
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Çıktılar | StructuredOutputDefinition | Aracı tarafından üretilebilen yapılandırılmış bir çıkış. | Evet | |
| └─ açıklama | String | Yayınlanacak çıkışın açıklaması. Çıktının ne zaman yayınlanacağını belirlemek için model tarafından kullanılır. | Evet | |
| └─ ad | String | Yapılandırılmış çıkışın adı. | Evet | |
| └─ şeması | nesne | Yapılandırılmış çıkış için JSON şeması. | Evet | |
| └─ katı | boole değeri (null atanabilir) | Sıkı doğrulamanın uygulanıp uygulanmayacağı. Varsayılan true. |
Evet | |
| type | enum | Aracın türü. Her zaman capture_structured_outputs.Olası değerler: capture_structured_outputs |
Evet |
ChartCoordinate
Analiz tablosu için koordinatlar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| boyut | tamsayı | Grafik öğesinin boyutu. | Evet | |
| x | tamsayı | X ekseni koordinatı. | Evet | |
| y | tamsayı | Y ekseni koordinatı. | Evet |
ChatSummaryMemoryItem
Konuşmalardan çıkarılan bir özet içeren bir bellek öğesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | String | Belleğin içeriği. | Evet | |
| tür | enum | Hafıza öğesinin türü. Olası değerler: chat_summary |
Evet | |
| memory_id | String | Bellek öğesinin benzersiz kimliği. | Evet | |
| kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet | |
| updated_at | tamsayı | Bellek öğesinin son güncelleme zamanı. | Evet |
ClusterInsightResult
Küme analizinden elde edilen bilgiler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| clusters | InsightCluster dizisi | İçgörülerde tanımlanan kümelerin listesi. | Evet | |
| koordinatlar | nesne | Kimliklerin görselleştirme için UX tarafından kullanılan 2B koordinatlara isteğe bağlı eşlenmesi. Eşleme anahtarları dize tanımlayıcılarıdır (örneğin, küme kimliği veya örnek kimlik) ve değerler, 2B grafik üzerinde işleme için koordinatlar ve görsel boyutlardır. İstemci koordinat istemediği sürece bu özellik atlanır (örneğin, bir sorgu parametresi olarak geçirerek includeCoordinates=true ).Örnek: <br> {<br> "cluster-1": { "x": 12, "y": 34, "size": 8 },<br> "sample-123": { "x": 18, "y": 22, "size": 4 }<br> }<br> Koordinatlar yalnızca istemci tarafı görselleştirme için tasarlanmıştır ve kurallı içgörü sonuçlarını değiştirin. |
Hayı | |
| summary | InsightSummary | Hata kümesi analizinin özeti. | Evet | |
| └─ yöntemi | String | Kümeleme için kullanılan yöntem. | Evet | |
| └─ sampleCount | tamsayı | Analiz edilen toplam numune sayısı. | Evet | |
| └─ uniqueClusterCount | tamsayı | Benzersiz kümelerin toplam sayısı. | Evet | |
| └─ uniqueSubclusterCount | tamsayı | Benzersiz alt küme etiketlerinin toplam sayısı. | Evet | |
| └─ kullanımı | ClusterTokenUsage | Kümeleme analizi yapılırken belirteç kullanımı | Evet |
ClusterTokenUsage
Küme analizi için belirteç kullanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| inputTokenUsage | tamsayı | Giriş belirteci kullanımı | Evet | |
| outputTokenUsage | tamsayı | Çıkış belirteci kullanımı | Evet | |
| totalTokenUsage | tamsayı | Toplam jeton kullanımı | Evet |
CodeBasedEvaluatorDefinition
Python kodunu kullanarak kod tabanlı değerlendirici tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| code_text | String | Değerlendirici için satır içi kod metni | Evet | |
| data_schema | nesne | Değerlendiricinin giriş verileri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| init_parameters | nesne | Değerlendiricinin giriş parametreleri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| metrics | nesne | Bu değerlendirici tarafından üretilen çıktı metriklerinin listesi | Hayı | |
| type | enum | Olası değerler: code |
Evet |
CompletionMessageToolCallChunk
bir iletinin içindeki araç arama ayrıntıları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| function | FunctionToolCall | İşlev aracı çağrısının ayrıntıları. | Hayı | |
| └─ argümanlar | String | JSON biçiminde model tarafından oluşturulan işlevi çağırmak için bağımsız değişkenler. | Evet | |
| └─ ad | String | Çağrılacak işlevin adı. | Evet | |
| kimlik | String | Araç çağrısının kimliği. | Evet | |
| type | enum | Her zaman "işlev" olan araç çağrısının türü. Olası değerler: function |
Evet |
Bağlantı
Listeden yanıt alma ve bağlantı alma işlemleri
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| credentials | BaseCredentials (salt okunur) | Bağlantı kimlik bilgileri için bir temel sınıf | Evet | |
| └─ türü | CredentialType (salt okunur) | Bağlantı tarafından kullanılan kimlik bilgisi türü | Evet | |
| kimlik | dize (salt okunur) | Hizmet tarafından oluşturulan bağlantı için benzersiz bir tanımlayıcı | Evet | |
| Varsayılan | boole (salt okunur) | Bağlantının kendi türünde varsayılan bağlantı olarak etiketlenip etiketlenmediği | Evet | |
| metadata | object (salt okunur) | Bağlantının meta verileri | Evet | |
| name | dize (salt okunur) | Kullanıcı tarafından sağlanan bağlantının kolay adı. | Evet | |
| target | dize (salt okunur) | Bu hizmet için kullanılacak bağlantı URL'si | Evet | |
| type | ConnectionType (salt okunur) | Bağlantının Türü (veya kategorisi) | Evet |
BağlantıTürü
Bağlantının Türü (veya kategorisi)
| Mülkiyet | Değer |
|---|---|
| Açıklama | Bağlantının Türü (veya kategorisi) |
| Türü | String |
| Değerler | AzureOpenAIAzureBlobAzureStorageAccountCognitiveSearchCosmosDBApiKeyAppConfigAppInsightsCustomKeysRemoteTool_Preview |
ContainerAppAgentDefinition
Kapsayıcı uygulama aracısı tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| container_app_resource_id | String | Bu ajanı barındıran Azure Container Uygulamasının kaynak kimliği. Sürümler arasında değiştirilemez. | Evet | |
| container_protocol_versions | ProtocolVersionRecord dizisi | Aracının kapsayıcıların giriş iletişimi için desteklediği protokoller. | Evet | |
| ingress_subdomain_suffix | String | Aracıya giriş gönderirken uygulama alt etki alanına uygulanacak sonek. Bu, kapsayıcı uygulamasının varsayılan uç noktasını kullanmak için bir etiket (örneğin, '---geçerli'), belirli bir düzeltme (örneğin, '--0000001') veya boş olabilir. | Evet | |
| tür | enum | Olası değerler: container_app |
Evet | |
| rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| └─ rai_policy_name | String | Uygulanacak RAI politikasının adı. | Evet |
ContainerDetails
Kapsayıcı hakkında ayrıntılı bilgi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| health_state | String | Kapsayıcının sistem durumu. | Evet | |
| provisioning_error | String | Varsa kapsayıcının sağlama hatası. | Hayı | |
| provisioning_state | String | Kapsayıcının sağlama durumu. | Evet | |
| replicas | ContainerReplica dizisi | Kapsayıcıdaki çoğaltmaların listesi. | Evet | |
| state | String | Konteynerin durumu. | Evet | |
| updated_on | String | Kapsayıcının son güncelleştirme zamanı. | Evet |
ContainerLogKind
Bir konteynerden akış yapacak kütük türü.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | consolesystem |
ContainerReplica
Kapsayıcı çoğaltması hakkında bilgi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| container_state | String | Çoğaltmanın kapsayıcı durumu. | Evet | |
| name | String | Çoğaltmanın adı. | Evet | |
| state | String | Çoğaltmanın durumu. | Evet |
ContinuousEvaluationRuleAction
Sürekli değerlendirme için değerlendirme kuralı eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| evalId | String | Sürekli değerlendirme çalıştırmaları eklemek için Değerlendirme Kimliği. | Evet | |
| maxHourlyRuns | tamsayı | Saat başına izin verilen en fazla değerlendirme çalıştırması sayısı. | Hayı | |
| type | enum | Olası değerler: continuousEvaluation |
Evet |
CosmosDB Dizini
CosmosDB Vektör Deposu Dizin Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | enum | Endeks türü Olası değerler: CosmosDBNoSqlVectorStore |
Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
CosmosDBIndexUpdate
CosmosDB Vektör Deposu Dizin Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | enum | Endeks türü Olası değerler: CosmosDBNoSqlVectorStore |
Evet |
CreateAgentFromManifestRequest
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| manifest_id | String | Aracı sürümünü içeri aktaracak bildirim kimliği. | Evet | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Aracıyı tanımlayan benzersiz ad. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. - Alfasayısal karakterlerle başlayıp bitmelidir, - Ortada kısa çizgi içerebilir - 63 karakteri aşmamalıdır. Kısıtlamalar: maxLength: 63 |
Evet | |
| parameter_values | nesne | Bildirime yapılan ve tam olarak gerçekleştirilmiş bir Aracı ile sonuçlanacak girişler. | Evet |
CreateAgentRequest
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | AgentDefinition | Evet | ||
| └─ tür | AgentKind | Evet | ||
| └─ rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Aracıyı tanımlayan benzersiz ad. Ad, aracıyı almak/güncellemek/silmek için kullanılabilir. - Alfasayısal karakterlerle başlayıp bitmelidir, - Ortada kısa çizgi içerebilir - 63 karakteri aşmamalıdır. Kısıtlamalar: maxLength: 63 |
Evet |
CreateAgentVersionFromManifestRequest
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| manifest_id | String | Aracı sürümünü içeri aktaracak bildirim kimliği. | Evet | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| parameter_values | nesne | Bildirime yapılan ve tam olarak gerçekleştirilmiş bir Aracı ile sonuçlanacak girişler. | Evet |
CreateAgentVersionRequest
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | AgentDefinition | Evet | ||
| └─ tür | AgentKind | Evet | ||
| └─ rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı |
Değerlendirme İstek Oluştur
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veri_kaynağı_yapılandırması | OpenAI.CreateEvalCustomDataSourceConfig veya OpenAI.CreateEvalLogsDataSourceConfig veya OpenAI.CreateEvalStoredCompletionsDataSourceConfig veya AzureAIDataSourceConfig | Değerlendirme için kullanılan veri kaynağının yapılandırması çalışır. Değerlendirmede kullanılan verilerin şemasını dikte eder. | Evet | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Değerlendirmenin adı. | Hayı | |
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı | |
| test kriterleri | OpenAI.EvalGraderLabelModel veya OpenAI.EvalGraderStringCheck ya da OpenAI.EvalGraderTextSimilarity veya OpenAI.EvalGraderPython ya da OpenAI.EvalGraderScoreModel veya EvalGraderAzureAIEvaluator dizisi | Bu gruptaki tüm değerlendirme çalıştırmaları için değerlendirici listesi. Not verenler, gibi {{item.variable_name}}çift küme ayracı gösterimini kullanarak veri kaynağındaki değişkenlere başvurabilir. Modelin çıkışına başvurmak için ad alanını sample (örneğin, {{sample.output_text}}) kullanın. |
Evet |
Değerlendirme Çalışması İsteği Oluştur
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veri_kaynağı | OpenAI.CreateEvalJsonlRunDataSource veya OpenAI.CreateEvalCompletionsRunDataSource veya OpenAI.CreateEvalResponsesRunDataSource veya EvalRunDataSource | Çalıştırmanın veri kaynağıyla ilgili ayrıntılar. | Evet | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Koşunun adı. | Hayı | |
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı |
CredentialType
Bağlantı tarafından kullanılan kimlik bilgisi türü
| Mülkiyet | Değer |
|---|---|
| Açıklama | Bağlantı tarafından kullanılan kimlik bilgisi türü |
| Türü | String |
| Değerler | ApiKeyAADSASCustomKeysNoneAgenticIdentityToken_Preview |
CronTrigger
Cron tabanlı tetikleyici.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| endTime | String | ISO 8601 biçiminde cron zamanlaması için bitiş saati. | Hayı | |
| ifade | String | Zamanlama sıklığını tanımlayan cron ifadesi. | Evet | |
| startTime | String | ISO 8601 biçiminde cron zamanlaması için başlangıç saati. | Hayı | |
| timeZone | String | Cron zamanlaması için saat dilimi. | Hayı | UTC (Koordinatlı Evrensel Zaman) |
| type | enum | Olası değerler: Cron |
Evet |
CustomCredential
Özel kimlik bilgisi tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Kimlik bilgisi türü Olası değerler: CustomKeys |
Evet |
Bu nesne şu tür ek özellikleri de kabul eder: dize
DailyRecurrenceSchedule
Günlük yineleme programı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hours | tamsayı dizisi | Yinelenme zamanlaması için saatler. | Evet | |
| type | enum | Günlük tekrarlama türü. Olası değerler: Daily |
Evet |
DataSourceConfig
Ayrıştırıcı desteğiyle veri kaynaklarını çalıştırmak için temel sınıf.
DataSourceConfig için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| şema | nesne | Çalıştırma veri kaynağı öğeleri için genel nesne JSON şeması. | Evet | |
| type | String | Veri kaynağı türü ayrıştırıcısı. | Evet |
DatasetType
Veri türünü belirlemek için sabit listesi.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Veri türünü belirlemek için sabit listesi. |
| Türü | String |
| Değerler | uri_fileuri_folder |
DatasetVersion
DatasetVersion Tanımı
DatasetVersion için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
uri_file |
FileDatasetVersion |
uri_folder |
FolderDatasetVersion |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| connectionName (bağlantıadı) | String | Azure Storage Account bağlantı adı. Veri Kümesi oluşturulmadan önce startPendingUploadVersion çağrılmadıysa gereklidir | Hayı | |
| dataUri | String | Verilerin URI'si (örnek) Kısıtlamalar: minLength: 1, desen: [a-zA-Z0-9_] |
Evet | |
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| isReference | boole (salt okunur) | Veri setinin storage'a referans tuttuğunu veya veri setinin storage'ı kendisi yönetip yönetmediğini gösterir. Doğruysa, veri kümesi sürümü silindiğinde temel alınan veriler silinmez | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | DatasetType | Veri türünü belirlemek için sabit listesi. | Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
DatasetVersionUpdate
DatasetVersion Tanımı
DatasetVersionUpdate için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
uri_file |
FileDatasetVersionUpdate |
uri_folder |
FolderDatasetVersionUpdate |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | DatasetType | Veri türünü belirlemek için sabit listesi. | Evet |
HaftanınGünü
Tekrarlama zamanlaması için haftanın günleri.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Tekrarlama zamanlaması için haftanın günleri. |
| Türü | String |
| Değerler | SundayMondayTuesdayWednesdayThursdayFridaySaturday |
DeleteAgentResponse
Silinmiş bir aracı Nesnesi
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Aracının başarıyla silinip silinmediği. | Evet | |
| name | String | Aracının adı. | Evet | |
| nesne | enum | Nesne türü. Her zaman 'agent.deleted'. Olası değerler: agent.deleted |
Evet |
DeleteAgentVersionResponse
Silinmiş bir aracı sürümü Nesnesi
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Aracının başarıyla silinip silinmediği. | Evet | |
| name | String | Aracının adı. | Evet | |
| nesne | enum | Nesne türü. Her zaman 'agent.version.deleted'. Olası değerler: agent.version.deleted |
Evet | |
| version | String | Aracının sürüm tanımlayıcısı. | Evet |
DeleteEvalResponse
Silinen değerlendirme Nesnesi
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Değerlendirmenin başarıyla silinip silinmediği. | Evet | |
| eval_id | String | değerlendirmenin kimliği. | Evet | |
| nesne | enum | Nesne türü. Her zaman 'eval.deleted'. Olası değerler: eval.deleted |
Evet |
DeleteEvalRunResponse
Silinen değerlendirme çalıştırma nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Değerlendirmenin başarıyla silinip silinmediği. | Hayı | |
| nesne | enum | Nesne türü. Her zaman 'eval.deleted'. Olası değerler: eval.deleted |
Hayı | |
| run_id | String | değerlendirmenin kimliği. | Hayı |
DeleteMemoryStoreResponse
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Bellek deposunun başarıyla silinip silinmediği. | Evet | |
| name | String | Bellek deposunun adı. | Evet | |
| nesne | enum | Nesne türü. Her zaman 'memory_store.deleted'. Olası değerler: memory_store.deleted |
Evet |
DeleteResponseResult
Yanıt silme işleminin sonucu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | enum | Her zaman true döndür Olası değerler: True |
Evet | |
| kimlik | String | İşlem kimliği. | Evet | |
| nesne | enum | Her zaman 'yanıt' döndür. Olası değerler: response |
Evet |
Dağıtım
Model Dağıtım Tanımı
Dağıtım için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
ModelDeployment |
ModelDeployment |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | dize (salt okunur) | Dağıtımın adı | Evet | |
| type | Deploymenttype | Evet |
Deploymenttype
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | ModelDeployment |
EntraIDCredentials
Entra ID kimlik bilgisi tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Kimlik bilgisi türü Olası değerler: AAD |
Evet |
Değerlendirme
Veri kaynağı yapılandırması ve test ölçütlerine sahip bir Değerlendirme nesnesi. Değerlendirme, LLM tümleştirmeniz için yapılacak bir görevi temsil eder. Gibi:
- Sohbet botlarımın kalitesini artırma
- Sohbet botlarımın müşteri desteğini ne kadar iyi işlediğini görün
- O4-mini'nin benim kullanım alanımda gpt-4o'dan daha iyi olup olmadığını denetleyin
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Değerlendirmenin oluşturulduğu zaman için Unix zaman damgası (saniye olarak). | Evet | |
| Oluşturan | String | çalıştırmayı oluşturan kişinin adı. | Hayı | |
| veri_kaynağı_yapılandırması | OpenAI.CreateEvalCustomDataSourceConfig veya OpenAI.CreateEvalLogsDataSourceConfig veya OpenAI.CreateEvalStoredCompletionsDataSourceConfig veya AzureAIDataSourceConfig | Değerlendirme çalıştırmalarında kullanılan veri kaynaklarının yapılandırması. | Evet | |
| kimlik | String | Değerlendirme için benzersiz tanımlayıcı. | Evet | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Evet | |
| modified_at | integer | Hayı | ||
| name | String | Değerlendirmenin adı. | Evet | |
| nesne | enum | Nesne türü. Olası değerler: eval |
Evet | |
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı | |
| test kriterleri | OpenAI.EvalGraderLabelModel veya OpenAI.EvalGraderStringCheck ya da OpenAI.EvalGraderTextSimilarity veya OpenAI.EvalGraderPython ya da OpenAI.EvalGraderScoreModel veya EvalGraderAzureAIEvaluator dizisi | Test ölçütlerinin listesi. | Evet |
EvalCsvFileIdSource
Değerlendirme verileri için kaynak olarak kullanılan karşıya yüklenen CSV dosyasına başvuruyu temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Karşıya yüklenen CSV dosyasının tanımlayıcısı. | Evet | |
| type | enum | Kaynak türü, her zaman file_id.Olası değerler: file_id |
Evet |
EvalCsvRunDataSource
Değerlendirme çalıştırmaları için csv veri kaynağını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kaynak | EvalCsvFileIdSource | Değerlendirme verileri için kaynak olarak kullanılan karşıya yüklenen CSV dosyasına başvuruyu temsil eder. | Evet | |
| └─ kimlik | String | Karşıya yüklenen CSV dosyasının tanımlayıcısı. | Evet | |
| └─ türü | enum | Kaynak türü, her zaman file_id.Olası değerler: file_id |
Evet | |
| type | enum | Her zaman csvveri kaynağı türü.Olası değerler: csv |
Evet |
EvalGraderAzureAIEvaluator
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veri eşleme | nesne | Değerlendirme için kullanılacak model. Yapılandırılmış çıktıları destekleme zorunluluğu vardır. | Hayı | |
| evaluator_name | String | Değerlendiricinin adı. | Evet | |
| evaluator_version | String | Değerlendiricinin sürümü. Belirtilmezse en son sürüm. | Hayı | |
| initialization_parameters | nesne | Değerlendirme için başlatma parametreleri. Yapılandırılmış çıktıları destekleme zorunluluğu vardır. | Hayı | |
| name | String | Değerlendiricinin adı. | Evet | |
| type | enum | Her zaman azure_ai_evaluatorolan nesne türü.Olası değerler: azure_ai_evaluator |
Evet |
EvalResult
Değerlendirme sonucu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | String | Çekin adı | Evet | |
| Geçirilen | Boolean | kontrolün başarılı olup olmadığını gösterir | Evet | |
| Puan | Numara | Puan | Evet | |
| type | String | Çekin türü | Evet |
EvalRun
Değerlendirme oturumunu temsil eden şema.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Değerlendirme çalıştırması oluşturulduğunda Unix zaman damgası (saniye olarak). | Evet | |
| Oluşturan | String | çalıştırmayı oluşturan kişinin adı. | Hayı | |
| veri_kaynağı | OpenAI.CreateEvalJsonlRunDataSource veya OpenAI.CreateEvalCompletionsRunDataSource veya OpenAI.CreateEvalResponsesRunDataSource veya EvalRunDataSource | Çalıştırmanın veri kaynağı hakkında bilgi. | Evet | |
| hata | OpenAI.EvalApiError | Değerlendirme API'sinden bir hata yanıtını temsil eden nesne. | Evet | |
| eval_id | String | İlişkili değerlendirmenin tanımlayıcısı. | Evet | |
| kimlik | String | Değerlendirme çalışması için benzersiz tanımlayıcı. | Evet | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Evet | |
| model | String | Değerlendirilen model, eğer uygulanabiliyorsa. | Evet | |
| modified_at | integer | Hayı | ||
| name | String | Değerlendirme çalıştırmasının adı. | Evet | |
| nesne | enum | Nesnenin türü. Her zaman "eval.run". Olası değerler: eval.run |
Evet | |
| model_başına_kullanım | OpenAI.EvalRunPerModelUsage dizisi | Değerlendirme çalıştırması sırasında her model için kullanım istatistikleri. | Evet | |
| test_kriterlerine_göre_sonuçlar | OpenAI.EvalRunPerTestingCriteriaResults dizisi | Değerlendirme çalıştırması sırasında uygulanan test kriterlerine göre sonuçlar. | Evet | |
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı | |
| rapor_url | String | kullanıcı arabirimi panosunda görüntülenen değerlendirme raporunun URL'si. | Evet | |
| sonuç_sayıları | OpenAI.EvalRunResultCounts | Evet | ||
| └─ hata | OpenAI.integer | Evet | ||
| └─ başarısız oldu | OpenAI.integer | Evet | ||
| └─ geçti | OpenAI.integer | Evet | ||
| └─ toplam | OpenAI.integer | Evet | ||
| durum | String | Çalıştırma değerlendirmesinin durumu. | Evet |
EvalRunDataSource
Ayrıştırıcı desteğiyle veri kaynaklarını çalıştırmak için temel sınıf.
EvalRunDataSource için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
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 |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | String | Veri kaynağı türü ayrıştırıcısı. | Evet |
EvalRunOutputItem
Değerlendirme çalıştırmasının çıkış öğesini temsil eden bir şema.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Değerlendirme çalıştırması oluşturulduğunda Unix zaman damgası (saniye olarak). | Evet | |
| veri kaynağı öğesi | nesne | Giriş veri kaynağı öğesinin ayrıntıları. | Evet | |
| veri_kaynağı_öğe_kimliği | OpenAI.integer | Evet | ||
| eval_id | String | Değerlendirme grubunun tanımlayıcısı. | Evet | |
| kimlik | String | Değerlendirme çalıştırma çıkış öğesinin benzersiz tanımlayıcısı. | Evet | |
| nesne | enum | Nesnenin türü. Her zaman "eval.run.output_item". Olası değerler: eval.run.output_item |
Evet | |
| results | EvalRunOutputItemResult dizisi | Bu çıkış öğesi için not veren sonuçlarının listesi. | Evet | |
| run_id | String | Bu çıkış öğesiyle ilişkili değerlendirme çalıştırmasının tanımlayıcısı. | Evet | |
| örnek | OpenAI.EvalRunOutputItemSample | Evet | ||
| └─ hata | OpenAI.EvalApiError | Değerlendirme API'sinden bir hata yanıtını temsil eden nesne. | Evet | |
| └─ bitiş_nedeni | String | Evet | ||
| └─ giriş | EvalRunOutputItemSampleInput dizisi | Evet | ||
| └─ maksimum_önem_bitim_kodları | OpenAI.integer | Evet | ||
| └─ modeli | String | Evet | ||
| └─ çıkış | EvalRunOutputItemSampleOutput dizisi | Evet | ||
| └─ tohum | OpenAI.integer | Evet | ||
| └─ sıcaklık | OpenAI.numeric | Evet | ||
| └─ top_p | OpenAI.numeric | Evet | ||
| └─ kullanımı | OpenAI.EvalRunOutputItemSampleUsage | Evet | ||
| durum | String | Çalıştırma değerlendirmesinin durumu. | Evet |
EvalRunOutputItemResult
Değerlendirme çalıştırması çıkış öğesi için tek bir not veren sonucu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| label | String | Test ölçütü ölçümüyle ilişkili etiket (örneğin, "pass", "fail", "good", "bad"). | Hayı | |
| metric | String | Ölçümün adı (örneğin, "akıcılık", "f1_score"). | Hayı | |
| name | String | Değerlendiricinin adı. | Evet | |
| Geçirilen | Boolean | Not verenin çıkışı bir geçiş olarak değerlendirip değerlendirmediği. | Evet | |
| properties | nesne | Test ölçütleri ölçümü hakkında ek ayrıntılar. | Hayı | |
| sebep | String | Test ölçütleri ölçüm nedeni. | Hayı | |
| örnek | object (null atanabilir) | Not veren tarafından üretilen isteğe bağlı örnek veya ara veriler. | Hayı | |
| Puan | OpenAI.numeric | Evet | ||
| threshold | Numara | Sayısalsa, bu test ölçütlerinin başarılı/başarısız olduğunu belirlemek için kullanılan eşik. | Hayı | |
| type | String | Not veren türü (örneğin, "string-check-grader"). | Hayı |
Bu nesne ek özellikleri de kabul eder.
EvalRunOutputItemSampleInput
Değerlendirme çalıştırmasında bir ileti.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | String | Evet | ||
| role | String | Evet | ||
| tool_calls | CompletionMessageToolCallChunk dizisi | Varsa, ileti içinde yapılan araç çağrıları. | Evet |
EvalRunOutputItemSampleOutput
Değerlendirme çalıştırmasında bir ileti.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | String | Hayı | ||
| role | String | Hayı | ||
| tool_calls | CompletionMessageToolCallChunk dizisi | Varsa, ileti içinde yapılan araç çağrıları. | Evet |
EvalRunResultCompareItem
Bir tedavi için taban çizgisine karşı metrik karşılaştırma.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| deltaEstimate | Numara | Tedavi ve başlangıç arasındaki tahmini fark. | Evet | |
| pValue | Numara | Tedavi etkisi için P değeri. | Evet | |
| treatmentEffect | TreatmentEffectType | Tedavi Etki Türü. | Evet | |
| treatmentRunId | String | Tedavi çalıştırma kimliği. | Evet | |
| treatmentRunSummary | EvalRunResultSummary | Değerlendirme çalıştırmasındaki bir ölçümün özet istatistikleri. | Evet | |
| └─ ortalama | Numara | Değerlendirme çalıştırmasındaki ölçümün ortalama değeri. | Evet | |
| └─ runId | String | Değerlendirme çalıştırma kimliği. | Evet | |
| └─ sampleCount | tamsayı | Değerlendirme çalıştırmasındaki örnek sayısı. | Evet | |
| └─ standardDeviation | Numara | Değerlendirme çalıştırmasında metriğin standart sapması. | Evet |
EvalRunResultComparison
Tedavi için karşılaştırma sonuçları taban çizgisine göre çalışır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| baselineRunSummary | EvalRunResultSummary | Değerlendirme çalıştırmasındaki bir ölçümün özet istatistikleri. | Evet | |
| └─ ortalama | Numara | Değerlendirme çalıştırmasındaki ölçümün ortalama değeri. | Evet | |
| └─ runId | String | Değerlendirme çalıştırma kimliği. | Evet | |
| └─ sampleCount | tamsayı | Değerlendirme çalıştırmasındaki örnek sayısı. | Evet | |
| └─ standardDeviation | Numara | Değerlendirme çalıştırmasında metriğin standart sapması. | Evet | |
| compareItems | EvalRunResultCompareItem dizisi | Her tedavi çalışması için karşılaştırma sonuçlarının listesi. | Evet | |
| Değerlendir -ici | String | Bu test kriteri için değerlendiricinin adı. | Evet | |
| metric | String | Metrik değerlendiriliyor. | Evet | |
| testingCriteria | String | Test kriterlerinin adı. | Evet |
EvalRunResultSummary
Değerlendirme çalıştırmasındaki bir ölçümün özet istatistikleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| ortalama | Numara | Değerlendirme çalıştırmasındaki ölçümün ortalama değeri. | Evet | |
| runId | String | Değerlendirme çalıştırma kimliği. | Evet | |
| sampleCount | tamsayı | Değerlendirme çalıştırmasındaki örnek sayısı. | Evet | |
| standardDeviation | Numara | Değerlendirme çalıştırmasında metriğin standart sapması. | Evet |
EvaluationComparisonInsightRequest
Değerlendirme Karşılaştırma İsteği
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| baselineRunId | String | Karşılaştırma için temel çalıştırma kimliği. | Evet | |
| evalId | String | Değerlendirme için tanımlayıcı. | Evet | |
| treatmentRunIds | dize dizisi | Karşılaştırma için tedavi çalıştırma kimliklerinin listesi. | Evet | |
| type | enum | İstek türü. Olası değerler: EvaluationComparison |
Evet |
EvaluationComparisonInsightResult
Değerlendirme karşılaştırmasından elde edilen bilgiler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Karşılaştırma | EvalRunResultComparison dizisi | Her tedavi için karşılaştırma sonuçları taban çizgisine göre çalışır. | Evet | |
| method | String | Karşılaştırma için kullanılan istatistiksel yöntem. | Evet | |
| type | enum | İçgörülerin türü sonucu. Olası değerler: EvaluationComparison |
Evet |
EvaluationResultSample
Değerlendirme sonucundan bir örnek.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| correlationInfo | nesne | Analiz örneğinin korelasyonu hakkında bilgi. | Evet | |
| evaluationResult | EvalResult | Değerlendirme sonucu. | Evet | |
| └─ ad | String | Çekin adı | Evet | |
| └─ geçti | Boolean | kontrolün başarılı olup olmadığını gösterir | Evet | |
| └─ puanı | Numara | Puan | Evet | |
| └─ türü | String | Çekin türü | Evet | |
| features | nesne | UX'te verilerin ek filtrelenmesine yardımcı olacak özellikler. | Evet | |
| kimlik | String | Analiz örneğinin benzersiz tanımlayıcısı. | Evet | |
| type | enum | Değerlendirme Sonucu Örnek Türü Olası değerler: EvaluationResultSample |
Evet |
Değerlendirme Kuralı
Değerlendirme kuralı modeli.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | EvaluationRuleAction | Değerlendirme eylem modeli. | Evet | |
| └─ türü | EvaluationRuleActionType | Değerlendirme eyleminin türü. | Evet | |
| açıklama | String | Değerlendirme kuralının açıklaması. | Hayı | |
| ekran adı | String | Değerlendirme kuralı için Görünen Ad. | Hayı | |
| etkinleştirildi | Boolean | Değerlendirme kuralının etkin olup olmadığını gösterir. Varsayılan değer doğrudur | Evet | |
| eventType | EvaluationRuleEventType | Değerlendirme kuralı olayının türü. | Evet | |
| filtre | EvaluationRuleFilter | Değerlendirme filtresi modeli. | Hayı | |
| └─ ajanName | String | Müşteri temsilcisi adına göre filtreleyin. | Evet | |
| kimlik | dize (salt okunur) | Değerlendirme kuralı için benzersiz tanımlayıcı. | Evet | |
| sistem verileri | object (salt okunur) | Değerlendirme kuralı için sistem meta verileri. | Evet |
EvaluationRuleAction
Değerlendirme eylem modeli.
EvaluationRuleAction için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
continuousEvaluation |
ContinuousEvaluationRuleAction |
humanEvaluationPreview |
HumanEvaluationPreviewRuleAction |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | EvaluationRuleActionType | Değerlendirme eyleminin türü. | Evet |
EvaluationRuleActionType
Değerlendirme eyleminin türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendirme eyleminin türü. |
| Türü | String |
| Değerler | continuousEvaluationhumanEvaluationPreview |
EvaluationRuleEventType
Değerlendirme kuralı olayının türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendirme kuralı olayının türü. |
| Türü | String |
| Değerler | responseCompletedmanual |
EvaluationRuleFilter
Değerlendirme filtresi modeli.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| ajan adı | String | Müşteri temsilcisi adına göre filtreleyin. | Evet |
EvaluationRunClusterInsightRequest
Değerlendirme Sonuçları kümesine ilişkin içgörüler
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| evalId | String | İçgörüler için Değerlendirme Kimliği. | Evet | |
| model yapılandırması | InsightModelConfiguration | İçgörü oluşturmada kullanılan modelin yapılandırması. | Hayı | |
| └─ modelDeploymentName | String | Değerlendirilecek model dağıtımı. Dağıtım adını tek başına veya bağlantı adı olarak {connectionName}/<modelDeploymentName>kabul eder. |
Evet | |
| runId'ler | dize dizisi | İçgörüler için değerlendirme çalıştırma kimliklerinin listesi. | Evet | |
| type | enum | İçgörü isteğinin türü. Olası değerler: EvaluationRunClusterInsight |
Evet |
EvaluationRunClusterInsightResult
Değerlendirmeden elde edilen içgörüler küme analizini çalıştırır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| clusterInsight | ClusterInsightResult | Küme analizinden elde edilen bilgiler. | Evet | |
| type | enum | İçgörülerin türü sonucu. Olası değerler: EvaluationRunClusterInsight |
Evet |
EvaluationScheduleTask
Zamanlama için değerlendirme görevi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| configuration | nesne | Görev için yapılandırma. | Hayı | |
| evalId | String | Değerlendirme grubunun tanımlayıcısı. | Evet | |
| evalRun | nesne | Değerlendirme çalıştırma yükü. | Evet | |
| type | enum | Olası değerler: Evaluation |
Evet |
EvaluationTaxonomy
Değerlendirme Taksonomisi Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| properties | nesne | Değerlendirme taksonomisi için ek özellikler. | Hayı | |
| taksonomi Kategorileri | TaxonomyCategory dizisi | Taksonomi kategorilerinin listesi. | Hayı | |
| taksonomiInput | EvaluationTaxonomyInput | Değerlendirme taksonomisi için giriş yapılandırması. | Evet | |
| └─ türü | EvaluationTaxonomyInputType | Değerlendirme taksonomisinin giriş türü. | Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
EvaluationTaxonomyCreateOrUpdate
Değerlendirme Taksonomisi Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| properties | nesne | Değerlendirme taksonomisi için ek özellikler. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| taksonomi Kategorileri | TaxonomyCategory dizisi | Taksonomi kategorilerinin listesi. | Hayı | |
| taksonomiInput | EvaluationTaxonomyInput | Değerlendirme taksonomisi için giriş yapılandırması. | Evet | |
| └─ türü | EvaluationTaxonomyInputType | Değerlendirme taksonomisinin giriş türü. | Evet |
EvaluationTaxonomyInput
Değerlendirme taksonomisi için giriş yapılandırması.
EvaluationTaxonomyInput için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
agent |
AgentTaxonomyInput |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | EvaluationTaxonomyInputType | Değerlendirme taksonomisi girişinin türü. | Evet |
EvaluationTaxonomyInputType
Değerlendirme taksonomisi girişinin türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendirme taksonomisi girişinin türü. |
| Türü | String |
| Değerler | agentpolicy |
EvaluationTaxonomyInputUpdate
Değerlendirme taksonomisi için giriş yapılandırması.
EvaluationTaxonomyInputUpdate için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
agent |
AgentTaxonomyInputUpdate |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | EvaluationTaxonomyInputType | Değerlendirme taksonomisi girişinin türü. | Evet |
EvaluationTaxonomyUpdate
Değerlendirme Taksonomisi Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| properties | nesne | Değerlendirme taksonomisi için ek özellikler. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| taksonomi Kategorileri | TaxonomyCategory dizisi | Taksonomi kategorilerinin listesi. | Hayı | |
| taksonomiInput | EvaluationTaxonomyInputUpdate | Değerlendirme taksonomisi için giriş yapılandırması. | Hayı | |
| └─ türü | EvaluationTaxonomyInputType | Değerlendirme taksonomisinin giriş türü. | Evet |
DeğerlendiriciKategorisi
Değerlendiricinin kategorisi
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendiricinin kategorisi |
| Türü | String |
| Değerler | qualitysafetyagents |
DeğerlendiriciDefinition
Ayırıcılı temel değerlendirici konfigürasyonu
DeğerlendiriciDefinition için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
code |
CodeBasedEvaluatorDefinition |
prompt |
PromptBasedEvaluatorDefinition |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| data_schema | nesne | Değerlendiricinin giriş verileri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| init_parameters | nesne | Değerlendiricinin giriş parametreleri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| metrics | nesne | Bu değerlendirici tarafından üretilen çıktı metriklerinin listesi | Hayı | |
| type | EvaluatorDefinitionType | Değerlendirici tanımının türü | Evet |
EvaluatorDefinitionType
Değerlendirici tanımının türü
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendirici tanımının türü |
| Türü | String |
| Değerler | promptcodeprompt_and_codeserviceopenai_graders |
DeğerlendiriciÖlçerÖlçer
Değerlendirici Metriği
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| desirable_direction | DeğerlendiriciMetricDirection | Daha yüksek bir değerin daha iyi, daha düşük bir değerin daha iyi veya nötr olup olmadığını gösteren metriğin yönü | Hayı | |
| is_primary | Boolean | Birden çok ölçüm olduğunda bu ölçümün birincil olup olmadığını gösterir. | Hayı | |
| max_value | Numara | Ölçüm için en yüksek değer. Belirtilmezse, sınırsız olduğu varsayılır. | Hayı | |
| min_value | Numara | Metrik için minimum değer | Hayı | |
| type | DeğerlendiriciMetricType | Değerlendiricinin türü | Hayı |
DeğerlendiriciMetricDirection
Daha yüksek bir değerin daha iyi, daha düşük bir değerin daha iyi veya nötr olup olmadığını gösteren metriğin yönü
| Mülkiyet | Değer |
|---|---|
| Açıklama | Daha yüksek bir değerin daha iyi, daha düşük bir değerin daha iyi veya nötr olup olmadığını gösteren metriğin yönü |
| Türü | String |
| Değerler | increasedecreaseneutral |
DeğerlendiriciMetricType
Değerlendiricinin türü
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendiricinin türü |
| Türü | String |
| Değerler | ordinalcontinuousboolean |
Değerlendirici Türü
Değerlendiricinin türü
| Mülkiyet | Değer |
|---|---|
| Açıklama | Değerlendiricinin türü |
| Türü | String |
| Değerler | builtincustom |
EvaluatorVersion
Değerlendirici Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| categories | DeğerlendiriciKatgorisi dizisi | Değerlendiricinin kategorileri | Evet | |
| oluşturulma_tarihi | dize (salt okunur) | Değerlendiricinin oluşturulma tarihi/saati | Evet | |
| Oluşturan | dize (salt okunur) | Değerlendiricinin yaratıcısı | Evet | |
| tanım | DeğerlendiriciDefinition | Ayırıcılı temel değerlendirici konfigürasyonu | Evet | |
| └─ data_schema | nesne | Değerlendiricinin giriş verileri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| └─ init_parameters | nesne | Değerlendiricinin giriş parametreleri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| └─ ölçümler | nesne | Bu değerlendirici tarafından üretilen çıktı metriklerinin listesi | Hayı | |
| └─ türü | EvaluatorDefinitionType | Değerlendirici tanımının türü | Evet | |
| display_name | String | Değerlendirici için Görünen Ad. AI Foundry'de değerlendiriciyi kolayca bulmak yardımcı olur. Benzersiz olması gerekmez. | Hayı | |
| evaluator_type | Değerlendirici Türü | Değerlendiricinin türü | Evet | |
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| metadata | nesne | Değerlendirici hakkında meta veriler | Hayı | |
| modified_at | dize (salt okunur) | Değerlendiricinin son değiştirilme tarihi/saati | Evet | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
EvaluatorVersionCreate
Değerlendirici Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| categories | DeğerlendiriciKatgorisi dizisi | Değerlendiricinin kategorileri | Evet | |
| tanım | DeğerlendiriciDefinition | Ayırıcılı temel değerlendirici konfigürasyonu | Evet | |
| └─ data_schema | nesne | Değerlendiricinin giriş verileri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| └─ init_parameters | nesne | Değerlendiricinin giriş parametreleri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| └─ ölçümler | nesne | Bu değerlendirici tarafından üretilen çıktı metriklerinin listesi | Hayı | |
| └─ türü | EvaluatorDefinitionType | Değerlendirici tanımının türü | Evet | |
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| display_name | String | Değerlendirici için Görünen Ad. AI Foundry'de değerlendiriciyi kolayca bulmak yardımcı olur. Benzersiz olması gerekmez. | Hayı | |
| evaluator_type | Değerlendirici Türü | Değerlendiricinin türü | Evet | |
| metadata | nesne | Değerlendirici hakkında meta veriler | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı |
EvaluatorVersionUpdate
Değerlendirici Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| categories | DeğerlendiriciKatgorisi dizisi | Değerlendiricinin kategorileri | Hayı | |
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| display_name | String | Değerlendirici için Görünen Ad. AI Foundry'de değerlendiriciyi kolayca bulmak yardımcı olur. Benzersiz olması gerekmez. | Hayı | |
| metadata | nesne | Değerlendirici hakkında meta veriler | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı |
FabricDataAgentToolParameters
Yapı veri aracısı aracı parametreleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| project_connections | ToolProjectConnection dizisi | Bu araca bağlı proje bağlantıları. En fazla 1 bağlantı olabilir aracına bağlı kaynak. |
Hayı |
FileDatasetVersion
FileDatasetVersion Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| connectionName (bağlantıadı) | String | Azure Storage Account bağlantı adı. Veri Kümesi oluşturulmadan önce startPendingUploadVersion çağrılmadıysa gereklidir | Hayı | |
| dataUri | String | Verilerin URI'si (örnek) Kısıtlamalar: minLength: 1, desen: [a-zA-Z0-9_] |
Evet | |
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| isReference | boole (salt okunur) | Veri setinin storage'a referans tuttuğunu veya veri setinin storage'ı kendisi yönetip yönetmediğini gösterir. Doğruysa, veri kümesi sürümü silindiğinde temel alınan veriler silinmez | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | enum | Veri kümesi türü Olası değerler: uri_file |
Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
FileDatasetVersionUpdate
FileDatasetVersion Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | enum | Veri kümesi türü Olası değerler: uri_file |
Evet |
FolderDatasetVersion
FileDatasetVersion Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| connectionName (bağlantıadı) | String | Azure Storage Account bağlantı adı. Veri Kümesi oluşturulmadan önce startPendingUploadVersion çağrılmadıysa gereklidir | Hayı | |
| dataUri | String | Verilerin URI'si (örnek) Kısıtlamalar: minLength: 1, desen: [a-zA-Z0-9_] |
Evet | |
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| isReference | boole (salt okunur) | Veri setinin storage'a referans tuttuğunu veya veri setinin storage'ı kendisi yönetip yönetmediğini gösterir. Doğruysa, veri kümesi sürümü silindiğinde temel alınan veriler silinmez | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | enum | Veri kümesi türü Olası değerler: uri_folder |
Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
FolderDatasetVersionUpdate
FileDatasetVersion Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | enum | Veri kümesi türü Olası değerler: uri_folder |
Evet |
FunctionToolCall
İşlev aracı çağrısının ayrıntıları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | JSON biçiminde model tarafından oluşturulan işlevi çağırmak için bağımsız değişkenler. | Evet | |
| name | String | Çağrılacak işlevin adı. | Evet |
HostedAgentDefinition
Barındırılan aracı tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| container_protocol_versions | ProtocolVersionRecord dizisi | Aracının kapsayıcıların giriş iletişimi için desteklediği protokoller. | Evet | |
| cpu | String | Barındırılan aracının CPU yapılandırması. | Evet | |
| environment_variables | nesne | Barındırılan aracı kapsayıcısında ayarlanacak ortam değişkenleri. | Hayı | |
| image | String | Görüntü tabanlı barındırılan aracılar için geçerli olan aracının görüntü kimliği. | Hayı | |
| tür | enum | Olası değerler: hosted |
Evet | |
| memory | String | Barındırılan aracının bellek yapılandırması. | Evet | |
| rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| └─ rai_policy_name | String | Uygulanacak RAI politikasının adı. | Evet | |
| araçlar | OpenAI.Tool dizisi | Barındırılan aracının modelinin yanıt oluştururken çağırabileceği bir dizi araç. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir. |
Hayı |
HourlyRecurrenceSchedule
Saatlik yinelenme zamanlaması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: Hourly |
Evet |
HumanEvaluationPreviewRuleAction
İnsan değerlendirmesi için değerlendirme kuralı eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| şablonId | AssetId | Kaydedilmiş bir varlığın tanımlayıcısı. | Evet | |
| type | enum | Olası değerler: humanEvaluationPreview |
Evet |
Index
Dizin kaynağı Tanımı
Dizin için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
AzureSearch |
AzureAISearchIndex |
ManagedAzureSearch |
ManagedAzureAISearchIndex |
CosmosDBNoSqlVectorStore |
CosmosDBIndex |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | IndexType | Evet | ||
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
IndexType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | AzureSearchCosmosDBNoSqlVectorStoreManagedAzureSearch |
IndexUpdate
Dizin kaynağı Tanımı
IndexUpdate için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
AzureSearch |
AzureAISearchIndexUpdate |
ManagedAzureSearch |
ManagedAzureAISearchIndexUpdate |
CosmosDBNoSqlVectorStore |
CosmosDBIndexUpdate |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | IndexType | Evet |
İçgörü
Küme içgörüleri için yanıt gövdesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| ekran adı | String | İçgörü için kullanıcı dostu görünen ad. | Evet | |
| kimlik | dize (salt okunur) | İçgörüler raporunun benzersiz tanımlayıcısı. | Evet | |
| metadata | InsightsMetadata (salt okunur) | İçgörülerle ilgili meta veriler. | Evet | |
| └─ tamamlandıAt | String | İçgörülerin tamamlandığı zaman damgası. | Hayı | |
| └─ oluşturuldu | String | İçgörülerin oluşturulduğu zaman damgası. | Evet | |
| request | InsightRequest | İçgörüler raporunun isteği. | Evet | |
| └─ türü | InsightType | İstek türü. | Evet | |
| sonuç | InsightResult (salt okunur) | İçgörülerin sonucu. | Hayı | |
| └─ türü | InsightType | İçgörülerin türü sonucu. | Evet | |
| state | Azure. Core.Foundations.OperationState (yalnızca okunabilir) | İzin verilen işlem durumlarını açıklayan sabit listesi. | Evet |
InsightCluster
Analiz örneklerinden oluşan bir küme.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Analiz kümesinin açıklaması. | Evet | |
| kimlik | String | Analiz kümesinin kimliği. | Evet | |
| label | String | Küme için etiket | Evet | |
| Örnekleri | InsightSample dizisi | Bu kümeye ait örneklerin listesi. Örnekler alt kümelerin parçasıysa boşaltın. | Hayı | |
| alt kümeler | InsightCluster dizisi | Bu küme içindeki alt kümelerin listesi. Alt küme yoksa boştur. | Hayı | |
| öneri | String | Küme için öneri | Evet | |
| suggestionTitle | String | Küme için önerinin başlığı | Evet | |
| weight | tamsayı | Analiz kümesinin ağırlığı. Bu, kümedeki örnek sayısını gösterir. | Evet |
InsightModelConfiguration
İçgörü oluşturmada kullanılan modelin yapılandırması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| modelDeploymentName | String | Değerlendirilecek model dağıtımı. Dağıtım adını tek başına veya bağlantı adı olarak {connectionName}/<modelDeploymentName>kabul eder. |
Evet |
InsightRequest
İçgörüler raporunun isteği.
InsightRequest için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
EvaluationRunClusterInsight |
EvaluationRunClusterInsightRequest |
AgentClusterInsight |
AgentClusterInsightRequest |
EvaluationComparison |
EvaluationComparisonInsightRequest |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | InsightType | İçgörülerin isteği. | Evet |
InsightResult
İçgörülerin sonucu.
InsightResult için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
EvaluationComparison |
EvaluationComparisonInsightResult |
EvaluationRunClusterInsight |
EvaluationRunClusterInsightResult |
AgentClusterInsight |
AgentClusterInsightResult |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | InsightType | İçgörülerin isteği. | Evet |
InsightSample
Analizden bir örnek.
InsightSample için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
EvaluationResultSample |
EvaluationResultSample |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| correlationInfo | nesne | Analiz örneğinin korelasyonu hakkında bilgi. | Evet | |
| features | nesne | UX'te verilerin ek filtrelenmesine yardımcı olacak özellikler. | Evet | |
| kimlik | String | Analiz örneğinin benzersiz tanımlayıcısı. | Evet | |
| type | Sampletype | Analizde kullanılan numunenin türü. | Evet |
InsightScheduleTask
Zamanlama için içgörü görevi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| configuration | nesne | Görev için yapılandırma. | Hayı | |
| içgörü | Insight | Küme içgörüleri için yanıt gövdesi. | Evet | |
| └─ displayName | String | İçgörü için kullanıcı dostu görünen ad. | Evet | |
| └─ kimlik | dize (salt okunur) | İçgörüler raporunun benzersiz tanımlayıcısı. | Evet | |
| └─ meta veriler | InsightsMetadata (salt okunur) | İçgörüler raporuyla ilgili meta veriler. | Evet | |
| └─ isteği | InsightRequest | İçgörü analizi için talepte bulunun. | Evet | |
| └─ sonuç | InsightResult (salt okunur) | İçgörüler raporunun sonucu. | Hayı | |
| └─ durumu | Azure. Core.Foundations.OperationState (yalnızca okunabilir) | İçgörülerin mevcut durumu. | Evet | |
| type | enum | Olası değerler: Insight |
Evet |
InsightSummary
Hata kümesi analizinin özeti.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| method | String | Kümeleme için kullanılan yöntem. | Evet | |
| sampleCount | tamsayı | Analiz edilen toplam numune sayısı. | Evet | |
| uniqueClusterCount | tamsayı | Benzersiz kümelerin toplam sayısı. | Evet | |
| uniqueSubclusterCount | tamsayı | Benzersiz alt küme etiketlerinin toplam sayısı. | Evet | |
| usage | ClusterTokenUsage | Küme analizi için belirteç kullanımı | Evet | |
| └─ inputTokenUsage | tamsayı | Giriş belirteci kullanımı | Evet | |
| └─ outputTokenUsage | tamsayı | Çıkış belirteci kullanımı | Evet | |
| └─ totalTokenUsage | tamsayı | Toplam jeton kullanımı | Evet |
InsightType
İçgörülerin isteği.
| Mülkiyet | Değer |
|---|---|
| Açıklama | İçgörülerin isteği. |
| Türü | String |
| Değerler | EvaluationRunClusterInsightAgentClusterInsightEvaluationComparison |
InsightsMetadata
İçgörülerle ilgili meta veriler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| completedAt | String | İçgörülerin tamamlandığı zaman damgası. | Hayı | |
| createdAt | String | İçgörülerin oluşturulduğu zaman damgası. | Evet |
ItemGenerationParams
Öğe oluşturma işlemlerini denetlemek için kullanılan parametre kümesini temsil eder.
ItemGenerationParams için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
red_team |
RedTeamItemGenerationParams |
red_team_seed_prompts |
RedTeamSeedPromptsItemGenerationParams |
red_team_taxonomy |
RedTeamTaxonomyItemGenerationParams |
response_retrieval |
ResponseRetrievalItemGenerationParams |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | ItemGenerationParamsType | Kırmızı takım öğesi oluşturma için parametre türleri. | Evet |
ItemGenerationParamsType
Kırmızı takım öğesi oluşturma için parametre türleri.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Kırmızı takım öğesi oluşturma için parametre türleri. |
| Türü | String |
| Değerler | red_teamresponse_retrievalred_team_seed_promptsred_team_taxonomysynthetic_data_gen_preview |
ManagedAzureAISearchIndex
Managed Azure AI Search Index Definition
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | dize (salt okunur) | Öğe kimliği, öğe için benzersiz bir tanımlayıcı | Hayı | |
| name | dize (salt okunur) | Kaynağın adı | Evet | |
| type | enum | Endeks türü Olası değerler: ManagedAzureSearch |
Evet | |
| version | dize (salt okunur) | Kaynağın sürümü | Evet |
ManagedAzureAISearchIndexUpdate
Managed Azure AI Search Index Definition
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Varlık açıklaması metni. | Hayı | |
| tags | nesne | Etiket sözlüğü. Etiketler eklenebilir, kaldırılabilir ve güncelleştirilebilir. | Hayı | |
| type | enum | Endeks türü Olası değerler: ManagedAzureSearch |
Evet |
MemoryItem
Bellek deposunda saklanan, içerik ve meta verileri içeren tek bir bellek öğesi.
MemoryItem için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini kind kullanır:
| Tür Değeri | Şema |
|---|---|
user_profile |
UserProfileMemoryItem |
chat_summary |
ChatSummaryMemoryItem |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | String | Belleğin içeriği. | Evet | |
| tür | MemoryItemKind | Bellek öğesi türü. | Evet | |
| memory_id | String | Bellek öğesinin benzersiz kimliği. | Evet | |
| kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet | |
| updated_at | tamsayı | Bellek öğesinin son güncelleme zamanı. | Evet |
MemoryItemKind
Bellek öğesi türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Bellek öğesi türü. |
| Türü | String |
| Değerler | user_profilechat_summary |
MemoryOperation
Bir bellek öğesi üzerinde gerçekleştirilen tek bir bellek işlemini (oluşturma, güncelleştirme veya silme) temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tür | MemoryOperationKind | Bellek işlemi türü. | Evet | |
| memory_item | MemoryItem | Bellek deposunda saklanan, içerik ve meta verileri içeren tek bir bellek öğesi. | Evet | |
| └─ içerik | String | Belleğin içeriği. | Evet | |
| └─ tür | MemoryItemKind | Hafıza öğesinin türü. | Evet | |
| └─ memory_id | String | Bellek öğesinin benzersiz kimliği. | Evet | |
| └─ kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet | |
| └─ updated_at | tamsayı | Bellek öğesinin son güncelleme zamanı. | Evet |
MemoryOperationKind
Bellek işlemi türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Bellek işlemi türü. |
| Türü | String |
| Değerler | createupdatedelete |
MemorySearchItem
Bellek aramasından alınan bir bellek öğesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| memory_item | MemoryItem | Bellek deposunda saklanan, içerik ve meta verileri içeren tek bir bellek öğesi. | Evet | |
| └─ içerik | String | Belleğin içeriği. | Evet | |
| └─ tür | MemoryItemKind | Hafıza öğesinin türü. | Evet | |
| └─ memory_id | String | Bellek öğesinin benzersiz kimliği. | Evet | |
| └─ kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet | |
| └─ updated_at | tamsayı | Bellek öğesinin son güncelleme zamanı. | Evet |
MemorySearchOptions
Bellek arama seçenekleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_memories | tamsayı | Döndürülecek en fazla bellek öğesi sayısı. | Hayı |
MemorySearchPreviewTool
Anıları aracıya entegre etmek için bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| memory_store_name | String | Kullanılacak bellek deposunun adı. | Evet | |
| kapsam | String | Kullanıcı kimliği gibi anıları gruplandırmak ve yalıtmak için kullanılan ad alanı. Hangi anıların alınabileceğini veya güncellenebileceğini sınırlar. Belleklerin kapsamını geçerli oturum açmış kullanıcıya genişletmek için özel değişken {{$userId}} kullanın. |
Evet | |
| search_options | MemorySearchOptions | Bellek arama seçenekleri. | Hayı | |
| └─ max_memories | tamsayı | Döndürülecek en fazla bellek öğesi sayısı. | Hayı | |
| type | enum | Aracın türü. Her zaman memory_search_preview.Olası değerler: memory_search_preview |
Evet | |
| update_delay | tamsayı | Hareketsizlikten sonra anıları güncellemeden önce bekleme süresi (saniye). Varsayılan 300. | Hayı | 300 |
MemorySearchToolCallItemParam
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| results | MemorySearchItem dizisi | Bellek aramasından döndürülen sonuçlar. | Hayı | |
| type | enum | Olası değerler: memory_search_call |
Evet |
MemorySearchToolCallItemResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| results | MemorySearchItem dizisi | Bellek aramasından döndürülen sonuçlar. | Hayı | |
| durum | enum | Bellek arama aracı çağrısının durumu. Bunlardan biri in_progresssearching, completedveya incompletefailed,Olası değerler: in_progress, searching, completed, incomplete, failed |
Evet | |
| type | enum | Olası değerler: memory_search_call |
Evet |
MemoryStoreDefaultDefinition
Varsayılan bellek deposu uygulaması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| chat_model | String | Bellek işleme için kullanılan sohbet tamamlama modeli dağıtımının adı veya tanımlayıcısı. | Evet | |
| embedding_model | String | Bellek işleme için kullanılan ekleme modeli dağıtımının adı veya tanımlayıcısı. | Evet | |
| tür | enum | Bellek deposunun türü. Olası değerler: default |
Evet | |
| options | MemoryStoreDefaultOptions | Varsayılan bellek deposu yapılandırmaları. | Hayı | |
| └─ chat_summary_enabled | Boolean | Sohbet özetini açıp açma ve storage'ı etkinleştirip etkinleştirmediğiniz. Varsayılan değer doğrudur | Evet | Doğru |
| └─ user_profile_details | String | Ayıklanacak ve saklanacak belirli kategoriler veya kullanıcı profili bilgisi türleri. | Hayı | |
| └─ user_profile_enabled | Boolean | Kullanıcı profili çıkarma ve storage'ı etkinleştirip etkinleştirilmeyeceği. Varsayılan değer doğrudur | Evet | Doğru |
MemoryStoreDefaultOptions
Varsayılan bellek deposu yapılandırmaları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| chat_summary_enabled | Boolean | Sohbet özetini açıp açma ve storage'ı etkinleştirip etkinleştirmediğiniz. Varsayılan değer doğrudur | Evet | Doğru |
| user_profile_details | String | Ayıklanacak ve saklanacak belirli kategoriler veya kullanıcı profili bilgisi türleri. | Hayı | |
| user_profile_enabled | Boolean | Kullanıcı profili çıkarma ve storage'ı etkinleştirip etkinleştirilmeyeceği. Varsayılan değer doğrudur | Evet | Doğru |
MemoryStoreDefinition
Bellek deposu yapılandırmaları için temel tanım.
MemoryStoreDefinition için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini kind kullanır:
| Tür Değeri | Şema |
|---|---|
default |
MemoryStoreDefaultDefinition |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tür | MemoryStoreKind | Kullanılacak bellek deposu uygulamasının türü. | Evet |
MemoryStoreDeleteScopeResponse
Bir kapsamdan anıları silme yanıtı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Silme işleminin başarılı olup olmadığı. | Evet | |
| name | String | Bellek deposunun adı. | Evet | |
| nesne | enum | Nesne türü. Her zaman 'memory_store.scope.deleted'. Olası değerler: memory_store.scope.deleted |
Evet | |
| kapsam | String | Anıların silindiği kapsam. | Evet |
MemoryStoreKind
Kullanılacak bellek deposu uygulamasının türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Kullanılacak bellek deposu uygulamasının türü. |
| Türü | String |
| Değerler | default |
MemoryStoreObject
Kullanıcı anılarını depolayabilen ve alabilen bir bellek deposu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Bellek deposunun oluşturulduğu Unix zaman damgası (saniye). | Evet | |
| tanım | MemoryStoreDefinition | Bellek deposu yapılandırmaları için temel tanım. | Evet | |
| └─ tür | MemoryStoreKind | Bellek deposunun türü. | Evet | |
| açıklama | String | Bellek deposunun okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| kimlik | String | Bellek deposunun benzersiz tanımlayıcısı. | Evet | |
| metadata | nesne | Bellek deposuyla ilişkilendirilecek rastgele anahtar-değer meta verileri. | Hayı | |
| name | String | Bellek deposunun adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| nesne | enum | Her zaman 'memory_store' olan nesne türü. Olası değerler: memory_store |
Evet | |
| updated_at | tamsayı | Bellek deposunun en son güncellendiği Unix zaman damgası (saniye). | Evet |
MemoryStoreOperationUsage
Bellek deposu işleminin kullanım istatistikleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| embedding_tokens | tamsayı | Ekleme belirteçlerinin sayısı. | Evet | |
| input_tokens | OpenAI.integer | Evet | ||
| input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Evet | ||
| └─ önbelleğe alınmış jetonlar | OpenAI.integer | Evet | ||
| output_tokens | OpenAI.integer | Evet | ||
| output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Evet | ||
| └─ akıl yürütme_tokenlar | OpenAI.integer | Evet | ||
| total_tokens | OpenAI.integer | Evet |
MemoryStoreSearchResponse
Bellek arama yanıtı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Anıları | MemorySearchItem dizisi | Arama işlemi sırasında bulunan ilgili bellek öğeleri. | Evet | |
| search_id | String | Bu arama isteğinin benzersiz kimliği. Artımlı aramalar gerçekleştirmek için sonraki isteklerde previous_search_id olarak bu değeri kullanın. | Evet | |
| usage | MemoryStoreOperationUsage | Bellek deposu işleminin kullanım istatistikleri. | Evet | |
| └─ embedding_tokens | tamsayı | Ekleme belirteçlerinin sayısı. | Evet | |
| └─ girdi_simgeleri | OpenAI.integer | Giriş belirteçlerinin sayısı. | Evet | |
| └─ giriş_jeton_detayları | OpenAI.ResponseUsageInputTokensDetails | Giriş belirteçlerinin ayrıntılı dökümü. | Evet | |
| └─ çıkış_birimleri | OpenAI.integer | Çıkış belirteçlerinin sayısı. | Evet | |
| └─ output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Çıkış belirteçlerinin ayrıntılı dökümü. | Evet | |
| └─ toplam_jetonlar | OpenAI.integer | Kullanılan toplam belirteç sayısı. | Evet |
MemoryStoreUpdateCompletedResult
Bellek güncelleme sonucu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| memory_operations | MemoryOperation dizisi | Güncelleştirme sırasında gerçekleştirilen tek tek bellek işlemlerinin listesi. | Evet | |
| usage | MemoryStoreOperationUsage | Bellek deposu işleminin kullanım istatistikleri. | Evet | |
| └─ embedding_tokens | tamsayı | Ekleme belirteçlerinin sayısı. | Evet | |
| └─ girdi_simgeleri | OpenAI.integer | Giriş belirteçlerinin sayısı. | Evet | |
| └─ giriş_jeton_detayları | OpenAI.ResponseUsageInputTokensDetails | Giriş belirteçlerinin ayrıntılı dökümü. | Evet | |
| └─ çıkış_birimleri | OpenAI.integer | Çıkış belirteçlerinin sayısı. | Evet | |
| └─ output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Çıkış belirteçlerinin ayrıntılı dökümü. | Evet | |
| └─ toplam_jetonlar | OpenAI.integer | Kullanılan toplam belirteç sayısı. | Evet |
MemoryStoreUpdateResponse
Bellek deposu güncelleştirme işleminin durumunu sağlar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | OpenAI.Error | Hayı | ||
| └─ ekBilgi | nesne | Hayı | ||
| └─ kod | dize (null atanabilir) | Evet | ||
| └─ debugInfo | nesne | Hayı | ||
| └─ ayrıntılar | OpenAI.Error dizisi | Hayı | ||
| └─ ileti | String | Evet | ||
| └─ parametre | dize (null atanabilir) | Hayı | ||
| └─ türü | String | Hayı | ||
| sonuç | MemoryStoreUpdateCompletedResult | Bellek güncelleme sonucu. | Hayı | |
| └─ memory_operations | MemoryOperation dizisi | Güncelleştirme sırasında gerçekleştirilen tek tek bellek işlemlerinin listesi. | Evet | |
| └─ kullanımı | MemoryStoreOperationUsage | Bellek güncelleştirme işlemiyle ilişkili kullanım istatistikleri. | Evet | |
| durum | MemoryStoreUpdateStatus | Bellek deposu güncelleştirme işleminin durumu. | Evet | |
| superseded_by | String | İşlemin yerini aldığı update_id, durumun "yerine geçen" zamandır. | Hayı | |
| update_id | String | Bu güncelleştirme isteğinin benzersiz kimliği. Artımlı güncelleştirmeler gerçekleştirmek için sonraki isteklerde bu değeri previous_update_id olarak kullanın. | Evet |
MemoryStoreUpdateStatus
Bellek deposu güncelleştirme işleminin durumu.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | queuedin_progresscompletedfailedsuperseded |
MicrosoftFabricPreviewTool
Bir ajanı yapılandırmak için kullanılan Microsoft Fabric aracı için giriş tanım bilgileri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| fabric_dataagent_preview | FabricDataAgentToolParameters | Yapı veri aracısı aracı parametreleri. | Evet | |
| └─ project_connections | ToolProjectConnection dizisi | Bu araca bağlı proje bağlantıları. En fazla 1 bağlantı olabilir aracına bağlı kaynak. Kısıtlamalar: maxItems: 1 |
Hayı | |
| type | enum | Her zaman 'fabric_dataagent_preview' olan nesne türü. Olası değerler: fabric_dataagent_preview |
Evet |
ModelDeployment
Model Dağıtım Tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| capabilities | object (salt okunur) | Dağıtılan modelin yetenekleri | Evet | |
| connectionName (bağlantıadı) | dize (salt okunur) | Dağıtımın geldiği bağlantının adı | Hayı | |
| modelName | dize (salt okunur) | Publisher'a özgü olarak kullanılan modelin adı | Evet | |
| modelPublisher | dize (salt okunur) | Dağıtılan modelin publisher | Evet | |
| modelVersion | dize (salt okunur) | Publisher'a özgü dağıtım modeli | Evet | |
| name | dize (salt okunur) | Dağıtımın adı | Evet | |
| sku | Sku (salt okunur) | Sku bilgileri | Evet | |
| └─ kapasite | tamsayı | Sku kapasitesi | Evet | |
| └─ aile | String | Sku ailesi | Evet | |
| └─ ad | String | Sku adı | Evet | |
| └─ boyutu | String | Sku boyutu | Evet | |
| └─ katmanı | String | Sku katmanı | Evet | |
| type | enum | Dağıtımın türü Olası değerler: ModelDeployment |
Evet |
ModelÖrnekLemeParamları
Metin oluşturma sırasında dil modelinin örnekleme davranışını denetlemek için kullanılan bir parametre kümesini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_completion_tokens | tamsayı | Tamamlanmada izin verilen en fazla belirteç sayısı. | Evet | |
| seed | tamsayı | Yeniden üretilebilirlik için rastgele tohum. | Evet | |
| sıcaklık | Numara | Örnekleme için sıcaklık parametresi. | Evet | |
| top_p | Numara | Çekirdek örnekleme için top-p parametresi. | Evet |
ModelSamplingParamsUpdate
Metin oluşturma sırasında dil modelinin örnekleme davranışını denetlemek için kullanılan bir parametre kümesini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_completion_tokens | tamsayı | Tamamlanmada izin verilen en fazla belirteç sayısı. | Hayı | |
| seed | tamsayı | Yeniden üretilebilirlik için rastgele tohum. | Hayı | |
| sıcaklık | Numara | Örnekleme için sıcaklık parametresi. | Hayı | |
| top_p | Numara | Çekirdek örnekleme için top-p parametresi. | Hayı |
MonthlyRecurrenceSchedule
Aylık yinelenme zamanlaması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| daysOfMonth | tamsayı dizisi | Yinelenme zamanlaması için ayın günleri. | Evet | |
| type | enum | Aylık yinelenme türü. Olası değerler: Monthly |
Evet |
NoAuthenticationCredentials
Kimlik doğrulaması gerektirmeyen kimlik bilgileri
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Kimlik bilgisi türü Olası değerler: None |
Evet |
OAuthConsentRequestOutputItem
Hizmetten kullanıcının OAuth onayı gerçekleştirmesini isteyin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| consent_link | String | Kullanıcının OAuth onayı gerçekleştirmek için kullanabileceği bağlantı. | Evet | |
| kimlik | String | Evet | ||
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| sunucu etiketi | String | OAuth onay isteğinin sunucu etiketi. | Evet | |
| type | enum | Olası değerler: oauth_consent_request |
Evet |
OneTimeTrigger
Tek seferlik tetikleyici.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| timeZone | String | Tek seferlik tetikleyici için saat dilimi. | Hayı | UTC (Koordinatlı Evrensel Zaman) |
| triggerAt | String | ISO 8601 biçiminde tek seferlik tetikleyicinin tarih ve saati. | Evet | |
| type | enum | Olası değerler: OneTime |
Evet |
OpenAI.Annotation
Çıkış metninin yayılma alanına uygulanan bir ek açıklama.
OpenAI.Annotation için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
file_citation |
OpenAI.FileCitationBody |
url_citation |
OpenAI.UrlCitationBody |
container_file_citation |
OpenAI.ContainerFileCitationBody |
file_path |
OpenAI.FilePath |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.AnnotationType | Evet |
OpenAI.AnnotationType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | file_citationurl_citationcontainer_file_citationfile_path |
OpenAI.ApplyPatchCallOutputStatus
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | completedfailed |
OpenAI.ApplyPatchCallOutputStatusParam
apply_patch araç çağrısı çıktıları için raporlanan sonuç değerleri.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | completedfailed |
OpenAI.ApplyPatchCallStatus
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompleted |
OpenAI.ApplyPatchCallStatusParam
apply_patch araç çağrıları için raporlanan durum değerleri.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompleted |
OpenAI.ApplyPatchCreateFileOperation
apply_patch aracı aracılığıyla dosya oluşturmayı açıklayan yönerge.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Fark | String | Uygulanacak fark. | Evet | |
| path | String | Oluşturulacak dosyanın yolu. | Evet | |
| type | enum | Sağlanan fark ile yeni bir dosya oluşturun. Olası değerler: create_file |
Evet |
OpenAI.ApplyPatchCreateFileOperationParam
apply_patch aracı aracılığıyla yeni bir dosya oluşturma talimatı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Fark | String | Dosya oluşturulurken uygulanacak birleşik farklı içerikler. Kısıtlamalar: maxLength: 10485760 |
Evet | |
| path | String | Dosyanın çalışma alanı köküne göre oluşturulacak yolu. Kısıtlamalar: minLength: 1 |
Evet | |
| type | enum | İşlem türü. Her zaman create_file.Olası değerler: create_file |
Evet |
OpenAI.ApplyPatchDeleteFileOperation
apply_patch aracı aracılığıyla bir dosyanın nasıl silineceği hakkında yönergeler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| path | String | Silinecek dosyanın yolu. | Evet | |
| type | enum | Belirtilen dosyayı silin. Olası değerler: delete_file |
Evet |
OpenAI.ApplyPatchDeleteFileOperationParam
apply_patch aracı aracılığıyla mevcut bir dosyayı silme talimatı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| path | String | Dosyanın çalışma alanı köküne göre silme yolu. Kısıtlamalar: minLength: 1 |
Evet | |
| type | enum | İşlem türü. Her zaman delete_file.Olası değerler: delete_file |
Evet |
OpenAI.ApplyPatchFileOperation
apply_patch aracılığıyla uygulanan create_file, delete_file veya update_file işlemlerinden biri.
OpenAI.ApplyPatchFileOperation için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
create_file |
OpenAI.ApplyPatchCreateFileOperation |
delete_file |
OpenAI.ApplyPatchDeleteFileOperation |
update_file |
OpenAI.ApplyPatchUpdateFileOperation |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ApplyPatchFileOperationType | Evet |
OpenAI.ApplyPatchFileOperationType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | create_filedelete_fileupdate_file |
OpenAI.ApplyPatchOperationParam
apply_patch aracına sağlanan create_file, delete_file veya update_file işlemlerden biri.
OpenAI.ApplyPatchOperationParam için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
create_file |
OpenAI.ApplyPatchCreateFileOperationParam |
delete_file |
OpenAI.ApplyPatchDeleteFileOperationParam |
update_file |
OpenAI.ApplyPatchUpdateFileOperationParam |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ApplyPatchOperationParamType | Evet |
OpenAI.ApplyPatchOperationParamType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | create_filedelete_fileupdate_file |
OpenAI.ApplyPatchToolParam
Asistanın dosyaları birleşik farklılıklar kullanarak oluşturmasına, silmesine veya güncellemesine olanak tanır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Aracın türü. Her zaman apply_patch.Olası değerler: apply_patch |
Evet |
OpenAI.ApplyPatchUpdateFileOperation
apply_patch aracı aracılığıyla bir dosyanın nasıl güncelleştirileceklerini açıklayan yönerge.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Fark | String | Uygulanacak fark. | Evet | |
| path | String | Güncelleştirilecek dosyanın yolu. | Evet | |
| type | enum | Mevcut bir dosyayı sağlanan farkla güncelleştirin. Olası değerler: update_file |
Evet |
OpenAI.ApplyPatchUpdateFileOperationParam
apply_patch aracı aracılığıyla mevcut bir dosyayı güncelleme talimatı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Fark | String | Mevcut dosyaya uygulanacak birleşik farklı içerikler. Kısıtlamalar: maxLength: 10485760 |
Evet | |
| path | String | Dosyanın çalışma alanı köküne göre güncellenme yolu. Kısıtlamalar: minLength: 1 |
Evet | |
| type | enum | İşlem türü. Her zaman update_file.Olası değerler: update_file |
Evet |
OpenAI.YaklaşıkKonum
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| city | dize (null atanabilir) | Hayı | ||
| country | dize (null atanabilir) | Hayı | ||
| region | dize (null atanabilir) | Hayı | ||
| timezone | dize (null atanabilir) | Hayı | ||
| type | enum | Konum yaklaşımının türü. Her zaman approximate.Olası değerler: approximate |
Evet |
OpenAI Sohbet Tamamlama Aracı
Yanıt oluşturmak için kullanılabilecek bir işlev aracı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| function | OpenAI.FunctionObject | Evet | ||
| type | enum | Aracın türü. Şu anda yalnızca function desteklenmektedir.Olası değerler: function |
Evet |
OpenAI.ChatModel
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | leftrightwheelbackforward |
OpenAI.ClickParam
Tıklama eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| düğme | OpenAI.ClickButtonType | Evet | ||
| type | enum | Olay türünü belirtir. Tıklama hareketi için bu özellik her clickzaman .Olası değerler: click |
Evet | |
| x | OpenAI.integer | Evet | ||
| y | OpenAI.integer | Evet |
OpenAI.CodeInterpreterContainerAuto
Kod yorumlayıcı kapsayıcısı için yapılandırma. İsteğe bağlı olarak kodun çalıştırıldığı dosyaların kimliklerini belirtin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dosya_kimlikleri | dize dizisi | Kodunuz için kullanılabilir hale getirmek üzere yüklenen dosyaların isteğe bağlı bir listesi. | Hayı | |
| bellek sınırı | OpenAI.ContainerMemoryLimit (null atanabilir) | Hayı | ||
| type | enum | Her zaman auto.Olası değerler: auto |
Evet |
OpenAI.CodeInterpreterOutputImage
Kod yorumlayıcıdan görüntü çıkışı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Çıktının türü. Her zaman image.Olası değerler: image |
Evet | |
| url | String | Kod yorumlayıcıdan görüntü çıkışının URL'si. | Evet |
OpenAI.CodeInterpreterOutputLogs
Günlükler kod yorumlayıcıdan çıkar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| logs | String | Günlükler kod yorumlayıcıdan çıkar. | Evet | |
| type | enum | Çıktının türü. Her zaman logs.Olası değerler: logs |
Evet |
OpenAI.CodeInterpreterTool
Bir istem için yanıt oluşturmaya yardımcı olmak için Python kodu çalıştıran bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| container | string veya OpenAI.CodeInterpreterContainerAuto | Kod yorumlayıcı kapsayıcısı. Kapsayıcı kimliği veya bir nesne olabilir , kodunuz için kullanılabilir hale getirmek için karşıya yüklenen dosya kimliklerini ve bir isteğe bağlı memory_limit ayarına bakın.Sağlanmadıysa, hizmet otomatik olarak kabul edilir. |
Hayı | |
| type | enum | Kod yorumlayıcı aracının türü. Her zaman code_interpreter.Olası değerler: code_interpreter |
Evet |
OpenAI.CompactResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Sıkıştırılmış konuşmanın oluşturulduğu Unix zaman damgası (saniye). | Evet | |
| kimlik | String | Sıkıştırılmış yanıtın benzersiz tanımlayıcısı. | Evet | |
| nesne | enum | Nesne türü. Her zaman response.compaction.Olası değerler: response.compaction |
Evet | |
| çıktı | OpenAI.OutputItem dizisi | Sıkıştırılmış çıkış öğeleri listesi. Bu, tüm kullanıcı iletilerinin ve ardından tek bir sıkıştırma öğesinin listesidir. | Evet | |
| usage | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Evet | |
| └─ girdi_simgeleri | OpenAI.integer | Giriş belirteçlerinin sayısı. | Evet | |
| └─ giriş_jeton_detayları | OpenAI.ResponseUsageInputTokensDetails | Giriş belirteçlerinin ayrıntılı dökümü. | Evet | |
| └─ çıkış_birimleri | OpenAI.integer | Çıkış belirteçlerinin sayısı. | Evet | |
| └─ output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Çıkış belirteçlerinin ayrıntılı dökümü. | Evet | |
| └─ toplam_jetonlar | OpenAI.integer | Kullanılan toplam belirteç sayısı. | Evet |
OpenAI.CompactResponseMethodPublicBody
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | OpenAI.InputItem dizesi veya dizisi | Hayı | ||
| instructions | dize (null atanabilir) | Hayı | ||
| model | OpenAI.ModelIdsCompaction | veya gpt-5gibi o3 yanıtı oluşturmak için kullanılan model kimliği. OpenAI farklı özelliklere, performans özelliklerine ve fiyat noktalarına sahip çok çeşitli modeller sunar. Kullanılabilir modellere göz atmak ve modelleri karşılaştırmak için model kılavuzuna bakın. |
Evet | |
| previous_response_id | dize (null atanabilir) | Hayı |
OpenAI.KıyaslamaFiltresi
Tanımlı bir karşılaştırma işlemi kullanarak belirtilen öznitelik anahtarını belirli bir değerle karşılaştırmak için kullanılan filtre.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| key | String | Değerle karşılaştırmak için anahtar. | Evet | |
| type | enum | Karşılaştırma operatörünü belirtir: eq, ne, gt, gteltlteinnin.- eq:Eşit -tir- ne: eşit değil- gt: büyüktür- gte: büyüktür veya eşittir- lt: daha azdır- lte: küçüktür veya eşittir- in:Inç- nin: içinde değilOlası değerler: eq, ne, gt, gte, , lt, lte |
Evet | |
| değer | dize veya OpenAI.numeric ya da boole ya da OpenAI.ComparisonFilterValueItems dizisi | Öznitelik anahtarıyla karşılaştıracak değer; dize, sayı veya boole türlerini destekler. | Evet |
OpenAI.ComparisonFilterValueItems
Tür: dize veya OpenAI.numeric
OpenAI.CompoundFilter
and veya or kullanarak birden çok filtreyi birleştirin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| filters | OpenAI.ComparisonFilter dizisi veya nesnesi | Birleştirilecek filtreler dizisi. Öğeler ComparisonFilter veya CompoundFilter olabilir. |
Evet | |
| type | enum | İşlem türü: and veya or.Olası değerler: and, or |
Evet |
OpenAI.ComputerAction
OpenAI.ComputerAction için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
click |
OpenAI.ClickParam |
double_click |
OpenAI.DoubleClickAction |
drag |
OpenAI.Drag |
keypress |
OpenAI.KeyPressAction |
move |
OpenAI.Move |
screenshot |
OpenAI.Ekran Görüntüsü |
scroll |
OpenAI.Scroll |
type |
OpenAI.Type |
wait |
OpenAI.Wait |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ComputerActionType | Evet |
OpenAI.ComputerActionType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | clickdouble_clickdragkeypressmovescreenshotscrolltypewait |
OpenAI.ComputerCallSafetyCheckParam
Bilgisayar çağrısı için bekleyen bir güvenlik denetimi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | dize (null atanabilir) | Hayı | ||
| kimlik | String | Bekleyen güvenlik denetiminin kimliği. | Evet | |
| mesaj | dize (null atanabilir) | Hayı |
OpenAI.ComputerEnvironment
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | windowsmaclinuxubuntubrowser |
OpenAI.ComputerScreenshotContent
Bilgisayarın ekran görüntüsü.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dosya_kimlik | dize (null atanabilir) | Evet | ||
| image_url | String | Evet | ||
| type | enum | Olay türünü belirtir. Bilgisayar ekran görüntüsü için bu özellik her zaman olarak computer_screenshotayarlanır.Olası değerler: computer_screenshot |
Evet |
OpenAI.ComputerScreenshotImage
Bilgisayar kullanım aracıyla kullanılan bir bilgisayar ekran görüntüsü.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dosya_kimlik | String | Yüklenmiş dosyanın, ekran görüntüsünü içeren kimliği. | Hayı | |
| image_url | String | Ekran görüntüsü URL'si. | Hayı | |
| type | enum | Olay türünü belirtir. Bir bilgisayar ekran görüntüsü için bu özellik şu şekildedir: her zaman computer_screenshot olarak ayarlanır.Olası değerler: computer_screenshot |
Evet |
OpenAI Bilgisayar Kullanımı Önizleme Aracı
Sanal bilgisayarı denetleyebilen bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| görüntü yüksekliği | OpenAI.integer | Evet | ||
| görüntü genişliği | OpenAI.integer | Evet | ||
| environment | OpenAI.ComputerEnvironment | Evet | ||
| type | enum | Bilgisayar kullanım aracının türü. Her zaman computer_use_preview.Olası değerler: computer_use_preview |
Evet |
OpenAI.ContainerFileCitationBody
Model yanıtı oluşturmak için kullanılan bir konteyner dosyası için bir atıf.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| container_id | String | Konteyner dosyasının kimliği. | Evet | |
| end_index | OpenAI.integer | Evet | ||
| dosya_kimlik | String | Dosyanın kimliği. | Evet | |
| filename | String | Bahsedilen konteyner dosyasının dosya adı. | Evet | |
| start_index | OpenAI.integer | Evet | ||
| type | enum | Konteyner dosyası atıfının türü. Her zaman container_file_citation.Olası değerler: container_file_citation |
Evet |
OpenAI.ContainerMemoryLimit
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 1g4g16g64g |
OpenAI.ConversationItem
Konuşma içinde tek bir öğe. Olası türler kümesi, output türüyle aynıdır.
OpenAI.ConversationItem için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ConversationItemType | Evet |
OpenAI.ConversationItemApplyPatchToolCall
Dosya oluşturarak, silerek veya güncelleştirerek dosya farklarını uygulayan bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu araç çağrısını oluşturan varlığın kimliği. | Hayı | |
| kimlik | String | Düzeltme eki uygulama aracı çağrısının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| Operasyon | OpenAI.ApplyPatchFileOperation | apply_patch aracılığıyla uygulanan create_file, delete_file veya update_file işlemlerinden biri. | Evet | |
| └─ türü | OpenAI.ApplyPatchFileOperationType | Evet | ||
| durum | OpenAI.ApplyPatchCallStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman apply_patch_call.Olası değerler: apply_patch_call |
Evet |
OpenAI.ConversationItemApplyPatchToolCallOutput
Bir düzeltme eki uygulama aracı çağrısı tarafından yayılan çıkış.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu aracı oluşturan varlığın kimliği çağrı çıktısı. | Hayı | |
| kimlik | String | Düzeltme eki uygulama aracı çağrı çıkışının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| durum | OpenAI.ApplyPatchCallOutputStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman apply_patch_call_output.Olası değerler: apply_patch_call_output |
Evet |
OpenAI.ConversationItemCodeInterpreterToolCall
Kodu çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | dize (null atanabilir) | Evet | ||
| container_id | String | Kodu çalıştırmak için kullanılan kapsayıcının kimliği. | Evet | |
| kimlik | String | Kod yorumlayıcısı araç çağrısının benzersiz kimliği. | Evet | |
| Çıktılar | OpenAI.CodeInterpreterOutputLogs veya OpenAI.CodeInterpreterOutputImage dizisi | Evet | ||
| durum | enum | Kod yorumlayıcı aracı çağrısının durumu. Geçerli değerler : in_progress, completed, incomplete, interpretingve failed.Olası değerler: in_progress, completed, incomplete, interpreting, failed |
Evet | |
| type | enum | Kod yorumlayıcı aracı çağrısının türü. Her zaman code_interpreter_call.Olası değerler: code_interpreter_call |
Evet |
OpenAI.ConversationItemComputerToolCall
Bilgisayar kullanım araçlarına bir araç komutu verme. Daha fazla bilgi için bilgisayar kullanım rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.ComputerAction | Evet | ||
| call_id | String | Çıkış verisi ile araç çağrısına yanıt verirken kullanılan tanımlayıcı. | Evet | |
| kimlik | String | Bilgisayar çağrısının benzersiz tanımlayıcısı. | Evet | |
| pending_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Bilgisayar çağrısı için bekleyen güvenlik denetimleri. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Bilgisayar çağrısının türü. Her zaman computer_call.Olası değerler: computer_call |
Evet |
OpenAI.ConversationItemComputerToolCallOutputResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| acknowledged_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | API tarafından bildirilen ve kabul edilen güvenlik kontrolleri geliştirici. |
Hayı | |
| call_id | String | Çıktı üreten bilgisayar aracı çağrısının kimliği. | Evet | |
| kimlik | String | Bilgisayar aracı çağrısı çıkış kimliği. | Hayı | |
| çıktı | OpenAI.ComputerScreenshotImage | Bilgisayar kullanım aracıyla kullanılan bir bilgisayar ekran görüntüsü. | Evet | |
| durum | enum | İleti girişinin durumu.
in_progress, completed, veya bunlardan biriincomplete. API aracılığıyla giriş öğeleri döndürüldüğünde doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | Bilgisayar araçlarının çağrı çıktısının türü. Her zaman computer_call_output.Olası değerler: computer_call_output |
Evet |
OpenAI.ConversationItemCustomToolCall
Model tarafından oluşturulan özel bir araca çağrı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Bu özel araç çağrısını bir araç çağrısı çıktısına eşlemek için kullanılan bir tanımlayıcı. | Evet | |
| kimlik | String | OpenAI platformundaki özel araç çağrısının benzersiz kimliği. | Hayı | |
| girdi | String | Model tarafından oluşturulan özel araç çağrısı için girdi. | Evet | |
| name | String | Çağrılan özel aracın adı. | Evet | |
| type | enum | Özel araç çağrısının türü. Her zaman custom_tool_call.Olası değerler: custom_tool_call |
Evet |
OpenAI.ConversationItemCustomToolCallOutput
Kodunuzdan özel bir araç çağrısının çıktısı, modele geri gönderiliyor.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Çağrı kimliği, bu özel araç çağrısı çıktısını özel bir araç çağrısına eşlemek için kullanılır. | Evet | |
| kimlik | String | OpenAI platformunda çıkan özel araç çağrısının benzersiz kimliği. | Hayı | |
| çıktı | OpenAI.FunctionAndCustomToolCallOutput dizesi veya dizisi | Kodunuz tarafından oluşturulan özel araç çağrısından çıkan çıktı. Bir dizi veya çıkış içeriği listesi olabilir. |
Evet | |
| type | enum | Özel araç çağrısı çıkışının türü. Her zaman custom_tool_call_output.Olası değerler: custom_tool_call_output |
Evet |
OpenAI.ConversationItemFileSearchToolCall
Dosya arama aracı çağrısının sonuçları. Daha fazla bilgi için dosya arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Dosya arama aracı çağrısının benzersiz kimliği. | Evet | |
| queries | dize dizisi | Dosyaları aramak için kullanılan sorgular. | Evet | |
| results | OpenAI.FileSearchToolCallResults dizisi | Hayı | ||
| durum | enum | Dosya arama aracı çağrısının durumu. Bunlardan biri in_progresssearching, incomplete veya failed,Olası değerler: in_progress, searching, completed, incomplete, failed |
Evet | |
| type | enum | Dosya arama aracı çağrısının türü. Her zaman file_search_call.Olası değerler: file_search_call |
Evet |
OpenAI.ConversationItemFunctionShellCall
Yönetilen bir ortamda bir veya daha fazla kabuk komutu yürüten bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.FunctionShellAction | Bir kabuk komutu yürütür. | Evet | |
| └─ komutları | dize dizisi | Evet | ||
| └─ max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| └─ timeout_ms | OpenAI.integer (null atanabilir) | Evet | ||
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu araç çağrısını oluşturan varlığın kimliği. | Hayı | |
| kimlik | String | Kabuk aracı çağrısının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| durum | OpenAI.LocalShellCallStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman shell_call.Olası değerler: shell_call |
Evet |
OpenAI.ConversationItemFunctionShellCallOutput
Yayılan bir kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Öğeyi oluşturan aktörün tanımlayıcısı. | Hayı | |
| kimlik | String | Kabuk çağrısı çıkışının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| çıktı | OpenAI.FunctionShellCallOutputContent dizisi | Kabuk çağrısı çıkış içeriği dizisi | Evet | |
| type | enum | Kabuk çağrısı çıkışının türü. Her zaman shell_call_output.Olası değerler: shell_call_output |
Evet |
OpenAI.ConversationItemFunctionToolCallOutputResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracının çağrı çıkışının benzersiz kimliği. Bu öğe doldurulduğunda API aracılığıyla döndürülür. |
Hayı | |
| çıktı | OpenAI.FunctionAndCustomToolCallOutput dizesi veya dizisi | Kodunuz tarafından oluşturulan işlev çağrısının çıktısı. Bir dizi veya çıkış içeriği listesi olabilir. |
Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracının çağrı çıktısının türü. Her zaman function_call_output.Olası değerler: function_call_output |
Evet |
OpenAI.ConversationItemFunctionToolCallResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | İşleve geçirecek bağımsız değişkenlerin JSON dizesi. | Evet | |
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracı çağrısının benzersiz kimliği. | Hayı | |
| name | String | Çalıştırılacak işlevin adı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracı çağrısının türü. Her zaman function_call.Olası değerler: function_call |
Evet |
OpenAI.ConversationItemImageGenToolCall
Model tarafından yapılan bir görüntü oluşturma isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Görüntü oluşturma çağrısının benzersiz kimliği. | Evet | |
| sonuç | dize (null atanabilir) | Evet | ||
| durum | enum | Görüntü oluşturma çağrısının durumu. Olası değerler: in_progress, completed, generating, failed |
Evet | |
| type | enum | Görüntü oluşturma çağrısının türü. Her zaman image_generation_call.Olası değerler: image_generation_call |
Evet |
OpenAI.ConversationItemList
Konuşma öğelerinin listesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veriler | OpenAI.ConversationItem dizisi | Konuşma öğelerinin listesi. | Evet | |
| ilk_kimlik | String | Listedeki ilk öğenin kimliği. | Evet | |
| daha_fazla | Boolean | Kullanılabilir daha fazla öğe olup olmadığı. | Evet | |
| son_kimlik | String | Listedeki son öğenin kimliği. | Evet | |
| nesne | enum | Döndürülen nesnenin türü olmalıdır list.Olası değerler: list |
Evet |
OpenAI.ConversationItemLocalShellToolCall
Yerel kabukta komut çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.LocalShellExecAction | Sunucuda bir kabuk komutu yürütür. | Evet | |
| call_id | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | Yerel shell çağrısının benzersiz kimliği. | Evet | |
| durum | enum | Yerel shell çağrısının durumu. Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Yerel shell call'ın türü. Her zaman local_shell_call.Olası değerler: local_shell_call |
Evet |
OpenAI.ConversationItemLocalShellToolCallOutput
Yerel kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| çıktı | String | Yerel kabuk aracı çağrısının çıkışının JSON dizesi. | Evet | |
| durum | enum | Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | Yerel kabuk aracı çağrı çıkışının türü. Her zaman local_shell_call_output.Olası değerler: local_shell_call_output |
Evet |
OpenAI.ConversationItemMcpApprovalRequest
Bir araç çağrısı işlemi için insan onayı isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | Araç için bir JSON bağımsız değişken dizesi. | Evet | |
| kimlik | String | Onay talebinin benzersiz kimliği. | Evet | |
| name | String | Çalıştırılacak aracın adı. | Evet | |
| sunucu etiketi | String | İsteği yapan MCP sunucusunun etiketi. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_approval_request.Olası değerler: mcp_approval_request |
Evet |
OpenAI.ConversationItemMcpApprovalResponseResource
MCP onay isteğine yanıt.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | String | Yanıtlanan onay isteğinin ID'si. | Evet | |
| approve | Boolean | İsteğin onaylanıp onaylanmadı. | Evet | |
| kimlik | String | Onay yanıtının benzersiz kimliği | Evet | |
| sebep | dize (null atanabilir) | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_approval_response.Olası değerler: mcp_approval_response |
Evet |
OpenAI.ConversationItemMcpListTools
MCP sunucusunda kullanılabilen araçların listesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Listenin benzersiz kimliği. | Evet | |
| sunucu etiketi | String | MCP sunucusunun etiketi. | Evet | |
| araçlar | OpenAI.MCPListToolsTool dizisi | Sunucuda bulunan araçlar. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_list_tools.Olası değerler: mcp_list_tools |
Evet |
OpenAI.ConversationItemMcpToolCall
MCP sunucusundaki bir aracın çağrılması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | dize (null atanabilir) | Hayı | ||
| arguments | String | Araca geçirilen bağımsız değişkenlerin JSON dizesi. | Evet | |
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Araç çağrısının benzersiz kimliği. | Evet | |
| name | String | Çalıştırılan aracın adı. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| sunucu etiketi | String | Aracı çalıştıran MCP sunucusunun etiketi. | Evet | |
| durum | OpenAI.MCPToolCallStatus | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_call.Olası değerler: mcp_call |
Evet |
OpenAI.ConversationItemMessage
Modele veya modelden gelen bir ileti.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.MessageContent dizisi | İletinin içeriği | Evet | |
| kimlik | String | İletinin benzersiz kimliği. | Evet | |
| role | OpenAI.MessageRole | Evet | ||
| durum | OpenAI.MessageStatus | Evet | ||
| type | enum | İletinin türü. Her zaman messageolarak ayarlayın.Olası değerler: message |
Evet |
OpenAI.ConversationItemReasoningItem
Bir yanıt oluştururken bir akıl yürütme modeli tarafından kullanılan düşünce zincirinin açıklaması. Eğer konuşmanın sonraki turlarında bu öğeleri bağlam yönetiyorsanız ile manuel olarak konuşuyorsanız, Responses API'ye input hesabınıza dahil edin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.ReasoningTextContent dizisi | Metin içeriğini akıl yürütme. | Hayı | |
| encrypted_content | dize (null atanabilir) | Hayı | ||
| kimlik | String | Akıl yürütme içeriğinin benzersiz tanımlayıcısı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| summary | OpenAI.Summary dizisi | Akıl yürütme özeti içeriği. | Evet | |
| type | enum | Nesnenin türü. Her zaman reasoning.Olası değerler: reasoning |
Evet |
OpenAI.ConversationItemType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Bir web arama aracı çağrısının sonuçları. Daha fazla bilgi için web arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.WebSearchActionSearch veya OpenAI.WebSearchActionOpenPage veya OpenAI.WebSearchActionFind | Bu web arama çağrısında gerçekleştirilen belirli eylemi açıklayan bir nesne. Modelin web'i nasıl kullandığına ilişkin ayrıntıları içerir (arama, open_page, bulma). |
Evet | |
| kimlik | String | Web arama aracının benzersiz kimliği çağrı. | Evet | |
| durum | enum | Web arama aracı çağrısının durumu. Olası değerler: in_progress, searching, completed, failed |
Evet | |
| type | enum | Web arama aracının türü. Her zaman web_search_call.Olası değerler: web_search_call |
Evet |
OpenAI.ConversationParam
Bu yanıtın ait olduğu konuşma. Bu konuşmadaki öğeler, bu yanıt isteği için öğesine input_items eklenir.
Bu yanıt tamamlandıktan sonra bu yanıttaki giriş öğeleri ve çıkış öğeleri otomatik olarak bu konuşmaya eklenir.
Tür: dize veya OpenAI.ConversationParam-2
Bu yanıtın ait olduğu konuşma. Bu konuşmadaki öğeler, bu yanıt isteği için öğesine input_items eklenir.
Bu yanıt tamamlandıktan sonra bu yanıttaki giriş öğeleri ve çıkış öğeleri otomatik olarak bu konuşmaya eklenir.
OpenAI.ConversationParam-2
Bu yanıtın ait olduğu konuşma.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Konuşmanın benzersiz kimliği. | Evet |
OpenAI.ConversationReference
Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Bu yanıtın ilişkilendirildiği konuşmanın benzersiz kimliği. | Evet |
OpenAI.ConversationResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Unix döneminin ardından saniye cinsinden ölçülen konuşmanın oluşturulduğu zaman. | Evet | |
| kimlik | String | Konuşmanın benzersiz kimliği. | Evet | |
| metadata | OpenAI.Metadata | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Evet | |
| nesne | enum | Her zaman conversationolan nesne türü.Olası değerler: conversation |
Evet |
OpenAI.CreateChatCompletionRequestResponseFormat
Modelin çıkış yapması gereken biçimi belirten bir nesne.
ayarı, { "type": "json_schema", "json_schema": {...} } modelin sağlanan JSON şemanızla eşleşmesini sağlayan Yapılandırılmış Çıkışları etkinleştirir.
Structured Outputs rehberi için daha fazla bilgi edinebilirsiniz.
ayarı { "type": "json_object" } , modelin oluşturduğu iletinin geçerli JSON olduğundan emin olan eski JSON modunu etkinleştirir. Destekleyen modeller için json_schema kullanılması tercih edilir.
OpenAI.CreateChatCompletionRequestResponseFormat için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
text |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatText |
json_object |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatJsonObject |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.CreateChatCompletionRequestResponseFormatType | Evet |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatJsonObject
JSON nesne yanıt biçimi. JSON yanıtları oluşturmanın eski bir yöntemi.
Bunu destekleyen modeller için kullanılması json_schema önerilir. Modelin, bir sistem veya kullanıcı mesajı olmadan JSON oluşturmayacağını unutmayın, bunu to do etmelidir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman json_object.Olası değerler: json_object |
Evet |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatText
Varsayılan yanıt biçimi. Metin yanıtları oluşturmak için kullanılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman text.Olası değerler: text |
Evet |
OpenAI.CreateChatCompletionRequestResponseFormatType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | textjson_schemajson_object |
OpenAI.CreateConversationBody
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nesneler | OpenAI.InputItem dizisi | Hayı | ||
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı |
OpenAI.CreateEvalCompletionsRunDataSource
Model örnekleme yapılandırmasını açıklayan CompletionsRunDataSource nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| input_mesajları | OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesTemplate veya OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference | Modelden örnekleme yaparken kullanılır. Modele geçirilen iletilerin yapısını dikte eder. Önceden oluşturulmuş bir yörüngeye (örn item.input_trajectory. ) başvuru veya ad alanına değişken başvuruları item içeren bir şablon olabilir. |
Hayı | |
| model | String | Tamamlanmaları oluşturmak için kullanılacak modelin adı (örneğin, "o3-mini"). | Hayı | |
| Örnekleme_Parametreleri | OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams | Hayı | ||
| kaynak | OpenAI.EvalJsonlFileContentSource veya OpenAI.EvalJsonlFileIdSource veya OpenAI.EvalStoredCompletionsSource | Bu çalıştırmanın veri kaynağındaki ad alanını item neyin dolduracaklarını belirler. |
Evet | |
| type | enum | Çalıştırma veri kaynağının türü. Her zaman completions.Olası değerler: completions |
Evet |
OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_reference | String | Evet | ||
| type | enum | Olası değerler: item_reference |
Evet |
OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesTemplate
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| şablon | OpenAI.EasyInputMessage veya OpenAI.EvalItem dizisi | Evet | ||
| type | enum | Olası değerler: template |
Evet |
OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_completion_tokens | OpenAI.integer | Hayı | ||
| akıl yürütme çabası | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| yanıt formatı | OpenAI.ResponseFormatText veya OpenAI.ResponseFormatJsonSchema veya OpenAI.ResponseFormatJsonObject | Hayı | ||
| seed | OpenAI.integer | Hayı | 42 | |
| sıcaklık | OpenAI.numeric | Hayı | 1 | |
| araçlar | OpenAI.ChatCompletionTool dizisi | Hayı | ||
| top_p | OpenAI.numeric | Hayı | 1 |
OpenAI.CreateEvalCustomDataSourceConfig
Değerlendirme çalıştırmaları için kullanılan veri kaynağının şemasını tanımlayan customDataSourceConfig nesnesi. Bu şema, aşağıdaki verilerin şeklini tanımlamak için kullanılır:
- Test ölçütlerinizi tanımlamak için kullanılır ve
- Çalıştırma oluştururken hangi veriler gereklidir?
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| örnek_şema_dahil_et | Boolean | Değerlendirmenin örnek ad alanını doldurmanızı beklemesi gerekip gerekmediği (örneğin, veri kaynağınızdan yanıt oluşturarak) | Hayı | |
| öğe şeması | nesne | Veri kaynağındaki her satır için json şeması. | Evet | |
| type | enum | Veri kaynağının türü. Her zaman custom.Olası değerler: custom |
Evet |
OpenAI.CreateEvalJsonlRunDataSource
Değerlendirmeyle eşleşen JSONL dosyasını belirten bir JsonlRunDataSource nesnesi
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kaynak | OpenAI.EvalJsonlFileContentSource veya OpenAI.EvalJsonlFileIdSource | Veri kaynağındaki ad alanını item neyin doldurdığını belirler. |
Evet | |
| type | enum | Veri kaynağının türü. Her zaman jsonl.Olası değerler: jsonl |
Evet |
OpenAI.CreateEvalLogsDataSourceConfig
Günlükler sorgunuzun meta veri özelliğini belirten bir veri kaynağı yapılandırması.
Bu genellikle usecase=chatbot, prompt-version=v2 gibi meta veridir vb.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| metadata | nesne | Log veri kaynağı için meta veri filtreleri. | Hayı | |
| type | enum | Veri kaynağının türü. Her zaman logs.Olası değerler: logs |
Evet |
OpenAI.CreateEvalResponsesRunDataSource
Model örnekleme yapılandırmasını açıklayan Bir ResponsesRunDataSource nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| input_mesajları | OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate veya OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference | Modelden örnekleme yaparken kullanılır. Modele geçirilen iletilerin yapısını dikte eder. Önceden oluşturulmuş bir yörüngeye (örn item.input_trajectory. ) başvuru veya ad alanına değişken başvuruları item içeren bir şablon olabilir. |
Hayı | |
| model | String | Tamamlanmaları oluşturmak için kullanılacak modelin adı (örneğin, "o3-mini"). | Hayı | |
| Örnekleme_Parametreleri | OpenAI.CreateEvalResponsesRunDataSourceSamplingParams | Hayı | ||
| kaynak | OpenAI.EvalJsonlFileContentSource veya OpenAI.EvalJsonlFileIdSource veya OpenAI.EvalResponsesSource | Bu çalıştırmanın veri kaynağındaki ad alanını item neyin dolduracaklarını belirler. |
Evet | |
| type | enum | Çalıştırma veri kaynağının türü. Her zaman responses.Olası değerler: responses |
Evet |
OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_reference | String | Evet | ||
| type | enum | Olası değerler: item_reference |
Evet |
OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| şablon | object dizisi veya OpenAI.EvalItem | Evet | ||
| type | enum | Olası değerler: template |
Evet |
OpenAI.CreateEvalResponsesRunDataSourceSamplingParams
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_completion_tokens | OpenAI.integer | Hayı | ||
| akıl yürütme çabası | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| seed | OpenAI.integer | Hayı | 42 | |
| sıcaklık | OpenAI.numeric | Hayı | 1 | |
| text | OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText | Hayı | ||
| araçlar | OpenAI.Tool dizisi | Hayı | ||
| top_p | OpenAI.numeric | Hayı | 1 |
OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Modelin çıkış yapması gereken biçimi belirten bir nesne. Yapılandırma { "type": "json_schema" } , Yapılandırılmış Çıkışları etkinleştirir,modelin sağlanan JSON şemanızla eşleşmesini sağlar. Daha fazla bilgi için Varsayılan biçim { "type": "text" } ek seçenek yoktur.*gpt-4o ve daha yeni modeller için önerilmez:** { "type": "json_object" } ayarı, eski JSON modunu etkinleştirir.modelin oluşturduğu iletinin geçerli JSON olduğundan emin olur. json_schema’ı kullanmaBu özelliği destekleyen modeller için tercih edilir. |
Hayı |
OpenAI.CreateEvalStoredCompletionsDataSourceConfig
LogsDataSourceConfig yerine kullanım dışı bırakıldı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| metadata | nesne | Depolanan tamamlamalar veri kaynağı için meta veri filtreleri. | Hayı | |
| type | enum | Veri kaynağının türü. Her zaman stored_completions.Olası değerler: stored_completions |
Evet |
OpenAI.CreateFineTuningJobRequest
Geçerli modeller:
babbage-002
davinci-002
gpt-3.5-turbo
gpt-4o-mini
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hiper parametreler | OpenAI.CreateFineTuningJobRequestHyperparameters | Hayı | ||
| └─ yığın boyutu | dize veya OpenAI.integer | Hayı | otomatik | |
| └─ öğrenme oranı çarpanı | dize veya OpenAI.numeric | Hayı | ||
| └─ n_epochs | dize veya OpenAI.integer | Hayı | otomatik | |
| Entegrasyonlar | OpenAI.CreateFineTuningJobRequestIntegrations dizisi | İnce ayar işiniz için etkinleştirecek tümleştirmelerin listesi. | Hayı | |
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| method | OpenAI.FineTuneMethod | İnce ayar için kullanılan yöntem. | Hayı | |
| model | dize (aşağıdaki geçerli modellere bakın) | İnce ayar için modelin adı. Aşağıdakilerden birini seçebilirsiniz: destekli modeller. |
Evet | |
| seed | OpenAI.integer (null atanabilir) | Hayı | ||
| suffix | dize (null atanabilir) | İnce ayarlı model adınıza eklenecek en fazla 64 karakterlik bir dize. Örneğin, suffix "özel model-adı" gibi bir model adı ft:gpt-4o-mini:openai:custom-model-name:7p4lURelüretir.Kısıtlamalar: minLength: 1, maxLength: 64 |
Hayı | |
| eğitim_dosyası | String | Eğitim verilerini içeren karşıya yüklenen bir dosyanın kimliği. Karşıya dosya yükleme hakkında bilgi için bkz. dosyayı karşıya yükleme. Veri kümeniz JSONL dosyası olarak biçimlendirilmelidir. Ayrıca, dosyanızı amacı fine-tuneile karşıya yüklemeniz gerekir.Dosyanın içeriği, modelin sohbet, tamamlanma biçimi veya ince ayar yönteminin tercih biçimini kullanıp kullanmama durumuna bağlı olarak farklılık göstermelidir. Daha fazla detay için ince ayar rehberi sayfasına bakınız. |
Evet | |
| doğrulama_dosyası | dize (null atanabilir) | Doğrulama verilerini içeren karşıya yüklenen bir dosyanın kimliği. Bu dosyayı sağlarsanız, veriler doğrulama oluşturmak için kullanılır ölçümlerini ince ayarlama sırasında düzenli aralıklarla gerçekleştirin. Bu ölçümler ince ayar sonuçları dosyası. Aynı veriler hem eğitme hem de doğrulama dosyalarında bulunmamalıdır. Veri kümeniz JSONL dosyası olarak biçimlendirilmelidir. Dosyanızı amacı fine-tuneile karşıya yüklemeniz gerekir.Daha fazla detay için ince ayar rehberi sayfasına bakınız. |
Hayı |
OpenAI.CreateFineTuningJobRequestHyperparameters
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| küme_boyutu | dize veya OpenAI.integer | Hayı | ||
| öğrenme oranı çarpanı | dize veya OpenAI.numeric | Hayı | ||
| n_devir | dize veya OpenAI.integer | Hayı |
OpenAI.CreateFineTuningJobRequestIntegrations
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: wandb |
Evet | |
| wandb | OpenAI.CreateFineTuningJobRequestIntegrationsWandb | Evet |
OpenAI.CreateFineTuningJobRequestIntegrationsWandb
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| varlık | dize (null atanabilir) | Hayı | ||
| name | dize (null atanabilir) | Hayı | ||
| project | String | Evet | ||
| tags | dize dizisi | Hayı |
OpenAI.CreateResponseStreamingResponse
Tür: OpenAI.ResponseAudioDeltaEvent veya OpenAI.ResponseAudioTranscriptDeltaEvent veya OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent veya OpenAI.ResponseCodeInterpreterCallInProgressEvent veya OpenAI.ResponseCodeInterpreterCallInterpretingEvent veya OpenAI.ResponseContentPartAddedEvent veya OpenAI.ResponseCreatedEvent veya OpenAI.ResponseErrorEvent veya OpenAI.ResponseFileSearchCallInProgressEvent veya OpenAI.ResponseFileSearchCallSearchingEvent veya OpenAI.ResponseFunctionCallArgumentsDeltaEvent veya OpenAI.ResponseInProgressEvent veya OpenAI.ResponseFailedEvent veya OpenAI.ResponseIncompleteEvent veya OpenAI.ResponseOutputItemAddedEvent veya OpenAI.ResponseReasoningSummaryPartAddedEvent veya OpenAI.ResponseReasoningSummaryTextDeltaEvent veya OpenAI.ResponseReasoningTextDeltaEvent veya OpenAI.ResponseRefusalDeltaEvent veya OpenAI.ResponseTextDeltaEvent veya OpenAI.ResponseWebSearchCallInProgressEvent veya OpenAI.ResponseWebSearchCallSearchingEvent veya OpenAI.ResponseImageGenCallGeneratingEvent veya OpenAI.ResponseImageGenCallInProgressEvent veya OpenAI.ResponseImageGenCallPartialImageEvent veya OpenAI.ResponseMCPCallArgumentsDeltaEvent veya OpenAI.ResponseMCPCallFailedEvent veya OpenAI.ResponseMCPCallInProgressEvent veya OpenAI.ResponseMCPListToolsFailedEvent veya OpenAI.ResponseMCPListToolsInProgressEvent veya OpenAI.ResponseOutputTextAnnotationAddedEvent veya OpenAI.ResponseQueuedEvent veya OpenAI.ResponseCustomToolCallInputDeltaEvent veya OpenAI.ResponseAudioDoneEvent veya OpenAI.ResponseAudioTranscriptDoneEvent veya OpenAI.ResponseCodeInterpreterCallCodeDoneEvent veya OpenAI.ResponseCodeInterpreterCallCompletedEvent veya OpenAI.ResponseCompletedEvent veya OpenAI.ResponseContentPartDoneEvent veya OpenAI.ResponseFileSearchCallCompletedEvent veya OpenAI.ResponseFunctionCallArgumentsDoneEvent veya OpenAI.ResponseOutputItemDoneEvent veya OpenAI.ResponseReasoningSummaryPartDoneEvent veya OpenAI.ResponseReasoningSummaryTextDoneEvent veya OpenAI.ResponseReasoningTextDoneEvent veya OpenAI.ResponseRefusalDoneEvent veya OpenAI.ResponseTextDoneEvent veya OpenAI.ResponseWebSearchCallCompletedEvent veya OpenAI.ResponseImageGenCallCompletedEvent veya OpenAI.ResponseMCPCallArgumentsDoneEvent veya OpenAI.ResponseMCPCallCompletedEvent veya OpenAI.ResponseMCPListToolsCompletedEvent veya OpenAI.ResponseCustomToolCallInputDoneEvent
OpenAI.CustomGrammarFormatParam
Kullanıcı tarafından tanımlanan bir dilbilgisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | String | Dilbilgisi tanımı. | Evet | |
| syntax | OpenAI.GrammarSyntax1 | Evet | ||
| type | enum | Dilbilgisi formatı. Her zaman grammar.Olası değerler: grammar |
Evet |
OpenAI.CustomTextFormatParam
Sınırsız serbest biçimli metin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Sınırsız metin formatı. Her zaman text.Olası değerler: text |
Evet |
OpenAI.CustomToolParam
Belirli bir formatla girdiyi işleyen özel bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Daha fazla bağlam sağlamak için kullanılan özel aracın isteğe bağlı açıklaması. | Hayı | |
| format | OpenAI.CustomToolParamFormat | Özel araç için giriş formatı. Varsayılan metin sınırsız olur. | Hayı | |
| └─ türü | OpenAI.CustomToolParamFormatType | Evet | ||
| name | String | Özel aracın adı, aracı çağırmalarda tanımlamak için kullanılır. | Evet | |
| type | enum | Özel aracın türü. Her zaman custom.Olası değerler: custom |
Evet |
OpenAI.CustomToolParamFormat
Özel araç için giriş formatı. Varsayılan metin sınırsız olur.
OpenAI.CustomToolParamFormat için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
text |
OpenAI.CustomTextFormatParam |
grammar |
OpenAI.CustomGrammarFormatParam |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.CustomToolParamFormatType | Evet |
OpenAI.CustomToolParamFormatType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | textgrammar |
OpenAI.DeletedConversationResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| silindi | Boolean | Evet | ||
| kimlik | String | Evet | ||
| nesne | enum | Olası değerler: conversation.deleted |
Evet |
OpenAI.DetailEnum
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | lowhighauto |
OpenAI.DoubleClickAction
Çift tıklama eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olay türünü belirtir. Çift tıklama eylemi için bu özellik her zaman olarak double_clickayarlanır.Olası değerler: double_click |
Evet | |
| x | OpenAI.integer | Evet | ||
| y | OpenAI.integer | Evet |
OpenAI.Drag
Sürükleme eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| path | OpenAI.DragPoint dizisi | Sürükleme eyleminin yolunu temsil eden koordinat dizisi. Koordinatlar bir dizi olarak görünür nesnelerin, örneğin <br> [<br> { x: 100, y: 200 },<br> { x: 200, y: 300 }<br> ]<br> |
Evet | |
| type | enum | Olay türünü belirtir. Sürükleme eylemi için bu özellik her zaman drag olarak ayarlanır.Olası değerler: drag |
Evet |
OpenAI.DragPoint
X/y koordinat çifti, örneğin. { x: 100, y: 200 }
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| x | OpenAI.integer | Evet | ||
| y | OpenAI.integer | Evet |
OpenAI.EasyInputMessage
Modele, hiyerarşiyi izleyen yönergeyi belirten bir rol içeren bir ileti girişi.
developer veya system rolüyle verilen yönergeler, user rolüyle verilen yönergelerden önceliklidir.
assistant rolüne sahip iletilerin, önceki etkileşimlerde model tarafından oluşturulduğu varsayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | string veya OpenAI.InputMessageContentList | Yanıt oluşturmak için kullanılan modele metin, görüntü veya ses girişi. Önceki yardımcı yanıtlarını da içerebilir. |
Evet | |
| role | enum | İleti girişinin rolü.
user, assistant, system'den birideveloper.Olası değerler: user, assistant, system, developer |
Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İleti girişinin türü. Her zaman message.Olası değerler: message |
Evet |
OpenAI.Error
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| ek bilgi | nesne | Hayı | ||
| kod | dize (null atanabilir) | Evet | ||
| hata ayıklama bilgisi | nesne | Hayı | ||
| details | OpenAI.Error dizisi | Hayı | ||
| mesaj | String | Evet | ||
| param | dize (null atanabilir) | Hayı | ||
| type | String | Hayı |
OpenAI.EvalApiError
Değerlendirme API'sinden bir hata yanıtını temsil eden nesne.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | String | Hata kodu. | Evet | |
| mesaj | String | Hata iletisi. | Evet |
OpenAI.EvalGraderLabelModel
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | OpenAI.EvalItem dizisi | Evet | ||
| labels | dize dizisi | Değerlendirmedeki her öğeye atanacak etiketler. | Evet | |
| model | String | Değerlendirme için kullanılacak model. Yapılandırılmış çıktıları destekleme zorunluluğu vardır. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| geçen etiketler | dize dizisi | Geçen sonucu belirten etiketler. Etiketlerin bir alt kümesi olmalıdır. | Evet | |
| type | enum | Her zaman label_modelolan nesne türü.Olası değerler: label_model |
Evet |
OpenAI.EvalGraderPython
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| image_tag | String | Python betiği için kullanılacak görüntü etiketi. | Hayı | |
| name | String | Değerlendiricinin adı. | Evet | |
| eşik_geçiş | OpenAI.numeric | Hayı | ||
| kaynak | String | Python betiğinin kaynak kodu. | Evet | |
| type | enum | Her zaman pythonolan nesne türü.Olası değerler: python |
Evet |
OpenAI.EvalGraderScoreModel
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | OpenAI.EvalItem dizisi | Not veren tarafından değerlendirilen giriş iletileri. Metin, çıkış metni, giriş görüntüsü ve giriş ses içerik bloklarını destekler ve şablon dizeleri içerebilir. | Evet | |
| model | String | Değerlendirme için kullanılacak model. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| eşik_geçiş | OpenAI.numeric | Hayı | ||
| menzil | OpenAI.numeric dizisi | Puan aralığı. Varsayılan olarak [0, 1] değerini alır. |
Hayı | |
| Örnekleme_Parametreleri | OpenAI.EvalGraderScoreModelSamplingParams | Hayı | ||
| └─ max_completions_tokens | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ akıl yürütme çabası | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| └─ tohum | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| type | enum | Her zaman score_modelolan nesne türü.Olası değerler: score_model |
Evet |
OpenAI.EvalGraderScoreModelSamplingParams
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| max_completions_tokens | OpenAI.integer (null atanabilir) | Hayı | ||
| akıl yürütme çabası | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| seed | OpenAI.integer (null atanabilir) | Hayı | ||
| sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | ||
| top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 |
OpenAI.EvalGraderStringCheck
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | String | Giriş metni. Bu, şablon dizelerini içerebilir. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| Operasyon | enum | Gerçekleştirilecek dize denetimi işlemi.
eq, ne, like veya ilike.Olası değerler: eq, ne, like, ilike |
Evet | |
| referans | String | Başvuru metni. Bu, şablon dizelerini içerebilir. | Evet | |
| type | enum | Her zaman string_checkolan nesne türü.Olası değerler: string_check |
Evet |
OpenAI.EvalGraderTextSimilarity
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| değerlendirme ölçütü | enum | Kullanılacak değerlendirme ölçümü.
cosine, , fuzzy_match, bleu,gleu, meteor, rouge_1, , rouge_2, rouge_3, rouge_4, rouge_5,veya rouge_l.Olası değerler: cosine, fuzzy_match, bleu, , gleu, meteor, , rouge_1, rouge_2rouge_3, rouge_4rouge_5,rouge_l |
Evet | |
| girdi | String | Notlanan metin. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| eşik_geçiş | OpenAI.numeric | Evet | ||
| referans | String | Değerlendirmenin yapıldığı metin. | Evet | |
| type | enum | Not verenin türü. Olası değerler: text_similarity |
Evet |
OpenAI.EvalItem
Modele, hiyerarşiyi izleyen yönergeyi belirten bir rol içeren bir ileti girişi.
developer veya system rolüyle verilen yönergeler, user rolüyle verilen yönergelerden önceliklidir.
assistant rolüne sahip iletilerin, önceki etkileşimlerde model tarafından oluşturulduğu varsayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.EvalItemContent | Modele girişler - şablon dizeleri içerebilir. Tek bir öğe veya öğe dizisi olarak metin, çıkış metni, giriş görüntüleri ve giriş sesini destekler. | Evet | |
| role | enum | İleti girişinin rolü.
user, assistant, system'den birideveloper.Olası değerler: user, assistant, system, developer |
Evet | |
| type | enum | İleti girişinin türü. Her zaman message.Olası değerler: message |
Hayı |
OpenAI.EvalItemContent
Modele girişler - şablon dizeleri içerebilir. Tek bir öğe veya öğe dizisi olarak metin, çıkış metni, giriş görüntüleri ve giriş sesini destekler.
Tür: OpenAI.EvalItemContentItem veya OpenAI.EvalItemContentArray
Modele girişler - şablon dizeleri içerebilir. Tek bir öğe veya öğe dizisi olarak metin, çıkış metni, giriş görüntüleri ve giriş sesini destekler.
OpenAI.EvalItemContentArray
Her biri giriş metni, çıkış metni, giriş görüntüsü veya giriş ses nesnesi olabilecek girişlerin listesi.
Dizisi: OpenAI.EvalItemContentItem
OpenAI.EvalItemContentItem
Tek bir içerik öğesi: giriş metni, çıkış metni, giriş görüntüsü veya giriş sesi.
Tür: OpenAI.EvalItemContentText veya OpenAI.EvalItemContentItemObject
Tek bir içerik öğesi: giriş metni, çıkış metni, giriş görüntüsü veya giriş sesi.
OpenAI.EvalItemContentItemObject
Tek bir içerik öğesi: giriş metni, çıkış metni, giriş görüntüsü veya giriş sesi.
OpenAI.EvalItemContentItemObject için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
output_text |
OpenAI.EvalItemContentOutputText |
input_image |
OpenAI.EvalItemInputImage |
input_audio |
OpenAI.InputAudio |
input_text |
OpenAI.EvalItemContentItemObjectInputTextContent |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.EvalItemContentItemObjectType | Evet |
OpenAI.EvalItemContentItemObjectInputTextContent
Modele metin girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modele metin girişi. | Evet | |
| type | enum | Giriş öğesinin türü. Her zaman input_text.Olası değerler: input_text |
Evet |
OpenAI.EvalItemContentItemObjectType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | input_textoutput_textinput_imageinput_audio |
OpenAI.EvalItemContentOutputText
Modelden bir metin çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modelden metin çıkışı. | Evet | |
| type | enum | Çıkış metninin türü. Her zaman output_text.Olası değerler: output_text |
Evet |
OpenAI.EvalItemContentText
Modele metin girişi.
Tür: dize
OpenAI.EvalItemInputImage
EvalItem içerik dizilerinde kullanılan bir görüntü giriş bloğu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| detail | String | Modele gönderilecek görüntünün ayrıntı düzeyi.
high, lowveya auto. Varsayılan olarak auto değerini alır. |
Hayı | |
| image_url | String | Görüntü girişinin URL'si. | Evet | |
| type | enum | Görüntü girişinin türü. Her zaman input_image.Olası değerler: input_image |
Evet |
OpenAI.EvalJsonlFileContentSource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.EvalJsonlFileContentSourceContent dizisi | jsonl dosyasının içeriği. | Evet | |
| type | enum | Jsonl kaynağının türü. Her zaman file_content.Olası değerler: file_content |
Evet |
OpenAI.EvalJsonlFileContentSourceContent
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| öğe | nesne | Evet | ||
| örnek | nesne | Hayı |
OpenAI.EvalJsonlFileIdSource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Dosyanın tanımlayıcısı. | Evet | |
| type | enum | Jsonl kaynağının türü. Her zaman file_id.Olası değerler: file_id |
Evet |
OpenAI.EvalResponsesSource
Çalıştırma veri kaynağı yapılandırmasını açıklayan bir EvalResponsesSource nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi_sonrası | OpenAI.integer (null atanabilir) | Hayı | ||
| önceden oluşturulmuş | OpenAI.integer (null atanabilir) | Hayı | ||
| instructions_search | dize (null atanabilir) | Hayı | ||
| metadata | object (null atanabilir) | Hayı | ||
| model | dize (null atanabilir) | Hayı | ||
| akıl yürütme çabası | OpenAI.ReasoningEffort (null atanabilir) | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | ||
| araçlar | dize dizisi | Hayı | ||
| top_p | OpenAI.numeric (null atanabilir) | Hayı | ||
| type | enum | Çalıştırma veri kaynağının türü. Her zaman responses.Olası değerler: responses |
Evet | |
| users | dize dizisi | Hayı |
OpenAI.EvalRunOutputItemSample
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | OpenAI.EvalApiError | Değerlendirme API'sinden bir hata yanıtını temsil eden nesne. | Evet | |
| bitiş_nedeni | String | Evet | ||
| girdi | EvalRunOutputItemSampleInput dizisi | Evet | ||
| max_completion_tokens | OpenAI.integer | Evet | ||
| model | String | Evet | ||
| çıktı | EvalRunOutputItemSampleOutput dizisi | Evet | ||
| seed | OpenAI.integer | Evet | ||
| sıcaklık | OpenAI.numeric | Evet | ||
| top_p | OpenAI.numeric | Evet | ||
| usage | OpenAI.EvalRunOutputItemSampleUsage | Evet |
OpenAI.EvalRunOutputItemSampleUsage
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Evet | ||
| completion_tokens | OpenAI.integer | Evet | ||
| prompt_tokens | OpenAI.integer | Evet | ||
| total_tokens | OpenAI.integer | Evet |
OpenAI.EvalRunPerModelUsage
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Evet | ||
| completion_tokens | OpenAI.integer | Evet | ||
| invocation_count | OpenAI.integer | Evet | ||
| model_name | String | Evet | ||
| prompt_tokens | OpenAI.integer | Evet | ||
| total_tokens | OpenAI.integer | Evet |
OpenAI.EvalRunPerTestingCriteriaResults
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| başarısız | OpenAI.integer | Evet | ||
| Geçirilen | OpenAI.integer | Evet | ||
| test kriterleri | String | Evet |
OpenAI.EvalRunResultCounts
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata oluştu | OpenAI.integer | Evet | ||
| başarısız | OpenAI.integer | Evet | ||
| Geçirilen | OpenAI.integer | Evet | ||
| toplam | OpenAI.integer | Evet |
OpenAI.EvalStoredCompletionsSource
Bir filtre kümesini açıklayan StoredCompletionsRunDataSource yapılandırması
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi_sonrası | OpenAI.integer (null atanabilir) | Hayı | ||
| önceden oluşturulmuş | OpenAI.integer (null atanabilir) | Hayı | ||
| limit | OpenAI.integer (null atanabilir) | Hayı | ||
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| model | dize (null atanabilir) | Hayı | ||
| type | enum | Kaynak türü. Her zaman stored_completions.Olası değerler: stored_completions |
Evet |
OpenAI.FileCitationBody
Bir dosyaya referans.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dosya_kimlik | String | Dosyanın kimliği. | Evet | |
| filename | String | Belirtilen dosyanın dosya adı. | Evet | |
| indeks | OpenAI.integer | Evet | ||
| type | enum | Dosya alıntısının türü. Her zaman file_citation.Olası değerler: file_citation |
Evet |
OpenAI.FilePath
Bir dosyaya giden yol.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dosya_kimlik | String | Dosyanın kimliği. | Evet | |
| indeks | OpenAI.integer | Evet | ||
| type | enum | Dosya yolunun türü. Her zaman file_path.Olası değerler: file_path |
Evet |
OpenAI.FileSearchTool
Yüklenen dosyalardan ilgili içeriği arayan bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| filters | OpenAI.Filters (null atanabilir) | Hayı | ||
| maks_sonuç_sayısı | OpenAI.integer | Hayı | ||
| Sıralama_seçenekleri | OpenAI.RankingOptions | Hayı | ||
| └─ hybrid_search | OpenAI.HybridSearchOptions | Hibrit arama etkinleştirildiğinde karşılıklı sıralama birleşiminin anlamsal gömütme eşleşmeleri ile seyrek anahtar kelime eşleşmelerini nasıl dengelediğini kontrol eden ağırlıklar. | Hayı | |
| └─ sıralama yapıcı | OpenAI.RankerVersionType | Dosya araması için kullanılacak dereceleyici. | Hayı | |
| └─ skor_eşiği | OpenAI.numeric | Dosya araması için puan eşiği, 0 ile 1 arasında bir sayı. 1'e yakın sayılar yalnızca en uygun sonuçları döndürmeye çalışır, ancak daha az sonuç döndürebilir. | Hayı | |
| type | enum | Dosya arama aracının türü. Her zaman file_search.Olası değerler: file_search |
Evet | |
| vector_store_ids | dize dizisi | Aranacak vektör depolarının kimlikleri. | Evet |
OpenAI.FileSearchToolCallResults
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| attributes | OpenAI.VectorStoreFileAttributes (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar dizedir en fazla 64 karakter uzunluğunda. Değerler, en yüksek değere sahip dizelerdir 512 karakter uzunluğu, booleanlar veya sayılar. |
Hayı | |
| dosya_kimlik | String | Hayı | ||
| filename | String | Hayı | ||
| Puan | Numara | Hayı | ||
| text | String | Hayı |
OpenAI.Filters
Tür: OpenAI.ComparisonFilter veya OpenAI.CompoundFilter
OpenAI.FineTuneDPOHyperparameters
DPO hassas ayarlama işi için kullanılan hiper parametreler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| küme_boyutu | dize veya OpenAI.integer | Her toplu işlemdeki örnek sayısı. Daha büyük bir toplu iş boyutu, model parametrelerinin daha az sıklıkta, ancak daha düşük varyansla güncelleştirildiğini gösterir. | Hayı | |
| beta | dize veya OpenAI.numeric | DPO yönteminin beta değeri. Daha yüksek bir beta değeri, ilke ve başvuru modeli arasındaki cezanın ağırlığını artırır. | Hayı | |
| öğrenme oranı çarpanı | dize veya OpenAI.numeric | Öğrenme oranı için ölçeklendirme faktörü. Aşırı uydurmayı önlemek için daha düşük bir öğrenme oranı yararlı olabilir. | Hayı | |
| n_devir | dize veya OpenAI.integer | Modelin eğitileceği epok sayısı. Dönem, eğitim veri kümesindeki bir tam döngüyü ifade eder. | Hayı |
OpenAI.FineTuneDPOMethod
DPO ince ayarlama yöntemi için yapılandırma.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hiper parametreler | OpenAI.FineTuneDPOHyperparameters | DPO hassas ayarlama işi için kullanılan hiper parametreler. | Hayı |
OpenAI.FineTuneMethod
İnce ayar için kullanılan yöntem.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dpo | OpenAI.FineTuneDPOMethod | DPO ince ayarlama yöntemi için yapılandırma. | Hayı | |
| Takviye | OpenAI.FineTuneReinforcementMethod | Pekiştirici ince ayar yöntemi için yapılandırma. | Hayı | |
| Denetimli | OpenAI.FineTuneSupervisedMethod | Denetimli ince ayar yöntemi için yapılandırma. | Hayı | |
| type | enum | Yöntemin türü.
supervised, dpoveya reinforcementşeklindedir.Olası değerler: supervised, dpo, reinforcement |
Evet |
OpenAI.FineTuneReinforcementHyperparameters
Pekiştirici ince ayarlama işi için kullanılan hiper parametreler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| küme_boyutu | dize veya OpenAI.integer | Her toplu işlemdeki örnek sayısı. Daha büyük bir toplu iş boyutu, model parametrelerinin daha az sıklıkta, ancak daha düşük varyansla güncelleştirildiğini gösterir. | Hayı | |
| compute_multiplier | dize veya OpenAI.numeric | Eğitim sırasında arama alanını keşfetmek için kullanılan işlem miktarının çarpanı. | Hayı | |
| eval_interval | dize veya OpenAI.integer | Değerlendirme çalıştırmaları arasındaki eğitim adımlarının sayısı. | Hayı | |
| eval_samples | dize veya OpenAI.integer | Eğitim adımı başına oluşturulacak değerlendirme örneklerinin sayısı. | Hayı | |
| öğrenme oranı çarpanı | dize veya OpenAI.numeric | Öğrenme oranı için ölçeklendirme faktörü. Aşırı uydurmayı önlemek için daha düşük bir öğrenme oranı yararlı olabilir. | Hayı | |
| n_devir | dize veya OpenAI.integer | Modelin eğitileceği epok sayısı. Dönem, eğitim veri kümesindeki bir tam döngüyü ifade eder. | Hayı | |
| akıl yürütme çabası | enum | Akıl yürütme çabası düzeyi. Olası değerler: default, low, medium, high |
Hayı |
OpenAI.FineTuneReinforcementMethod
Pekiştirici ince ayar yöntemi için yapılandırma.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Greyder | OpenAI.GraderStringCheck veya OpenAI.GraderTextSimilarity veya OpenAI.GraderPython veya OpenAI.GraderScoreModel veya OpenAI.GraderMulti | İnce ayar işi için kullanılan not veren. | Evet | |
| hiper parametreler | OpenAI.FineTuneReinforcementHyperparameters | Pekiştirici ince ayarlama işi için kullanılan hiper parametreler. | Hayı |
OpenAI.FineTuneSupervisedHyperparameters
İnce ayar işi için kullanılan hiper parametreler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| küme_boyutu | dize veya OpenAI.integer | Her toplu işlemdeki örnek sayısı. Daha büyük bir toplu iş boyutu, model parametrelerinin daha az sıklıkta, ancak daha düşük varyansla güncelleştirildiğini gösterir. | Hayı | |
| öğrenme oranı çarpanı | dize veya OpenAI.numeric | Öğrenme oranı için ölçeklendirme faktörü. Aşırı uydurmayı önlemek için daha düşük bir öğrenme oranı yararlı olabilir. | Hayı | |
| n_devir | dize veya OpenAI.integer | Modelin eğitileceği epok sayısı. Dönem, eğitim veri kümesindeki bir tam döngüyü ifade eder. | Hayı |
OpenAI.FineTuneSupervisedMethod
Denetimli ince ayar yöntemi için yapılandırma.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hiper parametreler | OpenAI.FineTuneSupervisedHyperparameters | İnce ayar işi için kullanılan hiper parametreler. | Hayı |
OpenAI.FineTuningIntegration
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | İnce ayar işi için etkinleştirilen tümleştirmenin türü Olası değerler: wandb |
Evet | |
| wandb | OpenAI.FineTuningIntegrationWandb | Evet | ||
| └─ varlık | dize (null atanabilir) | Hayı | ||
| └─ ad | dize (null atanabilir) | Hayı | ||
| └─ project | String | Evet | ||
| └─ etiketleri | dize dizisi | Hayı |
OpenAI.FineTuningIntegrationWandb
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| varlık | dize (null atanabilir) | Hayı | ||
| name | dize (null atanabilir) | Hayı | ||
| project | String | Evet | ||
| tags | dize dizisi | Hayı |
OpenAI.FineTuningJob
nesnesi, fine_tuning.job API aracılığıyla oluşturulmuş bir ince ayar işini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | hassas ayarlama işinin oluşturulduğu zaman için Unix zaman damgası (saniye olarak). | Evet | |
| hata | OpenAI.FineTuningJobError (null atanabilir) | Evet | ||
| └─ kod | String | Evet | ||
| └─ ileti | String | Evet | ||
| └─ parametre | dize (null atanabilir) | Evet | ||
| tahmini_bitiş | tamsayı | Hayı | ||
| fine_tuned_model | dize (null atanabilir) | Evet | ||
| tamamlandı | tamsayı | Evet | ||
| hiper parametreler | OpenAI.FineTuningJobHyperparameters | Evet | ||
| └─ yığın boyutu | dize veya OpenAI.integer | Hayı | otomatik | |
| └─ öğrenme oranı çarpanı | dize veya OpenAI.numeric | Hayı | ||
| └─ n_epochs | dize veya OpenAI.integer | Hayı | otomatik | |
| kimlik | String | API uç noktalarına başvurulabilen nesne tanımlayıcısı. | Evet | |
| Entegrasyonlar | OpenAI.FineTuningIntegration dizisi | Hayı | ||
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| method | OpenAI.FineTuneMethod | İnce ayar için kullanılan yöntem. | Hayı | |
| model | String | İnce ayar yapılan temel model. | Evet | |
| nesne | enum | Her zaman "fine_tuning.job" olan nesne türü. Olası değerler: fine_tuning.job |
Evet | |
| organization_id | String | İnce ayar işinin sahibi olan kuruluş. | Evet | |
| sonuç_dosyaları | dize dizisi | İnce ayar işi için derlenmiş sonuç dosyası kimlikleri. Sonuçları Dosyalar API'siyle alabilirsiniz. | Evet | |
| seed | OpenAI.integer | Evet | ||
| durum | enum | , veya validating_filesolabilirqueuedrunningsucceededfailed, ince ayarlama işinin cancelledgeçerli durumu.Olası değerler: validating_files, queued, running, succeeded, , failed, cancelled |
Evet | |
| eğitilmiş_jetonlar | OpenAI.integer (null atanabilir) | Evet | ||
| eğitim_dosyası | String | Eğitim için kullanılan dosya kimliği. Eğitim verilerini Dosyalar API'siyle alabilirsiniz. | Evet | |
| doğrulama_dosyası | dize (null atanabilir) | Evet |
OpenAI.FineTuningJobCheckpoint
fine_tuning.job.checkpoint nesnesi, kullanıma hazır bir ince ayar işi için model denetim noktasını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | Denetim noktasının oluşturulduğu zaman için Unix zaman damgası (saniye olarak). | Evet | |
| ince_ayarlı_model_kontrol_noktası | String | Oluşturulan hassas denetim noktası modelinin adı. | Evet | |
| ince_ayarlama_iş_id | String | Bu denetim noktasının oluşturulduğu ince ayar işinin adı. | Evet | |
| kimlik | String | API uç noktalarında başvurulabilen denetim noktası tanımlayıcısı. | Evet | |
| metrics | OpenAI.FineTuningJobCheckpointMetrics | Evet | ||
| tam doğrulama kaybı (full_valid_loss) | OpenAI.numeric | Hayı | ||
| └─ tam_geçerli_ortalama_token_doğruluğu | OpenAI.numeric | Hayı | ||
| └─ adım | OpenAI.numeric | Hayı | ||
| └─ eğitim kaybı | OpenAI.numeric | Hayı | ||
| └─ eğitim_ortalama_token_dogrulugu | OpenAI.numeric | Hayı | ||
| └─ doğrulama_kaybı | OpenAI.numeric | Hayı | ||
| └─ geçerli_ortalama_öğe_doğruluğu | OpenAI.numeric | Hayı | ||
| nesne | enum | Her zaman "fine_tuning.job.checkpoint" olan nesne türü. Olası değerler: fine_tuning.job.checkpoint |
Evet | |
| adım_numarası | OpenAI.integer | Evet |
OpenAI.FineTuningJobCheckpointMetrics
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| full_valid_loss | OpenAI.numeric | Hayı | ||
| full_valid_mean_token_accuracy | OpenAI.numeric | Hayı | ||
| adım | OpenAI.numeric | Hayı | ||
| train_loss | OpenAI.numeric | Hayı | ||
| train_mean_token_accuracy | OpenAI.numeric | Hayı | ||
| valid_loss | OpenAI.numeric | Hayı | ||
| valid_mean_token_accuracy | OpenAI.numeric | Hayı |
OpenAI.FineTuningJobError
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | String | Evet | ||
| mesaj | String | Evet | ||
| param | dize (null atanabilir) | Evet |
OpenAI.FineTuningJobEvent
İş olayı nesnesine ince ayar
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| oluşturulma_tarihi | tamsayı | hassas ayarlama işinin oluşturulduğu zaman için Unix zaman damgası (saniye olarak). | Evet | |
| veriler | OpenAI.FineTuningJobEventData | Hayı | ||
| kimlik | String | Nesne tanımlayıcısı. | Evet | |
| seviye | enum | Olayın günlük düzeyi. Olası değerler: info, warn, error |
Evet | |
| mesaj | String | Olayın iletisi. | Evet | |
| nesne | enum | Her zaman "fine_tuning.job.event" olan nesne türü. Olası değerler: fine_tuning.job.event |
Evet | |
| type | enum | Olayın türü. Olası değerler: message, metrics |
Hayı |
OpenAI.FineTuningJobEventData
Tür: nesne
OpenAI.FineTuningJobHyperparameters
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| küme_boyutu | dize veya OpenAI.integer | Hayı | ||
| öğrenme oranı çarpanı | dize veya OpenAI.numeric | Hayı | ||
| n_devir | dize veya OpenAI.integer | Hayı |
OpenAI.FunctionAndCustomToolCallOutput
OpenAI.FunctionAndCustomToolCallOutput için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
input_text |
OpenAI.FunctionAndCustomToolCallOutputInputTextContent |
input_image |
OpenAI.FunctionAndCustomToolCallOutputInputImageContent |
input_file |
OpenAI.FunctionAndCustomToolCallOutputInputFileContent |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.FunctionAndCustomToolCallOutputType | Evet |
OpenAI.FunctionAndCustomToolCallOutputInputFileContent
Modele bir dosya girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| file_data | String | Modele gönderilecek dosyanın içeriği. | Hayı | |
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| file_url | String | Modele gönderilecek dosyanın URL'si. | Hayı | |
| filename | String | Modele gönderilecek dosyanın adı. | Hayı | |
| type | enum | Giriş öğesinin türü. Her zaman input_file.Olası değerler: input_file |
Evet |
OpenAI.FunctionAndCustomToolCallOutputInputImageContent
Modele bir görüntü girişi. image girişleri hakkında bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Evet | ||
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| image_url | String | Hayı | ||
| type | enum | Giriş öğesinin türü. Her zaman input_image.Olası değerler: input_image |
Evet |
OpenAI.FunctionAndCustomToolCallOutputInputTextContent
Modele metin girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modele metin girişi. | Evet | |
| type | enum | Giriş öğesinin türü. Her zaman input_text.Olası değerler: input_text |
Evet |
OpenAI.FunctionAndCustomToolCallOutputType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | input_textinput_imageinput_file |
OpenAI.FunctionCallItemStatus
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompletedincomplete |
OpenAI.FunctionObject
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | İşlevin ne zaman ve nasıl çağrıldığını seçmek için model tarafından kullanılan işlevin ne yaptığının açıklaması. | Hayı | |
| name | String | Çağrılacak işlevin adı. En fazla uzunluğu 64 olan a-z, A-Z, 0-9 veya alt çizgi ve kısa çizgi içermelidir. | Evet | |
| parameters | OpenAI.FunctionParameters | İşlevlerin kabullediği, JSON Şeması nesnesi olarak tanımlanan parametreler. Örnekler için guide ve format hakkında dokümantasyon için JSON Schema reference adresine bakınız. Atlama parameters , boş parametre listesi olan bir işlevi tanımlar. |
Hayı | |
| Sıkı | boole değeri (null atanabilir) | Hayı |
OpenAI.FunctionParameters
İşlevlerin kabullediği, JSON Şeması nesnesi olarak tanımlanan parametreler. Örnekler için guide ve format hakkında dokümantasyon için JSON Schema reference adresine bakınız.
Atlama parameters , boş parametre listesi olan bir işlevi tanımlar.
Tür: nesne
OpenAI.FunctionShellAction
Bir kabuk komutu yürütür.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| commands | dize dizisi | Evet | ||
| max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| zaman_aşımı_ms | OpenAI.integer (null atanabilir) | Evet |
OpenAI.FunctionShellActionParam
Shell araç çağrısının nasıl çalıştırılacağını açıklayan komutlar ve limitler.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| commands | dize dizisi | Çalıştırma ortamı için shell komutlarının çalıştırılması için emredildi. | Evet | |
| max_output_length | OpenAI.integer (null atanabilir) | Hayı | ||
| zaman_aşımı_ms | OpenAI.integer (null atanabilir) | Hayı |
OpenAI.FunctionShellCallItemStatus
Shell araç çağrıları için bildirilen durum değerleri.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompletedincomplete |
OpenAI.FunctionShellCallOutputContent
Bir kabuk aracının içeriği, yayılan çağrı çıkışını çağırır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Oluşturan | String | Öğeyi oluşturan aktörün tanımlayıcısı. | Hayı | |
| sonuç | OpenAI.FunctionShellCallOutputOutcome | Bir çıkış sonucunu (çıkış koduyla) veya kabuk çağrısı çıkış öbekleri için zaman aşımı sonucunu temsil eder. | Evet | |
| └─ türü | OpenAI.FunctionShellCallOutputOutcomeType | Evet | ||
| Stderr | String | Yakalanan standart hata çıkışı. | Evet | |
| stdout | String | Yakalanan standart çıkış. | Evet |
OpenAI.FunctionShellCallOutputContentParam
Shell aracı çağrısı çıkışının bir kısmı için stdout ve stderr yakalandı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sonuç | OpenAI.FunctionShellCallOutputOutcomeParam | Bu shell çağrısıyla ilişkili çıkış veya zaman aşımı sonucu. | Evet | |
| └─ türü | OpenAI.FunctionShellCallOutputOutcomeParamType | Evet | ||
| Stderr | String | Shell çağrısı için stderr çıkışı yakalandı. Kısıtlamalar: maxLength: 10485760 |
Evet | |
| stdout | String | Shell çağrısı için stdout çıktısı yakalandı. Kısıtlamalar: maxLength: 10485760 |
Evet |
OpenAI.FunctionShellCallOutputExitOutcome
Shell komutlarının tamamlandığını ve çıkış kodunu döndürdüğünü gösterir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| exit_code | OpenAI.integer | Evet | ||
| type | enum | Sonuç türü. Her zaman exit.Olası değerler: exit |
Evet |
OpenAI.FunctionShellCallOutputExitOutcomeParam
Shell komutlarının tamamlandığını ve çıkış kodunu döndürdüğünü gösterir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| exit_code | OpenAI.integer | Evet | ||
| type | enum | Sonuç türü. Her zaman exit.Olası değerler: exit |
Evet |
OpenAI.FunctionShellCallOutputOutcome
Bir çıkış sonucunu (çıkış koduyla) veya kabuk çağrısı çıkış öbekleri için zaman aşımı sonucunu temsil eder.
OpenAI.FunctionShellCallOutputOutcome için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
timeout |
OpenAI.FunctionShellCallOutputTimeoutOutcome |
exit |
OpenAI.FunctionShellCallOutputExitOutcome |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.FunctionShellCallOutputOutcomeType | Evet |
OpenAI.FunctionShellCallOutputOutcomeParam
Bu shell çağrısıyla ilişkili çıkış veya zaman aşımı sonucu.
OpenAI.FunctionShellCallOutputOutcomeParam için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
timeout |
OpenAI.FunctionShellCallOutputTimeoutOutcomeParam |
exit |
OpenAI.FunctionShellCallOutputExitOutcomeParam |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.FunctionShellCallOutputOutcomeParamType | Evet |
OpenAI.FunctionShellCallOutputOutcomeParamType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | timeoutexit |
OpenAI.FunctionShellCallOutputOutcomeType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | timeoutexit |
OpenAI.FunctionShellCallOutputTimeoutOutcome
Shell çağrısının ayarlanmış zaman sınırını aştığını gösterir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Sonuç türü. Her zaman timeout.Olası değerler: timeout |
Evet |
OpenAI.FunctionShellCallOutputTimeoutOutcomeParam
Shell çağrısının ayarlanmış zaman sınırını aştığını gösterir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Sonuç türü. Her zaman timeout.Olası değerler: timeout |
Evet |
OpenAI.FunctionShellToolParam
Modelin shell komutlarını çalıştırmasına olanak tanıyan bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Kabuk aracının türü. Her zaman shell.Olası değerler: shell |
Evet |
OpenAI.FunctionTool
Modelin çağırmayı seçebileceği kendi kodunuzda bir işlev tanımlar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | dize (null atanabilir) | Hayı | ||
| name | String | Çağrılacak işlevin adı. | Evet | |
| parameters | object (null atanabilir) | Evet | ||
| Sıkı | boole değeri (null atanabilir) | Evet | ||
| type | enum | İşlev aracının türü. Her zaman function.Olası değerler: function |
Evet |
OpenAI.GraderLabelModel
Değerlendirmedeki her öğeye etiket atamak için model kullanan bir LabelModelGrader nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | OpenAI.EvalItem dizisi | Evet | ||
| labels | dize dizisi | Değerlendirmedeki her öğeye atanacak etiketler. | Evet | |
| model | String | Değerlendirme için kullanılacak model. Yapılandırılmış çıktıları destekleme zorunluluğu vardır. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| geçen etiketler | dize dizisi | Geçen sonucu belirten etiketler. Etiketlerin bir alt kümesi olmalıdır. | Evet | |
| type | enum | Her zaman label_modelolan nesne türü.Olası değerler: label_model |
Evet |
OpenAI.GraderMulti
MultiGrader nesnesi, tek bir puan oluşturmak için birden çok not verenin çıkışını birleştirir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| calculate_output | String | Not veren sonuçlarına göre çıkışı hesaplamak için bir formül. | Evet | |
| Greyder | OpenAI.GraderStringCheck veya OpenAI.GraderTextSimilarity veya OpenAI.GraderPython veya OpenAI.GraderScoreModel veya OpenAI.GraderLabelModel | Evet | ||
| name | String | Değerlendiricinin adı. | Evet | |
| type | enum | Her zaman multiolan nesne türü.Olası değerler: multi |
Evet |
OpenAI.GraderPython
Girişte python betiği çalıştıran bir PythonGrader nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| image_tag | String | Python betiği için kullanılacak görüntü etiketi. | Hayı | |
| name | String | Değerlendiricinin adı. | Evet | |
| kaynak | String | Python betiğinin kaynak kodu. | Evet | |
| type | enum | Her zaman pythonolan nesne türü.Olası değerler: python |
Evet |
OpenAI.GraderScoreModel
Girişe puan atamak için model kullanan scoreModelGrader nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | OpenAI.EvalItem dizisi | Not veren tarafından değerlendirilen giriş iletileri. Metin, çıkış metni, giriş görüntüsü ve giriş ses içerik bloklarını destekler ve şablon dizeleri içerebilir. | Evet | |
| model | String | Değerlendirme için kullanılacak model. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| menzil | OpenAI.numeric dizisi | Puan aralığı. Varsayılan olarak [0, 1] değerini alır. |
Hayı | |
| Örnekleme_Parametreleri | OpenAI.EvalGraderScoreModelSamplingParams | Hayı | ||
| └─ max_completions_tokens | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ akıl yürütme çabası | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| └─ tohum | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| type | enum | Her zaman score_modelolan nesne türü.Olası değerler: score_model |
Evet |
OpenAI.GraderStringCheck
Belirtilen işlemi kullanarak giriş ve başvuru arasında dize karşılaştırması gerçekleştiren bir StringCheckGrader nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | String | Giriş metni. Bu, şablon dizelerini içerebilir. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| Operasyon | enum | Gerçekleştirilecek dize denetimi işlemi.
eq, ne, like veya ilike.Olası değerler: eq, ne, like, ilike |
Evet | |
| referans | String | Başvuru metni. Bu, şablon dizelerini içerebilir. | Evet | |
| type | enum | Her zaman string_checkolan nesne türü.Olası değerler: string_check |
Evet |
OpenAI.GraderTextSimilarity
Metinleri benzerlik ölçümlerine göre notlayan textSimilarityGrader nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| değerlendirme ölçütü | enum | Kullanılacak değerlendirme ölçümü.
cosine, , fuzzy_match, bleu,gleu, meteor, rouge_1, , rouge_2, rouge_3, rouge_4, rouge_5,veya rouge_l.Olası değerler: cosine, fuzzy_match, bleu, , gleu, meteor, , rouge_1, rouge_2rouge_3, rouge_4rouge_5,rouge_l |
Evet | |
| girdi | String | Notlanan metin. | Evet | |
| name | String | Değerlendiricinin adı. | Evet | |
| referans | String | Değerlendirmenin yapıldığı metin. | Evet | |
| type | enum | Not verenin türü. Olası değerler: text_similarity |
Evet |
OpenAI.GrammarSyntax1
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | larkregex |
OpenAI.HybridSearchOptions
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| embedding_weight | OpenAI.numeric | Evet | ||
| text_weight | OpenAI.numeric | Evet |
OpenAI.ImageDetail
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | lowhighauto |
OpenAI.ImageGenTool
GPT görüntü modelleriyle görüntü üreten bir araç.
Geçerli modeller:
gpt-image-1
gpt-image-1-mini
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arka plan | enum | Oluşturulan görüntünün arka plan türü. Bunlardan biri transparentopaqueveya auto. Varsayılan: auto.Olası değerler: transparent, opaque, auto |
Hayı | |
| input_fidelity | OpenAI.InputFidelity (null atanabilir) | Modelin giriş görüntülerinin stil ve özellikleriyle, özellikle yüz özellikleriyle eşleşmesi için ne kadar çaba göstereceğini kontrol edin. Bu parametre yalnızca için gpt-image-1desteklenir. için gpt-image-1-minidesteklenmiyor.
high ve lowdestekler. Varsayılan olarak low değerini alır. |
Hayı | |
| girdi_görüntü_maskesi | OpenAI.ImageGenToolInputImageMask | Hayı | ||
| └─ dosya_kimliği | String | Hayı | ||
| └─ image_url (görsel URL'si) | String | Hayı | ||
| model | dize (aşağıdaki geçerli modellere bakın) | Hayı | ||
| moderation | enum | Oluşturulan görüntü için denetim düzeyi. Varsayılan: auto.Olası değerler: auto, low |
Hayı | |
| çıktı sıkıştırma | OpenAI.integer | Hayı | 100 | |
| çıkış formatı | enum | Oluşturulan görüntünün çıkış biçimi.
png, webp, veya bunlardan birijpeg. Varsayılan: png.Olası değerler: png, webp, jpeg |
Hayı | |
| kısmi_görüntüler | OpenAI.integer | Hayı | ||
| nitelik | enum | Oluşturulan görüntünün kalitesi.
low, , medium, high,veya auto. Varsayılan: auto.Olası değerler: low, medium, high, auto |
Hayı | |
| boyut | enum | Oluşturulan görüntünün boyutu. , , 1024x1024' lerden 1024x1536biri1536x1024veya auto. Varsayılan: auto.Olası değerler: 1024x1024, 1024x1536, 1536x1024, auto |
Hayı | |
| type | enum | Görüntü oluşturma aracının türü. Her zaman image_generation.Olası değerler: image_generation |
Evet |
OpenAI.ImageGenToolInputImageMask
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| dosya_kimlik | String | Hayı | ||
| image_url | String | Hayı |
OpenAI.IncludeEnum
Model yanıtına eklenecek ek çıktı verilerini belirtin. Şu anda desteklenen değerler şunlardır:
-
web_search_call.action.sources: Web arama aracı çağrısının kaynaklarını ekleyin. -
code_interpreter_call.outputs: Kod yorumlayıcı aracı çağrı öğelerinde python kod yürütme çıktılarını içerir. -
computer_call_output.output.image_url: Bilgisayar çağrısı çıkışından görüntü URL'lerini ekleyin. -
file_search_call.results: Dosya arama aracı çağrısının arama sonuçlarını ekleyin. -
message.input_image.image_url: Giriş iletisinden görüntü URL'lerini ekleyin. -
message.output_text.logprobs: Yardımcı iletilerine logprobs ekleyin. -
reasoning.encrypted_content: Akıl yürütme öğesi çıkışlarında akıl yürütme belirteçlerinin şifrelenmiş bir sürümünü içerir. Bu, Yanıtlar API'sini durum bilgisi olmadan kullanırken (örneğin,storeparametresifalseolarak ayarlandığında veya bir kuruluş sıfır veri saklama programına kaydedildiğinde) akıl yürütme öğelerinin çok aşamalı konuşmalarda kullanılmasını sağlar.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Model yanıtına eklenecek ek çıktı verilerini belirtin. Şu anda desteklenen değerler şunlardır: |
-
web_search_call.action.sources: Web arama aracı çağrısının kaynaklarını ekleyin. -
code_interpreter_call.outputs: Kod yorumlayıcı aracı çağrı öğelerinde python kod yürütme çıktılarını içerir. -
computer_call_output.output.image_url: Bilgisayar çağrısı çıkışından görüntü URL'lerini ekleyin. -
file_search_call.results: Dosya arama aracı çağrısının arama sonuçlarını ekleyin. -
message.input_image.image_url: Giriş iletisinden görüntü URL'lerini ekleyin. -
message.output_text.logprobs: Yardımcı iletilerine logprobs ekleyin. -
reasoning.encrypted_content: Akıl yürütme öğesi çıkışlarında akıl yürütme belirteçlerinin şifrelenmiş bir sürümünü içerir. Bu, Yanıtlar API'sini durum bilgisi olmadan kullanırken (örneğin,storeparametresifalseolarak ayarlandığında veya bir kuruluş sıfır veri saklama programına kaydedildiğinde) akıl yürütme öğelerinin çok aşamalı konuşmalarda kullanılmasını sağlar. | | Tür | string | | Değerler |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
Modele ses girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| input_audio | OpenAI.InputAudioInputAudio | Evet | ||
| type | enum | Giriş öğesinin türü. Her zaman input_audio.Olası değerler: input_audio |
Evet |
OpenAI.InputAudioInputAudio
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veriler | String | Evet | ||
| format | enum | Olası değerler: mp3, wav |
Evet |
OpenAI.InputContent
OpenAI.InputContent için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
input_text |
OpenAI.InputContentInputTextContent |
input_image |
OpenAI.InputContentInputImageContent |
input_file |
OpenAI.InputContentInputFileContent |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.InputContentType | Evet |
OpenAI.InputContentInputFileContent
Modele bir dosya girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| file_data | String | Modele gönderilecek dosyanın içeriği. | Hayı | |
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| file_url | String | Modele gönderilecek dosyanın URL'si. | Hayı | |
| filename | String | Modele gönderilecek dosyanın adı. | Hayı | |
| type | enum | Giriş öğesinin türü. Her zaman input_file.Olası değerler: input_file |
Evet |
OpenAI.InputContentInputImageContent
Modele bir görüntü girişi. image girişleri hakkında bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Evet | ||
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| image_url | String | Hayı | ||
| type | enum | Giriş öğesinin türü. Her zaman input_image.Olası değerler: input_image |
Evet |
OpenAI.InputContentInputTextContent
Modele metin girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modele metin girişi. | Evet | |
| type | enum | Giriş öğesinin türü. Her zaman input_text.Olası değerler: input_text |
Evet |
OpenAI.InputContentType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | input_textinput_imageinput_file |
OpenAI.InputFidelity
Modelin giriş görüntülerinin stil ve özellikleriyle, özellikle yüz özellikleriyle eşleşmesi için ne kadar çaba göstereceğini kontrol edin. Bu parametre yalnızca için gpt-image-1desteklenir. için gpt-image-1-minidesteklenmiyor.
high ve lowdestekler. Varsayılan olarak low değerini alır.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | highlow |
OpenAI.InputFileContent
Modele bir dosya girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| file_data | String | Modele gönderilecek dosyanın içeriği. | Hayı | |
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| file_url | String | Modele gönderilecek dosyanın URL'si. | Hayı | |
| filename | String | Modele gönderilecek dosyanın adı. | Hayı | |
| type | enum | Giriş öğesinin türü. Her zaman input_file.Olası değerler: input_file |
Evet |
OpenAI.InputFileContentParam
Modele bir dosya girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| file_data | dize (null atanabilir) | Hayı | ||
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| file_url | String | Hayı | ||
| filename | dize (null atanabilir) | Hayı | ||
| type | enum | Giriş öğesinin türü. Her zaman input_file.Olası değerler: input_file |
Evet |
OpenAI.InputImageContent
Modele bir görüntü girişi. image girişleri hakkında bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Evet | ||
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| image_url | String | Hayı | ||
| type | enum | Giriş öğesinin türü. Her zaman input_image.Olası değerler: input_image |
Evet |
OpenAI.InputImageContentParamAutoParam
Modele bir görüntü girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| detail | OpenAI.DetailEnum (null atanabilir) | Hayı | ||
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| image_url | String | Hayı | ||
| type | enum | Giriş öğesinin türü. Her zaman input_image.Olası değerler: input_image |
Evet |
OpenAI.InputItem
Model tarafından oluşturulacak yanıt için bağlamın bir bölümünü temsil eden bir öğe. Metin, görüntü ve ses girişlerinin yanı sıra önceki yardımcı yanıtları ve araç çağrısı çıkışlarını içerebilir.
OpenAI.InputItem için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.InputItemType | Evet |
OpenAI.InputItemApplyPatchToolCallItemParam
Farklı yamalar kullanarak dosya oluşturma, silme veya güncelleme talebini temsil eden bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| Operasyon | OpenAI.ApplyPatchOperationParam | apply_patch aracına sağlanan create_file, delete_file veya update_file işlemlerden biri. | Evet | |
| └─ türü | OpenAI.ApplyPatchOperationParamType | Evet | ||
| durum | OpenAI.ApplyPatchCallStatusParam | apply_patch araç çağrıları için raporlanan durum değerleri. | Evet | |
| type | enum | Öğenin türü. Her zaman apply_patch_call.Olası değerler: apply_patch_call |
Evet |
OpenAI.InputItemApplyPatchToolCallOutputItemParam
Uygulama yaması aracı çağrısıyla yayımlanan akış çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| çıktı | dize (null atanabilir) | Hayı | ||
| durum | OpenAI.ApplyPatchCallOutputStatusParam | apply_patch araç çağrısı çıktıları için raporlanan sonuç değerleri. | Evet | |
| type | enum | Öğenin türü. Her zaman apply_patch_call_output.Olası değerler: apply_patch_call_output |
Evet |
OpenAI.InputItemCodeInterpreterToolCall
Kodu çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | dize (null atanabilir) | Evet | ||
| container_id | String | Kodu çalıştırmak için kullanılan kapsayıcının kimliği. | Evet | |
| kimlik | String | Kod yorumlayıcısı araç çağrısının benzersiz kimliği. | Evet | |
| Çıktılar | OpenAI.CodeInterpreterOutputLogs veya OpenAI.CodeInterpreterOutputImage dizisi | Evet | ||
| durum | enum | Kod yorumlayıcı aracı çağrısının durumu. Geçerli değerler : in_progress, completed, incomplete, interpretingve failed.Olası değerler: in_progress, completed, incomplete, interpreting, failed |
Evet | |
| type | enum | Kod yorumlayıcı aracı çağrısının türü. Her zaman code_interpreter_call.Olası değerler: code_interpreter_call |
Evet |
OpenAI.InputItemCompactionSummaryItemParam
API tarafından v1/responses/compactoluşturulan bir sıkıştırma öğesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| encrypted_content | String | Sıkıştırma özetinin şifrelenmiş içeriği. Kısıtlamalar: maxLength: 10485760 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| type | enum | Öğenin türü. Her zaman compaction.Olası değerler: compaction |
Evet |
OpenAI.InputItemComputerCallOutputItemParam
Bir bilgisayar aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| acknowledged_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Hayı | ||
| call_id | String | Çıktı üreten bilgisayar aracı çağrısının kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| çıktı | OpenAI.ComputerScreenshotImage | Bilgisayar kullanım aracıyla kullanılan bir bilgisayar ekran görüntüsü. | Evet | |
| durum | OpenAI.FunctionCallItemStatus (null atanabilir) | Hayı | ||
| type | enum | Bilgisayar araçlarının çağrı çıktısının türü. Her zaman computer_call_output.Olası değerler: computer_call_output |
Evet |
OpenAI.InputItemComputerToolCall
Bilgisayar kullanım araçlarına bir araç komutu verme. Daha fazla bilgi için bilgisayar kullanım rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.ComputerAction | Evet | ||
| call_id | String | Çıkış verisi ile araç çağrısına yanıt verirken kullanılan tanımlayıcı. | Evet | |
| kimlik | String | Bilgisayar çağrısının benzersiz tanımlayıcısı. | Evet | |
| pending_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Bilgisayar çağrısı için bekleyen güvenlik denetimleri. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Bilgisayar çağrısının türü. Her zaman computer_call.Olası değerler: computer_call |
Evet |
OpenAI.InputItemCustomToolCall
Model tarafından oluşturulan özel bir araca çağrı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Bu özel araç çağrısını bir araç çağrısı çıktısına eşlemek için kullanılan bir tanımlayıcı. | Evet | |
| kimlik | String | OpenAI platformundaki özel araç çağrısının benzersiz kimliği. | Hayı | |
| girdi | String | Model tarafından oluşturulan özel araç çağrısı için girdi. | Evet | |
| name | String | Çağrılan özel aracın adı. | Evet | |
| type | enum | Özel araç çağrısının türü. Her zaman custom_tool_call.Olası değerler: custom_tool_call |
Evet |
OpenAI.InputItemCustomToolCallOutput
Kodunuzdan özel bir araç çağrısının çıktısı, modele geri gönderiliyor.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Çağrı kimliği, bu özel araç çağrısı çıktısını özel bir araç çağrısına eşlemek için kullanılır. | Evet | |
| kimlik | String | OpenAI platformunda çıkan özel araç çağrısının benzersiz kimliği. | Hayı | |
| çıktı | OpenAI.FunctionAndCustomToolCallOutput dizesi veya dizisi | Kodunuz tarafından oluşturulan özel araç çağrısından çıkan çıktı. Bir dizi veya çıkış içeriği listesi olabilir. |
Evet | |
| type | enum | Özel araç çağrısı çıkışının türü. Her zaman custom_tool_call_output.Olası değerler: custom_tool_call_output |
Evet |
OpenAI.InputItemFileSearchToolCall
Dosya arama aracı çağrısının sonuçları. Daha fazla bilgi için dosya arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Dosya arama aracı çağrısının benzersiz kimliği. | Evet | |
| queries | dize dizisi | Dosyaları aramak için kullanılan sorgular. | Evet | |
| results | OpenAI.FileSearchToolCallResults dizisi | Hayı | ||
| durum | enum | Dosya arama aracı çağrısının durumu. Bunlardan biri in_progresssearching, incomplete veya failed,Olası değerler: in_progress, searching, completed, incomplete, failed |
Evet | |
| type | enum | Dosya arama aracı çağrısının türü. Her zaman file_search_call.Olası değerler: file_search_call |
Evet |
OpenAI.InputItemFunctionCallOutputItemParam
İşlev aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| çıktı | OpenAI.InputTextContentParam veya OpenAI.InputImageContentParamAutoParam veya OpenAI.InputFileContentParam dizesi veya dizisi | Fonksiyon aracı çağrısının metin, görüntü veya dosya çıktısı. | Evet | |
| durum | OpenAI.FunctionCallItemStatus (null atanabilir) | Hayı | ||
| type | enum | İşlev aracının çağrı çıktısının türü. Her zaman function_call_output.Olası değerler: function_call_output |
Evet |
OpenAI.InputItemFunctionShellCallItemParam
Bir veya daha fazla kabuk komutunu çalıştırma talebinin temsil edilen bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.FunctionShellActionParam | Shell araç çağrısının nasıl çalıştırılacağını açıklayan komutlar ve limitler. | Evet | |
| └─ komutları | dize dizisi | Çalıştırma ortamı için shell komutlarının çalıştırılması için emredildi. | Evet | |
| └─ max_output_length | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ timeout_ms | OpenAI.integer (null atanabilir) | Hayı | ||
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| durum | OpenAI.FunctionShellCallItemStatus (null atanabilir) | Shell araç çağrıları için bildirilen durum değerleri. | Hayı | |
| type | enum | Öğenin türü. Her zaman shell_call.Olası değerler: shell_call |
Evet |
OpenAI.InputItemFunctionShellCallOutputItemParam
Bir shell araç çağrısı tarafından yayımlanan akış çıktı öğeleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| max_output_length | OpenAI.integer (null atanabilir) | Hayı | ||
| çıktı | OpenAI.FunctionShellCallOutputContentParam dizisi | Stdout ve stderr çıktısının parçalarını ve bunlarla ilgili sonuçları yakalandı. | Evet | |
| type | enum | Öğenin türü. Her zaman shell_call_output.Olası değerler: shell_call_output |
Evet |
OpenAI.InputItemFunctionToolCall
Bir fonksiyonu çalıştırmak için bir araç çağrısı. Daha fazla bilgi için function çağrı rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | İşleve geçirecek bağımsız değişkenlerin JSON dizesi. | Evet | |
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracı çağrısının benzersiz kimliği. | Hayı | |
| name | String | Çalıştırılacak işlevin adı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracı çağrısının türü. Her zaman function_call.Olası değerler: function_call |
Evet |
OpenAI.InputItemImageGenToolCall
Model tarafından yapılan bir görüntü oluşturma isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Görüntü oluşturma çağrısının benzersiz kimliği. | Evet | |
| sonuç | dize (null atanabilir) | Evet | ||
| durum | enum | Görüntü oluşturma çağrısının durumu. Olası değerler: in_progress, completed, generating, failed |
Evet | |
| type | enum | Görüntü oluşturma çağrısının türü. Her zaman image_generation_call.Olası değerler: image_generation_call |
Evet |
OpenAI.InputItemLocalShellToolCall
Yerel kabukta komut çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.LocalShellExecAction | Sunucuda bir kabuk komutu yürütür. | Evet | |
| call_id | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | Yerel shell çağrısının benzersiz kimliği. | Evet | |
| durum | enum | Yerel shell çağrısının durumu. Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Yerel shell call'ın türü. Her zaman local_shell_call.Olası değerler: local_shell_call |
Evet |
OpenAI.InputItemLocalShellToolCallOutput
Yerel kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| çıktı | String | Yerel kabuk aracı çağrısının çıkışının JSON dizesi. | Evet | |
| durum | enum | Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | Yerel kabuk aracı çağrı çıkışının türü. Her zaman local_shell_call_output.Olası değerler: local_shell_call_output |
Evet |
OpenAI.InputItemMcpApprovalRequest
Bir araç çağrısı işlemi için insan onayı isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | Araç için bir JSON bağımsız değişken dizesi. | Evet | |
| kimlik | String | Onay talebinin benzersiz kimliği. | Evet | |
| name | String | Çalıştırılacak aracın adı. | Evet | |
| sunucu etiketi | String | İsteği yapan MCP sunucusunun etiketi. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_approval_request.Olası değerler: mcp_approval_request |
Evet |
OpenAI.InputItemMcpApprovalResponse
MCP onay isteğine yanıt.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | String | Yanıtlanan onay isteğinin ID'si. | Evet | |
| approve | Boolean | İsteğin onaylanıp onaylanmadı. | Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| sebep | dize (null atanabilir) | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_approval_response.Olası değerler: mcp_approval_response |
Evet |
OpenAI.InputItemMcpListTools
MCP sunucusunda kullanılabilen araçların listesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Listenin benzersiz kimliği. | Evet | |
| sunucu etiketi | String | MCP sunucusunun etiketi. | Evet | |
| araçlar | OpenAI.MCPListToolsTool dizisi | Sunucuda bulunan araçlar. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_list_tools.Olası değerler: mcp_list_tools |
Evet |
OpenAI.InputItemMcpToolCall
MCP sunucusundaki bir aracın çağrılması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | dize (null atanabilir) | Hayı | ||
| arguments | String | Araca geçirilen bağımsız değişkenlerin JSON dizesi. | Evet | |
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Araç çağrısının benzersiz kimliği. | Evet | |
| name | String | Çalıştırılan aracın adı. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| sunucu etiketi | String | Aracı çalıştıran MCP sunucusunun etiketi. | Evet | |
| durum | OpenAI.MCPToolCallStatus | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_call.Olası değerler: mcp_call |
Evet |
OpenAI.InputItemOutputMessage
Modelden bir çıkış iletisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.OutputMessageContent dizisi | Çıkış iletisinin içeriği. | Evet | |
| kimlik | String | Çıkış iletisinin benzersiz kimliği. | Evet | |
| role | enum | Çıkış iletisinin rolü. Her zaman assistant.Olası değerler: assistant |
Evet | |
| durum | enum | İleti girişinin durumu.
in_progress, completed, veya bunlardan biriincomplete. API aracılığıyla giriş öğeleri döndürüldüğünde doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Çıkış iletisinin türü. Her zaman message.Olası değerler: output_message |
Evet |
OpenAI.InputItemReasoningItem
Bir yanıt oluştururken bir akıl yürütme modeli tarafından kullanılan düşünce zincirinin açıklaması. Eğer konuşmanın sonraki turlarında bu öğeleri bağlam yönetiyorsanız ile manuel olarak konuşuyorsanız, Responses API'ye input hesabınıza dahil edin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.ReasoningTextContent dizisi | Metin içeriğini akıl yürütme. | Hayı | |
| encrypted_content | dize (null atanabilir) | Hayı | ||
| kimlik | String | Akıl yürütme içeriğinin benzersiz tanımlayıcısı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| summary | OpenAI.Summary dizisi | Akıl yürütme özeti içeriği. | Evet | |
| type | enum | Nesnenin türü. Her zaman reasoning.Olası değerler: reasoning |
Evet |
OpenAI.InputItemType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Bir web arama aracı çağrısının sonuçları. Daha fazla bilgi için web arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.WebSearchActionSearch veya OpenAI.WebSearchActionOpenPage veya OpenAI.WebSearchActionFind | Bu web arama çağrısında gerçekleştirilen belirli eylemi açıklayan bir nesne. Modelin web'i nasıl kullandığına ilişkin ayrıntıları içerir (arama, open_page, bulma). |
Evet | |
| kimlik | String | Web arama aracının benzersiz kimliği çağrı. | Evet | |
| durum | enum | Web arama aracı çağrısının durumu. Olası değerler: in_progress, searching, completed, failed |
Evet | |
| type | enum | Web arama aracının türü. Her zaman web_search_call.Olası değerler: web_search_call |
Evet |
OpenAI.InputMessage
Modele, hiyerarşiyi izleyen yönergeyi belirten bir rol içeren bir ileti girişi.
developer veya system rolüyle verilen yönergeler, user rolüyle verilen yönergelerden önceliklidir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.InputMessageContentList | Modelde farklı içerik içeren bir veya birden çok giriş öğesinin listesi types. |
Evet | |
| role | enum | İleti girişinin rolü.
user, systemveya developer.Olası değerler: user, system, developer |
Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İleti girişinin türü. Her zaman messageolarak ayarlayın.Olası değerler: message |
Evet |
OpenAI.InputMessageContentList
Modelde farklı içerik türleri içeren bir veya birden çok giriş öğesinin listesi.
Dizisi: OpenAI.InputContent
OpenAI.InputMessageResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.InputMessageContentList | Modelde farklı içerik içeren bir veya birden çok giriş öğesinin listesi types. |
Evet | |
| kimlik | String | İleti girişinin benzersiz kimliği. | Evet | |
| role | enum | İleti girişinin rolü.
user, systemveya developer.Olası değerler: user, system, developer |
Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İleti girişinin türü. Her zaman messageolarak ayarlayın.Olası değerler: message |
Evet |
OpenAI.InputParam
Yanıt oluşturmak için kullanılan modele metin, görüntü veya dosya girişleri. Daha fazla bilgi edinin:
Tür: OpenAI.InputItem dizesi veya dizisi
Yanıt oluşturmak için kullanılan modele metin, görüntü veya dosya girişleri. Daha fazla bilgi edinin:
OpenAI.InputTextContent
Modele metin girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modele metin girişi. | Evet | |
| type | enum | Giriş öğesinin türü. Her zaman input_text.Olası değerler: input_text |
Evet |
OpenAI.InputTextContentParam
Modele metin girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modele metin girişi. Kısıtlamalar: maxLength: 10485760 |
Evet | |
| type | enum | Giriş öğesinin türü. Her zaman input_text.Olası değerler: input_text |
Evet |
OpenAI.Item
Yanıt oluşturmak için kullanılan içerik öğesi.
OpenAI.Item için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ItemType | Evet |
OpenAI.ItemApplyPatchToolCallItemParam
Farklı yamalar kullanarak dosya oluşturma, silme veya güncelleme talebini temsil eden bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| Operasyon | OpenAI.ApplyPatchOperationParam | apply_patch aracına sağlanan create_file, delete_file veya update_file işlemlerden biri. | Evet | |
| └─ türü | OpenAI.ApplyPatchOperationParamType | Evet | ||
| durum | OpenAI.ApplyPatchCallStatusParam | apply_patch araç çağrıları için raporlanan durum değerleri. | Evet | |
| type | enum | Öğenin türü. Her zaman apply_patch_call.Olası değerler: apply_patch_call |
Evet |
OpenAI.ItemApplyPatchToolCallOutputItemParam
Uygulama yaması aracı çağrısıyla yayımlanan akış çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| çıktı | dize (null atanabilir) | Hayı | ||
| durum | OpenAI.ApplyPatchCallOutputStatusParam | apply_patch araç çağrısı çıktıları için raporlanan sonuç değerleri. | Evet | |
| type | enum | Öğenin türü. Her zaman apply_patch_call_output.Olası değerler: apply_patch_call_output |
Evet |
OpenAI.ItemCodeInterpreterToolCall
Kodu çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | dize (null atanabilir) | Evet | ||
| container_id | String | Kodu çalıştırmak için kullanılan kapsayıcının kimliği. | Evet | |
| kimlik | String | Kod yorumlayıcısı araç çağrısının benzersiz kimliği. | Evet | |
| Çıktılar | OpenAI.CodeInterpreterOutputLogs veya OpenAI.CodeInterpreterOutputImage dizisi | Evet | ||
| durum | enum | Kod yorumlayıcı aracı çağrısının durumu. Geçerli değerler : in_progress, completed, incomplete, interpretingve failed.Olası değerler: in_progress, completed, incomplete, interpreting, failed |
Evet | |
| type | enum | Kod yorumlayıcı aracı çağrısının türü. Her zaman code_interpreter_call.Olası değerler: code_interpreter_call |
Evet |
OpenAI.ItemCompactionSummaryItemParam
API tarafından v1/responses/compactoluşturulan bir sıkıştırma öğesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| encrypted_content | String | Sıkıştırma özetinin şifrelenmiş içeriği. Kısıtlamalar: maxLength: 10485760 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| type | enum | Öğenin türü. Her zaman compaction.Olası değerler: compaction |
Evet |
OpenAI.ItemComputerCallOutputItemParam
Bir bilgisayar aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| acknowledged_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Hayı | ||
| call_id | String | Çıktı üreten bilgisayar aracı çağrısının kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| çıktı | OpenAI.ComputerScreenshotImage | Bilgisayar kullanım aracıyla kullanılan bir bilgisayar ekran görüntüsü. | Evet | |
| durum | OpenAI.FunctionCallItemStatus (null atanabilir) | Hayı | ||
| type | enum | Bilgisayar araçlarının çağrı çıktısının türü. Her zaman computer_call_output.Olası değerler: computer_call_output |
Evet |
OpenAI.ItemComputerToolCall
Bilgisayar kullanım araçlarına bir araç komutu verme. Daha fazla bilgi için bilgisayar kullanım rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.ComputerAction | Evet | ||
| call_id | String | Çıkış verisi ile araç çağrısına yanıt verirken kullanılan tanımlayıcı. | Evet | |
| kimlik | String | Bilgisayar çağrısının benzersiz tanımlayıcısı. | Evet | |
| pending_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Bilgisayar çağrısı için bekleyen güvenlik denetimleri. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Bilgisayar çağrısının türü. Her zaman computer_call.Olası değerler: computer_call |
Evet |
OpenAI.ItemCustomToolCall
Model tarafından oluşturulan özel bir araca çağrı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Bu özel araç çağrısını bir araç çağrısı çıktısına eşlemek için kullanılan bir tanımlayıcı. | Evet | |
| kimlik | String | OpenAI platformundaki özel araç çağrısının benzersiz kimliği. | Hayı | |
| girdi | String | Model tarafından oluşturulan özel araç çağrısı için girdi. | Evet | |
| name | String | Çağrılan özel aracın adı. | Evet | |
| type | enum | Özel araç çağrısının türü. Her zaman custom_tool_call.Olası değerler: custom_tool_call |
Evet |
OpenAI.ItemCustomToolCallOutput
Kodunuzdan özel bir araç çağrısının çıktısı, modele geri gönderiliyor.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Çağrı kimliği, bu özel araç çağrısı çıktısını özel bir araç çağrısına eşlemek için kullanılır. | Evet | |
| kimlik | String | OpenAI platformunda çıkan özel araç çağrısının benzersiz kimliği. | Hayı | |
| çıktı | OpenAI.FunctionAndCustomToolCallOutput dizesi veya dizisi | Kodunuz tarafından oluşturulan özel araç çağrısından çıkan çıktı. Bir dizi veya çıkış içeriği listesi olabilir. |
Evet | |
| type | enum | Özel araç çağrısı çıkışının türü. Her zaman custom_tool_call_output.Olası değerler: custom_tool_call_output |
Evet |
OpenAI.ItemFileSearchToolCall
Dosya arama aracı çağrısının sonuçları. Daha fazla bilgi için dosya arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Dosya arama aracı çağrısının benzersiz kimliği. | Evet | |
| queries | dize dizisi | Dosyaları aramak için kullanılan sorgular. | Evet | |
| results | OpenAI.FileSearchToolCallResults dizisi | Hayı | ||
| durum | enum | Dosya arama aracı çağrısının durumu. Bunlardan biri in_progresssearching, incomplete veya failed,Olası değerler: in_progress, searching, completed, incomplete, failed |
Evet | |
| type | enum | Dosya arama aracı çağrısının türü. Her zaman file_search_call.Olası değerler: file_search_call |
Evet |
OpenAI.ItemFunctionCallOutputItemParam
İşlev aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| çıktı | OpenAI.InputTextContentParam veya OpenAI.InputImageContentParamAutoParam veya OpenAI.InputFileContentParam dizesi veya dizisi | Fonksiyon aracı çağrısının metin, görüntü veya dosya çıktısı. | Evet | |
| durum | OpenAI.FunctionCallItemStatus (null atanabilir) | Hayı | ||
| type | enum | İşlev aracının çağrı çıktısının türü. Her zaman function_call_output.Olası değerler: function_call_output |
Evet |
OpenAI.ItemFunctionShellCallItemParam
Bir veya daha fazla kabuk komutunu çalıştırma talebinin temsil edilen bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.FunctionShellActionParam | Shell araç çağrısının nasıl çalıştırılacağını açıklayan komutlar ve limitler. | Evet | |
| └─ komutları | dize dizisi | Çalıştırma ortamı için shell komutlarının çalıştırılması için emredildi. | Evet | |
| └─ max_output_length | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ timeout_ms | OpenAI.integer (null atanabilir) | Hayı | ||
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| durum | OpenAI.FunctionShellCallItemStatus (null atanabilir) | Shell araç çağrıları için bildirilen durum değerleri. | Hayı | |
| type | enum | Öğenin türü. Her zaman shell_call.Olası değerler: shell_call |
Evet |
OpenAI.ItemFunctionShellCallOutputItemParam
Bir shell araç çağrısı tarafından yayımlanan akış çıktı öğeleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. Kısıtlamalar: minLength: 1, maxLength: 64 |
Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| max_output_length | OpenAI.integer (null atanabilir) | Hayı | ||
| çıktı | OpenAI.FunctionShellCallOutputContentParam dizisi | Stdout ve stderr çıktısının parçalarını ve bunlarla ilgili sonuçları yakalandı. | Evet | |
| type | enum | Öğenin türü. Her zaman shell_call_output.Olası değerler: shell_call_output |
Evet |
OpenAI.ItemFunctionToolCall
Bir fonksiyonu çalıştırmak için bir araç çağrısı. Daha fazla bilgi için function çağrı rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | İşleve geçirecek bağımsız değişkenlerin JSON dizesi. | Evet | |
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracı çağrısının benzersiz kimliği. | Hayı | |
| name | String | Çalıştırılacak işlevin adı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracı çağrısının türü. Her zaman function_call.Olası değerler: function_call |
Evet |
OpenAI.ItemImageGenToolCall
Model tarafından yapılan bir görüntü oluşturma isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Görüntü oluşturma çağrısının benzersiz kimliği. | Evet | |
| sonuç | dize (null atanabilir) | Evet | ||
| durum | enum | Görüntü oluşturma çağrısının durumu. Olası değerler: in_progress, completed, generating, failed |
Evet | |
| type | enum | Görüntü oluşturma çağrısının türü. Her zaman image_generation_call.Olası değerler: image_generation_call |
Evet |
OpenAI.ItemLocalShellToolCall
Yerel kabukta komut çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.LocalShellExecAction | Sunucuda bir kabuk komutu yürütür. | Evet | |
| call_id | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | Yerel shell çağrısının benzersiz kimliği. | Evet | |
| durum | enum | Yerel shell çağrısının durumu. Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Yerel shell call'ın türü. Her zaman local_shell_call.Olası değerler: local_shell_call |
Evet |
OpenAI.ItemLocalShellToolCallOutput
Yerel kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| çıktı | String | Yerel kabuk aracı çağrısının çıkışının JSON dizesi. | Evet | |
| durum | enum | Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | Yerel kabuk aracı çağrı çıkışının türü. Her zaman local_shell_call_output.Olası değerler: local_shell_call_output |
Evet |
OpenAI.ItemMcpApprovalRequest
Bir araç çağrısı işlemi için insan onayı isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | Araç için bir JSON bağımsız değişken dizesi. | Evet | |
| kimlik | String | Onay talebinin benzersiz kimliği. | Evet | |
| name | String | Çalıştırılacak aracın adı. | Evet | |
| sunucu etiketi | String | İsteği yapan MCP sunucusunun etiketi. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_approval_request.Olası değerler: mcp_approval_request |
Evet |
OpenAI.ItemMcpApprovalResponse
MCP onay isteğine yanıt.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | String | Yanıtlanan onay isteğinin ID'si. | Evet | |
| approve | Boolean | İsteğin onaylanıp onaylanmadı. | Evet | |
| kimlik | dize (null atanabilir) | Hayı | ||
| sebep | dize (null atanabilir) | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_approval_response.Olası değerler: mcp_approval_response |
Evet |
OpenAI.ItemMcpListTools
MCP sunucusunda kullanılabilen araçların listesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Listenin benzersiz kimliği. | Evet | |
| sunucu etiketi | String | MCP sunucusunun etiketi. | Evet | |
| araçlar | OpenAI.MCPListToolsTool dizisi | Sunucuda bulunan araçlar. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_list_tools.Olası değerler: mcp_list_tools |
Evet |
OpenAI.ItemMcpToolCall
MCP sunucusundaki bir aracın çağrılması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | dize (null atanabilir) | Hayı | ||
| arguments | String | Araca geçirilen bağımsız değişkenlerin JSON dizesi. | Evet | |
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Araç çağrısının benzersiz kimliği. | Evet | |
| name | String | Çalıştırılan aracın adı. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| sunucu etiketi | String | Aracı çalıştıran MCP sunucusunun etiketi. | Evet | |
| durum | OpenAI.MCPToolCallStatus | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_call.Olası değerler: mcp_call |
Evet |
OpenAI.ItemOutputMessage
Modelden bir çıkış iletisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.OutputMessageContent dizisi | Çıkış iletisinin içeriği. | Evet | |
| kimlik | String | Çıkış iletisinin benzersiz kimliği. | Evet | |
| role | enum | Çıkış iletisinin rolü. Her zaman assistant.Olası değerler: assistant |
Evet | |
| durum | enum | İleti girişinin durumu.
in_progress, completed, veya bunlardan biriincomplete. API aracılığıyla giriş öğeleri döndürüldüğünde doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Çıkış iletisinin türü. Her zaman message.Olası değerler: output_message |
Evet |
OpenAI.ItemReasoningItem
Bir yanıt oluştururken bir akıl yürütme modeli tarafından kullanılan düşünce zincirinin açıklaması. Eğer konuşmanın sonraki turlarında bu öğeleri bağlam yönetiyorsanız ile manuel olarak konuşuyorsanız, Responses API'ye input hesabınıza dahil edin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.ReasoningTextContent dizisi | Metin içeriğini akıl yürütme. | Hayı | |
| encrypted_content | dize (null atanabilir) | Hayı | ||
| kimlik | String | Akıl yürütme içeriğinin benzersiz tanımlayıcısı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| summary | OpenAI.Summary dizisi | Akıl yürütme özeti içeriği. | Evet | |
| type | enum | Nesnenin türü. Her zaman reasoning.Olası değerler: reasoning |
Evet |
OpenAI.ItemReferenceParam
Başvurulacak bir öğenin iç tanımlayıcısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Başvurulacak öğenin kimliği. | Evet | |
| type | enum | Başvurulacak öğenin türü. Her zaman item_reference.Olası değerler: item_reference |
Evet |
OpenAI.ItemResource
Yanıt oluşturmak için kullanılan içerik öğesi.
OpenAI.ItemResource için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ItemResourceType | Evet |
OpenAI.ItemResourceApplyPatchToolCall
Dosya oluşturarak, silerek veya güncelleştirerek dosya farklarını uygulayan bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu araç çağrısını oluşturan varlığın kimliği. | Hayı | |
| kimlik | String | Düzeltme eki uygulama aracı çağrısının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| Operasyon | OpenAI.ApplyPatchFileOperation | apply_patch aracılığıyla uygulanan create_file, delete_file veya update_file işlemlerinden biri. | Evet | |
| └─ türü | OpenAI.ApplyPatchFileOperationType | Evet | ||
| durum | OpenAI.ApplyPatchCallStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman apply_patch_call.Olası değerler: apply_patch_call |
Evet |
OpenAI.ItemResourceApplyPatchToolCallOutput
Bir düzeltme eki uygulama aracı çağrısı tarafından yayılan çıkış.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu aracı oluşturan varlığın kimliği çağrı çıktısı. | Hayı | |
| kimlik | String | Düzeltme eki uygulama aracı çağrı çıkışının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| durum | OpenAI.ApplyPatchCallOutputStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman apply_patch_call_output.Olası değerler: apply_patch_call_output |
Evet |
OpenAI.ItemResourceCodeInterpreterToolCall
Kodu çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | dize (null atanabilir) | Evet | ||
| container_id | String | Kodu çalıştırmak için kullanılan kapsayıcının kimliği. | Evet | |
| kimlik | String | Kod yorumlayıcısı araç çağrısının benzersiz kimliği. | Evet | |
| Çıktılar | OpenAI.CodeInterpreterOutputLogs veya OpenAI.CodeInterpreterOutputImage dizisi | Evet | ||
| durum | enum | Kod yorumlayıcı aracı çağrısının durumu. Geçerli değerler : in_progress, completed, incomplete, interpretingve failed.Olası değerler: in_progress, completed, incomplete, interpreting, failed |
Evet | |
| type | enum | Kod yorumlayıcı aracı çağrısının türü. Her zaman code_interpreter_call.Olası değerler: code_interpreter_call |
Evet |
OpenAI.ItemResourceComputerToolCall
Bilgisayar kullanım araçlarına bir araç komutu verme. Daha fazla bilgi için bilgisayar kullanım rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.ComputerAction | Evet | ||
| call_id | String | Çıkış verisi ile araç çağrısına yanıt verirken kullanılan tanımlayıcı. | Evet | |
| kimlik | String | Bilgisayar çağrısının benzersiz tanımlayıcısı. | Evet | |
| pending_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Bilgisayar çağrısı için bekleyen güvenlik denetimleri. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Bilgisayar çağrısının türü. Her zaman computer_call.Olası değerler: computer_call |
Evet |
OpenAI.ItemResourceComputerToolCallOutputResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| acknowledged_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | API tarafından bildirilen ve kabul edilen güvenlik kontrolleri geliştirici. |
Hayı | |
| call_id | String | Çıktı üreten bilgisayar aracı çağrısının kimliği. | Evet | |
| kimlik | String | Bilgisayar aracı çağrısı çıkış kimliği. | Hayı | |
| çıktı | OpenAI.ComputerScreenshotImage | Bilgisayar kullanım aracıyla kullanılan bir bilgisayar ekran görüntüsü. | Evet | |
| durum | enum | İleti girişinin durumu.
in_progress, completed, veya bunlardan biriincomplete. API aracılığıyla giriş öğeleri döndürüldüğünde doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | Bilgisayar araçlarının çağrı çıktısının türü. Her zaman computer_call_output.Olası değerler: computer_call_output |
Evet |
OpenAI.ItemResourceFileSearchToolCall
Dosya arama aracı çağrısının sonuçları. Daha fazla bilgi için dosya arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Dosya arama aracı çağrısının benzersiz kimliği. | Evet | |
| queries | dize dizisi | Dosyaları aramak için kullanılan sorgular. | Evet | |
| results | OpenAI.FileSearchToolCallResults dizisi | Hayı | ||
| durum | enum | Dosya arama aracı çağrısının durumu. Bunlardan biri in_progresssearching, incomplete veya failed,Olası değerler: in_progress, searching, completed, incomplete, failed |
Evet | |
| type | enum | Dosya arama aracı çağrısının türü. Her zaman file_search_call.Olası değerler: file_search_call |
Evet |
OpenAI.ItemResourceFunctionShellCall
Yönetilen bir ortamda bir veya daha fazla kabuk komutu yürüten bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.FunctionShellAction | Bir kabuk komutu yürütür. | Evet | |
| └─ komutları | dize dizisi | Evet | ||
| └─ max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| └─ timeout_ms | OpenAI.integer (null atanabilir) | Evet | ||
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu araç çağrısını oluşturan varlığın kimliği. | Hayı | |
| kimlik | String | Kabuk aracı çağrısının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| durum | OpenAI.LocalShellCallStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman shell_call.Olası değerler: shell_call |
Evet |
OpenAI.ItemResourceFunctionShellCallOutput
Yayılan bir kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Öğeyi oluşturan aktörün tanımlayıcısı. | Hayı | |
| kimlik | String | Kabuk çağrısı çıkışının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| çıktı | OpenAI.FunctionShellCallOutputContent dizisi | Kabuk çağrısı çıkış içeriği dizisi | Evet | |
| type | enum | Kabuk çağrısı çıkışının türü. Her zaman shell_call_output.Olası değerler: shell_call_output |
Evet |
OpenAI.ItemResourceFunctionToolCallOutputResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracının çağrı çıkışının benzersiz kimliği. Bu öğe doldurulduğunda API aracılığıyla döndürülür. |
Hayı | |
| çıktı | OpenAI.FunctionAndCustomToolCallOutput dizesi veya dizisi | Kodunuz tarafından oluşturulan işlev çağrısının çıktısı. Bir dizi veya çıkış içeriği listesi olabilir. |
Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracının çağrı çıktısının türü. Her zaman function_call_output.Olası değerler: function_call_output |
Evet |
OpenAI.ItemResourceFunctionToolCallResource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | İşleve geçirecek bağımsız değişkenlerin JSON dizesi. | Evet | |
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracı çağrısının benzersiz kimliği. | Hayı | |
| name | String | Çalıştırılacak işlevin adı. | Evet | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracı çağrısının türü. Her zaman function_call.Olası değerler: function_call |
Evet |
OpenAI.ItemResourceImageGenToolCall
Model tarafından yapılan bir görüntü oluşturma isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Görüntü oluşturma çağrısının benzersiz kimliği. | Evet | |
| sonuç | dize (null atanabilir) | Evet | ||
| durum | enum | Görüntü oluşturma çağrısının durumu. Olası değerler: in_progress, completed, generating, failed |
Evet | |
| type | enum | Görüntü oluşturma çağrısının türü. Her zaman image_generation_call.Olası değerler: image_generation_call |
Evet |
OpenAI.ItemResourceLocalShellToolCall
Yerel kabukta komut çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.LocalShellExecAction | Sunucuda bir kabuk komutu yürütür. | Evet | |
| call_id | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | Yerel shell çağrısının benzersiz kimliği. | Evet | |
| durum | enum | Yerel shell çağrısının durumu. Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Yerel shell call'ın türü. Her zaman local_shell_call.Olası değerler: local_shell_call |
Evet |
OpenAI.ItemResourceLocalShellToolCallOutput
Yerel kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| çıktı | String | Yerel kabuk aracı çağrısının çıkışının JSON dizesi. | Evet | |
| durum | enum | Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | Yerel kabuk aracı çağrı çıkışının türü. Her zaman local_shell_call_output.Olası değerler: local_shell_call_output |
Evet |
OpenAI.ItemResourceMcpApprovalRequest
Bir araç çağrısı işlemi için insan onayı isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | Araç için bir JSON bağımsız değişken dizesi. | Evet | |
| kimlik | String | Onay talebinin benzersiz kimliği. | Evet | |
| name | String | Çalıştırılacak aracın adı. | Evet | |
| sunucu etiketi | String | İsteği yapan MCP sunucusunun etiketi. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_approval_request.Olası değerler: mcp_approval_request |
Evet |
OpenAI.ItemResourceMcpApprovalResponseResource
MCP onay isteğine yanıt.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | String | Yanıtlanan onay isteğinin ID'si. | Evet | |
| approve | Boolean | İsteğin onaylanıp onaylanmadı. | Evet | |
| kimlik | String | Onay yanıtının benzersiz kimliği | Evet | |
| sebep | dize (null atanabilir) | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_approval_response.Olası değerler: mcp_approval_response |
Evet |
OpenAI.ItemResourceMcpListTools
MCP sunucusunda kullanılabilen araçların listesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Listenin benzersiz kimliği. | Evet | |
| sunucu etiketi | String | MCP sunucusunun etiketi. | Evet | |
| araçlar | OpenAI.MCPListToolsTool dizisi | Sunucuda bulunan araçlar. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_list_tools.Olası değerler: mcp_list_tools |
Evet |
OpenAI.ItemResourceMcpToolCall
MCP sunucusundaki bir aracın çağrılması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| approval_request_id | dize (null atanabilir) | Hayı | ||
| arguments | String | Araca geçirilen bağımsız değişkenlerin JSON dizesi. | Evet | |
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Araç çağrısının benzersiz kimliği. | Evet | |
| name | String | Çalıştırılan aracın adı. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| sunucu etiketi | String | Aracı çalıştıran MCP sunucusunun etiketi. | Evet | |
| durum | OpenAI.MCPToolCallStatus | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_call.Olası değerler: mcp_call |
Evet |
OpenAI.ItemResourceOutputMessage
Modelden bir çıkış iletisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | OpenAI.OutputMessageContent dizisi | Çıkış iletisinin içeriği. | Evet | |
| kimlik | String | Çıkış iletisinin benzersiz kimliği. | Evet | |
| role | enum | Çıkış iletisinin rolü. Her zaman assistant.Olası değerler: assistant |
Evet | |
| durum | enum | İleti girişinin durumu.
in_progress, completed, veya bunlardan biriincomplete. API aracılığıyla giriş öğeleri döndürüldüğünde doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Çıkış iletisinin türü. Her zaman message.Olası değerler: output_message |
Evet |
OpenAI.ItemResourceType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Bir web arama aracı çağrısının sonuçları. Daha fazla bilgi için web arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.WebSearchActionSearch veya OpenAI.WebSearchActionOpenPage veya OpenAI.WebSearchActionFind | Bu web arama çağrısında gerçekleştirilen belirli eylemi açıklayan bir nesne. Modelin web'i nasıl kullandığına ilişkin ayrıntıları içerir (arama, open_page, bulma). |
Evet | |
| kimlik | String | Web arama aracının benzersiz kimliği çağrı. | Evet | |
| durum | enum | Web arama aracı çağrısının durumu. Olası değerler: in_progress, searching, completed, failed |
Evet | |
| type | enum | Web arama aracının türü. Her zaman web_search_call.Olası değerler: web_search_call |
Evet |
OpenAI.ItemType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Bir web arama aracı çağrısının sonuçları. Daha fazla bilgi için web arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.WebSearchActionSearch veya OpenAI.WebSearchActionOpenPage veya OpenAI.WebSearchActionFind | Bu web arama çağrısında gerçekleştirilen belirli eylemi açıklayan bir nesne. Modelin web'i nasıl kullandığına ilişkin ayrıntıları içerir (arama, open_page, bulma). |
Evet | |
| kimlik | String | Web arama aracının benzersiz kimliği çağrı. | Evet | |
| durum | enum | Web arama aracı çağrısının durumu. Olası değerler: in_progress, searching, completed, failed |
Evet | |
| type | enum | Web arama aracının türü. Her zaman web_search_call.Olası değerler: web_search_call |
Evet |
OpenAI.KeyPressAction
Modelin gerçekleştirmek istediği tuş baskıları koleksiyonu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| keys | dize dizisi | Modelin basılmasını istediği tuş kombinasyonu. Bu, her biri bir anahtarı temsil eden bir dize dizisidir. | Evet | |
| type | enum | Olay türünü belirtir. Bir tuşa basma eylemi için bu özellik her zaman olarak keypressayarlanır.Olası değerler: keypress |
Evet |
OpenAI.ListFineTuningJobCheckpointsResponse
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veriler | OpenAI.FineTuningJobCheckpoint dizisi | Evet | ||
| ilk_kimlik | dize (null atanabilir) | Hayı | ||
| daha_fazla | Boolean | Evet | ||
| son_kimlik | dize (null atanabilir) | Hayı | ||
| nesne | enum | Olası değerler: list |
Evet |
OpenAI.ListFineTuningJobEventsResponse
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veriler | OpenAI.FineTuningJobEvent dizisi | Evet | ||
| daha_fazla | Boolean | Evet | ||
| nesne | enum | Olası değerler: list |
Evet |
OpenAI.ListPaginatedFineTuningJobsResponse
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veriler | OpenAI.FineTuningJob dizisi | Evet | ||
| daha_fazla | Boolean | Evet | ||
| nesne | enum | Olası değerler: list |
Evet |
OpenAI.LocalShellCallStatus
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompletedincomplete |
OpenAI.LocalShellExecAction
Sunucuda bir kabuk komutu yürütür.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| komut | dize dizisi | Çalıştırılacak komut. | Evet | |
| env | nesne | Komutu için ayarlanacağı ortam değişkenleri. | Evet | |
| zaman_aşımı_ms | OpenAI.integer (null atanabilir) | Hayı | ||
| type | enum | Yerel kabuk eyleminin türü. Her zaman exec.Olası değerler: exec |
Evet | |
| user | dize (null atanabilir) | Hayı | ||
| working_directory | dize (null atanabilir) | Hayı |
OpenAI.LocalShellToolParam
Modelin yerel bir ortamda kabuk komutlarını yürütmesine izin veren bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Yerel kabuk aracının türü. Her zaman local_shell.Olası değerler: local_shell |
Evet |
OpenAI.LogProb
Belirtecin günlük olasılığı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| bytes | OpenAI.integer dizisi | Evet | ||
| logprob | OpenAI.numeric | Evet | ||
| token | String | Evet | ||
| top_logprobs | OpenAI.TopLogProb dizisi | Evet |
OpenAI.MCPListToolsTool
MCP sunucusunda kullanılabilen bir araç.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Açıklamalar | OpenAI.MCPListToolsToolAnnotations (null atanabilir) | Hayı | ||
| açıklama | dize (null atanabilir) | Hayı | ||
| input_schema | OpenAI.MCPListToolsToolInputSchema | Evet | ||
| name | String | Araç adı. | Evet |
OpenAI.MCPListToolsToolAnnotations
Tür: nesne
OpenAI.MCPListToolsToolInputSchema
Tür: nesne
OpenAI.MCPTool
Modele uzak Model Bağlam Protokolü (MCP) sunucuları aracılığıyla ek araçlara access ver.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| izin verilen araçlar | dize dizisi veya OpenAI.MCPToolFilter | Hayı | ||
| yetkilendirme | String | Uzak bir MCP sunucusuyla kullanılabilen bir OAuth access token, şu iki özel bir MCP sunucu URL'si veya hizmet bağlayıcısı ile. Uygulamanız OAuth yetkilendirme akışını işlemesi ve belirteci burada sağlaması gerekir. |
Hayı | |
| connector_id | enum | ChatGPT'de bulunanlara benzer hizmet bağlayıcıları için tanımlayıcı. Bunlardan biriserver_url veya connector_id sağlanmalıdır. Hizmet hakkında daha fazla bilgi edininBağlayıcılar burada. Şu anda desteklenen connector_id değerler şunlardır:-Dropbox: connector_dropbox-Gmail: connector_gmail- Google Takvim: connector_googlecalendar- Google Drive: connector_googledrive- Microsoft Teams: connector_microsoftteams- Outlook Takvimi: connector_outlookcalendar- Outlook E-postası: connector_outlookemail-Sharepoint: connector_sharepointOlası değerler: connector_dropbox, connector_gmail, connector_googlecalendar, connector_googledrive, connector_microsoftteams, connector_outlookcalendar, connector_outlookemail, connector_sharepoint |
Hayı | |
| headers | object (null atanabilir) | Hayı | ||
| project_connection_id | String | MCP sunucusu için proje içindeki bağlantı kimliği. Bağlantı, MCP sunucusuna bağlanmak için gereken kimlik doğrulamasını ve diğer bağlantı ayrıntılarını saklar. | Hayı | |
| onay_gerektir | object (aşağıdaki geçerli modellere bakın) | Hayı | ||
| server_description | String | MCP sunucusunun isteğe bağlı açıklaması, daha fazla bağlam sağlamak için kullanılır. | Hayı | |
| sunucu etiketi | String | Bu MCP sunucusu için araç çağrılarında tanımlamak için kullanılan bir etiket. | Evet | |
| sunucu_url | String | MCP sunucusunun URL'si.
server_url Bunlardan biri veya connector_id olması gerekirSağlanan. |
Hayı | |
| type | enum | MCP aracının türü. Her zaman mcp.Olası değerler: mcp |
Evet |
OpenAI.MCPToolCallStatus
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompletedincompletecallingfailed |
OpenAI.MCPToolFilter
Hangi araçların izin verildiğini belirtmek için bir filtre nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| read_only | Boolean | Bir aracın veriyi değiştirip değiştirmediğini veya sadece okunabilir olup olmadığını gösterir. Bir MCP sunucusuna ile readOnlyHintek açıklama eklenir.bu filtreyle eşleşecektir. |
Hayı | |
| tool_names | dize dizisi | İzin verilen araç adlarının listesi. | Hayı |
OpenAI.MCPToolRequireApproval
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| always | OpenAI.MCPToolFilter | Hangi araçların izin verildiğini belirtmek için bir filtre nesnesi. | Hayı | |
| hiç | OpenAI.MCPToolFilter | Hangi araçların izin verildiğini belirtmek için bir filtre nesnesi. | Hayı |
OpenAI.MessageContent
Giriş veya çıkış öğesini oluşturan içerik bölümü.
OpenAI.MessageContent için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
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 |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.MessageContentType | Evet |
OpenAI.MessageContentInputFileContent
Modele bir dosya girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| file_data | String | Modele gönderilecek dosyanın içeriği. | Hayı | |
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| file_url | String | Modele gönderilecek dosyanın URL'si. | Hayı | |
| filename | String | Modele gönderilecek dosyanın adı. | Hayı | |
| type | enum | Giriş öğesinin türü. Her zaman input_file.Olası değerler: input_file |
Evet |
OpenAI.MessageContentInputImageContent
Modele bir görüntü girişi. image girişleri hakkında bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Evet | ||
| dosya_kimlik | dize (null atanabilir) | Hayı | ||
| image_url | String | Hayı | ||
| type | enum | Giriş öğesinin türü. Her zaman input_image.Olası değerler: input_image |
Evet |
OpenAI.MessageContentInputTextContent
Modele metin girişi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modele metin girişi. | Evet | |
| type | enum | Giriş öğesinin türü. Her zaman input_text.Olası değerler: input_text |
Evet |
OpenAI.MessageContentOutputTextContent
Modelden bir metin çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Açıklamalar | OpenAI.Annotation dizisi | Metin çıkışının ek açıklamaları. | Evet | |
| logprobs | OpenAI.LogProb dizisi | Hayı | ||
| text | String | Modelden metin çıkışı. | Evet | |
| type | enum | Çıkış metninin türü. Her zaman output_text.Olası değerler: output_text |
Evet |
OpenAI.MessageContentReasoningTextContent
Modelden mantık metni.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modelden gelen mantık metni. | Evet | |
| type | enum | Akıl yürütme metninin türü. Her zaman reasoning_text.Olası değerler: reasoning_text |
Evet |
OpenAI.MessageContentRefusalContent
Model tarafından reddedilme.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Ret | String | Modelin sunduğu reddetme gerekçesi. | Evet | |
| type | enum | Reddetmenin türü. Her zaman refusal.Olası değerler: refusal |
Evet |
OpenAI.MessageContentType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | input_textoutput_texttextsummary_textreasoning_textrefusalinput_imagecomputer_screenshotinput_file |
OpenAI.MessageRole
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | unknownuserassistantsystemcriticdiscriminatordevelopertool |
OpenAI.MessageStatus
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | in_progresscompletedincomplete |
OpenAI.Metadata
Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, nesne hakkında ek bilgileri yapılandırılmış biçimde depolamak ve API veya pano aracılığıyla nesneleri sorgulamak için yararlı olabilir. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir.
Tür: nesne
OpenAI.ModelIdsCompaction
veya gpt-5gibi o3 yanıtı oluşturmak için kullanılan model kimliği. OpenAI farklı özelliklere, performans özelliklerine ve fiyat noktalarına sahip çok çeşitli modeller sunar. Kullanılabilir modellere göz atmak ve modelleri karşılaştırmak için model kılavuzuna bakın.
Tür: OpenAI.ModelIdsResponses veya dize
veya gpt-5gibi o3 yanıtı oluşturmak için kullanılan model kimliği. OpenAI farklı özelliklere, performans özelliklerine ve fiyat noktalarına sahip çok çeşitli modeller sunar. Kullanılabilir modellere göz atmak ve modelleri karşılaştırmak için model kılavuzuna bakın.
OpenAI.ModelIdsResponses
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Tür: dize veya OpenAI.ChatModel
OpenAI.Move
Fare hareket ettirme eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olay türünü belirtir. Taşıma eylemi için bu özellik her zaman move olarak ayarlanır.Olası değerler: move |
Evet | |
| x | OpenAI.integer | Evet | ||
| y | OpenAI.integer | Evet |
OpenAI.OutputContent
OpenAI.OutputContent için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
output_text |
OpenAI.OutputContentOutputTextContent |
refusal |
OpenAI.OutputContentRefusalContent |
reasoning_text |
OpenAI.OutputContentReasoningTextContent |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.OutputContentType | Evet |
OpenAI.OutputContentOutputTextContent
Modelden bir metin çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Açıklamalar | OpenAI.Annotation dizisi | Metin çıkışının ek açıklamaları. | Evet | |
| logprobs | OpenAI.LogProb dizisi | Hayı | ||
| text | String | Modelden metin çıkışı. | Evet | |
| type | enum | Çıkış metninin türü. Her zaman output_text.Olası değerler: output_text |
Evet |
OpenAI.OutputContentReasoningTextContent
Modelden mantık metni.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modelden gelen mantık metni. | Evet | |
| type | enum | Akıl yürütme metninin türü. Her zaman reasoning_text.Olası değerler: reasoning_text |
Evet |
OpenAI.OutputContentRefusalContent
Model tarafından reddedilme.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Ret | String | Modelin sunduğu reddetme gerekçesi. | Evet | |
| type | enum | Reddetmenin türü. Her zaman refusal.Olası değerler: refusal |
Evet |
OpenAI.OutputContentType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | output_textrefusalreasoning_text |
OpenAI.OutputItem
OpenAI.OutputItem için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| type | OpenAI.OutputItemType | Evet |
OpenAI.OutputItemApplyPatchToolCall
Dosya oluşturarak, silerek veya güncelleştirerek dosya farklarını uygulayan bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu araç çağrısını oluşturan varlığın kimliği. | Hayı | |
| kimlik | String | Düzeltme eki uygulama aracı çağrısının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| Operasyon | OpenAI.ApplyPatchFileOperation | apply_patch aracılığıyla uygulanan create_file, delete_file veya update_file işlemlerinden biri. | Evet | |
| └─ türü | OpenAI.ApplyPatchFileOperationType | Evet | ||
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | OpenAI.ApplyPatchCallStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman apply_patch_call.Olası değerler: apply_patch_call |
Evet |
OpenAI.OutputItemApplyPatchToolCallOutput
Bir düzeltme eki uygulama aracı çağrısı tarafından yayılan çıkış.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Model tarafından oluşturulan uygulama yama aracı çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu aracı oluşturan varlığın kimliği çağrı çıktısı. | Hayı | |
| kimlik | String | Düzeltme eki uygulama aracı çağrı çıkışının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | OpenAI.ApplyPatchCallOutputStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman apply_patch_call_output.Olası değerler: apply_patch_call_output |
Evet |
OpenAI.OutputItemCodeInterpreterToolCall
Kodu çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| kod | dize (null atanabilir) | Evet | ||
| container_id | String | Kodu çalıştırmak için kullanılan kapsayıcının kimliği. | Evet | |
| kimlik | String | Kod yorumlayıcısı araç çağrısının benzersiz kimliği. | Evet | |
| Çıktılar | OpenAI.CodeInterpreterOutputLogs veya OpenAI.CodeInterpreterOutputImage dizisi | Evet | ||
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Kod yorumlayıcı aracı çağrısının durumu. Geçerli değerler : in_progress, completed, incomplete, interpretingve failed.Olası değerler: in_progress, completed, incomplete, interpreting, failed |
Evet | |
| type | enum | Kod yorumlayıcı aracı çağrısının türü. Her zaman code_interpreter_call.Olası değerler: code_interpreter_call |
Evet |
OpenAI.OutputItemCompactionBody
API tarafından v1/responses/compactoluşturulan bir sıkıştırma öğesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| Oluşturan | String | Öğeyi oluşturan aktörün tanımlayıcısı. | Hayı | |
| encrypted_content | String | Sıkıştırma tarafından oluşturulan şifrelenmiş içerik. | Evet | |
| kimlik | String | Sıkıştırma öğesinin benzersiz kimliği. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| type | enum | Öğenin türü. Her zaman compaction.Olası değerler: compaction |
Evet |
OpenAI.OutputItemComputerToolCall
Bilgisayar kullanım araçlarına bir araç komutu verme. Daha fazla bilgi için bilgisayar kullanım rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.ComputerAction | Evet | ||
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Çıkış verisi ile araç çağrısına yanıt verirken kullanılan tanımlayıcı. | Evet | |
| kimlik | String | Bilgisayar çağrısının benzersiz tanımlayıcısı. | Evet | |
| pending_safety_checks | OpenAI.ComputerCallSafetyCheckParam dizisi | Bilgisayar çağrısı için bekleyen güvenlik denetimleri. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Bilgisayar çağrısının türü. Her zaman computer_call.Olası değerler: computer_call |
Evet |
OpenAI.OutputItemCustomToolCall
Model tarafından oluşturulan özel bir araca çağrı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Bu özel araç çağrısını bir araç çağrısı çıktısına eşlemek için kullanılan bir tanımlayıcı. | Evet | |
| kimlik | String | OpenAI platformundaki özel araç çağrısının benzersiz kimliği. | Hayı | |
| girdi | String | Model tarafından oluşturulan özel araç çağrısı için girdi. | Evet | |
| name | String | Çağrılan özel aracın adı. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| type | enum | Özel araç çağrısının türü. Her zaman custom_tool_call.Olası değerler: custom_tool_call |
Evet |
OpenAI.OutputItemFileSearchToolCall
Dosya arama aracı çağrısının sonuçları. Daha fazla bilgi için dosya arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| kimlik | String | Dosya arama aracı çağrısının benzersiz kimliği. | Evet | |
| queries | dize dizisi | Dosyaları aramak için kullanılan sorgular. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| results | OpenAI.FileSearchToolCallResults dizisi | Hayı | ||
| durum | enum | Dosya arama aracı çağrısının durumu. Bunlardan biri in_progresssearching, incomplete veya failed,Olası değerler: in_progress, searching, completed, incomplete, failed |
Evet | |
| type | enum | Dosya arama aracı çağrısının türü. Her zaman file_search_call.Olası değerler: file_search_call |
Evet |
OpenAI.OutputItemFunctionShellCall
Yönetilen bir ortamda bir veya daha fazla kabuk komutu yürüten bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.FunctionShellAction | Bir kabuk komutu yürütür. | Evet | |
| └─ komutları | dize dizisi | Evet | ||
| └─ max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| └─ timeout_ms | OpenAI.integer (null atanabilir) | Evet | ||
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Bu araç çağrısını oluşturan varlığın kimliği. | Hayı | |
| kimlik | String | Kabuk aracı çağrısının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | OpenAI.LocalShellCallStatus | Evet | ||
| type | enum | Öğenin türü. Her zaman shell_call.Olası değerler: shell_call |
Evet |
OpenAI.OutputItemFunctionShellCallOutput
Yayılan bir kabuk aracı çağrısının çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Model tarafından oluşturulan shell araç çağrısının benzersiz kimliği. | Evet | |
| Oluşturan | String | Öğeyi oluşturan aktörün tanımlayıcısı. | Hayı | |
| kimlik | String | Kabuk çağrısı çıkışının benzersiz kimliği. Bu öğe, API aracılığıyla iade edildiğinde doldurulur. | Evet | |
| max_output_length | OpenAI.integer (null atanabilir) | Evet | ||
| çıktı | OpenAI.FunctionShellCallOutputContent dizisi | Kabuk çağrısı çıkış içeriği dizisi | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| type | enum | Kabuk çağrısı çıkışının türü. Her zaman shell_call_output.Olası değerler: shell_call_output |
Evet |
OpenAI.OutputItemFunctionToolCall
Bir fonksiyonu çalıştırmak için bir araç çağrısı. Daha fazla bilgi için function çağrı rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| arguments | String | İşleve geçirecek bağımsız değişkenlerin JSON dizesi. | Evet | |
| call_id | String | Model tarafından oluşturulan işlev aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | İşlev aracı çağrısının benzersiz kimliği. | Hayı | |
| name | String | Çalıştırılacak işlevin adı. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| type | enum | İşlev aracı çağrısının türü. Her zaman function_call.Olası değerler: function_call |
Evet |
OpenAI.OutputItemImageGenToolCall
Model tarafından yapılan bir görüntü oluşturma isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| kimlik | String | Görüntü oluşturma çağrısının benzersiz kimliği. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| sonuç | dize (null atanabilir) | Evet | ||
| durum | enum | Görüntü oluşturma çağrısının durumu. Olası değerler: in_progress, completed, generating, failed |
Evet | |
| type | enum | Görüntü oluşturma çağrısının türü. Her zaman image_generation_call.Olası değerler: image_generation_call |
Evet |
OpenAI.OutputItemLocalShellToolCall
Yerel kabukta komut çalıştırmak için bir araç çağrısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.LocalShellExecAction | Sunucuda bir kabuk komutu yürütür. | Evet | |
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| call_id | String | Model tarafından oluşturulan yerel kabuk aracı çağrısının benzersiz kimliği. | Evet | |
| kimlik | String | Yerel shell çağrısının benzersiz kimliği. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Yerel shell çağrısının durumu. Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Yerel shell call'ın türü. Her zaman local_shell_call.Olası değerler: local_shell_call |
Evet |
OpenAI.OutputItemMcpApprovalRequest
Bir araç çağrısı işlemi için insan onayı isteği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| arguments | String | Araç için bir JSON bağımsız değişken dizesi. | Evet | |
| kimlik | String | Onay talebinin benzersiz kimliği. | Evet | |
| name | String | Çalıştırılacak aracın adı. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| sunucu etiketi | String | İsteği yapan MCP sunucusunun etiketi. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_approval_request.Olası değerler: mcp_approval_request |
Evet |
OpenAI.OutputItemMcpListTools
MCP sunucusunda kullanılabilen araçların listesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Listenin benzersiz kimliği. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| sunucu etiketi | String | MCP sunucusunun etiketi. | Evet | |
| araçlar | OpenAI.MCPListToolsTool dizisi | Sunucuda bulunan araçlar. | Evet | |
| type | enum | Öğenin türü. Her zaman mcp_list_tools.Olası değerler: mcp_list_tools |
Evet |
OpenAI.OutputItemMcpToolCall
MCP sunucusundaki bir aracın çağrılması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| approval_request_id | dize (null atanabilir) | Hayı | ||
| arguments | String | Araca geçirilen bağımsız değişkenlerin JSON dizesi. | Evet | |
| hata | dize (null atanabilir) | Hayı | ||
| kimlik | String | Araç çağrısının benzersiz kimliği. | Evet | |
| name | String | Çalıştırılan aracın adı. | Evet | |
| çıktı | dize (null atanabilir) | Hayı | ||
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| sunucu etiketi | String | Aracı çalıştıran MCP sunucusunun etiketi. | Evet | |
| durum | OpenAI.MCPToolCallStatus | Hayı | ||
| type | enum | Öğenin türü. Her zaman mcp_call.Olası değerler: mcp_call |
Evet |
OpenAI.OutputItemOutputMessage
Modelden bir çıkış iletisi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| içerik | OpenAI.OutputMessageContent dizisi | Çıkış iletisinin içeriği. | Evet | |
| kimlik | String | Çıkış iletisinin benzersiz kimliği. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| role | enum | Çıkış iletisinin rolü. Her zaman assistant.Olası değerler: assistant |
Evet | |
| durum | enum | İleti girişinin durumu.
in_progress, completed, veya bunlardan biriincomplete. API aracılığıyla giriş öğeleri döndürüldüğünde doldurulur.Olası değerler: in_progress, completed, incomplete |
Evet | |
| type | enum | Çıkış iletisinin türü. Her zaman message.Olası değerler: output_message |
Evet |
OpenAI.OutputItemReasoningItem
Bir yanıt oluştururken bir akıl yürütme modeli tarafından kullanılan düşünce zincirinin açıklaması. Eğer konuşmanın sonraki turlarında bu öğeleri bağlam yönetiyorsanız ile manuel olarak konuşuyorsanız, Responses API'ye input hesabınıza dahil edin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| içerik | OpenAI.ReasoningTextContent dizisi | Metin içeriğini akıl yürütme. | Hayı | |
| encrypted_content | dize (null atanabilir) | Hayı | ||
| kimlik | String | Akıl yürütme içeriğinin benzersiz tanımlayıcısı. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Öğenin durumu.
in_progress, completed, veya bunlardan biriincomplete. Öğeler API aracılığıyla döndürülürken doldurulur.Olası değerler: in_progress, completed, incomplete |
Hayı | |
| summary | OpenAI.Summary dizisi | Akıl yürütme özeti içeriği. | Evet | |
| type | enum | Nesnenin türü. Her zaman reasoning.Olası değerler: reasoning |
Evet |
OpenAI.OutputItemType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Bir web arama aracı çağrısının sonuçları. Daha fazla bilgi için web arama rehberi adresine bakınız.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hareket | OpenAI.WebSearchActionSearch veya OpenAI.WebSearchActionOpenPage veya OpenAI.WebSearchActionFind | Bu web arama çağrısında gerçekleştirilen belirli eylemi açıklayan bir nesne. Modelin web'i nasıl kullandığına ilişkin ayrıntıları içerir (arama, open_page, bulma). |
Evet | |
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| kimlik | String | Web arama aracının benzersiz kimliği çağrı. | Evet | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Web arama aracı çağrısının durumu. Olası değerler: in_progress, searching, completed, failed |
Evet | |
| type | enum | Web arama aracının türü. Her zaman web_search_call.Olası değerler: web_search_call |
Evet |
OpenAI.OutputMessageContent
OpenAI.OutputMessageContent için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
output_text |
OpenAI.OutputMessageContentOutputTextContent |
refusal |
OpenAI.OutputMessageContentRefusalContent |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.OutputMessageContentType | Evet |
OpenAI.OutputMessageContentOutputTextContent
Modelden bir metin çıktısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Açıklamalar | OpenAI.Annotation dizisi | Metin çıkışının ek açıklamaları. | Evet | |
| logprobs | OpenAI.LogProb dizisi | Hayı | ||
| text | String | Modelden metin çıkışı. | Evet | |
| type | enum | Çıkış metninin türü. Her zaman output_text.Olası değerler: output_text |
Evet |
OpenAI.OutputMessageContentRefusalContent
Model tarafından reddedilme.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| Ret | String | Modelin sunduğu reddetme gerekçesi. | Evet | |
| type | enum | Reddetmenin türü. Her zaman refusal.Olası değerler: refusal |
Evet |
OpenAI.OutputMessageContentType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | output_textrefusal |
OpenAI.Prompt
bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kimlik | String | Kullanılacak istem şablonunun benzersiz tanımlayıcısı. | Evet | |
| değişkenler | OpenAI.ResponsePromptVariables (null atanabilir) | içindeki değişkenlerin yerine kullanılacak isteğe bağlı değer eşlemesi Istemi. Değiştirme değerleri dizeler veya başka bir değer olabilir Görüntüler veya dosyalar gibi yanıt giriş türleri. |
Hayı | |
| version | dize (null atanabilir) | Hayı |
OpenAI.RankerVersionType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | autodefault-2024-11-15 |
OpenAI.RankingOptions
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hybrid_search | OpenAI.HybridSearchOptions | Hayı | ||
| └─ embedding_weight | OpenAI.numeric | Karşılıklı sıralama füzyonundaki gömülen ağırlığı. | Evet | |
| └─ text_weight | OpenAI.numeric | Karşılıklı sıralama birleşimindeki metnin ağırlığı. | Evet | |
| sıralayıcı | OpenAI.RankerVersionType | Hayı | ||
| puan_eşik_değeri | OpenAI.numeric | Hayı |
OpenAI.Reasoning
Sadece GPT-5 ve O-serisi modelleri Akıl yürütme modelleri için yapılandırma seçenekleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| effort | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| generate_summary | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| summary | enum | Olası değerler: auto, concise, detailed |
Hayı |
OpenAI.ReasoningEffort
Mantıp modelleri için mantık yürütme çabasını kısıtlar.
Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Muhakeme çabasının azaltılması, yanıtta daha hızlı yanıtlar ve daha az belirteç kullanılmasına neden olabilir.
-
gpt-5.1varsayılan olaraknone, bu da akıl yürütme yapmaz. Desteklenen gerekçe değerlerigpt-5.1none,low,medium, vehigh'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir. - Önceki
gpt-5.1tüm modeller varsayılan olarakmediumakıl yürütme çabasına geçer venonedesteklemez. - Model
gpt-5-provarsayılan olarak (ve sadece destekliyor)highakıl yürütme çabasını kullanır. -
xhighsonrası tüm modellergpt-5.1-codex-maxiçin desteklenir.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Nullable | Evet |
| Değerler | noneminimallowmediumhighxhigh |
OpenAI.ReasoningTextContent
Modelden mantık metni.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modelden gelen mantık metni. | Evet | |
| type | enum | Akıl yürütme metninin türü. Her zaman reasoning_text.Olası değerler: reasoning_text |
Evet |
OpenAI.Response
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference (null atanabilir) | Evet | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| arka plan | boole değeri (null atanabilir) | Hayı | ||
| tamamlanma_tarihi | tamsayı | Hayı | ||
| konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ kimlik | String | Bu yanıtın ilişkilendirildiği konuşmanın benzersiz kimliği. | Evet | |
| oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kod | OpenAI.ResponseErrorCode | Yanıtın hata kodu. | Evet | |
| └─ ileti | String | Hatanın insan tarafından okunabilen açıklaması. | Evet | |
| kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| incomplete_details | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ neden | enum | Olası değerler: max_output_tokens, content_filter |
Hayı | |
| instructions | OpenAI.InputItem dizesi veya dizisi | Evet | ||
| max_output_tokens | OpenAI.integer (null atanabilir) | Hayı | ||
| max_tool_calls | OpenAI.integer (null atanabilir) | Hayı | ||
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| model | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| çıktı | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| output_text | dize (null atanabilir) | Hayı | ||
| paralel araç çağrıları | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| previous_response_id | dize (null atanabilir) | Hayı | ||
| prompt | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| reasoning | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ çaba | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| └─ özet oluştur | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| └─ özeti | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| hizmet seviyesi | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| durum | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| text | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| tool_choice | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| araçlar | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| truncation | enum | Olası değerler: auto, disabled |
Hayı | |
| usage | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| user | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı |
OpenAI.ResponseAudioDeltaEvent
Kısmi bir ses yanıtı olduğunda yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | Base64 kodlanmış yanıt ses baytlarının bir öbeği. | Evet | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.audio.delta.Olası değerler: response.audio.delta |
Evet |
OpenAI.ResponseAudioDoneEvent
Ses yanıtı tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.audio.done.Olası değerler: response.audio.done |
Evet |
OpenAI.ResponseAudioTranscriptDeltaEvent
Sesin kısmi bir transkripti olduğunda yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | Ses yanıtının kısmi transkripti. | Evet | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.audio.transcript.delta.Olası değerler: response.audio.transcript.delta |
Evet |
OpenAI.ResponseAudioTranscriptDoneEvent
Tam ses transkripti tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.audio.transcript.done.Olası değerler: response.audio.transcript.done |
Evet |
OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent
Kısmi kod parçacığı kod yorumlayıcı tarafından akışa alındığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | Kod yorumlayıcı tarafından akışı yapılan kısmi kod parçacığı. | Evet | |
| item_id | String | Kod yorumlayıcı aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.code_interpreter_call_code.delta.Olası değerler: response.code_interpreter_call_code.delta |
Evet |
OpenAI.ResponseCodeInterpreterCallCodeDoneEvent
Kod parçacığı kod yorumlayıcı tarafından sonlandırıldığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | String | Kod yorumlayıcısı tarafından son kod parçacığı çıkışı. | Evet | |
| item_id | String | Kod yorumlayıcı aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.code_interpreter_call_code.done.Olası değerler: response.code_interpreter_call_code.done |
Evet |
OpenAI.ResponseCodeInterpreterCallCompletedEvent
Kod yorumlayıcı çağrısı tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Kod yorumlayıcı aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.code_interpreter_call.completed.Olası değerler: response.code_interpreter_call.completed |
Evet |
OpenAI.ResponseCodeInterpreterCallInProgressEvent
Bir kod yorumlayıcı çağrısı sırasında tetiklenir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Kod yorumlayıcı aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.code_interpreter_call.in_progress.Olası değerler: response.code_interpreter_call.in_progress |
Evet |
OpenAI.ResponseCodeInterpreterCallInterpretingEvent
Kod yorumlayıcısı kod parçacığını etkin bir şekilde yorumladığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Kod yorumlayıcı aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.code_interpreter_call.interpreting.Olası değerler: response.code_interpreter_call.interpreting |
Evet |
OpenAI.ResponseCompletedEvent
Model yanıtı tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| yanıt | OpenAI.Response | Evet | ||
| └─ agent_reference | AgentReference (null atanabilir) | Bu yanıt için kullanılan aracı | Evet | |
| └─ arka plan | boole değeri (null atanabilir) | Hayı | ||
| └─ completed_at | integer (null atanabilir) | Hayı | ||
| └─ konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| └─ hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| └─ eksik_bilgiler | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ yönerge | OpenAI.InputItem dizesi veya dizisi (null atanabilir) | Evet | ||
| └─ maksimum_çıkış_jetonları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ maksimum araç çağrıları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ meta veriler | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| └─ modeli | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| └─ nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| └─ çıkış | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| └─ çıktı_metin | dize (null atanabilir) | Hayı | ||
| └─ paralel_arac_cagrilari | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| └─ önceki_cevap_id | dize (null atanabilir) | Hayı | ||
| └─ istemi | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| └─ akıl yürütme | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| └─ service_tier | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| └─ durumu | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ metin | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| └─ araç seçimi | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| └─ araçları | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| └─ top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ kısaltma | enum | Olası değerler: auto, disabled |
Hayı | |
| └─ kullanımı | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| └─ kullanıcı | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.completed.Olası değerler: response.completed |
Evet |
OpenAI.ResponseContentPartAddedEvent
Yeni bir içerik bölümü eklendiğinde gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| item_id | String | İçerik bölümünün eklendiği çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| parça | OpenAI.OutputContent | Evet | ||
| └─ türü | OpenAI.OutputContentType | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.content_part.added.Olası değerler: response.content_part.added |
Evet |
OpenAI.ResponseContentPartDoneEvent
İçerik bölümü tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| item_id | String | İçerik bölümünün eklendiği çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| parça | OpenAI.OutputContent | Evet | ||
| └─ türü | OpenAI.OutputContentType | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.content_part.done.Olası değerler: response.content_part.done |
Evet |
OpenAI.ResponseCreatedEvent
Bir yanıt oluşturulduğunda yayılan bir olay.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| yanıt | OpenAI.Response | Evet | ||
| └─ agent_reference | AgentReference (null atanabilir) | Bu yanıt için kullanılan aracı | Evet | |
| └─ arka plan | boole değeri (null atanabilir) | Hayı | ||
| └─ completed_at | integer (null atanabilir) | Hayı | ||
| └─ konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| └─ hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| └─ eksik_bilgiler | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ yönerge | OpenAI.InputItem dizesi veya dizisi (null atanabilir) | Evet | ||
| └─ maksimum_çıkış_jetonları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ maksimum araç çağrıları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ meta veriler | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| └─ modeli | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| └─ nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| └─ çıkış | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| └─ çıktı_metin | dize (null atanabilir) | Hayı | ||
| └─ paralel_arac_cagrilari | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| └─ önceki_cevap_id | dize (null atanabilir) | Hayı | ||
| └─ istemi | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| └─ akıl yürütme | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| └─ service_tier | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| └─ durumu | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ metin | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| └─ araç seçimi | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| └─ araçları | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| └─ top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ kısaltma | enum | Olası değerler: auto, disabled |
Hayı | |
| └─ kullanımı | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| └─ kullanıcı | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.created.Olası değerler: response.created |
Evet |
OpenAI.ResponseCustomToolCallInputDeltaEvent
Özel bir araç çağrısının girişine delta (kısmi güncelleştirme) temsil eden olay.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | Özel araç çağrısı için artımlı giriş verileri (delta). | Evet | |
| item_id | String | Bu olayla ilişkili API öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olay türü tanımlayıcısı. Olası değerler: response.custom_tool_call_input.delta |
Evet |
OpenAI.ResponseCustomToolCallInputDoneEvent
Özel bir araç çağrısı için girişin tamamlandığını belirten olay.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| girdi | String | Özel araç çağrısı için tam giriş verileri. | Evet | |
| item_id | String | Bu olayla ilişkili API öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olay türü tanımlayıcısı. Olası değerler: response.custom_tool_call_input.done |
Evet |
OpenAI.ResponseError
Model yanıt oluşturamadığında döndürülen bir hata nesnesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | OpenAI.ResponseErrorCode | Yanıtın hata kodu. | Evet | |
| mesaj | String | Hatanın insan tarafından okunabilen açıklaması. | Evet |
OpenAI.ResponseErrorCode
Yanıtın hata kodu.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Bir hata oluştuğunda yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| kod | dize (null atanabilir) | Evet | ||
| mesaj | String | Hata iletisi. | Evet | |
| param | dize (null atanabilir) | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman error.Olası değerler: error |
Evet |
OpenAI.ResponseFailedEvent
Yanıt başarısız olduğunda yayılan bir olay.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| yanıt | OpenAI.Response | Evet | ||
| └─ agent_reference | AgentReference (null atanabilir) | Bu yanıt için kullanılan aracı | Evet | |
| └─ arka plan | boole değeri (null atanabilir) | Hayı | ||
| └─ completed_at | integer (null atanabilir) | Hayı | ||
| └─ konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| └─ hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| └─ eksik_bilgiler | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ yönerge | OpenAI.InputItem dizesi veya dizisi (null atanabilir) | Evet | ||
| └─ maksimum_çıkış_jetonları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ maksimum araç çağrıları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ meta veriler | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| └─ modeli | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| └─ nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| └─ çıkış | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| └─ çıktı_metin | dize (null atanabilir) | Hayı | ||
| └─ paralel_arac_cagrilari | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| └─ önceki_cevap_id | dize (null atanabilir) | Hayı | ||
| └─ istemi | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| └─ akıl yürütme | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| └─ service_tier | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| └─ durumu | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ metin | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| └─ araç seçimi | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| └─ araçları | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| └─ top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ kısaltma | enum | Olası değerler: auto, disabled |
Hayı | |
| └─ kullanımı | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| └─ kullanıcı | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.failed.Olası değerler: response.failed |
Evet |
OpenAI.ResponseFileSearchCallCompletedEvent
Bir dosya arama çağrısı tamamlandığında (sonuçlar bulundu) yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Dosya arama çağrısının başlatıldığı çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.file_search_call.completed.Olası değerler: response.file_search_call.completed |
Evet |
OpenAI.ResponseFileSearchCallInProgressEvent
Bir dosya arama çağrısı başlatıldığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Dosya arama çağrısının başlatıldığı çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.file_search_call.in_progress.Olası değerler: response.file_search_call.in_progress |
Evet |
OpenAI.ResponseFileSearchCallSearchingEvent
Bir dosya araması sırasında arama yapıldığında tetiklenir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Dosya arama çağrısının başlatıldığı çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.file_search_call.searching.Olası değerler: response.file_search_call.searching |
Evet |
OpenAI.ResponseFormatJsonObject
JSON nesne yanıt biçimi. JSON yanıtları oluşturmanın eski bir yöntemi.
Bunu destekleyen modeller için kullanılması json_schema önerilir. Modelin, bir sistem veya kullanıcı mesajı olmadan JSON oluşturmayacağını unutmayın, bunu to do etmelidir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman json_object.Olası değerler: json_object |
Evet |
OpenAI.ResponseFormatJsonSchema
JSON Şeması yanıt biçimi. Yapılandırılmış JSON yanıtları oluşturmak için kullanılır. Yapılandırılmış Çıktılar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| json şeması | OpenAI.ResponseFormatJsonSchemaJsonSchema | Evet | ||
| └─ açıklama | String | Hayı | ||
| └─ ad | String | Evet | ||
| └─ şeması | OpenAI.YanıtFormatıJsonŞemaŞeması | JSON Şeması nesnesi olarak tanımlanan yanıt biçimi şeması. JSON şemaları oluşturmayı buradan öğrenin. |
Hayı | |
| └─ katı | boole değeri (null atanabilir) | Hayı | ||
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman json_schema.Olası değerler: json_schema |
Evet |
OpenAI.ResponseFormatJsonSchemaJsonSchema
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Hayı | ||
| name | String | Evet | ||
| şema | OpenAI.YanıtFormatıJsonŞemaŞeması | JSON Şeması nesnesi olarak tanımlanan yanıt biçimi şeması. JSON şemaları oluşturmayı buradan öğrenin. |
Hayı | |
| Sıkı | boole değeri (null atanabilir) | Hayı |
OpenAI.CevapFormatJsonŞemaŞeması
JSON Şeması nesnesi olarak tanımlanan yanıt biçimi şeması. JSON şemaları oluşturmayı buradan öğrenin.
Tür: nesne
OpenAI.ResponseFormatText
Varsayılan yanıt biçimi. Metin yanıtları oluşturmak için kullanılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman text.Olası değerler: text |
Evet |
OpenAI.ResponseFunctionCallArgumentsDeltaEvent
Kısmi işlev çağrısı bağımsız değişkenleri delta olduğunda yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | Fonksiyon çağrısı argümanlarına eklenen delta. | Evet | |
| item_id | String | delta işlev çağrısı bağımsız değişkenlerinin eklendiği çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.function_call_arguments.delta.Olası değerler: response.function_call_arguments.delta |
Evet |
OpenAI.ResponseFunctionCallArgumentsDoneEvent
İşlev çağrısı bağımsız değişkenleri sonlandırıldığında verilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | İşlev çağrısı için argümanlar. | Evet | |
| item_id | String | Öğenin kimliği. | Evet | |
| name | String | Çağrılan işlevin adı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olası değerler: response.function_call_arguments.done |
Evet |
OpenAI.ResponseImageGenCallCompletedEvent
Görüntü oluşturma aracı çağrısı tamamlandığında ve son görüntü kullanılabilir olduğunda yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | İşlenmekte olan görüntü oluşturma öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.image_generation_call.completed' şeklinde. Olası değerler: response.image_generation_call.completed |
Evet |
OpenAI.ResponseImageGenCallGeneratingEvent
Görüntü oluşturma aracı çağrısı (ara durum) etkin bir şekilde görüntü oluştururken tetiklenir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | İşlenmekte olan görüntü oluşturma öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.image_generation_call.generating'. Olası değerler: response.image_generation_call.generating |
Evet |
OpenAI.ResponseImageGenCallInProgressEvent
Görüntü oluşturma aracı çağrısı devam ederken bir bildirim gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | İşlenmekte olan görüntü oluşturma öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.image_generation_call.in_progress'. Olası değerler: response.image_generation_call.in_progress |
Evet |
OpenAI.ResponseImageGenCallPartialImageEvent
Görüntü oluşturma akışı sırasında kısmi bir görüntü kullanılabilir olduğunda emit edilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | İşlenmekte olan görüntü oluşturma öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| partial_image_b64 | String | Base64 ile kodlanmış kısmi görüntü verileri, görüntü olarak işleme için uygundur. | Evet | |
| partial_image_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.image_generation_call.partial_image'. Olası değerler: response.image_generation_call.partial_image |
Evet |
OpenAI.ResponseInProgressEvent
Yanıt devam ederken gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| yanıt | OpenAI.Response | Evet | ||
| └─ agent_reference | AgentReference (null atanabilir) | Bu yanıt için kullanılan aracı | Evet | |
| └─ arka plan | boole değeri (null atanabilir) | Hayı | ||
| └─ completed_at | integer (null atanabilir) | Hayı | ||
| └─ konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| └─ hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| └─ eksik_bilgiler | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ yönerge | OpenAI.InputItem dizesi veya dizisi (null atanabilir) | Evet | ||
| └─ maksimum_çıkış_jetonları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ maksimum araç çağrıları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ meta veriler | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| └─ modeli | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| └─ nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| └─ çıkış | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| └─ çıktı_metin | dize (null atanabilir) | Hayı | ||
| └─ paralel_arac_cagrilari | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| └─ önceki_cevap_id | dize (null atanabilir) | Hayı | ||
| └─ istemi | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| └─ akıl yürütme | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| └─ service_tier | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| └─ durumu | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ metin | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| └─ araç seçimi | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| └─ araçları | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| └─ top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ kısaltma | enum | Olası değerler: auto, disabled |
Hayı | |
| └─ kullanımı | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| └─ kullanıcı | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.in_progress.Olası değerler: response.in_progress |
Evet |
OpenAI.ResponseIncompleteDetails
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sebep | enum | Olası değerler: max_output_tokens, content_filter |
Hayı |
OpenAI.ResponseIncompleteEvent
Yanıt eksik olduğunda yayılan bir olay.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| yanıt | OpenAI.Response | Evet | ||
| └─ agent_reference | AgentReference (null atanabilir) | Bu yanıt için kullanılan aracı | Evet | |
| └─ arka plan | boole değeri (null atanabilir) | Hayı | ||
| └─ completed_at | integer (null atanabilir) | Hayı | ||
| └─ konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| └─ hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| └─ eksik_bilgiler | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ yönerge | OpenAI.InputItem dizesi veya dizisi (null atanabilir) | Evet | ||
| └─ maksimum_çıkış_jetonları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ maksimum araç çağrıları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ meta veriler | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| └─ modeli | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| └─ nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| └─ çıkış | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| └─ çıktı_metin | dize (null atanabilir) | Hayı | ||
| └─ paralel_arac_cagrilari | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| └─ önceki_cevap_id | dize (null atanabilir) | Hayı | ||
| └─ istemi | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| └─ akıl yürütme | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| └─ service_tier | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| └─ durumu | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ metin | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| └─ araç seçimi | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| └─ araçları | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| └─ top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ kısaltma | enum | Olası değerler: auto, disabled |
Hayı | |
| └─ kullanımı | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| └─ kullanıcı | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.incomplete.Olası değerler: response.incomplete |
Evet |
OpenAI.ResponseLogProb
Logprob, modelin dizideki belirli bir konumda belirli bir belirteci üretmeye atayan logaritmik olasılıktır. Daha az negatif (daha yüksek) logprob değerleri, bu belirteç seçiminde model güvenilirliğinin daha yüksek olduğunu gösterir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| logprob | OpenAI.numeric | Evet | ||
| token | String | Olası bir metin belirteci. | Evet | |
| top_logprobs | OpenAI.ResponseLogProbTopLogprobs dizisi | En olası 20 belirtecin günlük olasılığı. | Hayı |
OpenAI.ResponseLogProbTopLogprobs
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| logprob | OpenAI.numeric | Hayı | ||
| token | String | Hayı |
OpenAI.ResponseMCPCallArgumentsDeltaEvent
MCP araç çağrısının bağımsız değişkenlerinde delta (kısmi güncelleştirme) olduğunda gerçekleşir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | MCP araç çağrısı için bağımsız değişkenlere yönelik kısmi güncelleştirmeyi içeren bir JSON dizesi. | Evet | |
| item_id | String | İşlenen MCP aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_call_arguments.delta'. Olası değerler: response.mcp_call_arguments.delta |
Evet |
OpenAI.ResponseMCPCallArgumentsDoneEvent
Bir MCP araç çağrısı için bağımsız değişkenler sonlandırıldığında oluşur.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arguments | String | MCP araç çağrısı için son haline getirilmiş bağımsız değişkenleri içeren bir JSON dizesi. | Evet | |
| item_id | String | İşlenen MCP aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_call_arguments.bitti'. Olası değerler: response.mcp_call_arguments.done |
Evet |
OpenAI.ResponseMCPCallCompletedEvent
BIR MCP araç çağrısı başarıyla tamamlandığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Tamamlanan MCP aracı çağrı öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_call.completed'. Olası değerler: response.mcp_call.completed |
Evet |
OpenAI.ResponseMCPCallFailedEvent
Bir MCP aracı çağrısının başarısız olması durumunda yayımlanır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Başarısız olan MCP aracı çağrı öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. 'sonuç her zaman 'response.mcp_call.failed' olur. Olası değerler: response.mcp_call.failed |
Evet |
OpenAI.ResponseMCPCallInProgressEvent
Bir MCP araç çağrısı devam ederken tetiklenir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | İşlenen MCP aracı çağrı öğesinin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_call.in_progress'. Olası değerler: response.mcp_call.in_progress |
Evet |
OpenAI.ResponseMCPListToolsCompletedEvent
Kullanılabilir MCP araçlarının listesi başarıyla alındığında tetiklenir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Bu çıkışı oluşturan MCP aracı çağrı öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_list_tools.completed'. Olası değerler: response.mcp_list_tools.completed |
Evet |
OpenAI.ResponseMCPListToolsFailedEvent
Kullanılabilir MCP araçlarını listeleme girişimi başarısız olduğunda ortaya çıkar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Başarısız olan MCP aracı çağrı öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_list_tools.başarısız'. Olası değerler: response.mcp_list_tools.failed |
Evet |
OpenAI.ResponseMCPListToolsInProgressEvent
Sistem, kullanılabilir MCP araçlarının listesini alırken tetiklenir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | İşlenmekte olan MCP aracı çağrı öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.mcp_list_tools.in_progress'. Olası değerler: response.mcp_list_tools.in_progress |
Evet |
OpenAI.ResponseOutputItemAddedEvent
Yeni bir çıkış öğesi eklendiğinde gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| öğe | OpenAI.OutputItem | Evet | ||
| └─ agent_reference | AgentReference | Öğeyi oluşturan aracı. | Hayı | |
| └─ response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| └─ türü | OpenAI.OutputItemType | Evet | ||
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.output_item.added.Olası değerler: response.output_item.added |
Evet |
OpenAI.ResponseOutputItemDoneEvent
Çıktı öğesi tamamlandı olarak işaretlendiğinde yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| öğe | OpenAI.OutputItem | Evet | ||
| └─ agent_reference | AgentReference | Öğeyi oluşturan aracı. | Hayı | |
| └─ response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| └─ türü | OpenAI.OutputItemType | Evet | ||
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.output_item.done.Olası değerler: response.output_item.done |
Evet |
OpenAI.ResponseOutputTextAnnotationAddedEvent
Çıkış metni içeriğine ek açıklama eklendiğinde yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| annotation | OpenAI.Annotation | Çıkış metninin yayılma alanına uygulanan bir ek açıklama. | Evet | |
| └─ türü | OpenAI.AnnotationType | Evet | ||
| annotation_index | OpenAI.integer | Evet | ||
| content_index | OpenAI.integer | Evet | ||
| item_id | String | Ek açıklamanın eklendiği öğenin benzersiz tanımlayıcısı. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.output_text.annotation.added'. Olası değerler: response.output_text.annotation.added |
Evet |
OpenAI.ResponsePromptVariables
İsteminizde değişkenlerin yerine kullanılacak isteğe bağlı değer eşlemesi. Değiştirme değerleri dizeler veya görüntüler veya dosyalar gibi diğer Yanıt giriş türleri olabilir.
Tür: nesne
OpenAI.ResponseQueuedEvent
Bir yanıt kuyruğa alınıp işlenmeyi beklediğinde gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| yanıt | OpenAI.Response | Evet | ||
| └─ agent_reference | AgentReference (null atanabilir) | Bu yanıt için kullanılan aracı | Evet | |
| └─ arka plan | boole değeri (null atanabilir) | Hayı | ||
| └─ completed_at | integer (null atanabilir) | Hayı | ||
| └─ konuşma | OpenAI.ConversationReference (null atanabilir) | Bu yanıtın ait olduğu konuşma. Bu yanıttaki giriş öğeleri ve çıkış öğeleri bu konuşmaya otomatik olarak eklendi. | Hayı | |
| └─ oluşturulma_tarihi | tamsayı | Bu Yanıtın oluşturulduğu unix zaman damgası (saniye). | Evet | |
| └─ hata | OpenAI.ResponseError (null atanabilir) | Model yanıt oluşturamadığında döndürülen bir hata nesnesi. | Evet | |
| └─ kimlik | String | Bu Yanıt için benzersiz tanımlayıcı. | Evet | |
| └─ eksik_bilgiler | OpenAI.ResponseIncompleteDetails (null atanabilir) | Evet | ||
| └─ yönerge | OpenAI.InputItem dizesi veya dizisi (null atanabilir) | Evet | ||
| └─ maksimum_çıkış_jetonları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ maksimum araç çağrıları | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ meta veriler | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| └─ modeli | String | Bu yanıtın oluşturulması için kullanılacak model dağıtımı. | Hayı | |
| └─ nesne | enum | Bu kaynağın nesne türü - her zaman response olarak ayarlanır.Olası değerler: response |
Evet | |
| └─ çıkış | OpenAI.OutputItem dizisi | Model tarafından oluşturulan içerik öğeleri dizisi. - Dizideki output öğelerin uzunluğu ve sırası bağlıdırmodelin yanıtı üzerinde. - Dizideki output ilk öğeye erişmek yerine vetarafından oluşturulan içeriğe sahip bir assistant ileti olduğunu varsayarsakmodeli dikkate alarak output_text özelliğini kullanmayı düşünebilirsiniz.SDK'larda desteklenir. |
Evet | |
| └─ çıktı_metin | dize (null atanabilir) | Hayı | ||
| └─ paralel_arac_cagrilari | Boolean | Modelin araç çağrılarını paralel olarak çalıştırmasına izin verilip verilmeyeceği. | Evet | Doğru |
| └─ önceki_cevap_id | dize (null atanabilir) | Hayı | ||
| └─ istemi | OpenAI.Prompt | bir istem şablonuna ve değişkenlerine başvuru. Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_key | String | OpenAI tarafından önbellek isabet hızlarınızı iyileştirmek amacıyla benzer isteklere yönelik yanıtları önbelleğe almak için kullanılır.
user alanını değiştirir.
Daha fazla bilgi edinin. |
Hayı | |
| └─ prompt_cache_retention | enum | Olası değerler: in-memory, 24h |
Hayı | |
| └─ akıl yürütme | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ safety_identifier | String | OpenAI'nin kullanım ilkelerini ihlal eden uygulamanızın kullanıcılarını algılamaya yardımcı olmak için kullanılan kararlı tanımlayıcı. Kimlikler, her kullanıcıyı benzersiz olarak tanımlayan bir dize olmalıdır. Bize herhangi bir tanımlayıcı bilgi göndermemek için kullanıcı adını veya e-posta adresini karma olarak kullanmanızı öneririz. Daha fazla bilgi edinin. |
Hayı | |
| └─ service_tier | OpenAI.ServiceTier | İsteğin sunulması için kullanılan işleme türünü belirtir. - 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet katmanı yapılandırılmış şekilde işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır. - 'varsayılan' olarak ayarlanırsa, istek seçilen model için standart fiyatlandırma ve performansla işlenir. - 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir. - Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir. service_tier Parametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir. |
Hayı | |
| └─ durumu | enum | Yanıt oluşturma durumu. , , completed' lerden failedbiriin_progress, cancelled, queued veya incomplete.Olası değerler: completed, failed, in_progress, cancelled, , queued, incomplete |
Hayı | |
| └─ sıcaklık | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ metin | OpenAI.ResponseTextParam | Modelden metin yanıtı için yapılandırma seçenekleri. Düz olabilir metin veya yapılandırılmış JSON verileri. Daha fazla bilgi edinin: - Metin girişleri ve çıktıları - Yapılandırılmış Çıktılar |
Hayı | |
| └─ araç seçimi | OpenAI.ToolChoiceOptions veya OpenAI.ToolChoiceParam | Hayı | ||
| └─ araçları | OpenAI.ToolsArray | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir.Aşağıdaki araç kategorilerini destekliyoruz: - Yerleşik araçlar: OpenAI tarafından sağlanan ve işlevselliği genişleten araçlar modelin yetenekleri, örneğin web arama veya file search. Hakkında daha fazla bilgi edinin yerleşik araçlar. - MCP Araçları: Özel MCP sunucuları aracılığıyla üçüncü taraf sistemlerle tümleştirmeler veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar. Hakkında daha fazla bilgi edinin MCP Araçları. - İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenlerle kendi kodunuzu çağırmasını sağlama ve çıkışlarını seçin. Hakkında daha fazla bilgi edinin fonksiyon çağrısı. Ayrıca şunları da kullanabilirsiniz: kendi kodunuzu çağırmak için özel araçlar. |
Hayı | |
| └─ top_logprobs | OpenAI.integer (null atanabilir) | Hayı | ||
| └─ top_p | OpenAI.numeric (null atanabilir) | Hayı | 1 | |
| └─ kısaltma | enum | Olası değerler: auto, disabled |
Hayı | |
| └─ kullanımı | OpenAI.ResponseUsage | Giriş belirteçleri, çıkış belirteçleri dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder. çıkış belirteçlerinin ve kullanılan toplam belirteçlerin dökümü. |
Hayı | |
| └─ kullanıcı | dize (kullanım dışı) | Bu alan ve safety_identifierile prompt_cache_key değiştiriliyor. Bunun yerine önbelleğe alma iyileştirmelerini korumak için kullanın prompt_cache_key .Son kullanıcılarınız için kararlı bir tanımlayıcı. Benzer istekleri daha iyi demetleyerek önbellek isabet oranlarını artırmak ve OpenAI'nin kötüye kullanımı algılayıp önlemesine yardımcı olmak için kullanılır. Daha fazla bilgi edinin. |
Hayı | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman 'response.queued'. Olası değerler: response.queued |
Evet |
OpenAI.ResponseReasoningSummaryPartAddedEvent
Yeni bir akıl yürütme özeti bölümü eklendiğinde yayımlanır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Bu özet bölümün ilişkili olduğu öğenin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| parça | OpenAI.ResponseReasoningSummaryPartAddedEventPart | Evet | ||
| └─ metin | String | Evet | ||
| └─ türü | enum | Olası değerler: summary_text |
Evet | |
| sequence_number | OpenAI.integer | Evet | ||
| summary_index | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.reasoning_summary_part.added.Olası değerler: response.reasoning_summary_part.added |
Evet |
OpenAI.ResponseReasoningSummaryPartAddedEventPart
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Evet | ||
| type | enum | Olası değerler: summary_text |
Evet |
OpenAI.ResponseReasoningSummaryPartDoneEvent
Bir akıl yürütme özeti bölümü tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Bu özet bölümün ilişkili olduğu öğenin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| parça | OpenAI.ResponseReasoningSummaryPartDoneEventPart | Evet | ||
| └─ metin | String | Evet | ||
| └─ türü | enum | Olası değerler: summary_text |
Evet | |
| sequence_number | OpenAI.integer | Evet | ||
| summary_index | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.reasoning_summary_part.done.Olası değerler: response.reasoning_summary_part.done |
Evet |
OpenAI.ResponseReasoningSummaryPartDoneEventPart
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Evet | ||
| type | enum | Olası değerler: summary_text |
Evet |
OpenAI.ResponseReasoningSummaryTextDeltaEvent
Bir muhakeme özeti metnine delta eklendiğinde oluşur.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| delta | String | Özete eklenen metin deltası. | Evet | |
| item_id | String | Bu özet metin deltasının ilişkili olduğu öğenin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| summary_index | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.reasoning_summary_text.delta.Olası değerler: response.reasoning_summary_text.delta |
Evet |
OpenAI.ResponseReasoningSummaryTextDoneEvent
Bir akıl yürütme özeti metni tamamlandığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Bu özet metnin ilişkili olduğu öğenin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| summary_index | OpenAI.integer | Evet | ||
| text | String | Tamamlanan akıl yürütme özetinin tam metni. | Evet | |
| type | enum | Olayın türü. Her zaman response.reasoning_summary_text.done.Olası değerler: response.reasoning_summary_text.done |
Evet |
OpenAI.ResponseReasoningTextDeltaEvent
Bir muhakeme metnine delta eklendiğinde yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| delta | String | Muhakeme içeriğine eklenen metin deltası. | Evet | |
| item_id | String | Bu muhakeme metni deltasının ilişkili olduğu öğenin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.reasoning_text.delta.Olası değerler: response.reasoning_text.delta |
Evet |
OpenAI.ResponseReasoningTextDoneEvent
Bir akıl yürütme metni tamamlandığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| item_id | String | Bu muhakeme metninin ilişkili olduğu öğenin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| text | String | Tamamlanmış muhakeme içeriğinin tam metni. | Evet | |
| type | enum | Olayın türü. Her zaman response.reasoning_text.done.Olası değerler: response.reasoning_text.done |
Evet |
OpenAI.ResponseRefusalDeltaEvent
Kısmi bir reddetme metni olduğunda yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| delta | String | Eklenen ret metni. | Evet | |
| item_id | String | Reddetme metninin eklendiği çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.refusal.delta.Olası değerler: response.refusal.delta |
Evet |
OpenAI.ResponseRefusalDoneEvent
Reddeden metin sonlandırıldığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| item_id | String | Sonlandırılan reddetme metninin ait olduğu çıkış öğesinin kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| Ret | String | Kesinleştirilen reddetme metni. | Evet | |
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.refusal.done.Olası değerler: response.refusal.done |
Evet |
OpenAI.ResponseStreamOptions
Akış yanıtları için seçenekler. Bunu yalnızca ayarladığınızda ayarlayın stream: true.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| include_obfuscation | Boolean | True olduğunda, akış gizleme etkinleştirilir. Akış gizleme eklemeleri değişiklik olaylarının akışındaki bir obfuscation alana rastgele karakterleryük boyutlarını belirli yan kanal saldırılarına karşı bir azaltma olarak normalleştirin. Bu gizleme alanları varsayılan olarak eklenir, ancak küçük bir miktar eklenir veri akışı için ek yük. Şunu ayarlayabilirsiniz: include_obfuscationarasında ağ bağlantılarına güveniyorsanız bant genişliğini iyileştirmek için false uygulamanızı ve OpenAI API'sini seçin. |
Hayı |
OpenAI.ResponseTextDeltaEvent
İlave bir metin deltası olduğunda oluşur.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| delta | String | Eklenen metin deltası. | Evet | |
| item_id | String | Metin deltasının eklendiği çıkış öğesinin kimliği. | Evet | |
| logprobs | OpenAI.ResponseLogProb dizisi | Deltadaki belirteçlerin günlük olasılıkları. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.output_text.delta.Olası değerler: response.output_text.delta |
Evet |
OpenAI.ResponseTextDoneEvent
Metin içeriği sonlandırıldığında yayınlanır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| content_index | OpenAI.integer | Evet | ||
| item_id | String | Metin içeriğinin sonlandırıldığı çıkış öğesinin kimliği. | Evet | |
| logprobs | OpenAI.ResponseLogProb dizisi | Deltadaki belirteçlerin günlük olasılıkları. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| text | String | Son haline getirilmiş metin içeriği. | Evet | |
| type | enum | Olayın türü. Her zaman response.output_text.done.Olası değerler: response.output_text.done |
Evet |
OpenAI.ResponseTextParam
Modelden metin yanıtı için yapılandırma seçenekleri. Düz metin veya yapılandırılmış JSON verileri olabilir. Daha fazla bilgi edinin:
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Modelin çıkış yapması gereken biçimi belirten bir nesne. Yapılandırma { "type": "json_schema" } , Yapılandırılmış Çıkışları etkinleştirir,modelin sağlanan JSON şemanızla eşleşmesini sağlar. Daha fazla bilgi için Varsayılan biçim { "type": "text" } ek seçenek yoktur.*gpt-4o ve daha yeni modeller için önerilmez:** { "type": "json_object" } ayarı, eski JSON modunu etkinleştirir.modelin oluşturduğu iletinin geçerli JSON olduğundan emin olur. json_schema’ı kullanmaBu özelliği destekleyen modeller için tercih edilir. |
Hayı | |
| Ayrıntı | OpenAI.Verbosity | Modelin yanıtının çok fazla olduğunu sınırlar. Daha düşük değerler, daha kısa yanıtlar elde ederken, daha yüksek değerler daha ayrıntılı yanıtlara neden olur. Şu anda desteklenen değerler , lowve medium'tirhigh. |
Hayı |
OpenAI.ResponseUsage
Giriş belirteçleri, çıkış belirteçleri, çıkış belirteçlerinin dökümü ve kullanılan toplam belirteçler dahil olmak üzere belirteç kullanım ayrıntılarını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| input_tokens | OpenAI.integer | Evet | ||
| input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Evet | ||
| └─ önbelleğe alınmış jetonlar | OpenAI.integer | Evet | ||
| output_tokens | OpenAI.integer | Evet | ||
| output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Evet | ||
| └─ akıl yürütme_tokenlar | OpenAI.integer | Evet | ||
| total_tokens | OpenAI.integer | Evet |
OpenAI.ResponseUsageInputTokensDetails
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Evet |
OpenAI.ResponseUsageOutputTokensDetails
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| akıl yürütme birimleri | OpenAI.integer | Evet |
OpenAI.ResponseWebSearchCallCompletedEvent
Web araması araması tamamlandığında gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Web arama çağrısıyla ilişkili çıkış öğesinin benzersiz kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.web_search_call.completed.Olası değerler: response.web_search_call.completed |
Evet |
OpenAI.ResponseWebSearchCallInProgressEvent
Bir web arama çağrısı başlatıldığında yayılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Web arama çağrısıyla ilişkili çıkış öğesinin benzersiz kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.web_search_call.in_progress.Olası değerler: response.web_search_call.in_progress |
Evet |
OpenAI.ResponseWebSearchCallSearchingEvent
Bir web arama çağrısı yürütülürken gönderilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_id | String | Web arama çağrısıyla ilişkili çıkış öğesinin benzersiz kimliği. | Evet | |
| output_index | OpenAI.integer | Evet | ||
| sequence_number | OpenAI.integer | Evet | ||
| type | enum | Olayın türü. Her zaman response.web_search_call.searching.Olası değerler: response.web_search_call.searching |
Evet |
OpenAI.Ekran Görüntüsü
Ekran görüntüsü alma işlemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olay türünü belirtir. Ekran görüntüsü eylemi için bu özellik her zaman screenshot olarak ayarlanır.Olası değerler: screenshot |
Evet |
OpenAI.Scroll
Kaydırma eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| scroll_x | OpenAI.integer | Evet | ||
| scroll_y | OpenAI.integer | Evet | ||
| type | enum | Olay türünü belirtir. Kaydırma eylemi için bu özellik her zaman scroll olarak ayarlanır.Olası değerler: scroll |
Evet | |
| x | OpenAI.integer | Evet | ||
| y | OpenAI.integer | Evet |
OpenAI.SearchContextSize
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | lowmediumhigh |
OpenAI.ServiceTier
İsteğin sunulması için kullanılan işleme türünü belirtir.
- 'Otomatik' olarak ayarlanırsa, talep Project ayarlarında hizmet seviyesi yapılandırılarak işlenecektir. Başka bir şekilde yapılandırmadıkça, Project 'default' seçeneğini kullanır.
- 'varsayılan' olarak ayarlanırsa istek, seçilen model için standart fiyatlandırma ve performansla işlenir.
- Eğer 'flex' veya 'öncelikli' olarak ayarlanırsa, talep ilgili hizmet katmanıyla işlenecektir.
- Ayarlanmadığında, varsayılan davranış 'auto' şeklindedir.
service_tierParametre ayarlandığında, yanıt gövdesi isteğe hizmet etmek için kullanılan işleme moduna göre değeri içerirservice_tier. Bu yanıt değeri, parametresindeki değerden farklı olabilir.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Nullable | Evet |
| Değerler | autodefaultflexscalepriority |
OpenAI.SpecificApplyPatchParam
Bir araç çağrısı yürütürken modeli apply_patch aracını çağırmaya zorlar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Çağrılacak araç. Her zaman apply_patch.Olası değerler: apply_patch |
Evet |
OpenAI.SpecificFunctionShellParam
Bir araç çağrısı gerektiğinde modeli kabuk aracını çağırmaya zorlar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Çağrılacak araç. Her zaman shell.Olası değerler: shell |
Evet |
OpenAI.Summary
Modelden özet metin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modelden şimdiye kadar elde edilen mantık çıkarlarının özeti. | Evet | |
| type | enum | Nesnenin türü. Her zaman summary_text.Olası değerler: summary_text |
Evet |
OpenAI.SummaryTextContent
Modelden özet metin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Modelden şimdiye kadar elde edilen mantık çıkarlarının özeti. | Evet | |
| type | enum | Nesnenin türü. Her zaman summary_text.Olası değerler: summary_text |
Evet |
OpenAI.TextContent
Metin içeriği.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Evet | ||
| type | enum | Olası değerler: text |
Evet |
OpenAI.TextResponseFormatConfiguration
Modelin çıkış yapması gereken biçimi belirten bir nesne.
Yapılandırma { "type": "json_schema" } , modelin sağlanan JSON şemanızla eşleşmesini sağlayan Yapılandırılmış Çıkışlar'ı etkinleştirir. Daha fazla bilgi için
Varsayılan biçim { "type": "text" } ek seçenek yoktur.
gpt-4o ve daha yeni modeller için önerilmez:* Modelin oluşturduğu mesajın geçerli olmasını sağlayan eski JSON modunu etkinleştirmek için ayar { "type": "json_object" } . Destekleyen modeller için json_schema kullanılması tercih edilir.
OpenAI.TextResponseFormatConfiguration için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
json_schema |
OpenAI.TextResponseFormatJsonSchema |
text |
OpenAI.TextResponseFormatConfigurationResponseFormatText |
json_object |
OpenAI.TextResponseFormatConfigurationResponseFormatJsonObject |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.TextResponseFormatConfigurationType | Evet |
OpenAI.TextResponseFormatConfigurationResponseFormatJsonObject
JSON nesne yanıt biçimi. JSON yanıtları oluşturmanın eski bir yöntemi.
Bunu destekleyen modeller için kullanılması json_schema önerilir. Modelin, bir sistem veya kullanıcı mesajı olmadan JSON oluşturmayacağını unutmayın, bunu to do etmelidir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman json_object.Olası değerler: json_object |
Evet |
OpenAI.TextResponseFormatConfigurationResponseFormatText
Varsayılan yanıt biçimi. Metin yanıtları oluşturmak için kullanılır.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman text.Olası değerler: text |
Evet |
OpenAI.TextResponseFormatConfigurationType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | textjson_schemajson_object |
OpenAI.TextResponseFormatJsonSchema
JSON Şeması yanıt biçimi. Yapılandırılmış JSON yanıtları oluşturmak için kullanılır. Yapılandırılmış Çıktılar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Model tarafından kullanılan yanıt biçiminin ne için olduğuna dair bir açıklama. Yanıt formatını nasıl belirleyeceğinizi öğrenin. |
Hayı | |
| name | String | Yanıt biçiminin adı. a-z, A-Z, 0-9 veya bunları içermelidir alt çizgi ve tirelerden oluşan, maksimum uzunluk 64 karakterdir. |
Evet | |
| şema | OpenAI.YanıtFormatıJsonŞemaŞeması | JSON Şeması nesnesi olarak tanımlanan yanıt biçimi şeması. JSON şemaları oluşturmayı buradan öğrenin. |
Evet | |
| Sıkı | boole değeri (null atanabilir) | Hayı | ||
| type | enum | Tanımlanan yanıt biçiminin türü. Her zaman json_schema.Olası değerler: json_schema |
Evet |
OpenAI.Tool
Yanıt oluşturmak için kullanılabilecek bir araç.
OpenAI.Tool için Ayırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
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 |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ToolType | Evet |
OpenAI.ToolChoiceAllowed
Modelde kullanılabilen araçları önceden tanımlanmış bir kümeyle kısıtlar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| modu | enum | Modelde kullanılabilen araçları önceden tanımlanmış bir kümeyle kısıtlar.auto modelin izin verilen araçlar arasından seçim yapmasına veİleti. required modelin izin verilen araçlardan birini veya daha fazlasını çağırmasını gerektirir.Olası değerler: auto, required |
Evet | |
| araçlar | nesne dizisi | Modelin çağırmasına izin verilmesi gereken araç tanımlarının listesi. Yanıtlar API'sinde araç tanımlarının listesi şöyle görünebilir: json<br> [<br> { "type": "function", "name": "get_weather" },<br> { "type": "mcp", "server_label": "deepwiki" },<br> { "type": "image_generation" }<br> ]<br> |
Evet | |
| type | enum | İzin verilen araç yapılandırma türü. Her zaman allowed_tools.Olası değerler: allowed_tools |
Evet |
OpenAI.ToolChoiceCodeInterpreter
Modelin bir yanıt oluşturmak için yerleşik bir araç kullanması gerektiğini gösterir. Yerleşik araçlar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: code_interpreter |
Evet |
OpenAI.ToolChoiceComputerUsePreview
Modelin bir yanıt oluşturmak için yerleşik bir araç kullanması gerektiğini gösterir. Yerleşik araçlar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: computer_use_preview |
Evet |
OpenAI.ToolChoiceCustom
Modeli belirli bir özel aracı çağırmaya zorlamak için bu seçeneği kullanın.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | String | Çağrılacak özel aracın adı. | Evet | |
| type | enum | Özel araç çağrısı için türü her zaman customşeklindedir.Olası değerler: custom |
Evet |
OpenAI.ToolChoiceFileSearch
Modelin bir yanıt oluşturmak için yerleşik bir araç kullanması gerektiğini gösterir. Yerleşik araçlar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: file_search |
Evet |
OpenAI.ToolChoiceFunction
Modeli belirli bir işlevi çağırmaya zorlamak için bu seçeneği kullanın.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | String | Çağrılacak işlevin adı. | Evet | |
| type | enum | İşlev çağrısı için türü her zaman functionşeklindedir.Olası değerler: function |
Evet |
OpenAI.ToolChoiceImageGeneration
Modelin bir yanıt oluşturmak için yerleşik bir araç kullanması gerektiğini gösterir. Yerleşik araçlar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: image_generation |
Evet |
OpenAI.ToolChoiceMCP
Modeli uzak bir MCP sunucusunda belirli bir aracı çağırmaya zorlamak için bu seçeneği kullanın.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| name | dize (null atanabilir) | Hayı | ||
| sunucu etiketi | String | Kullanılacak MCP sunucusunun etiketi. | Evet | |
| type | enum | MCP araçları için türü her zaman mcpşeklindedir.Olası değerler: mcp |
Evet |
OpenAI.ToolChoiceOptions
Model tarafından çağrılan aracı (varsa) denetler.
none modelin herhangi bir aracı çağırmayacağı ve bunun yerine bir ileti oluşturduğu anlamına gelir.
auto modelin ileti oluşturma veya bir veya daha fazla araç çağırma arasında seçim yapabileceğiniz anlamına gelir.
required modelin bir veya daha fazla araç çağırması gerektiği anlamına gelir.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | noneautorequired |
OpenAI.ToolChoiceParam
Modelin yanıt oluştururken kullanılacak aracı (veya araçları) seçmesi gerekir. Modelin hangi araçları çağırabileceğini belirtmek için tools parametresine bakın.
OpenAI.ToolChoiceParam için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
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 |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenAI.ToolChoiceParamType | Evet |
OpenAI.ToolChoiceParamType
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | allowed_toolsfunctionmcpcustomapply_patchshellfile_searchweb_search_previewcomputer_use_previewweb_search_preview_2025_03_11image_generationcode_interpreter |
OpenAI.ToolChoiceWebSearchPreview
Modelin bir yanıt oluşturmak için yerleşik bir araç kullanması gerektiğini gösterir. Yerleşik araçlar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: web_search_preview |
Evet |
OpenAI.ToolChoiceWebSearchPreview20250311
Modelin bir yanıt oluşturmak için yerleşik bir araç kullanması gerektiğini gösterir. Yerleşik araçlar hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: web_search_preview_2025_03_11 |
Evet |
OpenAI.AraçTürü
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | 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
Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilirsiniz.
Aşağıdaki araç kategorilerini destekliyoruz:
-
Yerleşik araçlar: OpenAI tarafından sağlanan ve modelin yeteneklerini genişleten araçlar, örneğin web arama veya dosya arama gibi.
yerleşik araçlar . - MCP Araçları: Özel MCP sunucuları veya Google Drive ve SharePoint gibi önceden tanımlanmış bağlayıcılar aracılığıyla üçüncü taraf sistemlerle tümleştirmeler. MCP Tools hakkında daha fazla bilgi edinin.
- İşlev çağrıları (özel araçlar): Sizin tanımladığınız işlevler, modelin kesin olarak yazılan bağımsız değişkenler ve çıkışlarla kendi kodunuzu çağırmasını sağlar. function calling hakkında daha fazla bilgi edinin. Kendi kodunuzu çağırmak için özel araçlar da kullanabilirsiniz.
Dizisi: OpenAI.Tool
OpenAI.TopLogProb
Belirtecin en yüksek günlük olasılığı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| bytes | OpenAI.integer dizisi | Evet | ||
| logprob | OpenAI.numeric | Evet | ||
| token | String | Evet |
OpenAI.Type
Metin yazmak için bir eylem.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| text | String | Yazılacak metin. | Evet | |
| type | enum | Olay türünü belirtir. Tür eylemi için bu özellik her zaman type olarak ayarlanır.Olası değerler: type |
Evet |
OpenAI.UpdateConversationBody
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Evet |
OpenAI.UrlCitationBody
Model yanıtı oluşturmak için kullanılan bir web kaynağı alıntısı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| end_index | OpenAI.integer | Evet | ||
| start_index | OpenAI.integer | Evet | ||
| title | String | Web kaynağının başlığı. | Evet | |
| type | enum | URL alıntısının türü. Her zaman url_citation.Olası değerler: url_citation |
Evet | |
| url | String | Web kaynağının URL'si. | Evet |
OpenAI.VectorStoreFileAttributes
Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, nesne hakkında ek bilgileri yapılandırılmış biçimde depolamak ve API veya pano aracılığıyla nesneleri sorgulamak için yararlı olabilir. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter, boole veya sayı olan dizelerdir.
Tür: nesne
OpenAI.Verbosity
Modelin yanıtının çok fazla olduğunu sınırlar. Daha düşük değerler daha kısa yanıtlar sağlarken, daha yüksek değerler daha fazla sözlü yanıtlar sağlar.
Şu anda desteklenen değerler , lowve medium'tirhigh.
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Nullable | Evet |
| Değerler | lowmediumhigh |
OpenAI.Wait
Bir bekleme eylemi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olay türünü belirtir. Bir bekleme eylemi için bu özellik her zaman wait olarak ayarlanır.Olası değerler: wait |
Evet |
OpenAI.WebSearchActionFind
Eylem türü "bul": Yüklenen bir sayfada desen arar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| pattern | String | Sayfa içinde aranacak desen veya metin. | Evet | |
| type | enum | Eylem türü. Olası değerler: find_in_page |
Evet | |
| url | String | Sayfanın URL'si deseni aradı. | Evet |
OpenAI.WebSearchActionOpenPage
Eylem türü "open_page" - Arama sonuçlarından belirli bir URL'yi açar.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Eylem türü. Olası değerler: open_page |
Evet | |
| url | String | Model tarafından açılan URL. | Evet |
OpenAI.WebSearchActionSearch
Eylem türü "arama" - Web araması sorgusu gerçekleştirir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| queries | dize dizisi | Arama sorguları. | Hayı | |
| soru | dize (kullanım dışı) | [KULLANIM DIŞI] Arama sorgusu. | Evet | |
| Kaynak | OpenAI.WebSearchActionSearchSources dizisi | Aramada kullanılan kaynaklar. | Hayı | |
| type | enum | Eylem türü. Olası değerler: search |
Evet |
OpenAI.WebSearchActionSearchSources
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Olası değerler: url |
Evet | |
| url | String | Evet |
OpenAI.WebSearchApproximateLocation
Kullanıcının yaklaşık konumu.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| city | dize (null atanabilir) | Hayı | ||
| country | dize (null atanabilir) | Hayı | ||
| region | dize (null atanabilir) | Hayı | ||
| timezone | dize (null atanabilir) | Hayı | ||
| type | enum | Konum yaklaşımının türü. Her zaman approximate.Olası değerler: approximate |
Hayı |
OpenAI.WebSearchPreviewTool
Bu araç, yanıt için ilgili sonuçları internette arar. web arama aracı hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| arama_bağlam_boyutu | OpenAI.SearchContextSize | Hayı | ||
| type | enum | Web arama aracının türü.
web_search_preview veya web_search_preview_2025_03_11'den biri.Olası değerler: web_search_preview |
Evet | |
| kullanıcı_konumu | OpenAI.ApproximateLocation (null atanabilir) | Hayı | ||
| └─ şehir | dize (null atanabilir) | Hayı | ||
| └─ ülke | dize (null atanabilir) | Hayı | ||
| └─ bölge | dize (null atanabilir) | Hayı | ||
| └─ saat dilimi | dize (null atanabilir) | Hayı | ||
| └─ türü | enum | Konum yaklaşımının türü. Her zaman approximate.Olası değerler: approximate |
Evet |
OpenAI.WebSearchTool
Yönlendirmeyle ilgili kaynakları internette arayın. web arama aracı hakkında daha fazla bilgi edinin.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| custom_search_configuration | WebSearchConfiguration | bing özel arama için bir web arama yapılandırması | Hayı | |
| └─ instance_name | String | Yapılandırmaya verilen özel yapılandırma örneğinin adı. | Evet | |
| └─ project_connection_id | String | Project bağlantı kimliği bing özel arama ile topraklama için | Evet | |
| filters | OpenAI.WebSearchToolFilters (null atanabilir) | Hayı | ||
| └─ allowed_domains | dize dizisi (null atanabilir) | Hayı | ||
| arama_bağlam_boyutu | enum | Arama için kullanılacak bağlam penceresi alanı miktarına yönelik üst düzey kılavuz.
low, mediumveya high.
medium varsayılan değerdir.Olası değerler: low, medium, high |
Hayı | |
| type | enum | Web arama aracının türü.
web_search veya web_search_2025_08_26'den biri.Olası değerler: web_search |
Evet | |
| kullanıcı_konumu | OpenAI.WebSearchApproximateLocation (null atanabilir) | Kullanıcının yaklaşık konumu. | Hayı | |
| └─ şehir | dize (null atanabilir) | Hayı | ||
| └─ ülke | dize (null atanabilir) | Hayı | ||
| └─ bölge | dize (null atanabilir) | Hayı | ||
| └─ saat dilimi | dize (null atanabilir) | Hayı | ||
| └─ türü | enum | Konum yaklaşımının türü. Her zaman approximate.Olası değerler: approximate |
Hayı |
OpenAI.WebSearchToolFilters
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| allowed_domains | dize dizisi | Hayı |
OpenAI.integer
Tür: tamsayı
Biçim: int64
OpenAI.numeric
Tür: sayı
Biçim: çift
OpenApiAnonymousAuthDetails
OpenApi anonim kimlik doğrulaması için güvenlik ayrıntıları
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | enum | Her zaman 'anonim' olan nesne türü. Olası değerler: anonymous |
Evet |
OpenApiAuthDetails
OpenApiFunctionDefinition için kimlik doğrulama ayrıntıları
OpenApiAuthDetails için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
anonymous |
OpenApiAnonymousAuthDetails |
project_connection |
OpenApiProjectConnectionAuthDetails |
managed_identity |
OpenApiManagedAuthDetails |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | OpenApiAuthType | OpenApi uç noktası için kimlik doğrulama türü. İzin verilen türler şunlardır: - Anonim (kimlik doğrulaması gerekmez) - Project Bağlantı (AI Foundry'de kurulduğu gibi uç noktaya project_connection_id gerektirir) - Managed_Identity (kimlik tabanlı kimlik doğrulaması için hedef kitle gerektirir) |
Evet |
OpenApiAuthType
OpenApi uç noktası için kimlik doğrulama türü. İzin verilen türler şunlardır:
- Anonim (kimlik doğrulaması gerekmez)
- Project Bağlantı (AI Foundry'de kurulduğu gibi uç noktaya project_connection_id gerektirir)
- Managed_Identity (kimlik tabanlı kimlik doğrulama için hedef kitle gerektirir)
| Mülkiyet | Değer |
|---|---|
| Açıklama | OpenApi uç noktası için kimlik doğrulama türü. İzin verilen türler şunlardır: - Anonim (kimlik doğrulaması gerekmez) - Project Bağlantı (AI Foundry'de kurulduğu gibi uç noktaya project_connection_id gerektirir) - Managed_Identity (kimlik tabanlı kimlik doğrulaması için hedef kitle gerektirir) |
| Türü | String |
| Değerler | anonymousproject_connectionmanaged_identity |
OpenApiFunctionDefinition
Openapi işlevinin giriş tanımı bilgileri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| auth | OpenApiAuthDetails | OpenApiFunctionDefinition için kimlik doğrulama ayrıntıları | Evet | |
| └─ türü | OpenApiAuthType | Kimlik doğrulama türü anonim/project_connection/managed_identity olmalıdır | Evet | |
| default_params | dize dizisi | Kullanıcı tarafından sağlanan varsayılanları kullanacak OpenAPI belirtim parametrelerinin listesi | Hayı | |
| açıklama | String | İşlevin ne zaman ve nasıl çağrıldığını seçmek için model tarafından kullanılan işlevin ne yaptığının açıklaması. | Hayı | |
| functions | nesne dizisi | OpenApi aracı tarafından kullanılan işlev tanımlarının listesi | Hayı | |
| name | String | Çağrılacak işlevin adı. | Evet | |
| spec | nesne | JSON Şeması nesnesi olarak tanımlanan openapi işlev şekli. | Evet |
OpenApiManagedAuthDetails
OpenApi managed_identity kimlik doğrulaması için güvenlik ayrıntıları
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| security_scheme | OpenApiManagedSecurityScheme | OpenApi managed_identity kimlik doğrulaması için güvenlik şeması | Evet | |
| └─ hedef kitle | String | managed_identity kimlik doğrulama türü için kimlik doğrulama kapsamı | Evet | |
| type | enum | Her zaman 'managed_identity' olan nesne türü. Olası değerler: managed_identity |
Evet |
OpenApiManagedSecurityScheme
OpenApi managed_identity kimlik doğrulaması için güvenlik şeması
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| audience | String | managed_identity kimlik doğrulama türü için kimlik doğrulama kapsamı | Evet |
OpenApiProjectConnectionAuthDetails
OpenAPI proje bağlantı doğrulaması için güvenlik detayları
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| security_scheme | OpenApiProjectConnectionSecurityScheme | OpenApi managed_identity kimlik doğrulaması için güvenlik şeması | Evet | |
| └─ project_connection_id | String | Project bağlantı kimliği için Project bağlantı kimliği | Evet | |
| type | enum | Her zaman 'project_connection' olan nesne türü. Olası değerler: project_connection |
Evet |
OpenApiProjectConnectionSecurityScheme
OpenApi managed_identity kimlik doğrulaması için güvenlik şeması
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| project_connection_id | String | Project bağlantı kimliği için Project bağlantı kimliği | Evet |
OpenApiTool
Aracıyı yapılandırmak için kullanılan OpenAPI aracının giriş tanımı bilgileri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| openapi | OpenApiFunctionDefinition | Openapi işlevinin giriş tanımı bilgileri. | Evet | |
| └─ kimlik doğrulaması | OpenApiAuthDetails | Açık API kimlik doğrulaması ayrıntıları | Evet | |
| └─ default_params | dize dizisi | Kullanıcı tarafından sağlanan varsayılanları kullanacak OpenAPI belirtim parametrelerinin listesi | Hayı | |
| └─ açıklama | String | İşlevin ne zaman ve nasıl çağrıldığını seçmek için model tarafından kullanılan işlevin ne yaptığının açıklaması. | Hayı | |
| └─ işlevleri | nesne dizisi (salt okunur) | OpenApi aracı tarafından kullanılan işlev tanımlarının listesi | Hayı | |
| └─ açıklama | String | İşlevin ne zaman ve nasıl çağrıldığını seçmek için model tarafından kullanılan işlevin ne yaptığının açıklaması. | Hayı | |
| └─ ad | String | Çağrılacak işlevin adı. | Evet | |
| └─ parametreler | nesne | İşlevlerin kabullediği, JSON Şeması nesnesi olarak tanımlanan parametreler. | Evet | |
| └─ ad | String | Çağrılacak işlevin adı. | Evet | |
| └─ belirtim | nesne | JSON Şeması nesnesi olarak tanımlanan openapi işlev şekli. | Evet | |
| type | enum | Her zaman 'openapi' olan nesne türü. Olası değerler: openapi |
Evet |
PageOrder
| Mülkiyet | Değer |
|---|---|
| Türü | String |
| Değerler | ascdesc |
PagedConnection
Bağlantı öğelerinin sayfalı koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | Bağlantı dizisi | Bu sayfadaki Bağlantı öğeleri | Evet |
PagedDatasetVersion
DatasetVersion öğelerinin sayfalı koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | DatasetVersion dizisi | Bu sayfadaki DatasetVersion öğeleri | Evet |
PagedDeployment
Dağıtım öğelerinin sayfalı koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | Dağıtım dizisi | Bu sayfadaki Dağıtım öğeleri | Evet |
PagedEvaluationRule
EvaluationRule öğelerinin disk belleğine alınmış koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | EvaluationRule dizisi | Bu sayfadaki EvaluationRule öğeleri | Evet |
PagedEvaluationTaxonomy
EvaluationTaxonomy öğelerinin sayfalanmış koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | EvaluationTaxonomy dizisi | Bu sayfadaki EvaluationTaxonomy öğeleri | Evet |
PagedEvaluatorVersion
EvaluatorVersion öğelerinin disk belleğine alınmış koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | EvaluatorVersion dizisi | Bu sayfadaki EvaluatorVersion öğeleri | Evet |
PagedIndex
Dizin öğelerinin sayfalı koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | Dizin dizisi | Bu sayfadaki Dizin öğeleri | Evet |
PagedInsight
İçgörü öğelerinin disk belleğine alınmış koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | insight dizisi | Bu sayfadaki İçgörü öğeleri | Evet |
PagedRedTeam
RedTeam öğelerinin sayfalı koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | RedTeam dizisi | Bu sayfadaki RedTeam öğeleri | Evet |
PagedSchedule
Zamanlama öğelerinin sayfalı koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | Zamanlama dizisi | Bu sayfadaki Öğeleri zamanla | Evet |
PagedScheduleRun
ScheduleRun öğelerinin disk belleği koleksiyonu
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| nextLink | String | Öğelerin sonraki sayfasına bağlantı | Hayı | |
| değer | ScheduleRun dizisi | Bu sayfadaki ScheduleRun öğeleri | Evet |
PendingUploadRequest
Bekleyen bir yükleme isteğini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| connectionName (bağlantıadı) | String | Azure Storage Account connection name to use for generate temporary SAS token | Hayı | |
| pendingUploadId | String | PendingUploadId sağlanmazsa, rastgele bir GUID kullanılır. | Hayı | |
| pendingUploadType | enum | BlobReference desteklenen tek türdür. Olası değerler: BlobReference |
Evet |
PendingUploadResponse
Bekleyen bir yükleme isteğinin yanıtını temsil eder
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| blobReference | BlobReference | Blob başvuru ayrıntıları. | Evet | |
| └─ blobUri | String | İstemcinin verileri karşıya yüklemesi için Blob URI yolu. Örnek: https://blob.windows.core.net/Container/Path |
Evet | |
| └─ kimlik bilgisi | SasCredential | storage hesabı access kimlik bilgileri. | Evet | |
| └─ storageAccountArmId | String | Kullanılacak storage hesabının ARM ID'si. | Evet | |
| pendingUploadId | String | Bu yükleme isteğinin kimliği. | Evet | |
| pendingUploadType | enum | BlobReference desteklenen tek türdür Olası değerler: BlobReference |
Evet | |
| version | String | Kullanıcı ilk yükleme oluşturulurken sürüm belirtmediyse oluşturulacak öğenin sürümü | Hayı |
PromptAgentDefinition
İstem aracısı tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| instructions | dize (null atanabilir) | Modelin bağlamı içine eklenen bir sistem (veya geliştirici) iletisi. | Hayı | |
| tür | enum | Olası değerler: prompt |
Evet | |
| model | String | Bu aracı için kullanılacak model dağıtımı. | Evet | |
| rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| └─ rai_policy_name | String | Uygulanacak RAI politikasının adı. | Evet | |
| reasoning | OpenAI.Reasoning (null atanabilir) |
yalnızca gpt-5 ve o serisi modeller Için yapılandırma seçenekleri mantıp modelleri. |
Hayı | |
| └─ çaba | OpenAI.ReasoningEffort | Akıl yürütme çabasını kısıtlar mantıp modelleri. Şu anda desteklenen değerler none, minimal, low, medium, high, ve xhigh'dir. Azaltmamuhakeme çabası daha hızlı yanıtlara ve daha az belirteç kullanılmasına neden olabilir bir yanıtta mantık yürütme. - gpt-5.1 varsayılan olarak noneöğesini kullanır ve mantık yürütmez. Desteklenen gerekçe değerleri gpt-5.1none, low, medium, ve high'dir. Araç çağrıları gpt-5.1'deki tüm akıl yürütme değerleri için desteklenir.- Tüm modeller varsayılan olarak akıl yürütme eforu olmadan gpt-5.1 önce medium ve desteklemeznone.- Model gpt-5-pro varsayılan olarak akıl yürütme eforunu kullanır (ve yalnızca destekler high ).- xhigh , sonrasındaki gpt-5.1-codex-maxtüm modeller için desteklenir. |
Hayı | |
| └─ özet oluştur | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| └─ özeti | enum | Olası değerler: auto, concise, detailed |
Hayı | |
| structured_inputs | nesne | Bilgi istemi şablonu değiştirme veya araç bağımsız değişkeni bağlamalarına katılabilen yapılandırılmış girişler kümesi. | Hayı | |
| sıcaklık | Numara | 0 ile 2 arasında hangi örnekleme sıcaklığının kullanılacağı. 0,8 gibi daha yüksek değerler çıkışı daha rastgele hale getirirken, 0,2 gibi daha düşük değerler daha odaklanmış ve belirleyici hale getirir. Genellikle bunu değiştirmenizi öneririz top_p ancak ikisini birden değiştirmemenizi öneririz. |
Hayı | 1 |
| text | PromptAgentDefinitionTextOptions | Modelden metin yanıtı için yapılandırma seçenekleri. Düz metin veya yapılandırılmış JSON verileri olabilir. | Hayı | |
| └─ biçimi | OpenAI.TextResponseFormatConfiguration | Modelin çıkış yapması gereken biçimi belirten bir nesne. Yapılandırma { "type": "json_schema" } , Yapılandırılmış Çıkışları etkinleştirir,modelin sağlanan JSON şemanızla eşleşmesini sağlar. Daha fazla bilgi için Varsayılan biçim { "type": "text" } ek seçenek yoktur.*gpt-4o ve daha yeni modeller için önerilmez:** { "type": "json_object" } ayarı, eski JSON modunu etkinleştirir.modelin oluşturduğu iletinin geçerli JSON olduğundan emin olur. json_schema’ı kullanmaBu özelliği destekleyen modeller için tercih edilir. |
Hayı | |
| tool_choice | string veya OpenAI.ToolChoiceParam | Modelin yanıt oluştururken kullanılacak aracı (veya araçları) seçmesi gerekir. Modelin hangi araçları çağırabileceğini belirtmek için tools parametresine bakın. |
Hayı | |
| araçlar | OpenAI.Tool dizisi | Yanıt oluştururken modelin çağırabileceği bir araç dizisi. Siz parametresini ayarlayarak tool_choice hangi aracın kullanılacağını belirtebilir. |
Hayı | |
| top_p | Numara | Sıcaklıkla örneklemeye alternatif olarak çekirdek örneklemesi adı verilir, burada model, belirteçlerin sonuçlarını top_p olasılıkla değerlendirir kütle. Yani 0,1 yalnızca ilk 10% olasılık kütlesini oluşturan belirteçler anlamına gelir dikkate alınır. Genellikle bunu değiştirmenizi öneririz temperature ancak ikisini birden değiştirmemenizi öneririz. |
Hayı | 1 |
PromptAgentDefinitionTextOptions
Modelden metin yanıtı için yapılandırma seçenekleri. Düz metin veya yapılandırılmış JSON verileri olabilir.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Modelin çıkış yapması gereken biçimi belirten bir nesne. Yapılandırma { "type": "json_schema" } , Yapılandırılmış Çıkışları etkinleştirir,modelin sağlanan JSON şemanızla eşleşmesini sağlar. Daha fazla bilgi için Varsayılan biçim { "type": "text" } ek seçenek yoktur.*gpt-4o ve daha yeni modeller için önerilmez:** { "type": "json_object" } ayarı, eski JSON modunu etkinleştirir.modelin oluşturduğu iletinin geçerli JSON olduğundan emin olur. json_schema’ı kullanmaBu özelliği destekleyen modeller için tercih edilir. |
Hayı |
PromptBasedEvaluatorDefinition
İstem tabanlı değerlendirici
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| data_schema | nesne | Değerlendiricinin giriş verileri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| init_parameters | nesne | Değerlendiricinin giriş parametreleri için JSON şeması (Taslak 2020-12). Bu, tür, özellikler, gerekli gibi parametreleri içerir. | Hayı | |
| metrics | nesne | Bu değerlendirici tarafından üretilen çıktı metriklerinin listesi | Hayı | |
| prompt_text | String | Değerlendirme için kullanılan bilgi istemi metni | Evet | |
| type | enum | Olası değerler: prompt |
Evet |
ProtocolVersionRecord
Tek bir protokol ve sürümü için kayıt eşlemesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| protokol | AgentProtocol | Evet | ||
| version | String | Protokolün sürüm dizesi, örneğin 'v0.1.1'. | Evet |
RaiConfig
Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| rai_policy_name | String | Uygulanacak RAI politikasının adı. | Evet |
RecurrenceSchedule
Yinelenme zamanlama modeli.
RecurrenceSchedule için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
Hourly |
HourlyRecurrenceSchedule |
Daily |
DailyRecurrenceSchedule |
Weekly |
WeeklyRecurrenceSchedule |
Monthly |
MonthlyRecurrenceSchedule |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | RecurrenceType | Yinelenme türü. | Evet |
RecurrenceTrigger
Yinelenmeye dayalı tetikleyici.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| endTime | String | ISO 8601 biçiminde yinelenme zamanlaması için bitiş saati. | Hayı | |
| interval | tamsayı | Yinelenme zamanlaması aralığı. | Evet | |
| takvim | RecurrenceSchedule | Yinelenme zamanlama modeli. | Evet | |
| └─ türü | RecurrenceType | Yinelenme zamanlaması için yinelenme türü. | Evet | |
| startTime | String | ISO 8601 biçiminde yinelenme zamanlaması için başlangıç saati. | Hayı | |
| timeZone | String | Yinelenme zamanlaması için saat dilimi. | Hayı | UTC (Koordinatlı Evrensel Zaman) |
| type | enum | Tetikleyicinin türü. Olası değerler: Recurrence |
Evet |
RecurrenceType
Yinelenme türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Yinelenme türü. |
| Türü | String |
| Değerler | HourlyDailyWeeklyMonthly |
RedTeam
Kırmızı takım detayları.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| applicationScenario | String | Senaryoya özel saldırılar oluşturmak için kırmızı takım operasyonu için uygulama senaryosu. | Hayı | |
| attackStrategies | AttackStrategy dizisi | Saldırı stratejilerinin listesi veya saldırı stratejilerinin iç içe geçmiş listeleri. | Hayı | |
| ekran adı | String | Kırmızı takım koşusunun adı. | Hayı | |
| kimlik | dize (salt okunur) | Kırmızı takım koşusunun tanımlayıcısı. | Evet | |
| numTurns | tamsayı | Simülasyon turlarının sayısı. | Hayı | |
| properties | nesne | Kırmızı takımın özellikleri. Etiketlerden farklı olarak özellikler yalnızca eklentidir. Bir özellik eklendikten sonra kaldırılamaz. | Hayı | |
| risk Kategorileri | RiskCategory dizisi | Saldırı hedefleri oluşturmak için risk kategorilerinin listesi. | Hayı | |
| simulationOnly | Boolean | Yalnızca simülasyon veya Simülasyon + Değerlendirme. Varsayılan olarak false, doğruysa tarama değerlendirme sonucunu değil konuşma çıktısını verir. | Hayı | Yanlış |
| durum | dize (salt okunur) | Kırmızı takımın durumu. Hizmet tarafından ayarlanır ve salt okunurdur. | Hayı | |
| tags | nesne | Kırmızı takımın etiketleri. Özelliklerden farklı olarak etiketler tamamen değişebilir. | Hayı | |
| target | TargetConfig | Hedef yapılandırma için soyut sınıf. | Evet | |
| └─ türü | String | Model yapılandırmasının türü. | Evet |
RedTeamEvalRunDataSource
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| item_generation_params | ItemGenerationParams | Öğe oluşturma işlemlerini denetlemek için kullanılan parametre kümesini temsil eder. | Evet | |
| └─ türü | ItemGenerationParamsType | Kullanılacak öğe oluşturma parametrelerinin türü. | Evet | |
| target | Hedef | Ayırıcı desteği olan hedefler için temel sınıf. | Evet | |
| └─ türü | String | Hedefin türü. | Evet | |
| type | enum | Veri kaynağının türü. Her zaman azure_ai_red_team.Olası değerler: azure_ai_red_team |
Evet |
RedTeamItemGenerationParams
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| attack_strategies | AttackStrategy dizisi | Kullanılacak saldırı stratejilerinin koleksiyonu. | Evet | |
| num_turns | tamsayı | Oyunda izin verilen dönüş sayısı. | Evet | 20 |
| type | enum | Öğe oluşturma parametrelerinin türü. Olası değerler: red_team |
Evet |
RedTeamSeedPromptsItemGenerationParams
Kırmızı takım çekirdek istemleri öğe oluşturma parametrelerini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| attack_strategies | AttackStrategy dizisi | Kullanılacak saldırı stratejilerinin koleksiyonu. | Evet | |
| num_turns | tamsayı | Oyunda izin verilen dönüş sayısı. | Evet | 20 |
| kaynak | OpenAI.EvalJsonlFileContentSource | Evet | ||
| └─ içerik | OpenAI.EvalJsonlFileContentSourceContent dizisi | jsonl dosyasının içeriği. | Evet | |
| └─ türü | enum | Jsonl kaynağının türü. Her zaman file_content.Olası değerler: file_content |
Evet | |
| type | enum | Her zaman red_team_seed_promptsolan öğe oluşturma parametrelerinin türü.Olası değerler: red_team_seed_prompts |
Evet |
RedTeamTaxonomyItemGenerationParams
Kırmızı takım taksonomisi öğesi oluşturma parametrelerini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| attack_strategies | AttackStrategy dizisi | Kullanılacak saldırı stratejilerinin koleksiyonu. | Evet | |
| num_turns | tamsayı | Oyunda izin verilen dönüş sayısı. | Evet | 20 |
| kaynak | OpenAI.EvalJsonlFileContentSource | Evet | ||
| └─ içerik | OpenAI.EvalJsonlFileContentSourceContent dizisi | jsonl dosyasının içeriği. | Evet | |
| └─ türü | enum | Jsonl kaynağının türü. Her zaman file_content.Olası değerler: file_content |
Evet | |
| type | enum | Her zaman red_team_taxonomyolan öğe oluşturma parametrelerinin türü.Olası değerler: red_team_taxonomy |
Evet |
ResponseRetrievalItemGenerationParams
Yanıt alma öğesi oluşturma parametrelerini temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| veri eşleme | nesne | Sohbet geçmişini almak için gereken kaynak alanlardan response_id alanına eşleme. | Evet | |
| max_num_turns | tamsayı | Değerlendirilecek sohbet geçmişinin maksimum dönüş sayısı. | Evet | |
| kaynak | OpenAI.EvalJsonlFileContentSource veya OpenAI.EvalJsonlFileIdSource | JSONL içeriğinin okunduğu kaynak. | Evet | |
| type | enum | Her zaman response_retrievalolan öğe oluşturma parametrelerinin türü.Olası değerler: response_retrieval |
Evet |
RiskCategory
Saldırı hedefi için risk kategorisi.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Saldırı hedefi için risk kategorisi. |
| Türü | String |
| Değerler | HateUnfairnessViolenceSexualSelfHarmProtectedMaterialCodeVulnerabilityUngroundedAttributesProhibitedActionsSensitiveDataLeakageTaskAdherence |
SASCredentials
Paylaşılan Access İmzası (SAS) kimlik tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| SAS | dize (salt okunur) | SAS belirteci | Hayı | |
| type | enum | Kimlik bilgisi türü Olası değerler: SAS |
Evet |
SampleType
Analizde kullanılan numunenin türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Analizde kullanılan numunenin türü. |
| Türü | String |
| Değerler | EvaluationResultSample |
SasCredential (SasKimlik Bilgisi)
SAS Kimlik Bilgisi tanımı
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sasUri | dize (salt okunur) | SAS uri'si | Evet | |
| type | enum | Kimlik bilgisi türü Olası değerler: SAS |
Evet |
Schedule
Zamanlama modeli.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Zamanlamanın açıklaması. | Hayı | |
| ekran adı | String | Zamanlamanın adı. | Hayı | |
| etkinleştirildi | Boolean | Zamanlamanın etkin durumu. | Evet | |
| kimlik | dize (salt okunur) | Zamanlamanın tanımlayıcısı. | Evet | |
| properties | nesne | Schedule'ın özellikleri. Etiketlerden farklı olarak özellikler yalnızca eklentidir. Bir özellik eklendikten sonra kaldırılamaz. | Hayı | |
| provisioningStatus | ScheduleProvisioningStatus (salt okunur) | Sağlama durumunu zamanlayın. | Hayı | |
| sistem verileri | object (salt okunur) | Kaynak için sistem meta verileri. | Evet | |
| tags | nesne | Schedule'un etiketleri. Özelliklerden farklı olarak etiketler tamamen değişebilir. | Hayı | |
| görev | ScheduleTask | Zamanlama görev modeli. | Evet | |
| └─ yapılandırması | nesne | Görev için yapılandırma. | Hayı | |
| └─ türü | ScheduleTaskType | Görevin türü. | Evet | |
| trigger | Trigger | Zamanlamanın tetikleyicisi için temel model. | Evet | |
| └─ türü | TriggerType | Tetikleyicinin türü. | Evet |
ScheduleProvisioningStatus
Sağlama durumunu zamanlayın.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Sağlama durumunu zamanlayın. |
| Türü | String |
| Değerler | CreatingUpdatingDeletingSucceededFailed |
ScheduleRun
Zamanlama çalıştırma modeli.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| hata | dize (salt okunur) | Zamanlama çalıştırması için hata bilgileri. | Hayı | |
| kimlik | dize (salt okunur) | Zamanlama çalıştırmasının tanımlayıcısı. | Evet | |
| properties | object (salt okunur) | Zamanlama çalıştırmasının özellikleri. | Evet | |
| scheduleId | String | Zamanlamanın tanımlayıcısı. | Evet | |
| başarı | boole (salt okunur) | Zamanlama çalıştırmasının başarı durumunu tetikleyin. | Evet | |
| triggerTime | String | Zamanlama çalıştırmasının tetikleme zamanı. | Hayı |
Görev Planla
Zamanlama görev modeli.
ScheduleTask için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
Evaluation |
EvaluationScheduleTask |
Insight |
InsightScheduleTask |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| configuration | nesne | Görev için yapılandırma. | Hayı | |
| type | ScheduleTaskType | Görevin türü. | Evet |
ScheduleTaskType
Görevin türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Görevin türü. |
| Türü | String |
| Değerler | EvaluationInsight |
SharepointGroundingToolParameters
Sharepoint topraklama aracı parametreleri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| project_connections | ToolProjectConnection dizisi | Bu araca bağlı proje bağlantıları. En fazla 1 bağlantı olabilir aracına bağlı kaynak. |
Hayı |
SharepointPreviewTool
Aracıyı yapılandırmak için kullanılan sharepoint aracının giriş tanımı bilgileri.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| sharepoint_grounding_preview | SharepointGroundingToolParameters | Sharepoint topraklama aracı parametreleri. | Evet | |
| └─ project_connections | ToolProjectConnection dizisi | Bu araca bağlı proje bağlantıları. En fazla 1 bağlantı olabilir aracına bağlı kaynak. Kısıtlamalar: maxItems: 1 |
Hayı | |
| type | enum | Nesne türü, ki her zaman 'sharepoint_grounding_preview' olur. Olası değerler: sharepoint_grounding_preview |
Evet |
Sku
Sku bilgileri
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| capacity | tamsayı | Sku kapasitesi | Evet | |
| family | String | Sku ailesi | Evet | |
| name | String | Sku adı | Evet | |
| boyut | String | Sku boyutu | Evet | |
| seviye | String | Sku katmanı | Evet |
StructuredInputDefinition
Bilgi istemi şablonu değiştirmelerine ve araç bağımsız değişkeni bağlamasına katılabilen yapılandırılmış bir giriş.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| default_value | Çalışma zamanı değeri sağlanmamışsa giriş için varsayılan değer. | Hayı | ||
| açıklama | String | Girişin okunabilir bir açıklaması. | Hayı | |
| required | Boolean | Aracı çağrıldığında giriş özelliğinin gerekli olup olmadığı. | Hayı | Yanlış |
| şema | nesne | Yapılandırılmış giriş için JSON şeması (isteğe bağlı). | Hayı |
StructuredOutputDefinition
Aracı tarafından üretilebilen yapılandırılmış bir çıkış.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Yayınlanacak çıkışın açıklaması. Çıktının ne zaman yayınlanacağını belirlemek için model tarafından kullanılır. | Evet | |
| name | String | Yapılandırılmış çıkışın adı. | Evet | |
| şema | nesne | Yapılandırılmış çıkış için JSON şeması. | Evet | |
| Sıkı | boole değeri (null atanabilir) | Sıkı doğrulamanın uygulanıp uygulanmayacağı. Varsayılan true. |
Evet |
StructuredOutputsOutputItem
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| çıktı | Yanıt sırasında yakalanan yapılandırılmış çıkış. | Evet | ||
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| type | enum | Olası değerler: structured_outputs |
Evet |
SyntheticDataGenerationPreviewEvalRunDataSource
Test amacıyla oluşturulan yapay verileri temel alan değerlendirme çalıştırmaları için bir veri kaynağını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| input_mesajları | OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate | Hayı | ||
| └─ şablon | object dizisi veya OpenAI.EvalItem | Evet | ||
| └─ türü | enum | Olası değerler: template |
Evet | |
| item_generation_params | SyntheticDataGenerationPreviewItemGenerationParams | Evet | ||
| └─ model_deployment_name | String | Yapay veri oluşturmak için kullanılacak model dağıtımının adı. | Evet | |
| └─ output_dataset_id | dize (salt okunur) | Oluşturulan yapay verilerin depolandığı çıkış veri kümesinin tanımlayıcısı. Oluşturulan veriler, sütun kimliği, sorgu ve test_description içeren bir jsonl dosyasıdır. | Hayı | |
| └─ output_dataset_name | String | Oluşturulan yapay verilerin depolanacağı çıkış veri kümesinin adı. Sağlanmazsa, hizmet otomatik olarak veri kümesi adı oluşturur. | Hayı | |
| └─ istemi | String | Yapay veri oluşturmak için kullanılan istem. Hedef, aracıda yapılandırılan yönergelerle 'azure_ai_agent' türündeyse bu seçenektir. | Hayı | |
| └─ samples_count | tamsayı | Oluşturulacak en fazla veri örneği sayısı. | Evet | |
| └─ kaynaklar | OpenAI.EvalJsonlFileIdSource dizisi | Veri oluşturma için isteğe bağlı çekirdek veri içerik kaynağı dosyaları. | Evet | |
| └─ türü | enum | Öğe oluşturma parametrelerinin türü. Olası değerler: synthetic_data_gen_preview |
Evet | |
| target | Hedef | Ayırıcı desteği olan hedefler için temel sınıf. | Evet | |
| └─ türü | String | Hedefin türü. | Evet | |
| type | enum | Her zaman azure_ai_synthetic_data_gen_previewveri kaynağı türü.Olası değerler: azure_ai_synthetic_data_gen_preview |
Evet |
SyntheticDataGenerationPreviewItemGenerationParams
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| model_deployment_name | String | Yapay veri oluşturmak için kullanılacak model dağıtımının adı. | Evet | |
| output_dataset_id | dize (salt okunur) | Oluşturulan yapay verilerin depolandığı çıkış veri kümesinin tanımlayıcısı. Oluşturulan veriler, sütun kimliği, sorgu ve test_description içeren bir jsonl dosyasıdır. | Hayı | |
| output_dataset_name | String | Oluşturulan yapay verilerin depolanacağı çıkış veri kümesinin adı. Sağlanmazsa, hizmet otomatik olarak veri kümesi adı oluşturur. | Hayı | |
| prompt | String | Yapay veri oluşturmak için kullanılan istem. Hedef, aracıda yapılandırılan yönergelerle 'azure_ai_agent' türündeyse bu seçenektir. | Hayı | |
| samples_count | tamsayı | Oluşturulacak en fazla veri örneği sayısı. | Evet | |
| Kaynak | OpenAI.EvalJsonlFileIdSource dizisi | Veri oluşturma için isteğe bağlı çekirdek veri içerik kaynağı dosyaları. | Evet | |
| type | enum | Öğe oluşturma parametrelerinin türü. Olası değerler: synthetic_data_gen_preview |
Evet |
Hedef
Ayırıcı desteği olan hedefler için temel sınıf.
Hedef için Ayrımcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
azure_ai_model |
AzureAIModelTarget |
azure_ai_agent |
AzureAIAgentTarget |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | String | Hedefin türü. | Evet |
TargetCompletionEvalRunDataSource
Hedef tabanlı tamamlama değerlendirme yapılandırması için bir veri kaynağını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| input_mesajları | OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference | Hayı | ||
| └─ öğe_referansı | String | Evet | ||
| └─ türü | enum | Olası değerler: item_reference |
Evet | |
| kaynak | OpenAI.EvalJsonlFileContentSource veya OpenAI.EvalJsonlFileIdSource | Satır içi veya dosya verileri için kaynak yapılandırma. | Evet | |
| target | Hedef | Ayırıcı desteği olan hedefler için temel sınıf. | Evet | |
| └─ türü | String | Hedefin türü. | Evet | |
| type | enum | Her zaman azure_ai_target_completionsveri kaynağı türü.Olası değerler: azure_ai_target_completions |
Evet |
TargetConfig
Hedef yapılandırma için soyut sınıf.
TargetConfig için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
AzureOpenAIModel |
AzureOpenAIModelConfiguration |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | String | Model yapılandırmasının türü. | Evet |
TargetUpdate
Ayırıcı desteği olan hedefler için temel sınıf.
TargetUpdate için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
azure_ai_model |
AzureAIModelTargetUpdate |
azure_ai_agent |
AzureAIAgentTargetUpdate |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | String | Hedefin türü. | Evet |
TaksonomiKategorisi
Taksonomi kategori tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Taksonomi kategorisinin açıklaması. | Hayı | |
| kimlik | String | Taksonomi kategorisinin benzersiz tanımlayıcısı. | Evet | |
| name | String | Taksonomi kategorisinin adı. | Evet | |
| properties | nesne | Taksonomi kategorisi için ek özellikler. | Hayı | |
| riskCategory | RiskCategory | Saldırı hedefi için risk kategorisi. | Evet | |
| Alt kategori | TaxonomySubCategory dizisi | Taksonomi alt kategorilerinin listesi. | Evet |
TaxonomySubCategory
Taksonomi alt kategori tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Taksonomi alt kategorisinin açıklaması. | Hayı | |
| etkinleştirildi | Boolean | Bu alt kategori altındaki taksonomi öğelerinin listesi. | Evet | |
| kimlik | String | Taksonomi alt kategorisinin benzersiz tanımlayıcısı. | Evet | |
| name | String | Taksonomi alt kategorisinin adı. | Evet | |
| properties | nesne | Taksonomi alt kategorisi için ek özellikler. | Hayı |
ToolDescription
Bir aracı tarafından kullanılabilecek bir aracın açıklaması.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracın amacının kısa bir açıklaması. | Hayı | |
| name | String | Araç adı. | Hayı |
ToolProjectConnection
Bir proje bağlantısı kaynağı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| project_connection_id | String | Bu araca bağlı bir ToolProjectConnectionList'teki bir project bağlantısı. | Evet |
TracesPreviewEvalRunDataSource
Application Insights'ta depolanan Aracı izlemeleri üzerinde çalışan değerlendirme çalıştırmaları için bir veri kaynağını temsil eder.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| agent_id | String | Değerlendirme için izlemeleri filtrelemek için kullanılan aracı kimliği. | Hayı | |
| agent_name | String | Değerlendirme için izlemeleri filtrelemek için kullanılan aracı adı. | Hayı | |
| bitiş_zamanı | tamsayı | İzleme sorgusu penceresinin sonunu işaret eden Unix zaman damgası (saniye olarak). Varsayılan olarak geçerli saati kullanır. | Hayı | |
| ingestion_delay_seconds | tamsayı | İzlemeleri sorgularken alma için uygulanacak gecikme. | Hayı | 300 |
| lookback_hours | tamsayı | Application Insights'tan izlemeler alınırken uygulanan geri arama penceresi (saat cinsinden). Zamanlanmış değerlendirmeler için bu, yinelenme aralığından çıkarılır. |
Hayı | 168 |
| max_traces | tamsayı | Değerlendirme için alınan izlemelere uygulanan örnekleme sınırı. | Hayı | 1000 |
| trace_ids | dize dizisi | Değerlendirilmesi gereken Aracı izleme tanımlayıcıları koleksiyonu. | Hayı | |
| type | enum | Her zaman azure_ai_traces_previewveri kaynağı türü.Olası değerler: azure_ai_traces_preview |
Evet |
TreatmentEffectType
Tedavi Etki Türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Tedavi Etki Türü. |
| Türü | String |
| Değerler | TooFewSamplesInconclusiveChangedImprovedDegraded |
Tetikleyici
Zamanlamanın tetikleyicisi için temel model.
Tetikleyici için Ayrıştırıcı
Bu bileşen, farklı türler arasında ayrım yapmak için özelliğini type kullanır:
| Tür Değeri | Şema |
|---|---|
Cron |
CronTrigger |
Recurrence |
RecurrenceTrigger |
OneTime |
OneTimeTrigger |
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| type | TriggerType | Tetikleyicinin türü. | Evet |
TriggerType
Tetikleyicinin türü.
| Mülkiyet | Değer |
|---|---|
| Açıklama | Tetikleyicinin türü. |
| Türü | String |
| Değerler | CronRecurrenceOneTime |
UpdateAgentFromManifestRequest
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| manifest_id | String | Aracı sürümünü içeri aktaracak bildirim kimliği. | Evet | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| parameter_values | nesne | Bildirime yapılan ve tam olarak gerçekleştirilmiş bir Aracı ile sonuçlanacak girişler. | Evet |
UpdateAgentRequest
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tanım | AgentDefinition | Evet | ||
| └─ tür | AgentKind | Evet | ||
| └─ rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| açıklama | String | Aracının insan tarafından okunabilir bir açıklaması. Kısıtlamalar: maxLength: 512 |
Hayı | |
| metadata | nesne | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı |
UpdateEvalParametersBody
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| metadata | OpenAI.Metadata (null atanabilir) | Bir nesneye eklenebilen 16 anahtar-değer çifti kümesi. Bu, yapılandırılmış bir nesneyle ilgili ek bilgileri depolamak için kullanışlıdır biçimlendirme ve API veya kontrol paneli aracılığıyla nesneleri sorgulama. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler dizelerdir en fazla 512 karakter uzunluğunda. |
Hayı | |
| name | String | Hayı | ||
| properties | nesne | Ek bilgileri depolamak için bir nesneye eklenebilen sabit 16 anahtar-değer çifti kümesi. Anahtarlar, uzunluğu en fazla 64 karakter olan dizelerdir. Değerler, uzunluğu en fazla 512 karakter olan dizelerdir. |
Hayı |
UserProfileMemoryItem
Tercihler, ilgi alanları ve kişisel ayrıntılar gibi konuşmalardan çıkarılan kullanıcı profili bilgilerini özel olarak içeren bir bellek öğesi.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| içerik | String | Belleğin içeriği. | Evet | |
| tür | enum | Hafıza öğesinin türü. Olası değerler: user_profile |
Evet | |
| memory_id | String | Bellek öğesinin benzersiz kimliği. | Evet | |
| kapsam | String | Kullanıcı kimliği gibi anıları mantıksal olarak gruplandıran ve yalıtan ad alanı. | Evet | |
| updated_at | tamsayı | Bellek öğesinin son güncelleme zamanı. | Evet |
WebSearchConfiguration
bing özel arama için bir web arama yapılandırması
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| instance_name | String | Yapılandırmaya verilen özel yapılandırma örneğinin adı. | Evet | |
| project_connection_id | String | Project bağlantı kimliği bing özel arama ile topraklama için | Evet |
WeeklyRecurrenceSchedule
Haftalık yineleme programı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| daysOfWeek | DayOfWeek dizisi | Yinelenme zamanlaması için haftanın günleri. | Evet | |
| type | enum | Haftalık yineleme türü. Olası değerler: Weekly |
Evet |
WorkflowActionOutputItem
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| action_id | String | Eylem için benzersiz tanımlayıcı. | Evet | |
| agent_reference | AgentReference | Hayı | ||
| └─ ad | String | Aracının adı. Kısıtlamalar: maxLength: 256 |
Evet | |
| └─ türü | enum | Olası değerler: agent_reference |
Evet | |
| └─ sürümü | String | Aracının sürüm tanımlayıcısı. | Hayı | |
| tür | String | CSDL eyleminin türü (örneğin, 'SetVariable', 'InvokeAzureAgent'). | Evet | |
| parent_action_id | String | Bu iç içe bir eylemse, üst eylemin kimliği. | Hayı | |
| previous_action_id | String | Bu eylem başka bir eylemden sonra gelirse, önceki eylemin kimliği. | Hayı | |
| response_id | String | Öğenin oluşturulduğu yanıt. | Hayı | |
| durum | enum | Eylemin durumu (örneğin, 'in_progress', 'tamamlandı', 'başarısız', 'iptal edildi'). Olası değerler: completed, failed, in_progress, cancelled |
Evet | |
| type | enum | Olası değerler: workflow_action |
Evet |
WorkflowAgentDefinition
İş akışı aracısı tanımı.
| İsim | Türü | Description | Gerekli | Varsayılan |
|---|---|---|---|---|
| tür | enum | Olası değerler: workflow |
Evet | |
| rai_config | RaiConfig | Sorumlu Yapay Zeka (RAI) içerik filtreleme ve güvenlik özellikleri için yapılandırma. | Hayı | |
| └─ rai_policy_name | String | Uygulanacak RAI politikasının adı. | Evet | |
| iş akışı | String | İş akışının CSDL YAML tanımı. | Hayı |
tamsayı
Tür: tamsayı
Biçim: int64