Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Wersja interfejsu API: wersja 1
Authentication
Przepływ: niejawny
Adres URL autoryzacji:https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Zakresów:
https://ai.azure.com/.default
Agents
Agenci — tworzenie agenta
POST {endpoint}/agents?api-version=v1
Tworzy agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview, , HostedAgents=V1PreviewWorkflowAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | AgentDefinition | Yes | ||
| Rodzaj └* | AgentKind | Yes | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Unikatowa nazwa identyfikująca agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. - Musi rozpoczynać się i kończyć znakiem alfanumerycznym, - Może zawierać łączniki w środku - Nie może przekraczać 63 znaków. Ograniczenia: maxLength: 63 |
Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — lista agentów
GET {endpoint}/agents?api-version=v1
Zwraca listę wszystkich agentów.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| rodzaj | kwerenda | Nie. | ciąg Możliwe wartości: prompt, , hosted, container_appworkflow |
Filtruj agentów według rodzaju. Jeśli nie zostanie podana, zostaną zwróconi wszyscy agenci. |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — uzyskiwanie agenta
GET {endpoint}/agents/{agent_name}?api-version=v1
Pobiera agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — aktualizowanie agenta
POST {endpoint}/agents/{agent_name}?api-version=v1
Aktualizuje agenta, dodając nową wersję, jeśli nastąpią jakiekolwiek zmiany w definicji agenta. Jeśli nie ma zmian, zwraca istniejącą wersję agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview, , HostedAgents=V1PreviewWorkflowAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | AgentDefinition | Yes | ||
| Rodzaj └* | AgentKind | Yes | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — usuwanie agenta
DELETE {endpoint}/agents/{agent_name}?api-version=v1
Usuwa agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do usunięcia. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DeleteAgentResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — aktualizowanie agenta z manifestu
POST {endpoint}/agents/{agent_name}/import?api-version=v1
Aktualizuje agenta z manifestu, dodając nową wersję, jeśli istnieją jakiekolwiek zmiany w definicji agenta. Jeśli nie ma zmian, zwraca istniejącą wersję agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do zaktualizowania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Yes | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — tworzenie wersji agenta
POST {endpoint}/agents/{agent_name}/versions?api-version=v1
Utwórz nową wersję agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Unikatowa nazwa identyfikująca agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. - Musi rozpoczynać się i kończyć znakiem alfanumerycznym, - Może zawierać łączniki w środku - Nie może przekraczać 63 znaków. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview, , HostedAgents=V1PreviewWorkflowAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | AgentDefinition | Yes | ||
| Rodzaj └* | AgentKind | Yes | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentVersionObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — wyświetlanie listy wersji agentów
GET {endpoint}/agents/{agent_name}/versions?api-version=v1
Zwraca listę wersji agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do pobrania wersji programu . |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — uzyskiwanie wersji agenta
GET {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=v1
Pobiera określoną wersję agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do pobrania. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentVersionObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — usuwanie wersji agenta
DELETE {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=v1
Usuwa określoną wersję agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta do usunięcia. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta do usunięcia |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DeleteAgentVersionResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — tworzenie wersji agenta na podstawie manifestu
POST {endpoint}/agents/{agent_name}/versions:import?api-version=v1
Utwórz nową wersję agenta na podstawie manifestu.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Unikatowa nazwa identyfikująca agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. - Musi rozpoczynać się i kończyć znakiem alfanumerycznym, - Może zawierać łączniki w środku - Nie może przekraczać 63 znaków. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Yes | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentVersionObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Agenci — tworzenie agenta na podstawie manifestu
POST {endpoint}/agents:import?api-version=v1
Tworzy agenta na podstawie manifestu.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Yes | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Unikatowa nazwa identyfikująca agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. - Musi rozpoczynać się i kończyć znakiem alfanumerycznym, - Może zawierać łączniki w środku - Nie może przekraczać 63 znaków. Ograniczenia: maxLength: 63 |
Yes | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów
Kontenery agentów — wyświetlanie listy operacji kontenera agenta
GET {endpoint}/agents/{agent_name}/operations?api-version=v1
Wyświetlanie listy operacji kontenera dla agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — pobieranie operacji kontenera agenta
GET {endpoint}/agents/{agent_name}/operations/{operation_id}?api-version=v1
Uzyskaj stan operacji kontenera dla agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| operation_id | ścieżka | Yes | ciąg | Identyfikator operacji. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentContainerOperationObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — pobieranie kontenera agenta
GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default?api-version=v1
Pobierz kontener dla określonej wersji agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentContainerObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — wyświetlanie listy operacji kontenera wersji agenta
GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default/operations?api-version=v1
Wyświetlanie listy operacji kontenera dla określonej wersji agenta.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — usuwanie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:delete?api-version=v1
Usuń kontener dla określonej wersji agenta. Jeśli kontener nie istnieje, operacja będzie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentContainerOperationObject |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| Lokalizacja operacji | ciąg |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — dzienniki kontenera agenta strumienia
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:logstream?api-version=v1
Wpis dziennika kontenera przesyłany strumieniowo z kontenera jako fragmenty tekstu. Każdy fragment jest ciągiem UTF-8, który może być wierszem dziennika zwykłego tekstu lub wpisem dziennika sformatowanym w formacie JSON, w zależności od typu przesyłanego strumieniowo dziennika kontenera. Klienci powinni traktować każdy fragment jako nieprzezroczystym tekstem i w razie potrzeby próbować przeanalizować go w formacie JSON w oparciu o wymagania dotyczące rejestrowania.
W przypadku dzienników systemowych, format to JSON o następującej strukturze: {"TimeStamp":"2025-12-15T16:51:33Z","Type":"Normal","ContainerAppName":null,"RevisionName":null,"ReplicaName"::null,"Msg":"Connecting to the events collector...","Reason":"StartingGettingEvents","EventSource":"ContainerAppController","Count":1} {"TimeStamp":"2025-12-15T16:51:34Z","Type":"Normal","ContainerAppName":null,"RevisionName":null,"ReplicaName":null,"Msg":"Pomyślnie nawiązano połączenie ze zdarzeniami server","Reason":"ConnectedToEventsServer","EventSource":"ContainerAppController","Count":1}
W przypadku dzienników konsoli format jest zwykłym tekstem emitowanym przez stdout/stderr kontenera. 2025-12-15T08:43:48.72656 Trwa łączenie z kontenerem "agent-container"... 2025-12-15T08:43:48.75451 Successfully Connected to container: 'agent-container' [Revision: 'je90fe655aa742ef9a188b9fd14d6764--7tca06b', Replica: 'je90fe655aa742ef9a188b9fd14d6764--7tca06b-6898b9c89f-mpkjc'] 2025-12-15T08:33:59.0671054Z stdout F INFO: 127.0.0.1:42588 - "GET /readiness HTTP/1.1" 200 OK 2025-12-15T08:34:29.0649033Z stdout F INFO: 127.0.0.1:60246 - "GET /readiness HTTP/1.1" 200 OK 2025-12-15T08:34:59.0644467Z stdout F INFO: 127.0.0.1:43994 - "GET /readiness HTTP/1.1" 200 OK
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| rodzaj | kwerenda | Nie. | ciąg Możliwe wartości: console, system |
konsola zwraca strumień zdarzeń kontenera stdout/stderr, system zwraca strumień zdarzeń aplikacji kontenera. wartość domyślna konsoli |
| replica_name | kwerenda | Nie. | ciąg | Po pominięciu serwer wybiera pierwszą replikę logów konsoli. Wymagane do kierowania na określoną replikę. |
| końcowa część | kwerenda | Nie. | liczba całkowita | Liczba zwracanych końcowych wierszy. Wymuszone do 1–300. Wartość domyślna to 20 |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — uruchamianie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:start?api-version=v1
Uruchom kontener dla określonej wersji agenta. Jeśli kontener już działa, operacja będzie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_replicas | liczba całkowita | Maksymalna liczba replik. Wartość domyślna to 1. | Nie. | 1 |
| min_replicas | liczba całkowita | Minimalna liczba replik. Wartość domyślna to 1. | Nie. | 1 |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentContainerOperationObject |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| Lokalizacja operacji | ciąg |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — zatrzymywanie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:stop?api-version=v1
Zatrzymaj kontener dla określonej wersji agenta. Jeśli kontener nie działa lub został już zatrzymany, operacja będzie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentContainerOperationObject |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| Lokalizacja operacji | ciąg |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kontenery agentów — aktualizowanie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:update?api-version=v1
Aktualizowanie kontenera dla określonej wersji agenta. Jeśli kontener nie działa, operacja będzie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| agent_name | ścieżka | Yes | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Yes | ciąg | Wersja agenta. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: ContainerAgents=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_replicas | liczba całkowita | Maksymalna liczba replik. | Nie. | |
| min_replicas | liczba całkowita | Minimalna liczba replik. | Nie. |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AgentContainerOperationObject |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| Lokalizacja operacji | ciąg |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Connections
Połączenia — lista
GET {endpoint}/connections?api-version=v1
Wyświetlanie listy wszystkich połączeń w projekcie bez wypełniania poświadczeń połączenia
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ połączenia | kwerenda | Nie. | ciąg Możliwe wartości: AzureOpenAI, AzureBlob, AzureStorageAccount, CognitiveSearch, CosmosDB, ApiKey, AppConfig, AppInsights, CustomKeys, RemoteTool_Preview |
Wyświetlanie listy połączeń tego określonego typu |
| defaultConnection | kwerenda | Nie. | boolean | Wyświetlanie listy połączeń, które są połączeniami domyślnymi |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| x-ms-client-request-id | Nieprawda | ciąg | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedConnection |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-client-request-id | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Połączenia — pobierz
GET {endpoint}/connections/{name}?api-version=v1
Uzyskiwanie połączenia według nazwy bez wypełniania poświadczeń połączenia
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Przyjazna nazwa połączenia podana przez użytkownika. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| x-ms-client-request-id | Nieprawda | ciąg | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Connection |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-client-request-id | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Połączenia — pobieranie przy użyciu poświadczeń
POST {endpoint}/connections/{name}/getConnectionWithCredentials?api-version=v1
Uzyskiwanie połączenia według nazwy z poświadczeniami połączenia
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Przyjazna nazwa połączenia podana przez użytkownika. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| x-ms-client-request-id | Nieprawda | ciąg | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Connection |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-client-request-id | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Datasets
Zestawy danych — lista najnowszych
GET {endpoint}/datasets?api-version=v1
Wyświetlanie listy najnowszej wersji każdego elementu DatasetVersion
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedDatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Zestawy danych — wersje listy
GET {endpoint}/datasets/{name}/versions?api-version=v1
Wyświetlanie listy wszystkich wersji danego elementu DatasetVersion
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedDatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Zestawy danych — pobieranie wersji
GET {endpoint}/datasets/{name}/versions/{version}?api-version=v1
Pobierz określoną wersję parametru DatasetVersion. Usługa zwraca błąd 404 Nie znaleziono, jeśli element DatasetVersion nie istnieje.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji elementu DatasetVersion do pobrania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Zestawy danych — usuwanie wersji
DELETE {endpoint}/datasets/{name}/versions/{version}?api-version=v1
Usuń określoną wersję elementu DatasetVersion. Usługa zwraca wartość 204 Brak zawartości, jeśli element DatasetVersion został pomyślnie usunięty lub jeśli element DatasetVersion nie istnieje.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Wersja elementu DatasetVersion do usunięcia. |
Responses
Kod stanu: 204
Opis: Nie ma zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Zestawy danych — tworzenie lub aktualizowanie wersji
PATCH {endpoint}/datasets/{name}/versions/{version}?api-version=v1
Tworzenie nowego lub aktualizowanie istniejącego elementu DatasetVersion przy użyciu podanego identyfikatora wersji
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji elementu DatasetVersion do utworzenia lub zaktualizowania. |
Treść żądania
Typ treści: application/merge-patch+json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | Typ zestawu danych | Wyliczenie w celu określenia typu danych. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DatasetVersion |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Zestawy danych — uzyskiwanie poświadczeń
POST {endpoint}/datasets/{name}/versions/{version}/credentials?api-version=v1
Uzyskaj poświadczenia sygnatury dostępu współdzielonego, aby uzyskać dostęp do konta magazynu skojarzonego z wersją zestawu danych.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji elementu DatasetVersion do działania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | AssetCredentialResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Zestawy danych — rozpoczynanie oczekiwania na przekazanie wersji
POST {endpoint}/datasets/{name}/versions/{version}/startPendingUpload?api-version=v1
Rozpocznij nową lub uzyskaj istniejącą oczekującą na przekazanie zestawu danych dla określonej wersji.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji elementu DatasetVersion do działania. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Connectionname | ciąg | Nazwa połączenia konta usługi Azure Storage do użycia do generowania tymczasowego tokenu SAS | Nie. | |
| pendingUploadId | ciąg | Jeśli PendingUploadId nie zostanie podany, zostanie użyty losowy identyfikator GUID. | Nie. | |
| pendingUploadType | wyliczenie | Funkcja BlobReference jest jedynym obsługiwanym typem. Możliwe wartości: BlobReference |
Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PendingUploadResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Wdrożenia
Wdrożenia — lista
GET {endpoint}/deployments?api-version=v1
Wyświetlanie listy wszystkich wdrożonych modeli w projekcie
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| modelPublisher | kwerenda | Nie. | ciąg | Wydawca modelu do filtrowania modeli według |
| modelName | kwerenda | Nie. | ciąg | Nazwa modelu (nazwa specyficzna dla wydawcy) do filtrowania modeli według |
| deploymentType | kwerenda | Nie. | ciąg Możliwe wartości: ModelDeployment |
Typ wdrożenia do filtrowania listy według |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| x-ms-client-request-id | Nieprawda | ciąg | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedDeployment |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-client-request-id | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Wdrożenia — pobieranie
GET {endpoint}/deployments/{name}?api-version=v1
Pobierz wdrożony model.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa wdrożenia |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| x-ms-client-request-id | Nieprawda | ciąg | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Wdrożenie |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-client-request-id | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Taksonomie ewaluacyjne
Taksonomie oceny — lista
GET {endpoint}/evaluationtaxonomies?api-version=v1
Lista taksonomii oceny
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| inputName | kwerenda | Nie. | ciąg | Filtruj według nazwy wejściowej oceny. |
| inputType | kwerenda | Nie. | ciąg | Filtruj według typu danych wejściowych taksonomii. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedEvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Taksonomie oceny — pobierz
GET {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Pobierz przebieg oceny według nazwy.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Taksonomie oceny — usuwanie
DELETE {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Usuń taksonomię oceny według nazwy.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 204
Opis: Nie ma zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Taksonomie oceny — tworzenie
PUT {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Utwórz taksonomię oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa taksonomii oceny. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| properties | obiekt | Dodatkowe właściwości taksonomii oceny. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| taksonomiaKategorie | tablica taksonomiiKategory | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | EvaluationTaxonomyInput | Konfiguracja danych wejściowych dla taksonomii oceny. | Yes | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationTaxonomy |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Taksonomie oceny — aktualizacja
PATCH {endpoint}/evaluationtaxonomies/{name}?api-version=v1
Aktualizowanie taksonomii ewaluacyjnej.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa taksonomii oceny. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| properties | obiekt | Dodatkowe właściwości taksonomii oceny. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| taksonomiaKategorie | tablica taksonomiiKategory | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | EvaluationTaxonomyInputUpdate | Konfiguracja danych wejściowych dla taksonomii oceny. | Nie. | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Reguły oceny
Reguły oceny — lista
GET {endpoint}/evaluationrules?api-version=v1
Wyświetl listę wszystkich reguł oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| actionType | kwerenda | Nie. | ciąg Możliwe wartości: continuousEvaluation, humanEvaluationPreview |
Filtruj według typu reguły oceny. |
| agentName | kwerenda | Nie. | ciąg | Filtruj według nazwy agenta. |
| enabled | kwerenda | Nie. | boolean | Filtruj według stanu włączonego. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedEvaluationRule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Reguły oceny — pobieranie
GET {endpoint}/evaluationrules/{id}?api-version=v1
Uzyskaj regułę oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Unikatowy identyfikator reguły oceny. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationRule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Reguły oceny — usuwanie
DELETE {endpoint}/evaluationrules/{id}?api-version=v1
Usuń regułę oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Unikatowy identyfikator reguły oceny. |
Responses
Kod stanu: 204
Opis: Nie ma zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Reguły oceny — tworzenie lub aktualizowanie
PUT {endpoint}/evaluationrules/{id}?api-version=v1
Utwórz lub zaktualizuj regułę oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Unikatowy identyfikator reguły oceny. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | Nieprawda | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | EvaluationRuleAction | Model działania ewaluacyjnego. | Yes | |
| └typ | EvaluationRuleActionType | Rodzaj działania w ramach oceny. | Yes | |
| opis | ciąg | Opis reguły oceny. | Nie. | |
| displayName | ciąg | Nazwa wyświetlana reguły oceny. | Nie. | |
| enabled | boolean | Wskazuje, czy reguła oceny jest włączona. Wartość domyślna to true. | Yes | |
| eventType | EvaluationRuleEventType | Typ zdarzenia reguły oceny. | Yes | |
| filtr | EvaluationRuleFilter | Model filtru oceny. | Nie. | |
| └} agentName | ciąg | Filtruj według nazwy agenta. | Yes | |
| id | ciąg (tylko do odczytu) | Unikatowy identyfikator reguły oceny. | Yes | |
| daneSystemowe | obiekt (tylko do odczytu) | Metadane systemu dla reguły oceny. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationRule |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluationRule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Ewaluatorzy
Ewaluatory — lista najnowszych wersji
GET {endpoint}/evaluators?api-version=v1
Lista najnowszych wersji każdego ewaluatora
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ | kwerenda | Nie. | ciąg Możliwe wartości: builtin, , customall |
Filtruj ewaluatory według typu. Możliwe wartości: "all", "custom", "builtin". |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedEvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Ewaluatory — wersje listy
GET {endpoint}/evaluators/{name}/versions?api-version=v1
Lista wszystkich wersji danego ewaluatora
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| typ | kwerenda | Nie. | ciąg Możliwe wartości: builtin, , customall |
Filtruj ewaluatory według typu. Możliwe wartości: "all", "custom", "builtin". |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedEvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Ewaluatory — tworzenie wersji
POST {endpoint}/evaluators/{name}/versions?api-version=v1
Utwórz nową wersję EvaluatorVersion z automatycznie zwiększanym identyfikatorem wersji
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| categories | tablica EwaluatorCategory | Kategorie osoby oceniającej | Yes | |
| definicja | EwaluatorDefinition | Podstawowa konfiguracja ewaluatora z dyskryminatorem | Yes | |
| └data_schema | obiekt | Schemat JSON (wersja robocza 2020-12) dla danych wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| └init_parameters | obiekt | Schemat JSON (wersja robocza 2020-12) dla parametrów wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| Metryki └* | obiekt | Lista wskaźników wyjściowych opracowanych przez tego ewaluatora | Nie. | |
| └typ | EwaluatorDefinitionType | Definicja rodzaju osoby ewaluującej | Yes | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Łatwiej jest znaleźć ewaluatora w AI Foundry. Nie musi być unikalny. | Nie. | |
| evaluator_type | Typ ewaluatora | Rodzaj osoby oceniającej | Yes | |
| metadane | obiekt | Metadane dotyczące osoby oceniającej | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. |
Responses
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Ewaluatory — pobieranie wersji
GET {endpoint}/evaluators/{name}/versions/{version}?api-version=v1
Pobierz konkretną wersję EvaluatorVersion. Usługa zwraca błąd 404 Nie znaleziono, jeśli EvaluatorVersion nie istnieje.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji ewaluatorVersion do pobrania. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Ewaluatory — usuwanie wersji
DELETE {endpoint}/evaluators/{name}/versions/{version}?api-version=v1
Usuń określoną wersję EvaluatorVersion. Usługa zwraca wartość 204 No Content, jeśli element EvaluatorVersion został pomyślnie usunięty lub jeśli element EvaluatorVersion nie istnieje.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Wersja ewaluatorVersion do usunięcia. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 204
Opis: Nie ma zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Ewaluatorzy — wersja aktualizacji
PATCH {endpoint}/evaluators/{name}/versions/{version}?api-version=v1
Zaktualizuj istniejącą wersję EvaluatorVersion przy użyciu podanego identyfikatora wersji
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Wersja ewaluatorVersion do aktualizacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Evaluations=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| categories | tablica EwaluatorCategory | Kategorie osoby oceniającej | Nie. | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Łatwiej jest znaleźć ewaluatora w AI Foundry. Nie musi być unikalny. | Nie. | |
| metadane | obiekt | Metadane dotyczące osoby oceniającej | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Indexes
Indeksy — najnowsza lista
GET {endpoint}/indexes?api-version=v1
Wyświetlanie listy najnowszej wersji każdego indeksu
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedIndex |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Indeksy — wersje listy
GET {endpoint}/indexes/{name}/versions?api-version=v1
Wyświetl listę wszystkich wersji danego indeksu
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedIndex |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Indeksy — pobieranie wersji
GET {endpoint}/indexes/{name}/versions/{version}?api-version=v1
Pobierz określoną wersję indeksu. Usługa zwraca błąd 404 Nie znaleziono, jeśli indeks nie istnieje.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji indeksu do pobrania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Indeks |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Indeksy — usuwanie wersji
DELETE {endpoint}/indexes/{name}/versions/{version}?api-version=v1
Usuń określoną wersję indeksu. Usługa zwraca wartość 204 Brak zawartości, jeśli indeks został pomyślnie usunięty lub indeks nie istnieje.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Wersja indeksu do usunięcia. |
Responses
Kod stanu: 204
Opis: Nie ma zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Indeksy — tworzenie lub aktualizowanie wersji
PATCH {endpoint}/indexes/{name}/versions/{version}?api-version=v1
Tworzenie nowego lub aktualizowanie istniejącego indeksu przy użyciu podanego identyfikatora wersji
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Nazwa zasobu |
| wersja | ścieżka | Yes | ciąg | Określony identyfikator wersji indeksu do utworzenia lub zaktualizowania. |
Treść żądania
Typ treści: application/merge-patch+json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | Typ indeksu | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Indeks |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Indeks |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Insights
Szczegółowe informacje — generowanie
POST {endpoint}/insights?api-version=v1
Generowanie szczegółowych informacji
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Insights=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
| Powtarzalność —Request-ID | Nieprawda | ciąg | Unikatowy, wygenerowany przez klienta identyfikator zapewniający idempotentność żądania. Użyj tego samego identyfikatora dla ponownych prób, aby zapobiec zduplikowanym ocenom. |
| Powtarzalność —First-Sent | Nieprawda | ciąg | Sygnatura czasowa wskazująca, kiedy to żądanie zostało zainicjowane po raz pierwszy. Używany w połączeniu z repeatability-request-id do kontroli idempotentności. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| displayName | ciąg | Przyjazna dla użytkownika nazwa wyświetlana szczegółowych informacji. | Yes | |
| id | ciąg (tylko do odczytu) | Unikatowy identyfikator raportu szczegółowych informacji. | Yes | |
| metadane | InsightsMetadata (tylko do odczytu) | Metadane dotyczące szczegółowych informacji. | Yes | |
| └* completedAt | ciąg | Sygnatura czasowa ukończenia szczegółowych informacji. | Nie. | |
| └} createdAt | ciąg | Sygnatura czasowa utworzenia szczegółowych informacji. | Yes | |
| żądanie | InsightRequest | Żądanie raportu szczegółowych informacji. | Yes | |
| └typ | InsightType | Typ żądania. | Yes | |
| result | InsightResult (tylko do odczytu) | Wynik spostrzeżeń. | Nie. | |
| └typ | InsightType | Typ wyniku szczegółowych informacji. | Yes | |
| stan | Azure. Core.Foundations.OperationState (tylko do odczytu) | Wyliczenie opisujące dozwolone stany operacji. | Yes |
Responses
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Wgląd |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Szczegółowe informacje — lista
GET {endpoint}/insights?api-version=v1
Wyświetl wszystkie szczegółowe informacje w odwrotnej kolejności chronologicznej (najnowsza pierwsza).
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ | kwerenda | Nie. | ciąg Możliwe wartości: EvaluationRunClusterInsight, , AgentClusterInsightEvaluationComparison |
Filtrowanie według typu analizy. |
| evalId | kwerenda | Nie. | ciąg | Filtrowanie według identyfikatora oceny. |
| identyfikator uruchomienia | kwerenda | Nie. | ciąg | Filtrowanie według identyfikatora przebiegu oceny. |
| agentName | kwerenda | Nie. | ciąg | Filtruj według nazwy agenta. |
| includeCoordinates | kwerenda | Nie. | boolean | Określa, czy w odpowiedzi mają być uwzględniane współrzędne wizualizacji. Wartość domyślna to fałsz. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Insights=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedInsight |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Szczegółowe informacje — uzyskiwanie
GET {endpoint}/insights/{id}?api-version=v1
Uzyskaj szczegółowe informacje według identyfikatora.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Unikatowy identyfikator raportu szczegółowych informacji. |
| includeCoordinates | kwerenda | Nie. | boolean | Określa, czy w odpowiedzi mają być uwzględniane współrzędne wizualizacji. Wartość domyślna to fałsz. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Insights=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Wgląd |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Magazyny pamięci
Tworzenie magazynu pamięci
POST {endpoint}/memory_stores?api-version=v1
Utwórz magazyn pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | MemoryStoreDefinition | Podstawowa definicja konfiguracji magazynu pamięci. | Yes | |
| Rodzaj └* | MemoryStoreKind | Rodzaj magazynu pamięci. | Yes | |
| opis | ciąg | Czytelny dla człowieka opis magazynu pamięci. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Dowolne metadane klucz-wartość do skojarzenia z magazynem pamięci. | Nie. | |
| nazwa | ciąg | Nazwa magazynu pamięci. Ograniczenia: maxLength: 256 |
Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Lista magazynów pamięci
GET {endpoint}/memory_stores?api-version=v1
Wyświetla listę wszystkich magazynów pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Aktualizowanie magazynu pamięci
POST {endpoint}/memory_stores/{name}?api-version=v1
Aktualizowanie magazynu pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci do zaktualizowania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis magazynu pamięci. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Dowolne metadane klucz-wartość do skojarzenia z magazynem pamięci. | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Pobieranie magazynu pamięci
GET {endpoint}/memory_stores/{name}?api-version=v1
Pobieranie magazynu pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Usuwanie magazynu pamięci
DELETE {endpoint}/memory_stores/{name}?api-version=v1
Usuń magazyn pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci do usunięcia. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DeleteMemoryStoreResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Pobieranie wyniku aktualizacji
GET {endpoint}/memory_stores/{name}/updates/{update_id}?api-version=v1
Pobierz wynik aktualizacji magazynu pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci. |
| update_id | ścieżka | Yes | ciąg | Identyfikator operacji aktualizacji pamięci. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreUpdateResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Usuwanie wspomnień zakresu
POST {endpoint}/memory_stores/{name}:delete_scope?api-version=v1
Usuń wszystkie wspomnienia skojarzone z określonym zakresem z magazynu pamięci.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje pamięci do usunięcia, na przykład identyfikator użytkownika. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreDeleteScopeResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyszukiwanie wspomnień
POST {endpoint}/memory_stores/{name}:search_memories?api-version=v1
Wyszukaj odpowiednie wspomnienia z magazynu wspomnień na podstawie kontekstu rozmowy.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci do wyszukania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| items | tablica openAI.InputItem | Elementy, dla których należy wyszukać odpowiednie wspomnienia. | Nie. | |
| options | MemorySearchOptions | Opcje wyszukiwania w pamięci. | Nie. | |
| └max_memories | liczba całkowita | Maksymalna liczba elementów pamięci do zwrócenia. | Nie. | |
| previous_search_id | ciąg | Unikatowy identyfikator poprzedniego żądania wyszukiwania, umożliwiający przyrostowe wyszukiwanie pamięci, z którego została przerwana ostatnia operacja. | Nie. | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreSearchResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Aktualizowanie pamięci
POST {endpoint}/memory_stores/{name}:update_memories?api-version=v1
Zaktualizuj magazyn pamięci o wspomnienia z rozmów.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| nazwa | ścieżka | Yes | ciąg | Nazwa magazynu pamięci do zaktualizowania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: MemoryStores=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| items | tablica openAI.InputItem | Elementy konwersacji, z których mają być wyodrębnione wspomnienia. | Nie. | |
| previous_update_id | ciąg | Unikatowy identyfikator poprzedniego żądania aktualizacji, włączając aktualizacje pamięci przyrostowej, z których ostatnia operacja została przerwana. | Nie. | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes | |
| update_delay | liczba całkowita | Limit czasu przed przetworzeniem aktualizacji pamięci w sekundach. Jeśli w tym okresie zostanie odebrane nowe żądanie aktualizacji, anuluje bieżące żądanie i zresetuje limit czasu. Ustaw wartość 0, aby natychmiast wyzwolić aktualizację bez opóźnień. Wartość domyślna to 300 (5 minut). |
Nie. | 300 |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | MemoryStoreUpdateResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| Lokalizacja operacji | ciąg | Lokalizacja monitorowania stanu operacji. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Rozmowy
Tworzenie konwersacji
POST {endpoint}/openai/v1/conversations
Utwórz konwersację.
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| items | tablica openAI.InputItem | Nie. | ||
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy konwersacji
GET {endpoint}/openai/v1/conversations
Zwraca listę wszystkich konwersacji.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| agent_name | kwerenda | Nie. | ciąg | Filtruj według nazwy agenta. Jeśli zostanie podana, zostaną zwrócone tylko elementy skojarzone z określonym agentem. |
| Agent_id | kwerenda | Nie. | ciąg | Filtruj według identyfikatora agenta w formacie name:version. Jeśli zostanie podana, zostaną zwrócone tylko elementy skojarzone z określonym identyfikatorem agenta. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Aktualizowanie konwersacji
POST {endpoint}/openai/v1/conversations/{conversation_id}
Aktualizowanie konwersacji.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji do zaktualizowania. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Uzyskiwanie konwersacji
GET {endpoint}/openai/v1/conversations/{conversation_id}
Pobiera konwersację.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji do pobrania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Usuwanie konwersacji
DELETE {endpoint}/openai/v1/conversations/{conversation_id}
Usuwa konwersację.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji do usunięcia. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.DeletedConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Tworzenie elementów konwersacji
POST {endpoint}/openai/v1/conversations/{conversation_id}/items
Utwórz elementy w konwersacji z danym identyfikatorem.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji, na której należy utworzyć element. |
| Obejmują | kwerenda | Nie. | macierz | Dodatkowe pola do uwzględnienia w odpowiedzi.include Aby uzyskać więcej informacji, zobacz parametr zawierający listę elementów konwersacji. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| items | tablica elementów OpenAI.Item | Elementy do dodania do konwersacji. Jednocześnie możesz dodać maksymalnie 20 elementów. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ConversationItemList |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy elementów konwersacji
GET {endpoint}/openai/v1/conversations/{conversation_id}/items
Wyświetl listę wszystkich elementów konwersacji z danym identyfikatorem.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji, na której należy wymienić elementy. |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| item_type | kwerenda | Nie. | ciąg Możliwe wartości: message, output_messagefile_search_callcomputer_callcomputer_call_outputweb_search_callfunction_callfunction_call_outputreasoningcompactionimage_generation_callcode_interpreter_calllocal_shell_calllocal_shell_call_outputshell_callshell_call_outputapply_patch_callapply_patch_call_outputmcp_list_toolsmcp_approval_requestmcp_approval_responsemcp_callcustom_tool_call_outputcustom_tool_callstructured_outputsoauth_consent_requestmemory_search_callworkflow_action |
Filtruj według typu elementu. Jeśli zostanie podana, zostaną zwrócone tylko elementy określonego typu. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Pobieranie elementu konwersacji
GET {endpoint}/openai/v1/conversations/{conversation_id}/items/{item_id}
Pobierz pojedynczy element z konwersacji z podanymi identyfikatorami.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji zawierającej element. |
| item_id | ścieżka | Yes | ciąg | Identyfikator elementu konwersacji do pobrania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.OutputItem |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Usuwanie elementu konwersacji
DELETE {endpoint}/openai/v1/conversations/{conversation_id}/items/{item_id}
Usuń element z konwersacji z podanymi identyfikatorami.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| conversation_id | ścieżka | Yes | ciąg | Identyfikator konwersacji, z której należy usunąć element. |
| item_id | ścieżka | Yes | ciąg | Identyfikator elementu konwersacji do usunięcia. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals
Evals — evals listy
GET {endpoint}/openai/v1/evals
Wyświetl listę wszystkich ocen Lista ocen dla projektu.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| Po | kwerenda | Nie. | ciąg | Identyfikator ostatniego uruchomienia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba przebiegów do pobrania. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Kolejność sortowania przebiegów według znacznika czasu. Użyj asc dla kolejności rosnącej lub desc dla kolejności malejącej. Wartość domyślna to asc. |
| sortowanie_według | kwerenda | Nie. | ciąg Możliwe wartości: created_at, updated_at |
Oceny mogą być uporządkowane według czasu utworzenia lub czasu ostatniej aktualizacji. Użyj created_at dla czasu utworzenia lub updated_at dla czasu ostatniej aktualizacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — tworzenie eval
POST {endpoint}/openai/v1/evals
Utwórz ocenę Utwórz strukturę oceny, która może służyć do testowania wydajności modelu. Ocena to zestaw kryteriów testowania i konfiguracja źródła danych, która określa schemat danych używanych w ocenie. Po utworzeniu oceny można uruchomić go na różnych modelach i parametrach modelu. Obsługujemy kilka typów klasyrów i źródeł danych. Aby uzyskać więcej informacji, zobacz
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| konfiguracja źródła danych | OpenAI.CreateEvalCustomDataSourceConfig lub OpenAI.CreateEvalLogsDataSourceConfig lub OpenAI.CreateEvalStoredCompletionsDataSourceConfig lub AzureAIDataSourceConfig | Konfiguracja źródła danych używanego do uruchamiania oceny. Określa schemat danych używanych w ocenie. | Yes | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Nazwa oceny. | Nie. | |
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. | |
| kryteria_testowe | tablica elementów OpenAI.EvalGraderLabelModel lub OpenAI.EvalGraderStringCheck lub OpenAI.EvalGraderTextSimilarity lub OpenAI.EvalGraderPython lub OpenAI.EvalGraderScoreModel lub EvalGraderAzureAIEvaluator | Lista osób oceniających dla wszystkich przebiegów oceny w tej grupie. Klasyfikatory mogą odwoływać się do zmiennych w źródle danych przy użyciu notacji podwójnych nawiasów klamrowych, takich jak {{item.variable_name}}. Aby odwołać się do danych wyjściowych modelu, użyj sample przestrzeni nazw (tj. {{sample.output_text}}). |
Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Eval |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — usuwanie eval
DELETE {endpoint}/openai/v1/evals/{eval_id}
Usuń ocenę Usuń ocenę.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny do usunięcia. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DeleteEvalResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Oceny – zrób ocenę
GET {endpoint}/openai/v1/evals/{eval_id}
Uzyskaj ocenę Pobierz ocenę według identyfikatora.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny do odzyskania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Eval |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — eval aktualizacji
POST {endpoint}/openai/v1/evals/{eval_id}
Zaktualizuj ocenę Zaktualizuj niektóre właściwości oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny do zaktualizowania. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Nie. | ||
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Eval |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — uruchomienia listy
GET {endpoint}/openai/v1/evals/{eval_id}/runs
Pobierz listę przebiegów oceny Pobierz listę przebiegów do oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny, dla której mają zostać pobrane przebiegi. |
| Po | kwerenda | Nie. | ciąg | Identyfikator ostatniego uruchomienia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba przebiegów do pobrania. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Kolejność sortowania przebiegów według znacznika czasu. Użyj asc dla kolejności rosnącej lub desc dla kolejności malejącej. Wartość domyślna to asc. |
| stan | kwerenda | Nie. | ciąg Możliwe wartości: queued, , in_progresscompleted, canceled, failed . Filtruj uruchomienia według stanu. Jeden z queued, , in_progressfailed, completed, canceled. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — tworzenie przebiegu oceny
POST {endpoint}/openai/v1/evals/{eval_id}/runs
Tworzenie przebiegu oceny
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny potrzebny do utworzenia przebiegu. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| źródło danych | OpenAI.CreateEvalJsonlRunDataSource lub OpenAI.CreateEvalCompletionsRunDataSource lub OpenAI.CreateEvalResponsesRunDataSource lub EvalRunDataSource | Szczegółowe informacje o źródle danych przebiegu. | Yes | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Nazwa przebiegu. | Nie. | |
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvalRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — usuwanie przebiegu oceny
DELETE {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}
Usuń przebieg oceny Usuń przebieg oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny, z której ma zostać usunięty przebieg. |
| run_id | ścieżka | Yes | ciąg | Identyfikator przebiegu do usunięcia. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DeleteEvalRunResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals - get eval run (Pobieranie przebiegu oceny)
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}
Pobierz przebieg oceny Pobierz ocenę uruchamianą według identyfikatora.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny, dla której mają zostać pobrane przebiegi. |
| run_id | ścieżka | Yes | ciąg | Identyfikator przebiegu do pobrania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvalRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — anulowanie przebiegu oceny
POST {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}
Anuluj przebieg oceny Anuluj trwający przebieg oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator ewaluacji, której wykonanie chcesz anulować. |
| run_id | ścieżka | Yes | ciąg | Identyfikator uruchomienia do anulowania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvalRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — pobieranie elementów wyjściowych przebiegu eval
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items
Pobierz elementy wyjściowe przebiegu oceny Pobierz listę elementów wyjściowych dla przebiegu oceny.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | |
| run_id | ścieżka | Yes | ciąg | Identyfikator przebiegu w celu pobrania elementów wyjściowych. |
| Po | kwerenda | Nie. | ciąg | Identyfikator ostatniego uruchomienia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba przebiegów do pobrania. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Kolejność sortowania przebiegów według znacznika czasu. Użyj asc dla kolejności rosnącej lub desc dla kolejności malejącej. Wartość domyślna to asc. |
| stan | kwerenda | Nie. | ciąg Możliwe wartości: fail, pass |
Filtruj elementy wyjściowe według stanu. Użyj failed polecenia , aby filtrować według nieudanych danych wyjściowychelementy lub pass filtrowanie według przekazanych elementów wyjściowych. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Evals — pobieranie elementu wyjściowego przebiegu eval
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}
Pobierz element wyjściowy przebiegu oceny Pobierz element wyjściowy przebiegu oceny według identyfikatora.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| eval_id | ścieżka | Yes | ciąg | Identyfikator oceny, dla której mają zostać pobrane przebiegi. |
| run_id | ścieżka | Yes | ciąg | Identyfikator przebiegu do pobrania. |
| Identyfikator_elementu_wyjściowego (output_item_id) | ścieżka | Yes | ciąg | Identyfikator elementu wyjściowego do pobrania. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | EvalRunOutputItem |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Fine-Tuning
Tworzenie zadania dostrajania
POST {endpoint}/openai/v1/fine_tuning/jobs?api-version=v1
Tworzy zadanie dostrajania, które rozpoczyna proces tworzenia nowego modelu na podstawie danego zestawu danych.
Odpowiedź zawiera szczegóły zadania w kolejce, w tym stan zadania, jak również nazwę dopasowanych modeli po zakończeniu.
Dowiedz się więcej o dostrajaniu
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| hiperparametry | OpenAI.CreateFineTuningJobRequestHyperparameters | Nie. | ||
| └batch_size | string lub OpenAI.integer | Nie. | samochód | |
| └ learning_rate_multiplier | string lub OpenAI.numeric | Nie. | ||
| └n_epochs | string lub OpenAI.integer | Nie. | samochód | |
| Integracje | tablica obiektów OpenAI.CreateFineTuningJobRequestIntegrations | Lista integracji umożliwiających dostrajanie zadania. | Nie. | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| metoda | OpenAI.FineTuneMethod | Metoda używana do dostrajania. | Nie. | |
| model | ciąg (zobacz prawidłowe modele poniżej) | Nazwa modelu do dostosowania. Możesz wybrać jedną z opcji obsługiwane modele. |
Yes | |
| seed | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Sufiks | ciąg (dopuszczany do wartości null) | Ciąg składający się z maksymalnie 64 znaków, które zostaną dodane do nazwy dostrojonego modelu. Na przykład wartość suffix "custom-model-name" spowoduje wygenerowanie nazwy modelu, takiej jak ft:gpt-4o-mini:openai:custom-model-name:7p4lURel.Ograniczenia: minLength: 1, maxLength: 64 |
Nie. | |
| plik szkoleniowy | ciąg | Identyfikator przekazanego pliku zawierającego dane szkoleniowe. Zobacz przekazywanie pliku , aby dowiedzieć się, jak przekazać plik. Zestaw danych musi być sformatowany jako plik JSONL. Ponadto należy wgrać swój plik w celu fine-tune.Zawartość pliku powinna się różnić w zależności od tego, czy model używa formatu czatu, uzupełniania lub czy metoda dostrajania dokładnego używa formatu preferencji . Aby uzyskać więcej informacji, zobacz przewodnik dostosowywania . |
Yes | |
| plik walidacji | ciąg (dopuszczany do wartości null) | Identyfikator przekazanego pliku zawierającego dane walidacji. Jeśli podasz ten plik, dane są używane do generowania walidacji Metryki są oceniane okresowo podczas dostrajania. Metryki można wyświetlić w plik wyników fine-tuningu. Te same dane nie powinny być obecne zarówno w plikach trenowania, jak i walidacji. Zestaw danych musi być sformatowany jako plik JSONL. Musisz przekazać plik z celem fine-tune.Aby uzyskać więcej informacji, zobacz przewodnik dostosowywania . |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy zadań dostrajania podzielonego na strony
GET {endpoint}/openai/v1/fine_tuning/jobs?api-version=v1
Wymień zadania dostrajania swojej organizacji
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| Po | kwerenda | Nie. | ciąg | Identyfikator ostatniego zadania z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba zadań dostrajania do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ListPaginatedFineTuningJobsResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Pobieranie zadania dostrajania
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}?api-version=v1
Uzyskaj informacje o zadaniu dostrajania.
Dowiedz się więcej o dostrajaniu
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| identyfikator_zadania_dostrajania | ścieżka | Yes | ciąg | Identyfikator zadania dostrajania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Anulowanie zadania dostrajania
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel?api-version=v1
Natychmiast anuluj zadanie dostrajania.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| identyfikator_zadania_dostrajania | ścieżka | Yes | ciąg | Identyfikator zadania dostrajania do anulowania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy punktów kontrolnych zadań dostrajania
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints?api-version=v1
Wyświetlanie listy punktów kontrolnych dla zadania dostrajania.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| identyfikator_zadania_dostrajania | ścieżka | Yes | ciąg | Identyfikator zadania dostrajania w celu pobrania punktów kontrolnych. |
| Po | kwerenda | Nie. | ciąg | Identyfikator punktu kontrolnego z ostatniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba punktów kontrolnych do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ListFineTuningJobCheckpointsResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy zdarzeń zadania dostrajania
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/events?api-version=v1
Uzyskaj szczegółowe aktualizacje stanu dla zadania dostrajania.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| identyfikator_zadania_dostrajania | ścieżka | Yes | ciąg | Identyfikator zadania dostrajania w celu pobrania zdarzeń. |
| Po | kwerenda | Nie. | ciąg | Identyfikator ostatniego zdarzenia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba zdarzeń do pobrania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.ListFineTuningJobEventsResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wstrzymaj zadanie dostrajania
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/pause?api-version=v1
Wstrzymaj uruchomione zadanie dostrajania.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| identyfikator_zadania_dostrajania | ścieżka | Yes | ciąg | Identyfikator wstrzymywanego zadania dostrajania. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wznawianie zadania dostrajania
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/resume?api-version=v1
Wznów wstrzymane zadanie precyzyjnego dostrajania.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| identyfikator_zadania_dostrajania | ścieżka | Yes | ciąg | Identyfikator zadania finetuningu do wznowienia. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Responses
Tworzenie odpowiedzi — tworzenie strumienia odpowiedzi
POST {endpoint}/openai/v1/responses
Tworzy odpowiedź modelu. Tworzy odpowiedź modelu (odpowiedź strumieniowa).
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| konwersacja | OpenAI.ConversationParam (dopuszczana wartość null) | Konwersacja, do którego należy ta odpowiedź. Elementy z tej konwersacji są poprzedzane input_items dla tego żądania odpowiedzi.Elementy wejściowe i elementy wyjściowe z tej odpowiedzi są automatycznie dodawane do tej konwersacji po zakończeniu tej odpowiedzi. |
Nie. | |
| Obejmują | tablica openAI.IncludeEnum | Nie. | ||
| dane wejściowe | OpenAI.InputParam | Dane wejściowe tekstu, obrazu lub pliku w modelu używane do generowania odpowiedzi. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wejściowe obrazu - Dane wejściowe pliku - Stan konwersacji - Wywoływanie funkcji |
Nie. | |
| instructions | ciąg (dopuszczany do wartości null) | Nie. | ||
| max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| maks_liczba_wywołań_narzędzi | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| wywołania_narzędzia_równoległe | Wartość logiczna (dopuszczana do wartości null) | Nie. | True | |
| previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| monit | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| reasoning | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └─ wysiłek | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| └─ generuj_podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| └─ Podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| poziom usługi | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| przechowywać | Wartość logiczna (dopuszczana do wartości null) | Nie. | True | |
| odtwarzać strumieniowo | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| stream_options | OpenAI.ResponseStreamOptions (dopuszczana wartość null) | Opcje przesyłania strumieniowego odpowiedzi. Ustaw tę wartość tylko po ustawieniu stream: true. |
Nie. | |
| └include_obfuscation | boolean | W przypadku wartości true funkcja zaciemnienia strumienia zostanie włączona. Dodawanie zaciemniania strumienia losowe znaki do pola w przypadku zdarzeń różnicowych przesyłania strumieniowego obfuscation donormalizuj rozmiary ładunków jako środki zaradcze dla niektórych ataków kanału bocznego. Te pola zaciemniania są domyślnie uwzględniane, ale dodaj niewielką ilość narzut na strumień danych. Możesz ustawić wartość include_obfuscation nafalse, aby zoptymalizować przepustowość, jeśli ufasz łączem sieciowym między aplikacja i interfejs API openAI. |
Nie. | |
| structured_inputs | obiekt | Ustrukturyzowane dane wejściowe odpowiedzi, które mogą uczestniczyć w podstawieniu szablonu monitu lub powiązaniach argumentów narzędzia. | Nie. | |
| temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| SMS | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| tool_choice | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| truncation | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.Response | |
| text/event-stream | OpenAI.CreateResponseStreamingResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy odpowiedzi
GET {endpoint}/openai/v1/responses
Zwraca listę wszystkich odpowiedzi.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
| agent_name | kwerenda | Nie. | ciąg | Filtruj według nazwy agenta. Jeśli zostanie podana, zostaną zwrócone tylko elementy skojarzone z określonym agentem. |
| Agent_id | kwerenda | Nie. | ciąg | Filtruj według identyfikatora agenta w formacie name:version. Jeśli zostanie podana, zostaną zwrócone tylko elementy skojarzone z określonym identyfikatorem agenta. |
| conversation_id | kwerenda | Nie. | ciąg | Filtruj według identyfikatora konwersacji. Jeśli zostanie podana, zostaną zwrócone tylko odpowiedzi skojarzone z określoną konwersacją. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Kompaktowanie konwersacji odpowiedzi
POST {endpoint}/openai/v1/responses/compact
Tworzy kompaktowanie konwersacji odpowiedzi.
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | ciąg lub tablica elementu OpenAI.InputItem | Nie. | ||
| instructions | ciąg (dopuszczany do wartości null) | Nie. | ||
| model | OpenAI.ModelIdsCompaction | Identyfikator modelu używany do generowania odpowiedzi, na przykład gpt-5 lub o3. Platforma OpenAI oferuje szeroką gamę modeli z różnymi możliwościami, charakterystykami wydajności i punktami cenowymi. Zapoznaj się z przewodnikiem po modelu , aby przeglądać i porównywać dostępne modele. |
Yes | |
| previous_response_id | ciąg (dopuszczany do wartości null) | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.CompactResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Uzyskiwanie odpowiedzi — pobieranie strumienia odpowiedzi
GET {endpoint}/openai/v1/responses/{response_id}
Pobiera odpowiedź modelu z danym identyfikatorem. Pobiera odpowiedź modelu z danym identyfikatorem (odpowiedź strumieniowa).
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| response_id | ścieżka | Yes | ciąg | |
| include[] | kwerenda | Nie. | macierz | |
| odtwarzać strumieniowo | kwerenda | Nie. | boolean | |
| starting_after | kwerenda | Nie. | liczba całkowita |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| akceptuj | Nieprawda | ciąg Możliwe wartości: text/event-stream |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.Response | |
| text/event-stream | OpenAI.CreateResponseStreamingResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Usuń odpowiedź
DELETE {endpoint}/openai/v1/responses/{response_id}
Usuwa odpowiedź modelu.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| response_id | ścieżka | Yes | ciąg | Identyfikator odpowiedzi do usunięcia. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | DeleteResponseResult |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Anuluj odpowiedź
POST {endpoint}/openai/v1/responses/{response_id}/cancel
Anuluje odpowiedź modelu.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| response_id | ścieżka | Yes | ciąg | Identyfikator odpowiedzi na anulowanie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | OpenAI.Response |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Wyświetlanie listy elementów wejściowych
GET {endpoint}/openai/v1/responses/{response_id}/input_items
Zwraca listę elementów wejściowych dla danej odpowiedzi.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| response_id | ścieżka | Yes | ciąg | |
| limit | kwerenda | Nie. | liczba całkowita | Limit liczby zwracanych obiektów. Limit może mieścić się w zakresie od 1 do 100, a wartość domyślna to 20. |
| porządek | kwerenda | Nie. | ciąg Możliwe wartości: asc, desc |
Sortuj kolejność według znacznika created_at czasu obiektów.
asc dla kolejności rosnącej idescdla kolejności malejącej. |
| Po | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
after jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr after=obj_foo, co pozwoli pobrać następną stronę listy. |
| przed | kwerenda | Nie. | ciąg | Kursor do wykorzystania w stronicowaniu.
before jest identyfikatorem obiektu definiującym miejsce na liście.Jeśli na przykład utworzysz żądanie listy i otrzymasz 100 obiektów, kończąc na obj_foo, Kolejne wywołanie może zawierać parametr before=obj_foo, aby pobrać poprzednią stronę listy. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Redteams
Redteams - lista
GET {endpoint}/redTeams/runs?api-version=v1
Wyświetl listę redteam według nazwy.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: RedTeams=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedRedTeam |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Redteams – zdobądź
GET {endpoint}/redTeams/runs/{name}?api-version=v1
Uzyskaj czerwoną drużynę według nazwy.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Yes | ciąg | Identyfikator czerwonego przebiegu zespołu. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: RedTeams=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | RedTeam |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Redteams — tworzenie
POST {endpoint}/redTeams/runs:run?api-version=v1
Tworzy uruchomienie redteam.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: RedTeams=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| applicationScenario | ciąg | Scenariusz aplikacji dla czerwonej operacji zespołu w celu wygenerowania konkretnych ataków scenariusza. | Nie. | |
| attackStrategies | tablica strategii ataków | Lista strategii ataku lub zagnieżdżonych list strategii ataku. | Nie. | |
| displayName | ciąg | Nazwa uruchomienia czerwonego zespołu. | Nie. | |
| id | ciąg (tylko do odczytu) | Identyfikator czerwonego przebiegu zespołu. | Yes | |
| liczbawywracania | liczba całkowita | Liczba rund symulacji. | Nie. | |
| properties | obiekt | Właściwości zespołu czerwonego. W przeciwieństwie do tagów właściwości są tylko do dodawania. Po dodaniu nie można usunąć właściwości. | Nie. | |
| riskCategories | tablica kategorii ryzyka | Lista kategorii ryzyka do generowania celów ataku. | Nie. | |
| symulacjaOnly | boolean | Tylko symulacja lub Symulacja i ocena. Wartość domyślna false, jeśli wartość true skanowania generuje wynik konwersacji, która nie jest wynikiem oceny. | Nie. | Nieprawda |
| stan | ciąg (tylko do odczytu) | Stan czerwonego zespołu. Jest on ustawiany przez usługę i jest tylko do odczytu. | Nie. | |
| tags | obiekt | Tagi czerwonego zespołu. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| miejsce docelowe | TargetConfig | Klasa abstrakcyjna dla konfiguracji docelowej. | Yes | |
| └typ | ciąg | Typ konfiguracji modelu. | Yes |
Responses
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | RedTeam |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Rozkłady
Harmonogramy — lista
GET {endpoint}/schedules?api-version=v1
Wyświetl listę wszystkich harmonogramów.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ | kwerenda | Nie. | ciąg Możliwe wartości: Evaluation, Insight |
Filtruj według typu harmonogramu. |
| enabled | kwerenda | Nie. | boolean | Filtruj według stanu włączonego. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Schedules=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedSchedule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Harmonogramy — usuwanie
DELETE {endpoint}/schedules/{id}?api-version=v1
Usuń harmonogram.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Identyfikator harmonogramu. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Schedules=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 204
Opis: Nie ma zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Harmonogramy — pobierz
GET {endpoint}/schedules/{id}?api-version=v1
Pobierz harmonogram według identyfikatora.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Identyfikator harmonogramu. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Schedules=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Schedule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Harmonogramy — tworzenie lub aktualizowanie
PUT {endpoint}/schedules/{id}?api-version=v1
Tworzenie lub aktualizowanie szablonu operacji.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Identyfikator harmonogramu. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Schedules=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis harmonogramu. | Nie. | |
| displayName | ciąg | Nazwa harmonogramu. | Nie. | |
| enabled | boolean | Włączony stan harmonogramu. | Yes | |
| id | ciąg (tylko do odczytu) | Identyfikator harmonogramu. | Yes | |
| properties | obiekt | Właściwości harmonogramu. W przeciwieństwie do tagów właściwości są tylko do dodawania. Po dodaniu nie można usunąć właściwości. | Nie. | |
| provisioningStatus (stan aprowizacji) | ScheduleProvisioningStatus (tylko do odczytu) | Zaplanuj stan apryfikacji. | Nie. | |
| daneSystemowe | obiekt (tylko do odczytu) | Metadane systemu dla zasobu. | Yes | |
| tags | obiekt | Tagi harmonogramu. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| zadanie | ScheduleTask | Zaplanuj model zadań. | Yes | |
| Konfiguracja └* | obiekt | Konfiguracja zadania. | Nie. | |
| └typ | ScheduleTaskType | Typ zadania. | Yes | |
| wyzwalacz | Trigger | Model podstawowy dla wyzwalacza harmonogramu. | Yes | |
| └typ | Typ wyzwalacza | Typ wyzwalacza. | Yes |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Schedule |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Schedule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Harmonogramy — uruchomienia listy
GET {endpoint}/schedules/{id}/runs?api-version=v1
Wyświetl listę wszystkich przebiegów harmonogramu.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| id | ścieżka | Yes | ciąg | Identyfikator harmonogramu. |
| typ | kwerenda | Nie. | ciąg Możliwe wartości: Evaluation, Insight |
Filtruj według typu harmonogramu. |
| enabled | kwerenda | Nie. | boolean | Filtruj według stanu włączonego. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Schedules=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | PagedScheduleRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | Azure. Core.Foundations.ErrorResponse |
Nagłówki odpowiedzi:
| Nagłówka | Typ | Description |
|---|---|---|
| x-ms-error-code | ciąg | Kod błędu ciągu wskazujący, co poszło nie tak. |
Harmonogramy — pobieranie przebiegu
GET {endpoint}/schedules/{schedule_id}/runs/{run_id}?api-version=v1
Pobierz harmonogram przebiegu według identyfikatora.
Parametry identyfikatora URI
| Name | Cala | Obowiązkowy | Typ | Description |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Yes | ciąg | Punkt końcowy Project foundry w formularzu "https://{ai-services-account-name}.services.ai.azure.com/api/projects/{nazwa projektu}". Jeśli masz tylko jedną Project w usłudze Foundry Hub lub docelową domyślną Project w centrum użyj formularza "https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project" |
| Schedule_id | ścieżka | Yes | ciąg | Unikatowy identyfikator harmonogramu. |
| run_id | ścieżka | Yes | ciąg | Unikatowy identyfikator przebiegu harmonogramu. |
| wersja API | kwerenda | Yes | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Obowiązkowy | Typ | Description |
|---|---|---|---|
| Foundry-Features | True | ciąg Możliwe wartości: Schedules=V1Preview |
Flaga funkcji wymagana podczas korzystania z operacji w wersji zapoznawczej lub modyfikowania trwałych zasobów w wersji zapoznawczej. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ScheduleRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Type | Opis |
|---|---|---|
| application/json | ApiErrorResponse |
Components
A2APreviewTool
Agent implementujący protokół A2A.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_card_path | ciąg | Ścieżka do karty agenta względem .base_urlJeśli nie zostanie podany, wartość domyślna to /.well-known/agent-card.json |
Nie. | |
| base_url | ciąg | Podstawowy adres URL agenta. | Nie. | |
| project_connection_id | ciąg | Identyfikator połączenia w project dla serwera A2A. W połączeniu przechowywane są dane uwierzytelniające i inne szczegóły połączenia potrzebne do nawiązania połączenia z serwerem A2A. |
Nie. | |
| typ | wyliczenie | Typ narzędzia. Zawsze "a2a_preview.Możliwe wartości: a2a_preview |
Yes |
AISearchIndexResource
Zasób AI Search Index.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| filtr | ciąg | ciąg filtru dla zasobu wyszukiwania. Więcej informacji można znaleźć tutaj. | Nie. | |
| index_asset_id | ciąg | Identyfikator zasobu indeksu dla zasobu wyszukiwania. | Nie. | |
| nazwa_indeksu | ciąg | Nazwa indeksu w indeksieResource dołączonym do tego agenta. | Nie. | |
| project_connection_id | ciąg | Identyfikator połączenia indeksu w pliku IndexResource dołączony do tego agenta. | Nie. | |
| typ zapytania | AzureAISearchQueryType | Dostępne typy zapytań dla narzędzia Wyszukiwanie AI platformy Azure. | Nie. | |
| top_k | liczba całkowita | Liczba dokumentów do pobrania z wyszukiwania i prezentowania do modelu. | Nie. |
AgentClusterInsightRequest
Wgląd w zestaw wyników oceny agenta
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agentName | ciąg | Identyfikator agenta. | Yes | |
| modelKonfiguracja | InsightModelConfiguration | Konfiguracja modelu używanego w generowaniu wniosków. | Nie. | |
| └* modelDeploymentName | ciąg | Wdrożenie modelu do oceny. Akceptuje nazwę wdrożenia samodzielnie lub z nazwą połączenia jako {connectionName}/<modelDeploymentName>. |
Yes | |
| typ | wyliczenie | Typ żądania. Możliwe wartości: AgentClusterInsight |
Yes |
AgentClusterInsightResult
Szczegółowe informacje z analizy skupień agentów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| clusterInsight | ClusterInsightResult | Wnioski z analizy skupień. | Yes | |
| typ | wyliczenie | Typ wyniku szczegółowych informacji. Możliwe wartości: AgentClusterInsight |
Yes |
AgentContainerObject
Szczegóły kontenera określonej wersji agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kontener | ContainerDetails (tylko do odczytu) | Szczegółowe informacje o kontenerze. | Nie. | |
| └health_state | ciąg | Stan kondycji kontenera. | Yes | |
| └provisioning_error | ciąg | Błąd aprowizacji kontenera, jeśli istnieje. | Nie. | |
| └provisioning_state | ciąg | Stan aprowizacji kontenera. | Yes | |
| Repliki └* | tablica konteneraReplica | Lista replik w kontenerze. | Yes | |
| Stan └* | ciąg | Stan kontenera. | Yes | |
| └updated_on | ciąg | Czas ostatniej aktualizacji kontenera. | Yes | |
| utworzono_o | ciąg | Czas tworzenia kontenera. | Yes | |
| Error_message | ciąg (tylko do odczytu) | Komunikat o błędzie, jeśli kontener nie może działać, jeśli istnieje. | Nie. | |
| id | ciąg (tylko do odczytu) | Identyfikator kontenera. | Nie. | |
| max_replicas | liczba całkowita | Maksymalna liczba replik dla kontenera. Wartość domyślna to 1. | Nie. | |
| min_replicas | liczba całkowita | Minimalna liczba replik dla kontenera. Wartość domyślna to 1. | Nie. | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "agent.container". Możliwe wartości: agent.container |
Yes | |
| stan | AgentContainerStatus (tylko do odczytu) | Stan kontenera określonej wersji agenta. | Yes | |
| updated_at | ciąg | Czas ostatniej aktualizacji kontenera. | Yes |
AgentContainerOperationError
Szczegóły błędu operacji kontenera, jeśli istnieją.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg | Kod błędu operacji kontenera, jeśli istnieje. | Yes | |
| komunikat | ciąg | Komunikat o błędzie operacji kontenera, jeśli istnieje. | Yes | |
| typ | ciąg | Typ błędu operacji kontenera, jeśli istnieje. | Yes |
AgentContainerOperationObject
Operacja kontenera dla określonej wersji agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Agent_id | ciąg | Identyfikator agenta. | Yes | |
| agent_version_id | ciąg | Identyfikator wersji agenta. | Yes | |
| kontener | AgentContainerObject | Szczegóły kontenera określonej wersji agenta. | Nie. | |
| Kontener └* | ContainerDetails (tylko do odczytu) | Szczegółowe informacje o kontenerze. | Nie. | |
| └─ utworzono_o | ciąg (tylko do odczytu) | Czas tworzenia kontenera. | Yes | |
| └error_message | ciąg (tylko do odczytu) | Komunikat o błędzie, jeśli kontener nie może działać, jeśli istnieje. | Nie. | |
| └─ ID | ciąg (tylko do odczytu) | Identyfikator kontenera. | Nie. | |
| └max_replicas | liczba całkowita | Maksymalna liczba replik dla kontenera. Wartość domyślna to 1. | Nie. | |
| └min_replicas | liczba całkowita | Minimalna liczba replik dla kontenera. Wartość domyślna to 1. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu, który jest zawsze "agent.container". Możliwe wartości: agent.container |
Yes | |
| └─ Status | AgentContainerStatus (tylko do odczytu) | Stan kontenera określonej wersji agenta. | Yes | |
| └updated_at | ciąg (tylko do odczytu) | Czas ostatniej aktualizacji kontenera. | Yes | |
| błąd | AgentContainerOperationError | Szczegóły błędu operacji kontenera, jeśli istnieją. | Nie. | |
| └─ kod | ciąg | Kod błędu operacji kontenera, jeśli istnieje. | Yes | |
| └─ Komunikat | ciąg | Komunikat o błędzie operacji kontenera, jeśli istnieje. | Yes | |
| └typ | ciąg | Typ błędu operacji kontenera, jeśli istnieje. | Yes | |
| id | ciąg | Identyfikator operacji kontenera. Ten identyfikator jest unikatowym identyfikatorem w systemie. | Yes | |
| stan | AgentContainerOperationStatus | Stan operacji kontenera dla określonej wersji agenta. | Yes |
AgentContainerOperationStatus
Stan operacji kontenera dla określonej wersji agenta.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | NotStartedInProgressSucceededFailed |
AgentContainerStatus
Stan kontenera określonej wersji agenta.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | StartingRunningStoppingStoppedFailedDeletingDeletedUpdating |
AgentDefinition
Dyskryminujące dla agentaDefinition
Ten składnik używa właściwości kind do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
prompt |
PromptAgentDefinition |
workflow |
WorkflowAgentDefinition |
hosted |
HostedAgentDefinition |
container_app |
ContainerAppAgentDefinition |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rodzaj | AgentKind | Yes | ||
| rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| └rai_policy_name | ciąg | Nazwa zasad RAI do zastosowania. | Yes |
AgentKind
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | prompthostedcontainer_appworkflow |
AgentObject
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator agenta. | Yes | |
| nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 63 |
Yes | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "agentem". Możliwe wartości: agent |
Yes | |
| versions | obiekt | Najnowsza wersja agenta. | Yes | |
| └* najnowsze | AgentVersionObject | Yes |
AgentProtocol
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | activity_protocolresponses |
AgentReference
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| wersja | ciąg | Identyfikator wersji agenta. | Nie. |
AgentTaxonomyInput
Konfiguracja danych wejściowych dla taksonomii oceny, gdy typ danych wejściowych to agent.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| riskCategories | tablica kategorii ryzyka | Lista kategorii ryzyka do oceny. | Yes | |
| miejsce docelowe | Obiekt docelowy | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Yes | |
| └typ | ciąg | Typ obiektu docelowego. | Yes | |
| typ | wyliczenie | Typ danych wejściowych taksonomii oceny. Możliwe wartości: agent |
Yes |
AgentTaxonomyInputUpdate
Konfiguracja danych wejściowych dla taksonomii oceny, gdy typ danych wejściowych to agent.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| riskCategories | tablica kategorii ryzyka | Lista kategorii ryzyka do oceny. | Nie. | |
| miejsce docelowe | TargetUpdate | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Nie. | |
| └typ | ciąg | Typ obiektu docelowego. | Yes | |
| typ | wyliczenie | Typ danych wejściowych taksonomii oceny. Możliwe wartości: agent |
Yes |
AgentVersionObject
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) w momencie utworzenia agenta. | Yes | |
| definicja | AgentDefinition | Yes | ||
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| id | ciąg | Unikatowy identyfikator wersji agenta. | Yes | |
| metadane | object (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Yes | |
| nazwa | ciąg | Nazwa agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. Ograniczenia: maxLength: 256 |
Yes | |
| obiekt | wyliczenie | Typ obiektu, którym zawsze jest "agent.version". Możliwe wartości: agent.version |
Yes | |
| wersja | ciąg | Identyfikator wersji agenta. Agenci są niezmienni, a każda aktualizacja tworzy nową wersję, zachowując tę samą nazwę. | Yes |
AgenticIdentityPreviewCredentials
Definicja poświadczeń tożsamości agenta
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: AgenticIdentityToken_Preview |
Yes |
ApiErrorResponse
Odpowiedź na błąd w przypadku awarii interfejsu API.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | OpenAI.Error | Yes |
ApiKeyCredentials
Definicja poświadczeń klucza interfejsu API
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| klucz | ciąg (tylko do odczytu) | Klucz API | Nie. | |
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: ApiKey |
Yes |
AssetCredentialResponse
Reprezentuje odwołanie do obiektu blob do użycia
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| BlobReference | BlobReference | Szczegóły odwołania do obiektu blob. | Yes | |
| └* identyfikator blobUri | ciąg | Ścieżka identyfikatora URI obiektu blob dla klienta w celu przekazania danych. Przykład: https://blob.windows.core.net/Container/Path |
Yes | |
| Poświadczenie └* | SasCredential | Informacje o poświadczeniach umożliwiające uzyskanie dostępu do konta magazynu. | Yes | |
| └* storageAccountArmId | ciąg | Identyfikator arm konta magazynu do użycia. | Yes |
Identyfikator zasobu
Identyfikator zapisanego zasobu.
Typ: ciąg
AttackStrategy
Strategie ataków.
| Property | Value |
|---|---|
| Opis | Strategie ataków. |
| Type | ciąg |
| Wartości | easymoderatedifficultascii_artascii_smuggleratbashbase64binarycaesarcharacter_spacejailbreakansi_attackcharacter_swapsuffix_appendstring_joinunicode_confusableunicode_substitutiondiacriticflipleetspeakrot13morseurlbaselineindirect_jailbreaktensemulti_turncrescendo |
Azure. Core.Foundations.Error
Obiekt błędu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Yes | |
| details | tablica Azure. Core.Foundations.Error | Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu. | Nie. | |
| innererror | Azure. Core.Foundations.InnerError | Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors. | Nie. | |
| └─ kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Nie. | |
| └* wewnętrzny błąd | Azure. Core.Foundations.InnerError | Błąd wewnętrzny. | Nie. | |
| komunikat | ciąg | Czytelna dla człowieka reprezentacja błędu. | Yes | |
| miejsce docelowe | ciąg | Obiekt docelowy błędu. | Nie. |
Azure. Core.Foundations.ErrorResponse
Odpowiedź zawierająca szczegóły błędu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | Azure. Core.Foundations.Error | Obiekt błędu. | Yes | |
| └─ kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Yes | |
| └szczegóły | tablica Azure. Core.Foundations.Error | Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu. | Nie. | |
| └* wewnętrzny błąd | Azure. Core.Foundations.InnerError | Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie. | Nie. | |
| └─ Komunikat | ciąg | Czytelna dla człowieka reprezentacja błędu. | Yes | |
| └* docelowy | ciąg | Obiekt docelowy błędu. | Nie. |
Azure. Core.Foundations.InnerError
Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Nie. | |
| innererror | Azure. Core.Foundations.InnerError | Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors. | Nie. | |
| └─ kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Nie. | |
| └* wewnętrzny błąd | Azure. Core.Foundations.InnerError | Błąd wewnętrzny. | Nie. |
Azure. Core.Foundations.OperationState
Wyliczenie opisujące dozwolone stany operacji.
| Property | Value |
|---|---|
| Opis | Wyliczenie opisujące dozwolone stany operacji. |
| Type | ciąg |
| Wartości | NotStartedRunningSucceededFailedCanceled |
Azure. Core.uuid
Unikatowy identyfikator uniwersalny
Typ: ciąg
Format: uuid
AzureAIAgentTarget
Reprezentuje cel określający agenta Azure AI.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg | Unikatowy identyfikator agenta Azure AI. | Yes | |
| tool_descriptions | tablica elementu ToolDescription | Parametry używane do kontrolowania zachowania próbkowania agenta podczas generowania tekstu. | Nie. | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_agent.Możliwe wartości: azure_ai_agent |
Yes | |
| wersja | ciąg | Wersja agenta Azure AI. | Nie. |
AzureAIAgentTargetUpdate
Reprezentuje cel określający agenta Azure AI.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg | Unikatowy identyfikator agenta Azure AI. | Nie. | |
| tool_descriptions | tablica elementu ToolDescription | Parametry używane do kontrolowania zachowania próbkowania agenta podczas generowania tekstu. | Nie. | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_agent.Możliwe wartości: azure_ai_agent |
Yes | |
| wersja | ciąg | Wersja agenta Azure AI. | Nie. |
AzureAIDataSourceConfig
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| scenariusz | wyliczenie | Scenariusz schematu danych. Możliwe wartości: red_team, , responses, traces_previewsynthetic_data_gen_preview |
Yes | |
| schemat | obiekt | Ogólny schemat JSON obiektu dla elementów źródła danych uruchamiania. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze azure_ai_source.Możliwe wartości: azure_ai_source |
Yes |
AzureAIModelTarget
Reprezentuje cel określający model AI Azure dla operacji wymagających wyboru modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| model | ciąg | Unikatowy identyfikator modelu sztucznej inteligencji Azure. | Nie. | |
| parametry_próbowania | ModelSamplingParams | Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu. | Nie. | |
| └─ maksymalna_ilość_znaków_do_zakończenia | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Yes | |
| └─ nasion | liczba całkowita | Losowe inicjatory do odtworzenia. | Yes | |
| └* temperatura | number | Parametr temperatury do próbkowania. | Yes | |
| └─top_p | number | Parametr top-p próbkowania jądra. | Yes | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_model.Możliwe wartości: azure_ai_model |
Yes |
AzureAIModelTargetUpdate
Reprezentuje cel określający model AI Azure dla operacji wymagających wyboru modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| model | ciąg | Unikatowy identyfikator modelu sztucznej inteligencji Azure. | Nie. | |
| parametry_próbowania | ModelSamplingParamsUpdate | Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu. | Nie. | |
| └─ maksymalna_ilość_znaków_do_zakończenia | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Nie. | |
| └─ nasion | liczba całkowita | Losowe inicjatory do odtworzenia. | Nie. | |
| └* temperatura | number | Parametr temperatury do próbkowania. | Nie. | |
| └─top_p | number | Parametr top-p próbkowania jądra. | Nie. | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_model.Możliwe wartości: azure_ai_model |
Yes |
AzureAIResponsesEvalRunDataSource
Reprezentuje źródło danych dla przebiegów oceny, które są specyficzne dla scenariuszy ciągłej oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| event_configuration_id | ciąg | Nazwa konfiguracji zdarzenia skojarzona z tym przebiegiem oceny. | Yes | |
| item_generation_params | ResponseRetrievalItemGenerationParams | Reprezentuje parametry generowania elementu pobierania odpowiedzi. | Yes | |
| └data_mapping | obiekt | Mapowanie z pól źródłowych na pole response_id wymagane do pobierania historii czatu. | Yes | |
| └max_num_turns | liczba całkowita | Maksymalna liczba zakrętów historii czatów do oceny. | Yes | |
| └— źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource | Źródło, z którego jest odczytywana zawartość JSONL. | Yes | |
| └typ | wyliczenie | Typ parametrów generowania elementów, zawsze response_retrieval.Możliwe wartości: response_retrieval |
Yes | |
| max_runs_hourly | liczba całkowita | Maksymalna dozwolona liczba przebiegów oceny na godzinę. | Yes | |
| typ | wyliczenie | Typ źródła danych, zawsze azure_ai_responses.Możliwe wartości: azure_ai_responses |
Yes |
Indeks wyszukiwania Azure AI
definicja indeksu Wyszukiwanie AI platformy Azure
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | wyliczenie | Typ indeksu Możliwe wartości: AzureSearch |
Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
AzureAISearchIndexUpdate
definicja indeksu Wyszukiwanie AI platformy Azure
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | wyliczenie | Typ indeksu Możliwe wartości: AzureSearch |
Yes |
AzureAISearchQueryType
Dostępne typy zapytań dla narzędzia Wyszukiwanie AI platformy Azure.
| Property | Value |
|---|---|
| Opis | Dostępne typy zapytań dla narzędzia Wyszukiwanie AI platformy Azure. |
| Type | ciąg |
| Wartości | simplesemanticvectorvector_simple_hybridvector_semantic_hybrid |
AzureAISearchTool
Informacje o definicji wejściowych dla narzędzia wyszukiwania Azure AI, używane do konfiguracji agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| azure_ai_search | AzureAISearchToolResource | Zestaw zasobów indeksu używanych przez narzędzie azure_ai_search. |
Yes | |
| Indeksy └* | tablica AISearchIndexResource | Indeksy dołączone do tego agenta. Może istnieć maksymalnie 1 indeks zasób dołączony do agenta. Ograniczenia: maxItems: 1 |
Yes | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'azure_ai_search'. Możliwe wartości: azure_ai_search |
Yes |
AzureAISearchToolResource
Zestaw zasobów indeksu używanych przez narzędzie azure_ai_search.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Indeksy | tablica AISearchIndexResource | Indeksy dołączone do tego agenta. Może istnieć maksymalnie 1 indeks zasób dołączony do agenta. |
Yes |
AzureFunctionBinding
Struktura przechowywania storage nazwa kolejki i identyfikator URI.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| storage_queue | AzureFunctionStorageQueue | Struktura przechowywania storage nazwa kolejki i identyfikator URI. | Yes | |
| └queue_name | ciąg | Nazwa kolejki magazynu funkcji Azure. | Yes | |
| └queue_service_endpoint | ciąg | Identyfikator URI do usługi kolejki Azure Storage umożliwia manipulowanie kolejką. | Yes | |
| typ | wyliczenie | Typ powiązania, który jest zawsze "storage_queue". Możliwe wartości: storage_queue |
Yes |
AzureFunctionDefinition
Definicja funkcji Azure.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| funkcja | obiekt | Definicja funkcji platformy Azure i jej parametrów. | Yes | |
| Opis └* | ciąg | Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję. | Nie. | |
| └─ nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| Parametry | obiekt | Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. | Yes | |
| input_binding | AzureFunctionBinding | Struktura przechowywania storage nazwa kolejki i identyfikator URI. | Yes | |
| └storage_queue | AzureFunctionStorageQueue | Kolejka magazynu. | Yes | |
| └typ | wyliczenie | Typ powiązania, który jest zawsze "storage_queue". Możliwe wartości: storage_queue |
Yes | |
| output_binding | AzureFunctionBinding | Struktura przechowywania storage nazwa kolejki i identyfikator URI. | Yes | |
| └storage_queue | AzureFunctionStorageQueue | Kolejka magazynu. | Yes | |
| └typ | wyliczenie | Typ powiązania, który jest zawsze "storage_queue". Możliwe wartości: storage_queue |
Yes |
AzureFunctionStorageQueue
Struktura przechowywania storage nazwa kolejki i identyfikator URI.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| queue_name | ciąg | Nazwa kolejki magazynu funkcji Azure. | Yes | |
| queue_service_endpoint | ciąg | Identyfikator URI do usługi kolejki Azure Storage umożliwia manipulowanie kolejką. | Yes |
AzureFunctionTool
Informacje o definicji wejściowych dla narzędzia Azure Function Tool, używane do konfiguracji agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| azure_function | AzureFunctionDefinition | Definicja funkcji Azure. | Yes | |
| └* , funkcja | obiekt | Definicja funkcji platformy Azure i jej parametrów. | Yes | |
| Opis └* | ciąg | Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję. | Nie. | |
| └─ nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| Parametry | obiekt | Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. | Yes | |
| └input_binding | AzureFunctionBinding | Kolejka magazynu wejściowego. Wyzwalacz magazynu kolejek uruchamia funkcję w miarę dodawania do niej komunikatów. | Yes | |
| └output_binding | AzureFunctionBinding | Kolejka magazynu wyjściowego. Funkcja zapisuje dane wyjściowe w tej kolejce po przetworzeniu elementów wejściowych. | Yes | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest "browser_automation". Możliwe wartości: azure_function |
Yes |
AzureOpenAIModelConfiguration
Azure konfiguracji modelu OpenAI. Wersja interfejsu API zostanie wybrana przez usługę do wykonywania zapytań dotyczących modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| modelDeploymentName | ciąg | Nazwa wdrożenia modelu AOAI. Przykład: gpt-4o, jeśli w usłudze AIServices lub na podstawie connection_name/deployment_name połączenia (np. my-aoai-connection/gpt-4o). |
Yes | |
| typ | wyliczenie | Możliwe wartości: AzureOpenAIModel |
Yes |
BaseCredentials
Klasa bazowa dla poświadczeń połączenia
Dyskryminujące dla obiektów BaseCredential
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
ApiKey |
ApiKeyCredentials |
AAD |
EntraIDCredentials |
CustomKeys |
Customcredential |
SAS |
Sygnatury dostępu współdzielonego |
None |
NoAuthenticationCredentials |
AgenticIdentityToken_Preview |
AgenticIdentityPreviewCredentials |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | CredentialType (tylko do odczytu) | Typ poświadczeń używany przez połączenie | Yes |
BingCustomSearchConfiguration
Konfiguracja wyszukiwania niestandardowego bing.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| count | liczba całkowita | Liczba wyników wyszukiwania, które mają być zwracane w odpowiedzi interfejsu API Bing | Nie. | |
| freshness | ciąg | Filtruj wyniki wyszukiwania według określonego zakresu czasu. Zobacz akceptowane wartości tutaj. | Nie. | |
| instance_name | ciąg | Nazwa wystąpienia konfiguracji niestandardowej podane do konfiguracji. | Yes | |
| Rynku | ciąg | Rynek, z którego pochodzą wyniki. | Nie. | |
| project_connection_id | ciąg | Project identyfikator połączenia dla uziemienia za pomocą wyszukiwania bing | Yes | |
| set_lang | ciąg | Język używany do obsługi ciągów interfejsu użytkownika podczas wywoływania interfejsu API Bing. | Nie. |
BingCustomSearchPreviewTool
Informacje o definicji danych wejściowych dla narzędzia wyszukiwania niestandardowego Bing używane do konfigurowania agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| bing_custom_search_preview | BingCustomSearchToolParameters | Parametry niestandardowego narzędzia wyszukiwania bing. | Yes | |
| └search_configurations | tablica obiektów BingCustomSearchConfiguration | Połączenia project dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. Ograniczenia: maxItems: 1 |
Yes | |
| typ | wyliczenie | Typ obiektu, który zawsze jest "bing_custom_search_preview". Możliwe wartości: bing_custom_search_preview |
Yes |
BingCustomSearchToolParameters
Parametry niestandardowego narzędzia wyszukiwania bing.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| search_configurations | tablica obiektów BingCustomSearchConfiguration | Połączenia project dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Yes |
BingGroundingSearchConfiguration
Wyszukaj konfigurację Bing Grounding
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| count | liczba całkowita | Liczba wyników wyszukiwania, które mają być zwracane w odpowiedzi interfejsu API Bing | Nie. | |
| freshness | ciąg | Filtruj wyniki wyszukiwania według określonego zakresu czasu. Zobacz akceptowane wartości tutaj. | Nie. | |
| Rynku | ciąg | Rynek, z którego pochodzą wyniki. | Nie. | |
| project_connection_id | ciąg | Project identyfikator połączenia dla uziemienia za pomocą wyszukiwania bing | Yes | |
| set_lang | ciąg | Język używany do obsługi ciągów interfejsu użytkownika podczas wywoływania interfejsu API Bing. | Nie. |
BingGroundingSearchToolParameters
Parametry narzędzia wyszukiwania bing uziemienia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| search_configurations | tablica obiektów BingGroundingSearchConfiguration | Konfiguracje wyszukiwania dołączone do tego narzędzia. Może istnieć maksymalnie 1 zasób konfiguracji wyszukiwania dołączony do narzędzia. |
Yes |
BingGroundingTool
Informacje o definicji danych wejściowych dla narzędzia wyszukiwania uziemieniowego bing używane do konfigurowania agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| bing_grounding | BingGroundingSearchToolParameters | Parametry narzędzia wyszukiwania bing uziemienia. | Yes | |
| └search_configurations | tablica obiektów BingGroundingSearchConfiguration | Konfiguracje wyszukiwania dołączone do tego narzędzia. Może istnieć maksymalnie 1 zasób konfiguracji wyszukiwania dołączony do narzędzia. Ograniczenia: maxItems: 1 |
Yes | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'bing_grounding'. Możliwe wartości: bing_grounding |
Yes |
BlobReference
Szczegóły odwołania do obiektu blob.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Identyfikator blobUri | ciąg | Ścieżka identyfikatora URI obiektu blob dla klienta w celu przekazania danych. Przykład: https://blob.windows.core.net/Container/Path |
Yes | |
| poświadczenie | SasCredential | Definicja poświadczeń sygnatury dostępu współdzielonego | Yes | |
| └* sasUri | ciąg (tylko do odczytu) | Identyfikator URI sygnatury dostępu współdzielonego | Yes | |
| └typ | wyliczenie | Typ poświadczeń Możliwe wartości: SAS |
Yes | |
| storageAccountArmId | ciąg | Identyfikator arm konta magazynu do użycia. | Yes |
BrowserAutomationPreviewTool
Informacje o definicji danych wejściowych dla narzędzia Browser Automation Tool, które służy do konfigurowania agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| browser_automation_preview | BrowserAutomationToolParameters | Definicja parametrów wejściowych dla narzędzia Browser Automation Tool. | Yes | |
| Połączenie └* | BrowserAutomationToolConnectionParameters | Parametry połączenia projektu skojarzone z narzędziem automatyzacji przeglądarki. | Yes | |
| typ | wyliczenie | Typ obiektu, który zawsze jest "browser_automation_preview". Możliwe wartości: browser_automation_preview |
Yes |
BrowserAutomationToolConnectionParameters
Definicja parametrów wejściowych dla połączenia używanego przez narzędzie Browser Automation Tool.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| project_connection_id | ciąg | Identyfikator połączenia projektu z zasobem Azure Playwright. | Yes |
BrowserAutomationToolParameters
Definicja parametrów wejściowych dla narzędzia Browser Automation Tool.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| połączenie | BrowserAutomationToolConnectionParameters | Definicja parametrów wejściowych dla połączenia używanego przez narzędzie Browser Automation Tool. | Yes | |
| └project_connection_id | ciąg | Identyfikator połączenia projektu z zasobem Azure Playwright. | Yes |
CaptureStructuredOutputsTool
Narzędzie do przechwytywania ustrukturyzowanych danych wyjściowych
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| outputs | StructuredOutputDefinition | Ustrukturyzowane dane wyjściowe, które mogą być generowane przez agenta. | Yes | |
| Opis └* | ciąg | Opis danych wyjściowych do emisji. Używany przez model do określania, kiedy emitować dane wyjściowe. | Yes | |
| └─ nazwa | ciąg | Nazwa danych wyjściowych ze strukturą. | Yes | |
| Schemat └* | obiekt | Schemat JSON dla danych wyjściowych ze strukturą. | Yes | |
| └* ścisłe | Wartość logiczna (dopuszczana do wartości null) | Czy wymuszać ścisłą walidację. Wartość domyślna true. |
Yes | |
| typ | wyliczenie | Typ narzędzia. Zawsze capture_structured_outputs.Możliwe wartości: capture_structured_outputs |
Yes |
Wykres współrzędny
Współrzędne wykresu analizy.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| size | liczba całkowita | Rozmiar elementu wykresu. | Yes | |
| x | liczba całkowita | Współrzędna osi X. | Yes | |
| y | liczba całkowita | Współrzędna osi Y. | Yes |
ChatSummaryMemoryItem
Element pamięci zawierający podsumowanie wyodrębnione z konwersacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | ciąg | Zawartość pamięci. | Yes | |
| rodzaj | wyliczenie | Rodzaj elementu pamięci. Możliwe wartości: chat_summary |
Yes | |
| memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Yes | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes | |
| updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Yes |
ClusterInsightResult
Wnioski z analizy skupień.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| clusters | tablica tablicy insightCluster | Lista klastrów zidentyfikowanych w szczegółowych danych. | Yes | |
| współrzędne | obiekt | Opcjonalne mapowanie identyfikatorów na współrzędne 2D używane przez interfejs użytkownika do wizualizacji. Klucze mapy są identyfikatorami ciągów (na przykład identyfikatorem klastra lub przykładowym identyfikatorem) wartości to współrzędne i rozmiar wizualizacji renderowania na wykresie 2D. Ta właściwość zostanie pominięta, chyba że klient żąda współrzędnych (na przykład przekazując includeCoordinates=true jako parametr zapytania).Przykład: <br> {<br> "cluster-1": { "x": 12, "y": 34, "size": 8 },<br> "sample-123": { "x": 18, "y": 22, "size": 4 }<br> }<br> Współrzędne są przeznaczone tylko dla wizualizacji po stronie klienta i nie zmodyfikuj wyniki szczegółowych informacji kanonicznych. |
Nie. | |
| podsumowanie | InsightSummary | Podsumowanie analizy skupień błędów. | Yes | |
| └* metoda | ciąg | Metoda używana do klastrowania. | Yes | |
| └* sampleCount | liczba całkowita | Łączna liczba analizowanych próbek. | Yes | |
| └* uniqueClusterCount | liczba całkowita | Łączna liczba unikatowych klastrów. | Yes | |
| └(*) uniqueSubclusterCount | liczba całkowita | Całkowita liczba unikatowych etykiet podklasy. | Yes | |
| └─ użycie | ClusterTokenUsage | Użycie tokenu podczas przeprowadzania analizy klastrowania | Yes |
ClusterTokenUsage
Użycie tokenu do analizy skupień
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| inputTokenUsage | liczba całkowita | użycie tokenu wejściowego | Yes | |
| outputTokenUsage | liczba całkowita | użycie tokenu wyjściowego | Yes | |
| totalTokenUsage | liczba całkowita | łączne użycie tokenu | Yes |
CodeBasedEvaluatorDefinition
Definicja ewaluatora opartego na kodzie przy użyciu kodu w języku Python
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| code_text | ciąg | Wbudowany tekst kodu dla ewaluatora | Yes | |
| data_schema | obiekt | Schemat JSON (wersja robocza 2020-12) dla danych wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| init_parameters | obiekt | Schemat JSON (wersja robocza 2020-12) dla parametrów wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| metryki | obiekt | Lista wskaźników wyjściowych opracowanych przez tego ewaluatora | Nie. | |
| typ | wyliczenie | Możliwe wartości: code |
Yes |
CompletionMessageToolCallChunk
Szczegóły wywołania narzędzia w wiadomości.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| funkcja | FunctionToolCall | Szczegóły wywołania narzędzia funkcji. | Nie. | |
| └─ Argumenty | ciąg | Argumenty do wywołania funkcji za pomocą , wygenerowane przez model w formacie JSON. | Yes | |
| └─ nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| id | ciąg | Identyfikator wywołania narzędzia. | Yes | |
| typ | wyliczenie | Typ wywołania narzędzia, który jest zawsze "funkcją". Możliwe wartości: function |
Yes |
Połączenie
Operacje odpowiedzi z listy i pobierania połączeń
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane logowania | BaseCredentials (tylko do odczytu) | Klasa bazowa dla poświadczeń połączenia | Yes | |
| └typ | CredentialType (tylko do odczytu) | Typ poświadczeń używany przez połączenie | Yes | |
| id | ciąg (tylko do odczytu) | Unikatowy identyfikator połączenia wygenerowany przez usługę | Yes | |
| isDefault | Wartość logiczna (tylko do odczytu) | Czy połączenie jest oznaczone jako domyślne połączenie typu | Yes | |
| metadane | obiekt (tylko do odczytu) | Metadane połączenia | Yes | |
| nazwa | ciąg (tylko do odczytu) | Przyjazna nazwa połączenia podana przez użytkownika. | Yes | |
| miejsce docelowe | ciąg (tylko do odczytu) | Adres URL połączenia, który ma być używany dla tej usługi | Yes | |
| typ | ConnectionType (tylko do odczytu) | Typ (lub kategoria) połączenia | Yes |
ConnectionType
Typ (lub kategoria) połączenia
| Property | Value |
|---|---|
| Opis | Typ (lub kategoria) połączenia |
| Type | ciąg |
| Wartości | AzureOpenAIAzureBlobAzureStorageAccountCognitiveSearchCosmosDBApiKeyAppConfigAppInsightsCustomKeysRemoteTool_Preview |
ContainerAppAgentDefinition
Definicja agenta aplikacji kontenera.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| container_app_resource_id | ciąg | Identyfikator zasobu aplikacji kontenera Azure hostujący tego agenta. Nie można modyfikować między wersjami. | Yes | |
| container_protocol_versions | tablica wartości ProtocolVersionRecord | Protokoły obsługiwane przez agenta na potrzeby komunikacji przychodzącej kontenerów. | Yes | |
| ingress_subdomain_suffix | ciąg | Sufiks do zastosowania do poddomeny aplikacji podczas wysyłania ruchu przychodzącego do agenta. Może to być etykieta (np. "---current"), określona poprawka (np. "--0000001") lub pusta, aby użyć domyślnego punktu końcowego dla aplikacji kontenera. | Yes | |
| rodzaj | wyliczenie | Możliwe wartości: container_app |
Yes | |
| rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| └rai_policy_name | ciąg | Nazwa zasad RAI do zastosowania. | Yes |
ContainerDetails
Szczegółowe informacje o kontenerze.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| health_state | ciąg | Stan kondycji kontenera. | Yes | |
| provisioning_error | ciąg | Błąd aprowizacji kontenera, jeśli istnieje. | Nie. | |
| provisioning_state | ciąg | Stan aprowizacji kontenera. | Yes | |
| replicas | tablica konteneraReplica | Lista replik w kontenerze. | Yes | |
| stan | ciąg | Stan kontenera. | Yes | |
| updated_on | ciąg | Czas ostatniej aktualizacji kontenera. | Yes |
ContainerLogKind
Typ dzienników do przesyłania strumieniowego z kontenera.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | consolesystem |
ContainerReplica
Informacje o repliki kontenera.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| container_state | ciąg | Stan kontenera repliki. | Yes | |
| nazwa | ciąg | Nazwa repliki. | Yes | |
| stan | ciąg | Stan repliki. | Yes |
ContinuousEvaluationRuleAction
Akcja reguły oceny dla ciągłej oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| evalId | ciąg | Identyfikator oceny w celu dodania przebiegów oceny ciągłej do. | Yes | |
| maxHourlyRuns | liczba całkowita | Maksymalna dozwolona liczba przebiegów oceny na godzinę. | Nie. | |
| typ | wyliczenie | Możliwe wartości: continuousEvaluation |
Yes |
Indeks CosmosDB
Definicja indeksu magazynu wektorów usługi CosmosDB
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | wyliczenie | Typ indeksu Możliwe wartości: CosmosDBNoSqlVectorStore |
Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
CosmosDBIndexUpdate
Definicja indeksu magazynu wektorów usługi CosmosDB
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | wyliczenie | Typ indeksu Możliwe wartości: CosmosDBNoSqlVectorStore |
Yes |
CreateAgentFromManifestRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Yes | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Unikatowa nazwa identyfikująca agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. - Musi rozpoczynać się i kończyć znakiem alfanumerycznym, - Może zawierać łączniki w środku - Nie może przekraczać 63 znaków. Ograniczenia: maxLength: 63 |
Yes | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Yes |
CreateAgentRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | AgentDefinition | Yes | ||
| Rodzaj └* | AgentKind | Yes | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Unikatowa nazwa identyfikująca agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. - Musi rozpoczynać się i kończyć znakiem alfanumerycznym, - Może zawierać łączniki w środku - Nie może przekraczać 63 znaków. Ograniczenia: maxLength: 63 |
Yes |
CreateAgentVersionFromManifestRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Yes | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Yes |
CreateAgentVersionRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | AgentDefinition | Yes | ||
| Rodzaj └* | AgentKind | Yes | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. |
UtwórzŻądanieOceny
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| konfiguracja źródła danych | OpenAI.CreateEvalCustomDataSourceConfig lub OpenAI.CreateEvalLogsDataSourceConfig lub OpenAI.CreateEvalStoredCompletionsDataSourceConfig lub AzureAIDataSourceConfig | Konfiguracja źródła danych używanego do uruchamiania oceny. Określa schemat danych używanych w ocenie. | Yes | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Nazwa oceny. | Nie. | |
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. | |
| kryteria_testowe | tablica elementów OpenAI.EvalGraderLabelModel lub OpenAI.EvalGraderStringCheck lub OpenAI.EvalGraderTextSimilarity lub OpenAI.EvalGraderPython lub OpenAI.EvalGraderScoreModel lub EvalGraderAzureAIEvaluator | Lista osób oceniających dla wszystkich przebiegów oceny w tej grupie. Klasyfikatory mogą odwoływać się do zmiennych w źródle danych przy użyciu notacji podwójnych nawiasów klamrowych, takich jak {{item.variable_name}}. Aby odwołać się do danych wyjściowych modelu, użyj sample przestrzeni nazw (tj. {{sample.output_text}}). |
Yes |
CreateEvalRunRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| źródło danych | OpenAI.CreateEvalJsonlRunDataSource lub OpenAI.CreateEvalCompletionsRunDataSource lub OpenAI.CreateEvalResponsesRunDataSource lub EvalRunDataSource | Szczegółowe informacje o źródle danych przebiegu. | Yes | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Nazwa przebiegu. | Nie. | |
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. |
Typ poświadczeń
Typ poświadczeń używany przez połączenie
| Property | Value |
|---|---|
| Opis | Typ poświadczeń używany przez połączenie |
| Type | ciąg |
| Wartości | ApiKeyAADSASCustomKeysNoneAgenticIdentityToken_Preview |
CronTrigger
Wyzwalacz oparty na Cronie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| endTime | ciąg | Czas zakończenia harmonogramu cron w formacie ISO 8601. | Nie. | |
| wyrażenie | ciąg | Wyrażenie Crona, które definiuje częstotliwość harmonogramu. | Yes | |
| startTime | ciąg | Godzina rozpoczęcia harmonogramu cron w formacie ISO 8601. | Nie. | |
| timeZone | ciąg | Strefa czasowa dla harmonogramu cron. | Nie. | UTC |
| typ | wyliczenie | Możliwe wartości: Cron |
Yes |
Customcredential
Niestandardowa definicja poświadczeń
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: CustomKeys |
Yes |
Ten obiekt akceptuje również dodatkowe właściwości typu: string
DailyRecurrenceSchedule
Harmonogram codziennych cykli.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| hours | tablica liczb całkowitych | Godziny harmonogramu cyklu. | Yes | |
| typ | wyliczenie | Typ cyklu dziennego. Możliwe wartości: Daily |
Yes |
DataSourceConfig
Klasa podstawowa do uruchamiania źródeł danych z obsługą dyskryminującą.
Dyskryminujące dla elementu DataSourceConfig
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| schemat | obiekt | Ogólny schemat JSON obiektu dla elementów źródła danych uruchamiania. | Yes | |
| typ | ciąg | Dyskryminujący typ źródła danych. | Yes |
Typ zestawu danych
Wyliczenie w celu określenia typu danych.
| Property | Value |
|---|---|
| Opis | Wyliczenie w celu określenia typu danych. |
| Type | ciąg |
| Wartości | uri_fileuri_folder |
DatasetVersion
Definicja wersji zestawu danych DatasetVersion
Dyskryminujący dla elementu DatasetVersion
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
uri_file |
FileDatasetVersion |
uri_folder |
FolderDatasetVersion |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Connectionname | ciąg | Nazwa połączenia konta Azure Storage. Wymagane, jeśli parametr startPendingUploadVersion nie został wywołany przed utworzeniem zestawu danych | Nie. | |
| dataUri | ciąg | Identyfikator URI danych (przykład) Ograniczenia: minLength: 1, wzorzec: [a-zA-Z0-9_] |
Yes | |
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| Isreference | Wartość logiczna (tylko do odczytu) | Wskazuje, czy zestaw danych zawiera odwołanie do magazynu, czy zestaw danych zarządza samym magazynem. Jeśli to prawda, dane bazowe nie zostaną usunięte po usunięciu wersji zestawu danych | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | Typ zestawu danych | Wyliczenie w celu określenia typu danych. | Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
DatasetVersionUpdate
Definicja wersji zestawu danych DatasetVersion
Dyskryminujące dla elementu DatasetVersionUpdate
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
uri_file |
FileDatasetVersionUpdate |
uri_folder |
FolderDatasetVersionUpdate |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | Typ zestawu danych | Wyliczenie w celu określenia typu danych. | Yes |
DzieńTygodnia
Dni tygodnia dla harmonogramu cyklu.
| Property | Value |
|---|---|
| Opis | Dni tygodnia dla harmonogramu cyklu. |
| Type | ciąg |
| Wartości | SundayMondayTuesdayWednesdayThursdayFridaySaturday |
DeleteAgentResponse
Usunięty obiekt agenta
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Czy agent został pomyślnie usunięty. | Yes | |
| nazwa | ciąg | Nazwa agenta. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "agent.deleted". Możliwe wartości: agent.deleted |
Yes |
DeleteAgentVersionResponse
Usunięta wersja agenta Object
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Czy agent został pomyślnie usunięty. | Yes | |
| nazwa | ciąg | Nazwa agenta. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "agent.version.deleted". Możliwe wartości: agent.version.deleted |
Yes | |
| wersja | ciąg | Identyfikator wersji agenta. | Yes |
DeleteEvalResponse
Usunięty obiekt oceny
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Czy eval został pomyślnie usunięty. | Yes | |
| eval_id | ciąg | identyfikator ewalu. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.deleted". Możliwe wartości: eval.deleted |
Yes |
DeleteEvalRunResponse
Usunięty obiekt przebiegu oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Czy eval został pomyślnie usunięty. | Nie. | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.deleted". Możliwe wartości: eval.deleted |
Nie. | |
| run_id | ciąg | identyfikator ewalu. | Nie. |
DeleteMemoryStoreResponse
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Czy magazyn pamięci został pomyślnie usunięty. | Yes | |
| nazwa | ciąg | Nazwa magazynu pamięci. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "memory_store.deleted". Możliwe wartości: memory_store.deleted |
Yes |
DeleteResponseResult
Wynik operacji usuwania odpowiedzi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | wyliczenie | Zawsze zwracaj wartość true Możliwe wartości: True |
Yes | |
| id | ciąg | Identyfikator operacji. | Yes | |
| obiekt | wyliczenie | Zawsze zwracaj wartość "response". Możliwe wartości: response |
Yes |
Deployment
Definicja wdrożenia modelu
Dyskryminujące wdrożenie
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
ModelDeployment |
ModelDeployment |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg (tylko do odczytu) | Nazwa wdrożenia | Yes | |
| typ | Deploymenttype | Yes |
Deploymenttype
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | ModelDeployment |
EntraIDCredentials
Definicja poświadczenia Entra ID
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: AAD |
Yes |
Ewaluacja
Obiekt Eval z konfiguracją źródła danych i kryteriami testowania. Eval reprezentuje zadanie, które należy wykonać na potrzeby Twojej integracji z LLM. Lubię to:
- Poprawianie jakości mojego czatbota
- Zobacz, jak dobrze mój czatbot obsługuje obsługę klienta
- Sprawdź, czy o4-mini jest lepiej w moim przypadku użycia niż gpt-4o
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) wskazująca moment utworzenia oceny. | Yes | |
| utworzone_przez | ciąg | imię i nazwisko osoby, która utworzyła przebieg. | Nie. | |
| konfiguracja źródła danych | OpenAI.CreateEvalCustomDataSourceConfig lub OpenAI.CreateEvalLogsDataSourceConfig lub OpenAI.CreateEvalStoredCompletionsDataSourceConfig lub AzureAIDataSourceConfig | Konfiguracja źródeł danych używanych w przebiegach oceny. | Yes | |
| id | ciąg | Unikatowy identyfikator oceny. | Yes | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Yes | |
| modified_at | liczba całkowita | Nie. | ||
| nazwa | ciąg | Nazwa oceny. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Możliwe wartości: eval |
Yes | |
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. | |
| kryteria_testowe | tablica elementów OpenAI.EvalGraderLabelModel lub OpenAI.EvalGraderStringCheck lub OpenAI.EvalGraderTextSimilarity lub OpenAI.EvalGraderPython lub OpenAI.EvalGraderScoreModel lub EvalGraderAzureAIEvaluator | Lista kryteriów testowania. | Yes |
EvalCsvFileIdSource
Reprezentuje odwołanie do przekazanego pliku CSV używanego jako źródło danych ewaluacyjnych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Identyfikator przekazanego pliku CSV. | Yes | |
| typ | wyliczenie | Typ źródła, zawsze file_id.Możliwe wartości: file_id |
Yes |
EvalCsvRunDataSource
Reprezentuje źródło danych CSV na potrzeby przebiegów oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| przesłać źródło | EvalCsvFileIdSource | Reprezentuje odwołanie do przekazanego pliku CSV używanego jako źródło danych ewaluacyjnych. | Yes | |
| └─ ID | ciąg | Identyfikator przekazanego pliku CSV. | Yes | |
| └typ | wyliczenie | Typ źródła, zawsze file_id.Możliwe wartości: file_id |
Yes | |
| typ | wyliczenie | Typ źródła danych, zawsze csv.Możliwe wartości: csv |
Yes |
EvalGraderAzureAIEvaluator
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| mapowanie danych | obiekt | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Nie. | |
| evaluator_name | ciąg | Nazwa ewaluatora. | Yes | |
| evaluator_version | ciąg | Wersja ewaluatora. Najnowsza wersja, jeśli nie zostanie określona. | Nie. | |
| initialization_parameters | obiekt | Parametry inicjowania oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze azure_ai_evaluator.Możliwe wartości: azure_ai_evaluator |
Yes |
EvalResult
Wynik oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg | nazwa sprawdzania | Yes | |
| Przekazywane | boolean | wskazuje, czy sprawdzanie zakończyło się powodzeniem lub niepowodzeniem | Yes | |
| wynik | number | wynik | Yes | |
| typ | ciąg | typ sprawdzania | Yes |
EvalRun
Schemat reprezentujący przebieg oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) podczas tworzenia przebiegu oceny. | Yes | |
| utworzone_przez | ciąg | imię i nazwisko osoby, która utworzyła przebieg. | Nie. | |
| źródło danych | OpenAI.CreateEvalJsonlRunDataSource lub OpenAI.CreateEvalCompletionsRunDataSource lub OpenAI.CreateEvalResponsesRunDataSource lub EvalRunDataSource | Informacje o źródle danych przebiegu. | Yes | |
| błąd | OpenAI.EvalApiError | Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval. | Yes | |
| eval_id | ciąg | Identyfikator skojarzonej oceny. | Yes | |
| id | ciąg | Unikatowy identyfikator przebiegu oceny. | Yes | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Yes | |
| model | ciąg | Model, który jest oceniany, jeśli ma zastosowanie. | Yes | |
| modified_at | liczba całkowita | Nie. | ||
| nazwa | ciąg | Nazwa przebiegu oceny. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.run". Możliwe wartości: eval.run |
Yes | |
| użycie na model | tablica elementów OpenAI.EvalRunPerModelUsage | Statystyki użycia dla każdego modelu podczas przebiegu oceny. | Yes | |
| wyniki_wg_kryteriów_testowych | tablica obiektów OpenAI.EvalRunPerTestingCriteriaResults | Wyniki na kryteria testowania stosowane podczas przebiegu oceny. | Yes | |
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. | |
| report_url | ciąg | Adres URL wyświetlonego raportu przebiegu oceny na pulpicie interfejsu użytkownika. | Yes | |
| wyniki_liczby | OpenAI.EvalRunResultCounts | Yes | ||
| └─ Wystąpił błąd | OpenAI.integer | Yes | ||
| └* nie powiodło się | OpenAI.integer | Yes | ||
| └* zaliczone | OpenAI.integer | Yes | ||
| └─ suma | OpenAI.integer | Yes | ||
| stan | ciąg | Stan przebiegu oceny. | Yes |
EvalRunDataSource
Klasa podstawowa do uruchamiania źródeł danych z obsługą dyskryminującą.
Dyskryminujące dla elementu EvalRunDataSource
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
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 |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | ciąg | Dyskryminujący typ źródła danych. | Yes |
EvalRunOutputItem
Schemat reprezentujący element wyjściowy przebiegu oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) podczas tworzenia przebiegu oceny. | Yes | |
| element źródła danych | obiekt | Szczegóły elementu wejściowego źródła danych. | Yes | |
| "identyfikator_elementu_źródła_danych (datasource_item_id)" | OpenAI.integer | Yes | ||
| eval_id | ciąg | Identyfikator grupy ewaluacyjnej. | Yes | |
| id | ciąg | Unikatowy identyfikator elementu wyjściowego procesu oceny. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.run.output_item". Możliwe wartości: eval.run.output_item |
Yes | |
| results | tablica EvalRunOutputItemResult | Lista wyników klasyzatora dla tego elementu wyjściowego. | Yes | |
| run_id | ciąg | Identyfikator przebiegu oceny skojarzonego z tym elementem wyjściowym. | Yes | |
| próbka | OpenAI.EvalRunOutputItemSample | Yes | ||
| └─ błąd | OpenAI.EvalApiError | Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval. | Yes | |
| └ finish_reason | ciąg | Yes | ||
| └─ Wejście | tablica EvalRunOutputItemSampleInput | Yes | ||
| └─ maksymalna_ilość_znaków_do_zakończenia | OpenAI.integer | Yes | ||
| └─ Model | ciąg | Yes | ||
| └─ Dane wyjściowe | tablica EvalRunOutputItemSampleOutput | Yes | ||
| └─ nasion | OpenAI.integer | Yes | ||
| └* temperatura | OpenAI.numeric | Yes | ||
| └─top_p | OpenAI.numeric | Yes | ||
| └─ użycie | OpenAI.EvalRunOutputItemSampleUsage | Yes | ||
| stan | ciąg | Stan przebiegu oceny. | Yes |
EvalRunOutputItemResult
Pojedynczy wynik klasykatora dla elementu wyjściowego przebiegu oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| etykieta | ciąg | Etykieta skojarzona z metryką kryteriów testu (np. "pass", "fail", "good", "bad"). | Nie. | |
| metryka | ciąg | Nazwa metryki (np. "fluency", "f1_score"). | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| Przekazywane | boolean | Czy klasyk uznał dane wyjściowe za przekazywanie. | Yes | |
| properties | obiekt | Dodatkowe szczegóły dotyczące metryki kryteriów testu. | Nie. | |
| powód | ciąg | Przyczyna metryki kryteriów testu. | Nie. | |
| próbka | object (dopuszczana wartość null) | Opcjonalne próbki lub dane pośrednie generowane przez klasykator. | Nie. | |
| wynik | OpenAI.numeric | Yes | ||
| próg | number | Próg używany do określania przebiegu/niepowodzenia dla tych kryteriów testu, jeśli jest to wartość liczbowa. | Nie. | |
| typ | ciąg | Typ klasyra (na przykład "string-check-grader"). | Nie. |
Ten obiekt akceptuje również dodatkowe właściwości.
EvalRunOutputItemSampleInput
Komunikat w przebiegu oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | ciąg | Yes | ||
| rola | ciąg | Yes | ||
| tool_calls | tablica elementu CompletionMessageToolCallChunk | Wywołania narzędzi wykonane w wiadomości, jeśli istnieją. | Yes |
EvalRunOutputItemSampleOutput
Komunikat w przebiegu oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | ciąg | Nie. | ||
| rola | ciąg | Nie. | ||
| tool_calls | tablica elementu CompletionMessageToolCallChunk | Wywołania narzędzi wykonane w wiadomości, jeśli istnieją. | Yes |
EvalRunResultCompareItem
Porównanie wskaźników leczenia w stosunku do wartości wyjściowej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| deltaEstimate | number | Szacowana różnica między leczeniem a punktem odniesienia. | Yes | |
| pValue | number | Wartość P dla efektu leczenia. | Yes | |
| leczenieEffect | TreatmentEffectType | Rodzaj efektu zabiegu. | Yes | |
| leczenieRunId | ciąg | Identyfikator przebiegu leczenia. | Yes | |
| leczenieRunSummary | EvalRunResultSummary | Statystyki podsumowujące metrykę w przebiegu oceny. | Yes | |
| └* średnia | number | Średnia wartość metryki w przebiegu oceny. | Yes | |
| └* runId | ciąg | Identyfikator przebiegu oceny. | Yes | |
| └* sampleCount | liczba całkowita | Liczba próbek w przebiegu oceny. | Yes | |
| └* standardowaDeviation | number | Odchylenie standardowe metryki w przebiegu oceny. | Yes |
EvalRunResultComparison
Wyniki porównania dla leczenia są sprzeczne z wartością wyjściową.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| baselineRunSummary | EvalRunResultSummary | Statystyki podsumowujące metrykę w przebiegu oceny. | Yes | |
| └* średnia | number | Średnia wartość metryki w przebiegu oceny. | Yes | |
| └* runId | ciąg | Identyfikator przebiegu oceny. | Yes | |
| └* sampleCount | liczba całkowita | Liczba próbek w przebiegu oceny. | Yes | |
| └* standardowaDeviation | number | Odchylenie standardowe metryki w przebiegu oceny. | Yes | |
| compareItems | tablica EvalRunResultCompareItem | Lista wyników porównania dla każdego przebiegu leczenia. | Yes | |
| Oceniającego | ciąg | Nazwa ewaluatora dla tych kryteriów testowania. | Yes | |
| metryka | ciąg | Obliczana metryka. | Yes | |
| testingCriteria | ciąg | Nazwa kryteriów testowania. | Yes |
EvalRunResultSummary
Statystyki podsumowujące metrykę w przebiegu oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| średnia | number | Średnia wartość metryki w przebiegu oceny. | Yes | |
| identyfikator uruchomienia | ciąg | Identyfikator przebiegu oceny. | Yes | |
| sampleCount | liczba całkowita | Liczba próbek w przebiegu oceny. | Yes | |
| StandardowaDeviation | number | Odchylenie standardowe metryki w przebiegu oceny. | Yes |
EvaluationComparisonInsightRequest
Prośba o porównanie oceny
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| baselineRunId | ciąg | Identyfikator przebiegu punktu odniesienia dla porównania. | Yes | |
| evalId | ciąg | Identyfikator oceny. | Yes | |
| leczenieRunIds | tablica ciągów | Lista identyfikatorów przebiegów leczenia do porównania. | Yes | |
| typ | wyliczenie | Typ żądania. Możliwe wartości: EvaluationComparison |
Yes |
EvaluationComparisonInsightResult
Wnioski z porównania ewaluacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Porównania | tablica EvalRunResultComparison | Wyniki porównania dla każdego przebiegu leczenia względem punktu odniesienia. | Yes | |
| metoda | ciąg | Metoda statystyczna użyta do porównania. | Yes | |
| typ | wyliczenie | Typ wyniku szczegółowych informacji. Możliwe wartości: EvaluationComparison |
Yes |
EvaluationResultSample
Próbka z wyniku oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| correlationInfo | obiekt | Informacje o korelacji dla próbki analizy. | Yes | |
| evaluationResult | EvalResult | Wynik oceny. | Yes | |
| └─ nazwa | ciąg | nazwa sprawdzania | Yes | |
| └* zaliczone | boolean | wskazuje, czy sprawdzanie zakończyło się powodzeniem lub niepowodzeniem | Yes | |
| └* wynik | number | wynik | Yes | |
| └typ | ciąg | typ sprawdzania | Yes | |
| features | obiekt | Funkcje ułatwiające dodatkowe filtrowanie danych w środowisku użytkownika. | Yes | |
| id | ciąg | Unikatowy identyfikator próbki analizy. | Yes | |
| typ | wyliczenie | Typ przykładu wyniku oceny Możliwe wartości: EvaluationResultSample |
Yes |
Reguła oceny
Model reguły oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | EvaluationRuleAction | Model działania ewaluacyjnego. | Yes | |
| └typ | EvaluationRuleActionType | Rodzaj działania w ramach oceny. | Yes | |
| opis | ciąg | Opis reguły oceny. | Nie. | |
| displayName | ciąg | Nazwa wyświetlana reguły oceny. | Nie. | |
| enabled | boolean | Wskazuje, czy reguła oceny jest włączona. Wartość domyślna to true. | Yes | |
| eventType | EvaluationRuleEventType | Typ zdarzenia reguły oceny. | Yes | |
| filtr | EvaluationRuleFilter | Model filtru oceny. | Nie. | |
| └} agentName | ciąg | Filtruj według nazwy agenta. | Yes | |
| id | ciąg (tylko do odczytu) | Unikatowy identyfikator reguły oceny. | Yes | |
| daneSystemowe | obiekt (tylko do odczytu) | Metadane systemu dla reguły oceny. | Yes |
EvaluationRuleAction
Model działania ewaluacyjnego.
Dyskryminowanie ocenyRuleAction
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
continuousEvaluation |
ContinuousEvaluationRuleAction |
humanEvaluationPreview |
HumanEvaluationPreviewRuleAction |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | EvaluationRuleActionType | Rodzaj działania w ramach oceny. | Yes |
EvaluationRuleActionType
Rodzaj działania w ramach oceny.
| Property | Value |
|---|---|
| Opis | Rodzaj działania w ramach oceny. |
| Type | ciąg |
| Wartości | continuousEvaluationhumanEvaluationPreview |
EvaluationRuleEventType
Typ zdarzenia reguły oceny.
| Property | Value |
|---|---|
| Opis | Typ zdarzenia reguły oceny. |
| Type | ciąg |
| Wartości | responseCompletedmanual |
EvaluationRuleFilter
Model filtru oceny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agentName | ciąg | Filtruj według nazwy agenta. | Yes |
EvaluationRunClusterInsightRequest
Wgląd w zestaw wyników ewaluacji
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| evalId | ciąg | Identyfikator oceny dla szczegółowych informacji. | Yes | |
| modelKonfiguracja | InsightModelConfiguration | Konfiguracja modelu używanego w generowaniu wniosków. | Nie. | |
| └* modelDeploymentName | ciąg | Wdrożenie modelu do oceny. Akceptuje nazwę wdrożenia samodzielnie lub z nazwą połączenia jako {connectionName}/<modelDeploymentName>. |
Yes | |
| identyfikatory runId | tablica ciągów | Lista identyfikatorów przebiegów oceny dla szczegółowych informacji. | Yes | |
| typ | wyliczenie | Typ żądania szczegółowych informacji. Możliwe wartości: EvaluationRunClusterInsight |
Yes |
EvaluationRunClusterInsightResult
Szczegółowe informacje z oceny uruchamiają analizę skupień.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| clusterInsight | ClusterInsightResult | Wnioski z analizy skupień. | Yes | |
| typ | wyliczenie | Typ wyniku szczegółowych informacji. Możliwe wartości: EvaluationRunClusterInsight |
Yes |
EvaluationScheduleTask
Zadanie oceny harmonogramu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| konfiguracja | obiekt | Konfiguracja zadania. | Nie. | |
| evalId | ciąg | Identyfikator grupy ewaluacyjnej. | Yes | |
| evalRun | obiekt | Ładunek przebiegu oceny. | Yes | |
| typ | wyliczenie | Możliwe wartości: Evaluation |
Yes |
EvaluationTaxonomy
Definicja taksonomii oceny
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| properties | obiekt | Dodatkowe właściwości taksonomii oceny. | Nie. | |
| taksonomiaKategorie | tablica taksonomiiKategory | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | EvaluationTaxonomyInput | Konfiguracja danych wejściowych dla taksonomii oceny. | Yes | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
EvaluationTaxonomyCreateOrUpdate
Definicja taksonomii oceny
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| properties | obiekt | Dodatkowe właściwości taksonomii oceny. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| taksonomiaKategorie | tablica taksonomiiKategory | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | EvaluationTaxonomyInput | Konfiguracja danych wejściowych dla taksonomii oceny. | Yes | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Yes |
EvaluationTaxonomyInput
Konfiguracja danych wejściowych dla taksonomii oceny.
Dyskryminowanie wartości EvaluationTaxonomyInput
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
agent |
AgentTaxonomyInput |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | EvaluationTaxonomyInputType | Rodzaj danych wejściowych oceny taksonomii. | Yes |
EvaluationTaxonomyInputType
Rodzaj danych wejściowych oceny taksonomii.
| Property | Value |
|---|---|
| Opis | Rodzaj danych wejściowych oceny taksonomii. |
| Type | ciąg |
| Wartości | agentpolicy |
EvaluationTaxonomyInputUpdate
Konfiguracja danych wejściowych dla taksonomii oceny.
Dyskryminator ocenyTaxonomyInputUpdate
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
agent |
AgentTaxonomyInputUpdate |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | EvaluationTaxonomyInputType | Rodzaj danych wejściowych oceny taksonomii. | Yes |
EvaluationTaxonomyUpdate
Definicja taksonomii oceny
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| properties | obiekt | Dodatkowe właściwości taksonomii oceny. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| taksonomiaKategorie | tablica taksonomiiKategory | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | EvaluationTaxonomyInputUpdate | Konfiguracja danych wejściowych dla taksonomii oceny. | Nie. | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Yes |
EwaluatorCategory
Kategoria osoby oceniającej
| Property | Value |
|---|---|
| Opis | Kategoria osoby oceniającej |
| Type | ciąg |
| Wartości | qualitysafetyagents |
EwaluatorDefinition
Podstawowa konfiguracja ewaluatora z dyskryminatorem
Dyskryminowanie ewaluatoraDefinition
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
code |
CodeBasedEvaluatorDefinition |
prompt |
PromptBasedEvaluatorDefinition |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| data_schema | obiekt | Schemat JSON (wersja robocza 2020-12) dla danych wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| init_parameters | obiekt | Schemat JSON (wersja robocza 2020-12) dla parametrów wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| metryki | obiekt | Lista wskaźników wyjściowych opracowanych przez tego ewaluatora | Nie. | |
| typ | EwaluatorDefinitionType | Definicja rodzaju osoby ewaluującej | Yes |
EwaluatorDefinitionType
Definicja rodzaju osoby ewaluującej
| Property | Value |
|---|---|
| Opis | Definicja rodzaju osoby ewaluującej |
| Type | ciąg |
| Wartości | promptcodeprompt_and_codeserviceopenai_graders |
EwaluatorMetric
Metryka ewaluatora
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| desirable_direction | EwaluatorMetricDirection | Kierunek metryki wskazujący, czy wyższa wartość jest lepsza, niższa wartość jest lepsza, czy neutralna | Nie. | |
| is_primary | boolean | Wskazuje, czy ta metryka jest podstawowa, gdy istnieje wiele metryk. | Nie. | |
| max_value | number | Maksymalna wartość metryki. Jeśli nie zostanie określony, przyjmuje się, że jest on niezwiązany. | Nie. | |
| min_value | number | Minimalna wartość metryki | Nie. | |
| typ | EwaluatorMetricType | Rodzaj osoby oceniającej | Nie. |
EwaluatorMetricDirection
Kierunek metryki wskazujący, czy wyższa wartość jest lepsza, niższa wartość jest lepsza, czy neutralna
| Property | Value |
|---|---|
| Opis | Kierunek metryki wskazujący, czy wyższa wartość jest lepsza, niższa wartość jest lepsza, czy neutralna |
| Type | ciąg |
| Wartości | increasedecreaseneutral |
EwaluatorMetricType
Rodzaj osoby oceniającej
| Property | Value |
|---|---|
| Opis | Rodzaj osoby oceniającej |
| Type | ciąg |
| Wartości | ordinalcontinuousboolean |
Typ ewaluatora
Rodzaj osoby oceniającej
| Property | Value |
|---|---|
| Opis | Rodzaj osoby oceniającej |
| Type | ciąg |
| Wartości | builtincustom |
EvaluatorVersion
Definicja ewaluatora
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| categories | tablica EwaluatorCategory | Kategorie osoby oceniającej | Yes | |
| utworzono_o | ciąg (tylko do odczytu) | Data/godzina utworzenia osoby oceniającej | Yes | |
| utworzone_przez | ciąg (tylko do odczytu) | Twórca ewaluatora | Yes | |
| definicja | EwaluatorDefinition | Podstawowa konfiguracja ewaluatora z dyskryminatorem | Yes | |
| └data_schema | obiekt | Schemat JSON (wersja robocza 2020-12) dla danych wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| └init_parameters | obiekt | Schemat JSON (wersja robocza 2020-12) dla parametrów wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| Metryki └* | obiekt | Lista wskaźników wyjściowych opracowanych przez tego ewaluatora | Nie. | |
| └typ | EwaluatorDefinitionType | Definicja rodzaju osoby ewaluującej | Yes | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Łatwiej jest znaleźć ewaluatora w AI Foundry. Nie musi być unikalny. | Nie. | |
| evaluator_type | Typ ewaluatora | Rodzaj osoby oceniającej | Yes | |
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| metadane | obiekt | Metadane dotyczące osoby oceniającej | Nie. | |
| modified_at | ciąg (tylko do odczytu) | Data/godzina ostatniej modyfikacji osoby oceniającej | Yes | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
EvaluatorVersionTworzenie
Definicja ewaluatora
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| categories | tablica EwaluatorCategory | Kategorie osoby oceniającej | Yes | |
| definicja | EwaluatorDefinition | Podstawowa konfiguracja ewaluatora z dyskryminatorem | Yes | |
| └data_schema | obiekt | Schemat JSON (wersja robocza 2020-12) dla danych wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| └init_parameters | obiekt | Schemat JSON (wersja robocza 2020-12) dla parametrów wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| Metryki └* | obiekt | Lista wskaźników wyjściowych opracowanych przez tego ewaluatora | Nie. | |
| └typ | EwaluatorDefinitionType | Definicja rodzaju osoby ewaluującej | Yes | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Łatwiej jest znaleźć ewaluatora w AI Foundry. Nie musi być unikalny. | Nie. | |
| evaluator_type | Typ ewaluatora | Rodzaj osoby oceniającej | Yes | |
| metadane | obiekt | Metadane dotyczące osoby oceniającej | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. |
EvaluatorVersionUpdate
Definicja ewaluatora
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| categories | tablica EwaluatorCategory | Kategorie osoby oceniającej | Nie. | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Łatwiej jest znaleźć ewaluatora w AI Foundry. Nie musi być unikalny. | Nie. | |
| metadane | obiekt | Metadane dotyczące osoby oceniającej | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. |
FabricDataAgentToolParameters
Parametry narzędzia agenta danych sieci szkieletowej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| project_connections | tablica toolProjectConnection | Połączenia project dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Nie. |
FileDatasetVersion
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Connectionname | ciąg | Nazwa połączenia konta Azure Storage. Wymagane, jeśli parametr startPendingUploadVersion nie został wywołany przed utworzeniem zestawu danych | Nie. | |
| dataUri | ciąg | Identyfikator URI danych (przykład) Ograniczenia: minLength: 1, wzorzec: [a-zA-Z0-9_] |
Yes | |
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| Isreference | Wartość logiczna (tylko do odczytu) | Wskazuje, czy zestaw danych zawiera odwołanie do magazynu, czy zestaw danych zarządza samym magazynem. Jeśli to prawda, dane bazowe nie zostaną usunięte po usunięciu wersji zestawu danych | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_file |
Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
FileDatasetVersionUpdate
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_file |
Yes |
FolderDatasetVersion
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Connectionname | ciąg | Nazwa połączenia konta Azure Storage. Wymagane, jeśli parametr startPendingUploadVersion nie został wywołany przed utworzeniem zestawu danych | Nie. | |
| dataUri | ciąg | Identyfikator URI danych (przykład) Ograniczenia: minLength: 1, wzorzec: [a-zA-Z0-9_] |
Yes | |
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| Isreference | Wartość logiczna (tylko do odczytu) | Wskazuje, czy zestaw danych zawiera odwołanie do magazynu, czy zestaw danych zarządza samym magazynem. Jeśli to prawda, dane bazowe nie zostaną usunięte po usunięciu wersji zestawu danych | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_folder |
Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
FolderDatasetVersionUpdate
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_folder |
Yes |
FunctionToolCall
Szczegóły wywołania narzędzia funkcji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Argumenty do wywołania funkcji za pomocą , wygenerowane przez model w formacie JSON. | Yes | |
| nazwa | ciąg | Nazwa funkcji do wywołania. | Yes |
HostedAgentDefinition
Definicja hostowanego agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| container_protocol_versions | tablica wartości ProtocolVersionRecord | Protokoły obsługiwane przez agenta na potrzeby komunikacji przychodzącej kontenerów. | Yes | |
| cpu | ciąg | Konfiguracja procesora CPU dla hostowanego agenta. | Yes | |
| environment_variables | obiekt | Zmienne środowiskowe do ustawienia w kontenerze hostowanego agenta. | Nie. | |
| obraz | ciąg | Identyfikator obrazu agenta, który ma zastosowanie do agentów hostowanych na podstawie obrazów. | Nie. | |
| rodzaj | wyliczenie | Możliwe wartości: hosted |
Yes | |
| pamięć | ciąg | Konfiguracja pamięci hostowanego agenta. | Yes | |
| rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| └rai_policy_name | ciąg | Nazwa zasad RAI do zastosowania. | Yes | |
| Narzędzia | tablica narzędzi OpenAI.Tool | Szereg narzędzi, które model hostowanego agenta może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice . |
Nie. |
HourlyRecurrenceSchedule
Godzinowy harmonogram cykli.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: Hourly |
Yes |
HumanEvaluationPreviewRuleAction
Akcja reguły oceny dla oceny przez człowieka.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| templateId | Identyfikator zasobu | Identyfikator zapisanego zasobu. | Yes | |
| typ | wyliczenie | Możliwe wartości: humanEvaluationPreview |
Yes |
Index
Definicja zasobu indeksu
Dyskryminujący indeks
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
AzureSearch |
AzureAISearchIndex |
ManagedAzureSearch |
ManagedAzureAISearchIndex |
CosmosDBNoSqlVectorStore |
CosmosDBIndex |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | Typ indeksu | Yes | ||
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
Typ indeksu
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | AzureSearchCosmosDBNoSqlVectorStoreManagedAzureSearch |
IndexUpdate
Definicja zasobu indeksu
Dyskryminujący dla indeksuAktualizuj
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
AzureSearch |
AzureAISearchIndexUpdate |
ManagedAzureSearch |
ManagedAzureAISearchIndexUpdate |
CosmosDBNoSqlVectorStore |
CosmosDBIndexUpdate |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | Typ indeksu | Yes |
Wgląd
Treść odpowiedzi dla szczegółowych informacji o klastrze.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| displayName | ciąg | Przyjazna dla użytkownika nazwa wyświetlana szczegółowych informacji. | Yes | |
| id | ciąg (tylko do odczytu) | Unikatowy identyfikator raportu szczegółowych informacji. | Yes | |
| metadane | InsightsMetadata (tylko do odczytu) | Metadane dotyczące szczegółowych informacji. | Yes | |
| └* completedAt | ciąg | Sygnatura czasowa ukończenia szczegółowych informacji. | Nie. | |
| └} createdAt | ciąg | Sygnatura czasowa utworzenia szczegółowych informacji. | Yes | |
| żądanie | InsightRequest | Żądanie raportu szczegółowych informacji. | Yes | |
| └typ | InsightType | Typ żądania. | Yes | |
| result | InsightResult (tylko do odczytu) | Wynik spostrzeżeń. | Nie. | |
| └typ | InsightType | Typ wyniku szczegółowych informacji. | Yes | |
| stan | Azure. Core.Foundations.OperationState (tylko do odczytu) | Wyliczenie opisujące dozwolone stany operacji. | Yes |
InsightCluster
Klaster próbek analitycznych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis klastra analizy. | Yes | |
| id | ciąg | Identyfikator klastra analizy. | Yes | |
| etykieta | ciąg | Etykieta dla klastra | Yes | |
| Próbki | tablica insightSample | Lista przykładów należących do tego klastra. Puste, jeśli próbki są częścią podciągów. | Nie. | |
| subClusters | tablica tablicy insightCluster | Lista podrzędnych elementów podrzędnych w tym klastrze. Pusty, jeśli nie istnieją żadne podrzędne elementy podrzędne. | Nie. | |
| Sugestia | ciąg | Sugestia dotycząca klastra | Yes | |
| suggestionTitle | ciąg | Tytuł sugestii dla klastra | Yes | |
| weight | liczba całkowita | Waga klastra analizy. Wskazuje to liczbę próbek w klastrze. | Yes |
InsightModelConfiguration
Konfiguracja modelu używanego w generowaniu wniosków.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| modelDeploymentName | ciąg | Wdrożenie modelu do oceny. Akceptuje nazwę wdrożenia samodzielnie lub z nazwą połączenia jako {connectionName}/<modelDeploymentName>. |
Yes |
InsightRequest
Żądanie raportu szczegółowych informacji.
Dyskryminująca analizaRequest
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
EvaluationRunClusterInsight |
EvaluationRunClusterInsightRequest |
AgentClusterInsight |
AgentClusterInsightRequest |
EvaluationComparison |
EvaluationComparisonInsightRequest |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | InsightType | Prośba o wglądy. | Yes |
Szczegółowe informacje
Wynik spostrzeżeń.
Dyskryminująca analizaResult
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
EvaluationComparison |
EvaluationComparisonInsightResult |
EvaluationRunClusterInsight |
EvaluationRunClusterInsightResult |
AgentClusterInsight |
AgentClusterInsightResult |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | InsightType | Prośba o wglądy. | Yes |
InsightSample
Próbka z analizy.
Dyskryminowanie szczegółowych informacjiPrzykład
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
EvaluationResultSample |
EvaluationResultSample |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| correlationInfo | obiekt | Informacje o korelacji dla próbki analizy. | Yes | |
| features | obiekt | Funkcje ułatwiające dodatkowe filtrowanie danych w środowisku użytkownika. | Yes | |
| id | ciąg | Unikatowy identyfikator próbki analizy. | Yes | |
| typ | SampleType | Rodzaj próbki użytej w analizie. | Yes |
InsightScheduleTask
Zadanie Wgląd dla harmonogramu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| konfiguracja | obiekt | Konfiguracja zadania. | Nie. | |
| analiza | Wgląd | Treść odpowiedzi dla szczegółowych informacji o klastrze. | Yes | |
| └} displayName | ciąg | Przyjazna dla użytkownika nazwa wyświetlana szczegółowych informacji. | Yes | |
| └─ ID | ciąg (tylko do odczytu) | Unikatowy identyfikator raportu szczegółowych informacji. | Yes | |
| Metadane └* | InsightsMetadata (tylko do odczytu) | Metadane dotyczące raportu szczegółowych informacji. | Yes | |
| └* żądanie | InsightRequest | Żądanie analizy szczegółowych informacji. | Yes | |
| Wynik └* | InsightResult (tylko do odczytu) | Wynik raportu szczegółowych informacji. | Nie. | |
| Stan └* | Azure. Core.Foundations.OperationState (tylko do odczytu) | Bieżący stan szczegółowych informacji. | Yes | |
| typ | wyliczenie | Możliwe wartości: Insight |
Yes |
InsightSummary
Podsumowanie analizy skupień błędów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metoda | ciąg | Metoda używana do klastrowania. | Yes | |
| sampleCount | liczba całkowita | Łączna liczba analizowanych próbek. | Yes | |
| uniqueClusterCount | liczba całkowita | Łączna liczba unikatowych klastrów. | Yes | |
| uniqueSubclusterCount | liczba całkowita | Całkowita liczba unikatowych etykiet podklasy. | Yes | |
| użycie | ClusterTokenUsage | Użycie tokenu do analizy skupień | Yes | |
| └* inputTokenUsage | liczba całkowita | użycie tokenu wejściowego | Yes | |
| └} outputTokenUsage | liczba całkowita | użycie tokenu wyjściowego | Yes | |
| └* totalTokenUsage | liczba całkowita | łączne użycie tokenu | Yes |
InsightType
Prośba o wglądy.
| Property | Value |
|---|---|
| Opis | Prośba o wglądy. |
| Type | ciąg |
| Wartości | EvaluationRunClusterInsightAgentClusterInsightEvaluationComparison |
InsightsMetadata
Metadane dotyczące szczegółowych informacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| completedAt | ciąg | Sygnatura czasowa ukończenia szczegółowych informacji. | Nie. | |
| createdAt | ciąg | Sygnatura czasowa utworzenia szczegółowych informacji. | Yes |
ItemGenerationParams
Reprezentuje zestaw parametrów używanych do sterowania operacjami generowania elementów.
Dyskryminujący element ItemGenerationParams
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
red_team |
RedTeamItemGenerationParams |
red_team_seed_prompts |
RedTeamSeedPromptsItemGenerationParams |
red_team_taxonomy |
RedTeamTaxonomyItemGenerationParams |
response_retrieval |
ResponseRetrievalItemGenerationParams |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | ItemGenerationParamsType | Typy parametrów generowania elementów zespołu czerwonego. | Yes |
ItemGenerationParamsType
Typy parametrów generowania elementów zespołu czerwonego.
| Property | Value |
|---|---|
| Opis | Typy parametrów generowania elementów zespołu czerwonego. |
| Type | ciąg |
| Wartości | red_teamresponse_retrievalred_team_seed_promptsred_team_taxonomysynthetic_data_gen_preview |
ManagedAzureAISearchIndex
Definicja indeksu zarządzanego Wyszukiwanie AI platformy Azure
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg (tylko do odczytu) | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg (tylko do odczytu) | Nazwa zasobu | Yes | |
| typ | wyliczenie | Typ indeksu Możliwe wartości: ManagedAzureSearch |
Yes | |
| wersja | ciąg (tylko do odczytu) | Wersja zasobu | Yes |
ManagedAzureAISearchIndexUpdate
Definicja indeksu zarządzanego Wyszukiwanie AI platformy Azure
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | wyliczenie | Typ indeksu Możliwe wartości: ManagedAzureSearch |
Yes |
MemoryItem
Pojedynczy element pamięci przechowywany w magazynie pamięci, zawierający zawartość i metadane.
Dyskryminujące dla elementu MemoryItem
Ten składnik używa właściwości kind do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
user_profile |
UserProfileMemoryItem |
chat_summary |
ChatSummaryMemoryItem |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | ciąg | Zawartość pamięci. | Yes | |
| rodzaj | MemoryItemKind | Rodzaj elementu pamięci. | Yes | |
| memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Yes | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes | |
| updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Yes |
MemoryItemKind
Rodzaj elementu pamięci.
| Property | Value |
|---|---|
| Opis | Rodzaj elementu pamięci. |
| Type | ciąg |
| Wartości | user_profilechat_summary |
MemoryOperation
Reprezentuje pojedynczą operację pamięci (tworzenie, aktualizowanie lub usuwanie) wykonywaną na elemencie pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rodzaj | MemoryOperationKind | Rodzaj operacji pamięci. | Yes | |
| memory_item | MemoryItem | Pojedynczy element pamięci przechowywany w magazynie pamięci, zawierający zawartość i metadane. | Yes | |
| └─ zawartość | ciąg | Zawartość pamięci. | Yes | |
| Rodzaj └* | MemoryItemKind | Rodzaj elementu pamięci. | Yes | |
| └memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Yes | |
| Zakres └* | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes | |
| └updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Yes |
MemoryOperationKind
Rodzaj operacji pamięci.
| Property | Value |
|---|---|
| Opis | Rodzaj operacji pamięci. |
| Type | ciąg |
| Wartości | createupdatedelete |
MemorySearchItem
Pobrany element pamięci z wyszukiwania w pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| memory_item | MemoryItem | Pojedynczy element pamięci przechowywany w magazynie pamięci, zawierający zawartość i metadane. | Yes | |
| └─ zawartość | ciąg | Zawartość pamięci. | Yes | |
| Rodzaj └* | MemoryItemKind | Rodzaj elementu pamięci. | Yes | |
| └memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Yes | |
| Zakres └* | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes | |
| └updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Yes |
MemorySearchOptions
Opcje wyszukiwania w pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_memories | liczba całkowita | Maksymalna liczba elementów pamięci do zwrócenia. | Nie. |
MemorySearchPreviewTool
Narzędzie do integracji wspomnień z agentem.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| memory_store_name | ciąg | Nazwa magazynu pamięci, który ma być używany. | Yes | |
| zakres | ciąg | Przestrzeń nazw używana do grupowania i izolowania wspomnień, takich jak identyfikator użytkownika. Ogranicza liczbę wspomnień, które można odzyskać lub zaktualizować. Użyj specjalnej zmiennej {{$userId}} , aby określić zakres pamięci do bieżącego zalogowanego użytkownika. |
Yes | |
| search_options | MemorySearchOptions | Opcje wyszukiwania w pamięci. | Nie. | |
| └max_memories | liczba całkowita | Maksymalna liczba elementów pamięci do zwrócenia. | Nie. | |
| typ | wyliczenie | Typ narzędzia. Zawsze memory_search_preview.Możliwe wartości: memory_search_preview |
Yes | |
| update_delay | liczba całkowita | Czas oczekiwania przed aktualizacją wspomnień po braku aktywności (w sekundach). Domyślnie 300. | Nie. | 300 |
MemorySearchToolCallItemParam
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| results | tablica elementu MemorySearchItem | Wyniki zwrócone z wyszukiwania pamięci. | Nie. | |
| typ | wyliczenie | Możliwe wartości: memory_search_call |
Yes |
MemorySearchToolCallItemResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| results | tablica elementu MemorySearchItem | Wyniki zwrócone z wyszukiwania pamięci. | Nie. | |
| stan | wyliczenie | Stan wywołania narzędzia wyszukiwania pamięci. Jeden z in_progresssearching, completedlub incompletefailed,Możliwe wartości: in_progress, , searchingcompleted, , incompletefailed |
Yes | |
| typ | wyliczenie | Możliwe wartości: memory_search_call |
Yes |
MemoryStoreDefaultDefinition
Domyślna implementacja magazynu pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| chat_model | ciąg | Nazwa lub identyfikator wdrożenia modelu uzupełniania czatu używany do przetwarzania pamięci. | Yes | |
| embedding_model | ciąg | Nazwa lub identyfikator wdrożenia modelu osadzania używanego do przetwarzania pamięci. | Yes | |
| rodzaj | wyliczenie | Rodzaj magazynu pamięci. Możliwe wartości: default |
Yes | |
| options | MemoryStoreDefaultOptions | Domyślne konfiguracje magazynu pamięci. | Nie. | |
| └chat_summary_enabled | boolean | Czy włączyć wyodrębnianie podsumowania czatu i storage. Wartość domyślna to true. | Yes | True |
| └user_profile_details | ciąg | Określone kategorie lub typy informacji o profilu użytkownika do wyodrębnienia i przechowywania. | Nie. | |
| └user_profile_enabled | boolean | Czy włączyć wyodrębnianie i storage profilu użytkownika. Wartość domyślna to true. | Yes | True |
MemoryStoreDefaultOptions
Domyślne konfiguracje magazynu pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| chat_summary_enabled | boolean | Czy włączyć wyodrębnianie podsumowania czatu i storage. Wartość domyślna to true. | Yes | True |
| user_profile_details | ciąg | Określone kategorie lub typy informacji o profilu użytkownika do wyodrębnienia i przechowywania. | Nie. | |
| user_profile_enabled | boolean | Czy włączyć wyodrębnianie i storage profilu użytkownika. Wartość domyślna to true. | Yes | True |
MemoryStoreDefinition
Podstawowa definicja konfiguracji magazynu pamięci.
Dyskryminowanie dla klasy MemoryStoreDefinition
Ten składnik używa właściwości kind do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
default |
MemoryStoreDefaultDefinition |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rodzaj | MemoryStoreKind | Typ implementacji magazynu pamięci, który ma być używany. | Yes |
MemoryStoreDeleteScopeResponse
Odpowiedź na usunięcie wspomnień z zakresu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Czy operacja usuwania zakończyła się pomyślnie. | Yes | |
| nazwa | ciąg | Nazwa magazynu pamięci. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "memory_store.scope.deleted". Możliwe wartości: memory_store.scope.deleted |
Yes | |
| zakres | ciąg | Zakres, z którego usunięto wspomnienia. | Yes |
MemoryStoreKind
Typ implementacji magazynu pamięci, który ma być używany.
| Property | Value |
|---|---|
| Opis | Typ implementacji magazynu pamięci, który ma być używany. |
| Type | ciąg |
| Wartości | default |
MemoryStoreObject
Magazyn pamięci, który może przechowywać i pobierać wspomnienia użytkownika.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) podczas tworzenia magazynu pamięci. | Yes | |
| definicja | MemoryStoreDefinition | Podstawowa definicja konfiguracji magazynu pamięci. | Yes | |
| Rodzaj └* | MemoryStoreKind | Rodzaj magazynu pamięci. | Yes | |
| opis | ciąg | Czytelny dla człowieka opis magazynu pamięci. Ograniczenia: maxLength: 512 |
Nie. | |
| id | ciąg | Unikatowy identyfikator magazynu pamięci. | Yes | |
| metadane | obiekt | Dowolne metadane klucz-wartość do skojarzenia z magazynem pamięci. | Nie. | |
| nazwa | ciąg | Nazwa magazynu pamięci. Ograniczenia: maxLength: 256 |
Yes | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "memory_store". Możliwe wartości: memory_store |
Yes | |
| updated_at | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach), kiedy magazyn pamięci został ostatnio zaktualizowany. | Yes |
MemoryStoreOperationUsage
Statystyki użycia operacji składnicy pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| embedding_tokens | liczba całkowita | Liczba tokenów osadzania. | Yes | |
| input_tokens | OpenAI.integer | Yes | ||
| input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Yes | ||
| └cached_tokens | OpenAI.integer | Yes | ||
| output_tokens | OpenAI.integer | Yes | ||
| output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Yes | ||
| └─ tokeny_rozumowania | OpenAI.integer | Yes | ||
| total_tokens | OpenAI.integer | Yes |
MemoryStoreSearchResponse
Odpowiedź na wyszukiwanie w pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Wspomnienia | tablica elementu MemorySearchItem | Powiązane elementy pamięci znalezione podczas operacji wyszukiwania. | Yes | |
| search_id | ciąg | Unikatowy identyfikator tego żądania wyszukiwania. Użyj tej wartości jako previous_search_id w kolejnych żądaniach, aby wykonywać wyszukiwania przyrostowe. | Yes | |
| użycie | MemoryStoreOperationUsage | Statystyki użycia operacji składnicy pamięci. | Yes | |
| └embedding_tokens | liczba całkowita | Liczba tokenów osadzania. | Yes | |
| └input_tokens | OpenAI.integer | Liczba tokenów wejściowych. | Yes | |
| └input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Szczegółowy podział tokenów wejściowych. | Yes | |
| └─ tokeny_wyjściowe | OpenAI.integer | Liczba tokenów wyjściowych. | Yes | |
| └output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Szczegółowy podział tokenów wyjściowych. | Yes | |
| └total_tokens | OpenAI.integer | Całkowita liczba użytych tokenów. | Yes |
MemoryStoreUpdateCompletedResult
Wynik aktualizacji pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| memory_operations | tablica operacji MemoryOperation | Lista poszczególnych operacji pamięci, które zostały wykonane podczas aktualizacji. | Yes | |
| użycie | MemoryStoreOperationUsage | Statystyki użycia operacji składnicy pamięci. | Yes | |
| └embedding_tokens | liczba całkowita | Liczba tokenów osadzania. | Yes | |
| └input_tokens | OpenAI.integer | Liczba tokenów wejściowych. | Yes | |
| └input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Szczegółowy podział tokenów wejściowych. | Yes | |
| └─ tokeny_wyjściowe | OpenAI.integer | Liczba tokenów wyjściowych. | Yes | |
| └output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Szczegółowy podział tokenów wyjściowych. | Yes | |
| └total_tokens | OpenAI.integer | Całkowita liczba użytych tokenów. | Yes |
MemoryStoreUpdateResponse
Określa stan operacji aktualizacji magazynu pamięci.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | OpenAI.Error | Nie. | ||
| └* additionalInfo | obiekt | Nie. | ||
| └─ kod | ciąg (dopuszczany do wartości null) | Yes | ||
| └* debugInfo | obiekt | Nie. | ||
| └szczegóły | tablica openAI.Error | Nie. | ||
| └─ Komunikat | ciąg | Yes | ||
| └* param | ciąg (dopuszczany do wartości null) | Nie. | ||
| └typ | ciąg | Nie. | ||
| result | MemoryStoreUpdateCompletedResult | Wynik aktualizacji pamięci. | Nie. | |
| └memory_operations | tablica operacji MemoryOperation | Lista poszczególnych operacji pamięci, które zostały wykonane podczas aktualizacji. | Yes | |
| └─ użycie | MemoryStoreOperationUsage | Statystyki użycia skojarzone z operacją aktualizacji pamięci. | Yes | |
| stan | MemoryStoreUpdateStatus | Stan operacji aktualizacji magazynu pamięci. | Yes | |
| superseded_by | ciąg | Update_id operacja została zastąpiona przez stan "zastąpiony". | Nie. | |
| update_id | ciąg | Unikatowy identyfikator tego żądania aktualizacji. Użyj tej wartości jako previous_update_id w kolejnych żądaniach w celu wykonania aktualizacji przyrostowych. | Yes |
MemoryStoreUpdateStatus
Stan operacji aktualizacji magazynu pamięci.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | queuedin_progresscompletedfailedsuperseded |
MicrosoftFabricPreviewTool
Informacje o definicji wejściowych dla narzędzia Microsoft Fabric używane do konfiguracji agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| fabric_dataagent_preview | FabricDataAgentToolParameters | Parametry narzędzia agenta danych sieci szkieletowej. | Yes | |
| └project_connections | tablica toolProjectConnection | Połączenia project dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. Ograniczenia: maxItems: 1 |
Nie. | |
| typ | wyliczenie | Typ obiektu, który zawsze jest "fabric_dataagent_preview". Możliwe wartości: fabric_dataagent_preview |
Yes |
Implementacja modelu
Definicja wdrożenia modelu
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| capabilities | obiekt (tylko do odczytu) | Możliwości wdrożonego modelu | Yes | |
| Connectionname | ciąg (tylko do odczytu) | Nazwa połączenia, z poziomu których pochodzi wdrożenie | Nie. | |
| modelName | ciąg (tylko do odczytu) | Publisher nazwa wdrożonego modelu | Yes | |
| modelPublisher | ciąg (tylko do odczytu) | Nazwa wydawcy wdrożonego modelu | Yes | |
| wersja modelu | ciąg (tylko do odczytu) | Publisher wersji wdrożonego modelu | Yes | |
| nazwa | ciąg (tylko do odczytu) | Nazwa wdrożenia | Yes | |
| sku | Jednostka SKU (tylko do odczytu) | Informacje o jednostce SKU | Yes | |
| Pojemność └* | liczba całkowita | Pojemność jednostki SKU | Yes | |
| Rodzina └* | ciąg | Rodzina jednostek SKU | Yes | |
| └─ nazwa | ciąg | Nazwa jednostki SKU | Yes | |
| └* rozmiar | ciąg | Rozmiar jednostki SKU | Yes | |
| Warstwa └* | ciąg | Warstwa jednostki SKU | Yes | |
| typ | wyliczenie | Typ wdrożenia Możliwe wartości: ModelDeployment |
Yes |
ModelSamplingParams
Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_completion_tokens | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Yes | |
| seed | liczba całkowita | Losowe inicjatory do odtworzenia. | Yes | |
| temperatura | number | Parametr temperatury do próbkowania. | Yes | |
| top_p | number | Parametr top-p próbkowania jądra. | Yes |
ModelSamplingParamsUpdate
Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_completion_tokens | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Nie. | |
| seed | liczba całkowita | Losowe inicjatory do odtworzenia. | Nie. | |
| temperatura | number | Parametr temperatury do próbkowania. | Nie. | |
| top_p | number | Parametr top-p próbkowania jądra. | Nie. |
MonthlyRecurrenceSchedule
Miesięczny harmonogram cykli.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| daysOfMonth | tablica liczb całkowitych | Dni miesiąca dla harmonogramu cyklu. | Yes | |
| typ | wyliczenie | Typ cyklu miesięcznego. Możliwe wartości: Monthly |
Yes |
NoAuthenticationCredentials
Poświadczenia, które nie wymagają uwierzytelniania
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: None |
Yes |
OAuthConsentRequestOutputItem
Żądanie od usługi, aby użytkownik wykonał zgodę OAuth.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| consent_link | ciąg | Link, za pomocą których użytkownik może wykonać zgodę OAuth. | Yes | |
| id | ciąg | Yes | ||
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera dla żądania zgody OAuth. | Yes | |
| typ | wyliczenie | Możliwe wartości: oauth_consent_request |
Yes |
OneTimeTrigger
Jednorazowy spust.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| timeZone | ciąg | Strefa czasowa dla wyzwalacza jednorazowego. | Nie. | UTC |
| triggerAt | ciąg | Data i godzina jednorazowego wyzwolenia w formacie ISO 8601. | Yes | |
| typ | wyliczenie | Możliwe wartości: OneTime |
Yes |
OpenAI.Annotation
Adnotacja, która ma zastosowanie do zakresu tekstu wyjściowego.
Dyskryminator dla OpenAI.Annotation.
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
file_citation |
OpenAI.FileCitationBody |
url_citation |
OpenAI.UrlCitationBody |
container_file_citation |
OpenAI.ContainerFileCitationBody |
file_path |
OpenAI.FilePath |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.AnnotationType | Yes |
OpenAI.AnnotationType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | file_citationurl_citationcontainer_file_citationfile_path |
OpenAI.ApplyPatchCallOutputStatus
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | completedfailed |
OpenAI.ApplyPatchCallOutputStatusParam
Wartości wyników zgłaszane dla danych wyjściowych wywołań narzędzia apply_patch.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | completedfailed |
OpenAI.ApplyPatchCallStatus
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompleted |
OpenAI.ApplyPatchCallStatusParam
Wartości stanu zgłaszane dla wywołań narzędzi apply_patch.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompleted |
OpenAI.ApplyPatchCreateFileOperation
Instrukcja opisująca sposób tworzenia pliku za pomocą narzędzia apply_patch.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Różn | ciąg | Różnice, które mają być stosowane. | Yes | |
| ścieżka | ciąg | Ścieżka pliku do utworzenia. | Yes | |
| typ | wyliczenie | Utwórz nowy plik z podaną różnicą. Możliwe wartości: create_file |
Yes |
OpenAI.ApplyPatchCreateFileOperationParam
Instrukcja tworzenia nowego pliku za pomocą narzędzia apply_patch.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Różn | ciąg | Ujednolicona zawartość różnic do zastosowania podczas tworzenia pliku. Ograniczenia: maxLength: 10485760 |
Yes | |
| ścieżka | ciąg | Ścieżka pliku do utworzenia względem katalogu głównego obszaru roboczego. Ograniczenia: minLength: 1 |
Yes | |
| typ | wyliczenie | Typ operacji. Zawsze create_file.Możliwe wartości: create_file |
Yes |
OpenAI.ApplyPatchDeleteFileOperation
Instrukcja opisująca sposób usuwania pliku za pośrednictwem narzędzia apply_patch.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| ścieżka | ciąg | Ścieżka pliku do usunięcia. | Yes | |
| typ | wyliczenie | Usuń określony plik. Możliwe wartości: delete_file |
Yes |
OpenAI.ApplyPatchDeleteFileOperationParam
Instrukcja usuwania istniejącego pliku za pośrednictwem narzędzia apply_patch.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| ścieżka | ciąg | Ścieżka pliku do usunięcia względem katalogu głównego obszaru roboczego. Ograniczenia: minLength: 1 |
Yes | |
| typ | wyliczenie | Typ operacji. Zawsze delete_file.Możliwe wartości: delete_file |
Yes |
OpenAI.ApplyPatchFileOperation
Jedną z operacji create_file, delete_file lub update_file stosowanych za pośrednictwem apply_patch.
Dyskryminujące dla openAI.ApplyPatchFileOperation
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
create_file |
OpenAI.ApplyPatchCreateFileOperation |
delete_file |
OpenAI.ApplyPatchDeleteFileOperation |
update_file |
OpenAI.ApplyPatchUpdateFileOperation |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ApplyPatchFileOperationType | Yes |
OpenAI.ApplyPatchFileOperationType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | create_filedelete_fileupdate_file |
OpenAI.ApplyPatchOperationParam
Jeden z create_file, delete_file lub update_file operacji dostarczonych do narzędzia apply_patch.
Dyskryminujące dla openAI.ApplyPatchOperationParam
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
create_file |
OpenAI.ApplyPatchCreateFileOperationParam |
delete_file |
OpenAI.ApplyPatchDeleteFileOperationParam |
update_file |
OpenAI.ApplyPatchUpdateFileOperationParam |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ApplyPatchOperationParamType | Yes |
OpenAI.ApplyPatchOperationParamType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | create_filedelete_fileupdate_file |
OpenAI.ApplyPatchToolParam
Umożliwia asystentowi tworzenie, usuwanie lub aktualizowanie plików przy użyciu ujednoliconych różnic.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ narzędzia. Zawsze apply_patch.Możliwe wartości: apply_patch |
Yes |
OpenAI.ApplyPatchUpdateFileOperation
Instrukcja opisująca sposób aktualizowania pliku za pomocą narzędzia apply_patch.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Różn | ciąg | Różnice, które mają być stosowane. | Yes | |
| ścieżka | ciąg | Ścieżka pliku do aktualizacji. | Yes | |
| typ | wyliczenie | Zaktualizuj istniejący plik przy użyciu podanej różnicy. Możliwe wartości: update_file |
Yes |
OpenAI.ApplyPatchUpdateFileOperationParam
Instrukcja aktualizowania istniejącego pliku za pomocą narzędzia apply_patch.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Różn | ciąg | Ujednolicona zawartość różnicowa, która ma być stosowana do istniejącego pliku. Ograniczenia: maxLength: 10485760 |
Yes | |
| ścieżka | ciąg | Ścieżka pliku do aktualizacji względem katalogu głównego obszaru roboczego. Ograniczenia: minLength: 1 |
Yes | |
| typ | wyliczenie | Typ operacji. Zawsze update_file.Możliwe wartości: update_file |
Yes |
OpenAI.PrzybliżonaLokalizacja
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Miasta | ciąg (dopuszczany do wartości null) | Nie. | ||
| kraj | ciąg (dopuszczany do wartości null) | Nie. | ||
| region | ciąg (dopuszczany do wartości null) | Nie. | ||
| timezone | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ przybliżenia lokalizacji. Zawsze approximate.Możliwe wartości: approximate |
Yes |
OpenAI.ChatCompletionTool
Narzędzie funkcji, które może służyć do generowania odpowiedzi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| funkcja | OpenAI.FunctionObject | Yes | ||
| typ | wyliczenie | Typ narzędzia. Obecnie obsługiwany jest tylko function.Możliwe wartości: function |
Yes |
OpenAI.ChatModel
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | leftrightwheelbackforward |
OpenAI.ClickParam
Akcja kliknięcia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| przycisk | OpenAI.ClickButtonType | Yes | ||
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji kliknięcia ta właściwość jest zawsze click.Możliwe wartości: click |
Yes | |
| x | OpenAI.integer | Yes | ||
| y | OpenAI.integer | Yes |
OpenAI.CodeInterpreterContainerAuto
Konfiguracja kontenera interpretera kodu. Opcjonalnie określ identyfikatory plików do uruchomienia kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| identyfikatory_plików | tablica ciągów | Opcjonalna lista przesłanych plików, które mają być dostępne w Twoim kodzie. | Nie. | |
| limit_pamięci | OpenAI.ContainerMemoryLimit (dopuszczana do wartości null) | Nie. | ||
| typ | wyliczenie | Zawsze auto.Możliwe wartości: auto |
Yes |
OpenAI.CodeInterpreterOutputImage
Wynik obrazowy z interpretera kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ danych wyjściowych. Zawsze image.Możliwe wartości: image |
Yes | |
| url | ciąg | Adres URL wyjścia obrazu z interpretera kodu. | Yes |
OpenAI.CodeInterpreterOutputLogs
Dane wyjściowe dzienników z interpretera kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dzienniki | ciąg | Dane wyjściowe dzienników z interpretera kodu. | Yes | |
| typ | wyliczenie | Typ danych wyjściowych. Zawsze logs.Możliwe wartości: logs |
Yes |
OpenAI.CodeInterpreterTool
Narzędzie, które uruchamia kod języka Python, aby pomóc wygenerować odpowiedź na monit.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kontener | string lub OpenAI.CodeInterpreterContainerAuto | Kontener interpretera kodu. Może być identyfikatorem kontenera lub obiektem, który określa przekazane identyfikatory plików, aby udostępnić kod wraz z opcjonalne memory_limit ustawienie.Jeśli nie zostanie podana, usługa zakłada automatyczne użycie. |
Nie. | |
| typ | wyliczenie | Typ narzędzia interpretera kodu. Zawsze code_interpreter.Możliwe wartości: code_interpreter |
Yes |
OpenAI.CompactResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) podczas tworzenia skompaktowanej konwersacji. | Yes | |
| id | ciąg | Unikatowy identyfikator skompaktowanej odpowiedzi. | Yes | |
| obiekt | wyliczenie | Typ obiektu. Zawsze response.compaction.Możliwe wartości: response.compaction |
Yes | |
| We/Wy | tablica openAI.OutputItem | Kompaktowana lista elementów wyjściowych. Jest to lista wszystkich komunikatów użytkownika, po których następuje pojedynczy element kompaktowania. | Yes | |
| użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Yes | |
| └input_tokens | OpenAI.integer | Liczba tokenów wejściowych. | Yes | |
| └input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Szczegółowy podział tokenów wejściowych. | Yes | |
| └─ tokeny_wyjściowe | OpenAI.integer | Liczba tokenów wyjściowych. | Yes | |
| └output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Szczegółowy podział tokenów wyjściowych. | Yes | |
| └total_tokens | OpenAI.integer | Całkowita liczba użytych tokenów. | Yes |
OpenAI.CompactResponseMethodPublicBody
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | ciąg lub tablica elementu OpenAI.InputItem | Nie. | ||
| instructions | ciąg (dopuszczany do wartości null) | Nie. | ||
| model | OpenAI.ModelIdsCompaction | Identyfikator modelu używany do generowania odpowiedzi, na przykład gpt-5 lub o3. Platforma OpenAI oferuje szeroką gamę modeli z różnymi możliwościami, charakterystykami wydajności i punktami cenowymi. Zapoznaj się z przewodnikiem po modelu , aby przeglądać i porównywać dostępne modele. |
Yes | |
| previous_response_id | ciąg (dopuszczany do wartości null) | Nie. |
OpenAI.ComparisonFilter
Filtr używany do porównywania określonego klucza atrybutu z daną wartością przy użyciu zdefiniowanej operacji porównania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| klucz | ciąg | Klucz do porównania z wartością. | Yes | |
| typ | wyliczenie | Określa operator porównania: eq, , negt, gte, lt, lte, in, . nin- eq:Equals- ne: nie równa się- gt: większe niż- gte: większe niż lub równe- lt: mniejsze niż- lte: mniejsze niż lub równe- in:Cala- nin: nie wMożliwe wartości: eq, , negt, gte, , ltlte |
Yes | |
| value | ciąg lub openAI.numeric lub wartość logiczna lub tablica openAI.ComparisonFilterValueItems | Wartość do porównania z kluczem atrybutu; obsługuje typy ciągów, liczb lub wartości logicznych. | Yes |
OpenAI.ComparisonFilterValueItems
Typ: ciąg lub OpenAI.numeric
OpenAI.CompoundFilter
Połącz wiele filtrów przy użyciu polecenia and lub or.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| filters | tablica obiektów OpenAI.ComparisonFilter lub | Tablica filtrów do połączenia. Elementy mogą mieć wartość ComparisonFilter lub CompoundFilter. |
Yes | |
| typ | wyliczenie | Typ operacji: and lub or.Możliwe wartości: and, or |
Yes |
OpenAI.ComputerAction
Dyskryminujące dla openAI.ComputerAction
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
click |
OpenAI.ClickParam |
double_click |
OpenAI.DoubleClickAction |
drag |
OpenAI.Drag |
keypress |
OpenAI.KeyPressAction |
move |
OpenAI.Move |
screenshot |
OpenAI.Zrzut ekranu |
scroll |
OpenAI.Scroll |
type |
OpenAI.Type |
wait |
OpenAI.Wait |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ComputerActionType | Yes |
OpenAI.ComputerActionType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | clickdouble_clickdragkeypressmovescreenshotscrolltypewait |
OpenAI.ComputerCallSafetyCheckParam
Zaplanowana kontrola bezpieczeństwa dla komputerowego wezwania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Identyfikator oczekującego sprawdzenia bezpieczeństwa. | Yes | |
| komunikat | ciąg (dopuszczany do wartości null) | Nie. |
OpenAI.ComputerŚrodowisko
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | windowsmaclinuxubuntubrowser |
OpenAI.ComputerScreenshotContent
Zrzut ekranu przedstawiający komputer.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Yes | ||
| image_url | ciąg | Yes | ||
| typ | wyliczenie | Określa typ zdarzenia. W przypadku zrzutu ekranu komputera ta właściwość jest zawsze ustawiona na computer_screenshot.Możliwe wartości: computer_screenshot |
Yes |
OpenAI.ComputerScreenshotImage
Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Identyfikator przekazanego pliku zawierającego zrzut ekranu. | Nie. | |
| image_url | ciąg | Adres URL obrazu zrzutu ekranu. | Nie. | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku zrzutu ekranu komputera ta właściwość to zawsze ustawiony na computer_screenshot.Możliwe wartości: computer_screenshot |
Yes |
OpenAI.NarzędziePodgląduUżytkowaniaKomputera
Narzędzie kontrolujące komputer wirtualny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wysokość ekranu | OpenAI.integer | Yes | ||
| szerokość_wyświetlacza | OpenAI.integer | Yes | ||
| środowisko | OpenAI.ComputerŚrodowisko | Yes | ||
| typ | wyliczenie | Typ narzędzia do użycia komputera. Zawsze computer_use_preview.Możliwe wartości: computer_use_preview |
Yes |
OpenAI.ContainerFileCitationBody
Cytat dla pliku kontenera używanego do generowania odpowiedzi modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| container_id | ciąg | Identyfikator pliku kontenera. | Yes | |
| end_index | OpenAI.integer | Yes | ||
| identyfikator_pliku | ciąg | Identyfikator pliku. | Yes | |
| filename | ciąg | Nazwa pliku kontenera przytoczony. | Yes | |
| start_index | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ cytatu pliku kontenera. Zawsze container_file_citation.Możliwe wartości: container_file_citation |
Yes |
OpenAI.ContainerMemoryLimit
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 1g4g16g64g |
OpenAI.ConversationItem
Pojedynczy element w konwersacji. Zestaw możliwych typów jest taki sam jak output typ obiektu Response.
Dyskryminujące dla openAI.ConversationItem
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ConversationItemType | Yes |
OpenAI.ConversationItemApplyPatchToolCall
Wywołanie narzędzia, które stosuje różnice plików przez tworzenie, usuwanie lub aktualizowanie plików.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to wywołanie narzędzia. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| operacja | OpenAI.ApplyPatchFileOperation | Jedną z operacji create_file, delete_file lub update_file stosowanych za pośrednictwem apply_patch. | Yes | |
| └typ | OpenAI.ApplyPatchFileOperationType | Yes | ||
| stan | OpenAI.ApplyPatchCallStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call.Możliwe wartości: apply_patch_call |
Yes |
OpenAI.ConversationItemApplyPatchToolCallOutput
Dane wyjściowe emitowane przez wywołanie narzędzia zastosuj poprawkę.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to narzędzie, wywołuje dane wyjściowe. | Nie. | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania narzędzia stosowania poprawek. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| stan | OpenAI.ApplyPatchCallOutputStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call_output.Możliwe wartości: apply_patch_call_output |
Yes |
OpenAI.ConversationItemCodeInterpreterToolCall
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia interpretera kodu. | Yes | |
| outputs | tablica obiektów OpenAI.CodeInterpreterOutputLogs lub OpenAI.CodeInterpreterOutputImage | Yes | ||
| stan | wyliczenie | Stan wywołania narzędzia interpretera kodu. Prawidłowe wartości to in_progress, , completedincomplete, interpreting, i failed.Możliwe wartości: in_progress, , completedincomplete, , interpretingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia interpretera kodu. Zawsze code_interpreter_call.Możliwe wartości: code_interpreter_call |
Yes |
OpenAI.ConversationItemComputerToolCall
Narzędzie wywołujące narzędzie do korzystania z komputera. Aby uzyskać więcej informacji, zobacz przewodnik dotyczący korzystania z komputera .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Yes | ||
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania komputera. | Yes | |
| pending_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ wywołania komputera. Zawsze computer_call.Możliwe wartości: computer_call |
Yes |
OpenAI.ConversationItemComputerToolCallOutputResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| acknowledged_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Kontrole bezpieczeństwa, które zgłoszono za pomocą interfejsu API i zostały potwierdzone przez wywoływacz. |
Nie. | |
| call_id | ciąg | Identyfikator wywołania narzędzia komputerowego, które wygenerowało dane wyjściowe. | Yes | |
| id | ciąg | Identyfikator wyniku wywołania komputerowego narzędzia. | Nie. | |
| We/Wy | OpenAI.ComputerScreenshotImage | Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera. | Yes | |
| stan | wyliczenie | Stan danych wejściowych komunikatu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy wejściowe są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia komputerowego. Zawsze computer_call_output.Możliwe wartości: computer_call_output |
Yes |
OpenAI.ConversationItemCustomToolCall
Wywołanie niestandardowego narzędzia utworzonego przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Identyfikator używany do mapowania tego niestandardowego wywołania narzędzia na dane wyjściowe wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator niestandardowego wywołania narzędzia na platformie OpenAI. | Nie. | |
| dane wejściowe | ciąg | Dane wejściowe dla niestandardowego wywołania narzędzia wygenerowanego przez model. | Yes | |
| nazwa | ciąg | Nazwa wywoływanego narzędzia niestandardowego. | Yes | |
| typ | wyliczenie | Typ niestandardowego wywołania narzędzia. Zawsze custom_tool_call.Możliwe wartości: custom_tool_call |
Yes |
OpenAI.ConversationItemCustomToolCallOutput
Dane wyjściowe niestandardowego wywołania narzędzia z kodu wysyłanego z powrotem do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Identyfikator wywołania używany do mapowania tego niestandardowego narzędzia wywołania danych wyjściowych do niestandardowego wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania niestandardowego narzędzia na platformie OpenAI. | Nie. | |
| We/Wy | ciąg lub tablica obiektu OpenAI.FunctionAndCustomToolCallOutput | Dane wyjściowe z wywołania niestandardowego narzędzia wygenerowanego przez kod. Może być ciągiem lub listą zawartości wyjściowej. |
Yes | |
| typ | wyliczenie | Typ danych wyjściowych wywołania niestandardowego narzędzia. Zawsze custom_tool_call_output.Możliwe wartości: custom_tool_call_output |
Yes |
OpenAI.ConversationItemFileSearchToolCall
Wyniki wywołania narzędzia wyszukiwania plików. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania plików .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania plików. | Yes | |
| queries | tablica ciągów | Zapytania używane do wyszukiwania plików. | Yes | |
| results | tablica obiektów OpenAI.FileSearchToolCallResults | Nie. | ||
| stan | wyliczenie | Stan wywołania narzędzia do wyszukiwania plików. Jeden z in_progresssearching, lub incomplete, failedMożliwe wartości: in_progress, , searchingcompleted, , incompletefailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania plików. Zawsze file_search_call.Możliwe wartości: file_search_call |
Yes |
OpenAI.ConversationItemFunctionShellCall
Wywołanie narzędzia, które wykonuje co najmniej jedno polecenie powłoki w środowisku zarządzanym.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.FunctionShellAction | Wykonaj polecenie powłoki. | Yes | |
| Polecenia └* | tablica ciągów | Yes | ||
| └max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| └timeout_ms | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to wywołanie narzędzia. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| stan | OpenAI.LocalShellCallStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze shell_call.Możliwe wartości: shell_call |
Yes |
OpenAI.ConversationItemFunctionShellCallOutput
Dane wyjściowe wywołania narzędzia powłoki, które zostało wyemitowane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator aktora, który utworzył element. | Nie. | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania powłoki. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| We/Wy | tablica elementów OpenAI.FunctionShellCallOutputContent | Tablica zawartości danych wyjściowych wywołań powłoki | Yes | |
| typ | wyliczenie | Typ danych wyjściowych wywołania powłoki. Zawsze shell_call_output.Możliwe wartości: shell_call_output |
Yes |
OpenAI.ConversationItemFunctionToolCallOutputResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania narzędzia funkcji. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. |
Nie. | |
| We/Wy | ciąg lub tablica obiektu OpenAI.FunctionAndCustomToolCallOutput | Dane wyjściowe wywołania funkcji wygenerowanego przez kod. Może być ciągiem lub listą zawartości wyjściowej. |
Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia funkcji. Zawsze function_call_output.Możliwe wartości: function_call_output |
Yes |
OpenAI.ConversationItemFunctionToolCallResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia funkcjonalnego. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ wywołania funkcji narzędziowej. Zawsze function_call.Możliwe wartości: function_call |
Yes |
OpenAI.ConversationItemImageGenToolCall
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania generowania obrazu. | Yes | |
| result | ciąg (dopuszczany do wartości null) | Yes | ||
| stan | wyliczenie | Stan wywołania generowania obrazu. Możliwe wartości: in_progress, , completed, generatingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania generowania obrazu. Zawsze image_generation_call.Możliwe wartości: image_generation_call |
Yes |
OpenAI.ConversationItemList
Lista elementów konwersacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane | tablica openAI.ConversationItem | Lista elementów konwersacji. | Yes | |
| first_id | ciąg | Identyfikator pierwszego elementu na liście. | Yes | |
| zawiera_więcej | boolean | Czy dostępnych jest więcej elementów? | Yes | |
| last_id | ciąg | Identyfikator ostatniego elementu na liście. | Yes | |
| obiekt | wyliczenie | Zwracany typ obiektu musi mieć wartość list.Możliwe wartości: list |
Yes |
OpenAI.ConversationItemLocalShellToolCall
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator lokalnego wywołania powłoki. | Yes | |
| stan | wyliczenie | Stan lokalnego wywołania powłoki. Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ lokalnego wywołania powłoki. Zawsze local_shell_call.Możliwe wartości: local_shell_call |
Yes |
OpenAI.ConversationItemLocalShellToolCallOutput
Dane wyjściowe lokalnego wywołania narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| We/Wy | ciąg | Ciąg JSON reprezentujący dane wyjściowe z wywołania lokalnego narzędzia powłoki. | Yes | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ lokalnego narzędzia powłoki wywołuje dane wyjściowe. Zawsze local_shell_call_output.Możliwe wartości: local_shell_call_output |
Yes |
OpenAI.ConversationItemMcpApprovalRequest
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator żądania zatwierdzenia. | Yes | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_request.Możliwe wartości: mcp_approval_request |
Yes |
OpenAI.ConversationItemMcpApprovalResponseResource
Odpowiedź na żądanie zatwierdzenia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg | Identyfikator odpowiedzi na żądanie zatwierdzenia. | Yes | |
| approve | boolean | Czy żądanie zostało zatwierdzone. | Yes | |
| id | ciąg | Unikatowy identyfikator odpowiedzi zatwierdzenia | Yes | |
| powód | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_response.Możliwe wartości: mcp_approval_response |
Yes |
OpenAI.ConversationItemMcpListTools
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator listy. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Yes | |
| Narzędzia | tablica narzędzi OpenAI.MCPListToolsTools | Narzędzia dostępne na serwerze. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_list_tools.Możliwe wartości: mcp_list_tools |
Yes |
OpenAI.ConversationItemMcpToolCall
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Yes | |
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator wywołania narzędzia. | Yes | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Yes | |
| stan | OpenAI.MCPToolCallStatus | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_call.Możliwe wartości: mcp_call |
Yes |
OpenAI.ConversationItemMessage
Komunikat do lub z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica elementów OpenAI.MessageContent | Zawartość wiadomości | Yes | |
| id | ciąg | Unikatowy identyfikator wiadomości. | Yes | |
| rola | OpenAI.MessageRole | Yes | ||
| stan | OpenAI.MessageStatus | Yes | ||
| typ | wyliczenie | Typ komunikatu. Zawsze ustaw na message.Możliwe wartości: message |
Yes |
OpenAI.ConversationItemReasoningItem
Opis łańcucha myśli używanego przez model rozumowania podczas generowania odpowiedzi. Pamiętaj, aby uwzględnić te elementy w input interfejsie API odpowiedzi na kolejne etapy konwersacji, jeśli ręcznie zarządzasz kontekstem.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica obiektu OpenAI.ReasoningTextContent | Wnioskowanie zawartości tekstowej. | Nie. | |
| encrypted_content | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator zawartości rozumowania. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| podsumowanie | tablica interfejsu OpenAI.Summary | Rozumowanie zawartości podsumowania. | Yes | |
| typ | wyliczenie | Typ obiektu. Zawsze reasoning.Możliwe wartości: reasoning |
Yes |
OpenAI.ConversationItemType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Wyniki wywołania narzędzia wyszukiwania w Internecie. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania w Internecie .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.WebSearchActionSearch lub OpenAI.WebSearchActionOpenPage lub OpenAI.WebSearchActionFind | Obiekt opisujący określoną akcję podjętą w tym wywołaniu wyszukiwania w sieci Web. Zawiera szczegółowe informacje na temat sposobu użycia modelu w Internecie (wyszukiwanie, open_page, znajdowanie). |
Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania w Internecie. | Yes | |
| stan | wyliczenie | Stan działania wyszukiwarki internetowej. Możliwe wartości: in_progress, , searching, completedfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania w Internecie. Zawsze web_search_call.Możliwe wartości: web_search_call |
Yes |
OpenAI.ConversationParam
Konwersacja, do którego należy ta odpowiedź. Elementy z tej konwersacji są poprzedzane input_items dla tego żądania odpowiedzi.
Elementy wejściowe i elementy wyjściowe z tej odpowiedzi są automatycznie dodawane do tej konwersacji po zakończeniu tej odpowiedzi.
Typ: ciąg lub OpenAI.ConversationParam-2
Konwersacja, do którego należy ta odpowiedź. Elementy z tej konwersacji są poprzedzane input_items dla tego żądania odpowiedzi.
Elementy wejściowe i elementy wyjściowe z tej odpowiedzi są automatycznie dodawane do tej konwersacji po zakończeniu tej odpowiedzi.
OpenAI.ConversationParam-2
Konwersacja, do którego należy ta odpowiedź.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator konwersacji. | Yes |
OpenAI.ConversationReference
Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator konwersacji, z którą została skojarzona ta odpowiedź. | Yes |
OpenAI.ConversationResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Czas, w którym konwersacja została utworzona, mierzona w sekundach od epoki systemu Unix. | Yes | |
| id | ciąg | Unikatowy identyfikator konwersacji. | Yes | |
| metadane | OpenAI.Metadata | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Yes | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze conversation.Możliwe wartości: conversation |
Yes |
OpenAI.CreateChatCompletionRequestResponseFormat
Obiekt określający format, który musi zostać wygenerowany przez model.
Ustawienie w celu { "type": "json_schema", "json_schema": {...} } włączenia danych wyjściowych ze strukturą, co gwarantuje, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej w przewodniku dotyczącym Strukturalnych danych wyjściowych.
Włączenie trybu { "type": "json_object" } aktywuje starszy tryb JSON, co gwarantuje, że komunikat generowany przez model jest prawidłowym kodem JSON. Użycie json_schema jest preferowane w przypadku modeli, które go obsługują.
Dyskryminujący format OpenAI.CreateChatCompletionRequestResponseFormat
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
text |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatText |
json_object |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatJsonObject |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.CreateChatCompletionRequestResponseFormatType | Yes |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatJsonObject
Format odpowiedzi obiektu JSON. Starsza metoda generowania odpowiedzi JSON.
Użycie json_schema jest zalecane w przypadku modeli, które go obsługują. Należy pamiętać, że model nie wygeneruje kodu JSON bez komunikatu systemu lub użytkownika z instrukcjami, aby to zrobił.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_object.Możliwe wartości: json_object |
Yes |
OpenAI.CreateChatCompletionRequestResponseFormatResponseFormatText
Domyślny format odpowiedzi. Służy do generowania odpowiedzi tekstowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze text.Możliwe wartości: text |
Yes |
OpenAI.CreateChatCompletionRequestResponseFormatType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | textjson_schemajson_object |
OpenAI.CreateConversationBody
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| items | tablica openAI.InputItem | Nie. | ||
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. |
OpenAI.CreateEvalCompletionsRunDataSource
Obiekt CompletionsRunDataSource opisujący konfigurację próbkowania modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wiadomości wejściowe | OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesTemplate lub OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference | Używane podczas próbkowania z modelu. Określa strukturę komunikatów przekazywanych do modelu. Może być odwołaniem do wstępnie utworzonej trajektorii (tj item.input_trajectory. ) lub szablonu ze zmiennymi odwołaniami do item przestrzeni nazw. |
Nie. | |
| model | ciąg | Nazwa modelu, który ma być użyty do generowania uzupełnień (np. "o3-mini"). | Nie. | |
| parametry_próbowania | OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams | Nie. | ||
| przesłać źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource lub OpenAI.EvalStoredCompletionsSource | Określa, co wypełnia item przestrzeń nazw w źródle danych tego przebiegu. |
Yes | |
| typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze completions.Możliwe wartości: completions |
Yes |
OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_reference | ciąg | Yes | ||
| typ | wyliczenie | Możliwe wartości: item_reference |
Yes |
OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesTemplate
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| szablon | tablica openAI.EasyInputMessage lub OpenAI.EvalItem | Yes | ||
| typ | wyliczenie | Możliwe wartości: template |
Yes |
OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_completion_tokens | OpenAI.integer | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| format_odpowiedzi | OpenAI.ResponseFormatText lub OpenAI.ResponseFormatJsonSchema lub OpenAI.ResponseFormatJsonObject | Nie. | ||
| seed | OpenAI.integer | Nie. | 42 | |
| temperatura | OpenAI.numeric | Nie. | 1 | |
| Narzędzia | tablica narzędzi OpenAI.ChatCompletionTool | Nie. | ||
| top_p | OpenAI.numeric | Nie. | 1 |
OpenAI.CreateEvalCustomDataSourceConfig
Obiekt CustomDataSourceConfig, który definiuje schemat źródła danych używanego do przeprowadzania serii ocen. Ten schemat służy do definiowania kształtu danych, które będą następujące:
- Służy do definiowania kryteriów testowania i
- Jakie dane są wymagane podczas tworzenia przebiegu
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| uwzględnij_przykładowy_schemat | boolean | Czy podczas oceny należy oczekiwać wypełnienia przykładowej przestrzeni nazw (tj. przez generowanie odpowiedzi ze źródła danych) | Nie. | |
| item_schema | obiekt | Schemat JSON dla każdego wiersza w źródle danych. | Yes | |
| typ | wyliczenie | Typ źródła danych. Zawsze custom.Możliwe wartości: custom |
Yes |
OpenAI.CreateEvalJsonlRunDataSource
Obiekt JsonlRunDataSource, który określa plik JSONL odpowiadający ewaluacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| przesłać źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource | Określa, co wypełnia item przestrzeń nazw w źródle danych. |
Yes | |
| typ | wyliczenie | Typ źródła danych. Zawsze jsonl.Możliwe wartości: jsonl |
Yes |
OpenAI.CreateEvalLogsDataSourceConfig
Konfiguracja źródła danych określająca właściwość metadanych zapytania dotyczącego dzienników.
Zazwyczaj są to metadane, takie jak usecase=chatbot lub prompt-version=v2, itp.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metadane | obiekt | Filtry metadanych dla źródła danych dzienników. | Nie. | |
| typ | wyliczenie | Typ źródła danych. Zawsze logs.Możliwe wartości: logs |
Yes |
OpenAI.CreateEvalResponsesRunDataSource
Obiekt ResponsesRunDataSource opisujący konfigurację próbkowania modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wiadomości wejściowe | OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate lub OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference | Używane podczas próbkowania z modelu. Określa strukturę komunikatów przekazywanych do modelu. Może być odwołaniem do wstępnie utworzonej trajektorii (tj item.input_trajectory. ) lub szablonu ze zmiennymi odwołaniami do item przestrzeni nazw. |
Nie. | |
| model | ciąg | Nazwa modelu, który ma być użyty do generowania uzupełnień (np. "o3-mini"). | Nie. | |
| parametry_próbowania | OpenAI.CreateEvalResponsesRunDataSourceSamplingParams | Nie. | ||
| przesłać źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource lub OpenAI.EvalResponsesSource | Określa, co wypełnia item przestrzeń nazw w źródle danych tego przebiegu. |
Yes | |
| typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze responses.Możliwe wartości: responses |
Yes |
OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_reference | ciąg | Yes | ||
| typ | wyliczenie | Możliwe wartości: item_reference |
Yes |
OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| szablon | tablica obiektów lub OpenAI.EvalItem | Yes | ||
| typ | wyliczenie | Możliwe wartości: template |
Yes |
OpenAI.CreateEvalResponsesRunDataSourceSamplingParams
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_completion_tokens | OpenAI.integer | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| seed | OpenAI.integer | Nie. | 42 | |
| temperatura | OpenAI.numeric | Nie. | 1 | |
| SMS | OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText | Nie. | ||
| Narzędzia | tablica narzędzi OpenAI.Tool | Nie. | ||
| top_p | OpenAI.numeric | Nie. | 1 |
OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Obiekt określający format, który musi zostać wygenerowany przez model. Konfigurowanie { "type": "json_schema" } włącza dane wyjściowe o strukturze.zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej na tej witrynie Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.*Niezalecane w przypadku modeli gpt-4o i nowszych:** Ustawienie { "type": "json_object" } włącza starszy tryb JSON, którygwarantuje, że komunikat generowany przez model jest prawidłowym kodem JSON. Korzystanie z json_schemajest preferowany w przypadku modeli, które go obsługują. |
Nie. |
OpenAI.CreateEvalStoredCompletionsDataSourceConfig
Zdezaktualizowane na rzecz LogsDataSourceConfig.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metadane | obiekt | Filtry metadanych dla przechowywanego źródła danych uzupełniania. | Nie. | |
| typ | wyliczenie | Typ źródła danych. Zawsze stored_completions.Możliwe wartości: stored_completions |
Yes |
OpenAI.CreateFineTuningJobRequest
Prawidłowe modele:
babbage-002
davinci-002
gpt-3.5-turbo
gpt-4o-mini
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| hiperparametry | OpenAI.CreateFineTuningJobRequestHyperparameters | Nie. | ||
| └batch_size | string lub OpenAI.integer | Nie. | samochód | |
| └ learning_rate_multiplier | string lub OpenAI.numeric | Nie. | ||
| └n_epochs | string lub OpenAI.integer | Nie. | samochód | |
| Integracje | tablica obiektów OpenAI.CreateFineTuningJobRequestIntegrations | Lista integracji umożliwiających dostrajanie zadania. | Nie. | |
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| metoda | OpenAI.FineTuneMethod | Metoda używana do dostrajania. | Nie. | |
| model | ciąg (zobacz prawidłowe modele poniżej) | Nazwa modelu do dostosowania. Możesz wybrać jedną z opcji obsługiwane modele. |
Yes | |
| seed | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Sufiks | ciąg (dopuszczany do wartości null) | Ciąg składający się z maksymalnie 64 znaków, które zostaną dodane do nazwy dostrojonego modelu. Na przykład wartość suffix "custom-model-name" spowoduje wygenerowanie nazwy modelu, takiej jak ft:gpt-4o-mini:openai:custom-model-name:7p4lURel.Ograniczenia: minLength: 1, maxLength: 64 |
Nie. | |
| plik szkoleniowy | ciąg | Identyfikator przekazanego pliku zawierającego dane szkoleniowe. Zobacz przekazywanie pliku , aby dowiedzieć się, jak przekazać plik. Zestaw danych musi być sformatowany jako plik JSONL. Ponadto należy wgrać swój plik w celu fine-tune.Zawartość pliku powinna się różnić w zależności od tego, czy model używa formatu czatu, uzupełniania lub czy metoda dostrajania dokładnego używa formatu preferencji . Aby uzyskać więcej informacji, zobacz przewodnik dostosowywania . |
Yes | |
| plik walidacji | ciąg (dopuszczany do wartości null) | Identyfikator przekazanego pliku zawierającego dane walidacji. Jeśli podasz ten plik, dane są używane do generowania walidacji Metryki są oceniane okresowo podczas dostrajania. Metryki można wyświetlić w plik wyników fine-tuningu. Te same dane nie powinny być obecne zarówno w plikach trenowania, jak i walidacji. Zestaw danych musi być sformatowany jako plik JSONL. Musisz przekazać plik z celem fine-tune.Aby uzyskać więcej informacji, zobacz przewodnik dostosowywania . |
Nie. |
OpenAI.CreateFineTuningJobRequestHyperparameters
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rozmiar partii | string lub OpenAI.integer | Nie. | ||
| mnożnik szybkości uczenia | string lub OpenAI.numeric | Nie. | ||
| n_epochs (liczba epok) | string lub OpenAI.integer | Nie. |
OpenAI.CreateFineTuningJobRequestIntegrations
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: wandb |
Yes | |
| wandb | OpenAI.CreateFineTuningJobRequestIntegrationsWandb | Yes |
OpenAI.CreateFineTuningJobRequestIntegrationsWandb
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| jednostka | ciąg (dopuszczany do wartości null) | Nie. | ||
| nazwa | ciąg (dopuszczany do wartości null) | Nie. | ||
| projekt | ciąg | Yes | ||
| tags | tablica ciągów | Nie. |
OpenAI.CreateResponseStreamingResponse
Typ: OpenAI.ResponseAudioDeltaEvent lub OpenAI.ResponseAudioTranscriptDeltaEvent lub OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent lub OpenAI.ResponseCodeInterpreterCallInProgressEvent lub OpenAI.ResponseCodeInterpreterCallInterpretingEvent lub OpenAI.ResponseContentPartAddedEvent lub OpenAI.ResponseCreatedEvent lub OpenAI.ResponseCreatedEvent lub OpenAI.ResponseErrorEvent lub OpenAI.ResponseErrorEvent lub OpenAI.ResponseErrorEventlub OpenAI.OpenAI.ResponseFileSearchCallInProgressEvent lub OpenAI.ResponseFileSearchCallSearchingEvent lub OpenAI.ResponseFunctionCallArgumentsDeltaEvent lub OpenAI.ResponseInProgressEvent lub OpenAI.ResponseFailedEvent lub OpenAI.ResponseIncompleteEvent lub OpenAI.ResponseOutputItemAddedEvent lub OpenAI.ResponseReasoningSummaryPartAddedEvent lub OpenAI.ResponseReasoningSummaryTextDeltaEvent lub OpenAI.ResponseReasoningTextDeltaEvent lub OpenAI.ResponseRefusalDeltaEvent lub OpenAI.ResponseTextDeltaEvent lub OpenAI.ResponseWebSearchCallInProgressEvent lub OpenAI.ResponseWebSearchInProgressEvent lub OpenAI.ResponseWebSearchingEvent lub OpenAI.ResponseImageGenCallGeneratingEvent lub OpenAI.ResponseImageGenCallInProgressEvent lub OpenAI.ResponseImageGenCallPartialImageEvent lub OpenAI.ResponseMCPCallArgumentsDeltaEvent lub OpenAI.ResponseMCPCallFailedEvent lub OpenAI.ResponseMCPCallInProgressEvent lub OpenAI.ResponseMCPListToolsFailedEvent lub OpenAI.ResponseMCPListToolsInProgressEvent lub OpenAI.ResponseOutputTextAnnotationAddedEvent lub OpenAI.ResponseQueuedEvent lub OpenAI.ResponseCustomToolCallInputDeltaEvent lub OpenAI.ResponseAudioDoneEvent lub OpenAIOpenAI.ResponseAudioTranscriptDoneEvent lub OpenAI.ResponseCodeInterpreterCallCodeDoneEvent lub OpenAI.ResponseCodeInterpreterCallCompletedEvent lub OpenAI.ResponseCompletedEvent lub OpenAI.ResponseCompletedEvent lub OpenAI.ResponseContentPartDoneEvent lub OpenAI.ResponseFileSearchCallCompletedEvent lub OpenAI.ResponseFunctionCallArgumentsDoneEvent lub OpenAI.ResponseOutputItemDoneEvent lub OpenAI.ResponseReasoningSummaryPartDoneEvent lub OpenAI.ResponseReasoningSummaryTextDoneEvent lub OpenAI.ResponseReasoningTextDoneEvent lub OpenAI.ResponseRefusalDoneEvent lub OpenAAI.ResponseTextDoneEvent lub OpenAI.ResponseWebSearchCompletedEvent lub OpenAI.ResponseImageGenCallCompletedEvent lub OpenAI.ResponseMCPCallArgumentsDoneEvent lub OpenAI.ResponseMCPCallCompletedEvent lub OpenAI.ResponseMCPListToolsCompletedEvent lub OpenAI.ResponseCustomToolCallInputDoneEvent
OpenAI.CustomGrammarFormatParam
Gramatyka zdefiniowana przez użytkownika.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | ciąg | Definicja gramatyki. | Yes | |
| Składni | OpenAI.GrammarSyntax1 | Yes | ||
| typ | wyliczenie | Format gramatyki. Zawsze grammar.Możliwe wartości: grammar |
Yes |
OpenAI.CustomTextFormatParam
Nieprzeciętny tekst bez ograniczeń.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Format tekstu bez ograniczeń. Zawsze text.Możliwe wartości: text |
Yes |
OpenAI.CustomToolParam
Niestandardowe narzędzie, które przetwarza dane wejściowe przy użyciu określonego formatu. Dowiedz się więcej o narzędziach niestandardowych
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opcjonalny opis narzędzia niestandardowego używany do udostępniania większej liczby kontekstów. | Nie. | |
| format | OpenAI.CustomToolParamFormat | Format danych wejściowych dla narzędzia niestandardowego. Wartość domyślna to nieprzeciętny tekst. | Nie. | |
| └typ | OpenAI.CustomToolParamFormatType | Yes | ||
| nazwa | ciąg | Nazwa narzędzia niestandardowego używana do identyfikowania go w wywołaniach narzędzi. | Yes | |
| typ | wyliczenie | Typ narzędzia niestandardowego. Zawsze custom.Możliwe wartości: custom |
Yes |
OpenAI.CustomToolParamFormat
Format danych wejściowych dla narzędzia niestandardowego. Wartość domyślna to nieprzeciętny tekst.
Dyskryminujący format OpenAI.CustomToolParamFormat
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
text |
OpenAI.CustomTextFormatParam |
grammar |
OpenAI.CustomGrammarFormatParam |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.CustomToolParamFormatType | Yes |
OpenAI.CustomToolParamFormatType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | textgrammar |
OpenAI.DeletedConversationResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| usunięta | boolean | Yes | ||
| id | ciąg | Yes | ||
| obiekt | wyliczenie | Możliwe wartości: conversation.deleted |
Yes |
OpenAI.DetailEnum
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | lowhighauto |
OpenAI.DoubleClickAction
Dwukrotne kliknięcie myszy.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji dwukrotnego kliknięcia ta właściwość jest zawsze ustawiana jako double_click.Możliwe wartości: double_click |
Yes | |
| x | OpenAI.integer | Yes | ||
| y | OpenAI.integer | Yes |
OpenAI.Drag
Czynność przeciągania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| ścieżka | tablica openAI.DragPoint | Tablica współrzędnych reprezentujących ścieżkę operacji przeciągania. Współrzędne będą wyświetlane jako tablica obiektów, np. <br> [<br> { x: 100, y: 200 },<br> { x: 200, y: 300 }<br> ]<br> |
Yes | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji przeciągania ta właściwość to zawsze ustawiony na drag.Możliwe wartości: drag |
Yes |
OpenAI.DragPoint
Para współrzędnych x/y, np. { x: 100, y: 200 }.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| x | OpenAI.integer | Yes | ||
| y | OpenAI.integer | Yes |
OpenAI.EasyInputMessage
Wiadomość jako wejście do modelu z rolą wskazującą przestrzeganie hierarchii instrukcji. Instrukcje przypisane do roli developer lub system mają pierwszeństwo przed instrukcjami przypisanymi do roli user. Przyjmuje się, że komunikaty z rolą assistant zostały wygenerowane przez model w poprzednich interakcjach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | string lub OpenAI.InputMessageContentList | Tekst, obraz lub dane wejściowe audio w modelu używane do generowania odpowiedzi. Może również zawierać poprzednie odpowiedzi asystenta. |
Yes | |
| rola | wyliczenie | Rola wejścia komunikatu.
userJeden z, assistant, system lubdeveloper.Możliwe wartości: user, , assistant, systemdeveloper |
Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wejściowych komunikatu. Zawsze message.Możliwe wartości: message |
Yes |
OpenAI.Error
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dodatkoweInformacje | obiekt | Nie. | ||
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| debugInfo | obiekt | Nie. | ||
| details | tablica openAI.Error | Nie. | ||
| komunikat | ciąg | Yes | ||
| param | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | ciąg | Nie. |
OpenAI.EvalApiError
Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg | Kod błędu. | Yes | |
| komunikat | ciąg | Komunikat o błędzie. | Yes |
OpenAI.EvalGraderLabelModel
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | tablica openAI.EvalItem | Yes | ||
| labels | tablica ciągów | Etykiety do przypisania do każdego elementu w ocenie. | Yes | |
| model | ciąg | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| przechodzące_etykiety | tablica ciągów | Etykiety wskazujące wynik pozytywny. Musi być podzbiorem etykiet. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: label_model |
Yes |
OpenAI.EvalGraderPython
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| znacznik_obrazu | ciąg | Tag obrazu do użycia dla skryptu języka Python. | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| próg zaliczenia | OpenAI.numeric | Nie. | ||
| przesłać źródło | ciąg | Kod źródłowy skryptu języka Python. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze python.Możliwe wartości: python |
Yes |
OpenAI.EvalGraderScoreModel
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | tablica openAI.EvalItem | Komunikaty wejściowe oceniane przez klasykator. Obsługuje tekst, tekst wyjściowy, obraz wejściowy i wejściowe bloki zawartości audio i mogą zawierać ciągi szablonu. | Yes | |
| model | ciąg | Model do użycia do oceny. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| próg zaliczenia | OpenAI.numeric | Nie. | ||
| zakres | tablica openAI.numeric | Zakres wyniku Wartość domyślna to [0, 1]. |
Nie. | |
| parametry_próbowania | OpenAI.EvalGraderScoreModelSamplingParams | Nie. | ||
| └max_completions_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─ wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| └─ nasion | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| typ | wyliczenie | Typ obiektu, który jest zawsze score_model.Możliwe wartości: score_model |
Yes |
OpenAI.EvalGraderScoreModelSamplingParams
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| max_completions_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| seed | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | ||
| top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 |
OpenAI.EvalGraderStringCheck
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | ciąg | Tekst wejściowy. Może to obejmować ciągi szablonu. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| operacja | wyliczenie | Operacja sprawdzania ciągów, którą należy wykonać.
eqJeden z , ne, likelub ilike.Możliwe wartości: eq, , ne, likeilike |
Yes | |
| odwołanie | ciąg | Tekst odwołania. Może to obejmować ciągi szablonu. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze string_check.Możliwe wartości: string_check |
Yes |
OpenAI.EvalGraderTextSimilarity
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| miara oceny | wyliczenie | Metryka oceny do użycia. Jeden z cosine, , fuzzy_match, , bleugleu, meteor, , rouge_1, rouge_2rouge_3, , rouge_4, , rouge_5lub rouge_l.Możliwe wartości: cosine, fuzzy_matchbleugleumeteorrouge_1rouge_2rouge_3rouge_4rouge_5rouge_l |
Yes | |
| dane wejściowe | ciąg | Tekst jest oceniany. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| próg zaliczenia | OpenAI.numeric | Yes | ||
| odwołanie | ciąg | Tekst oceniany względem. | Yes | |
| typ | wyliczenie | Typ klasyra. Możliwe wartości: text_similarity |
Yes |
OpenAI.EvalItem
Wiadomość jako wejście do modelu z rolą wskazującą przestrzeganie hierarchii instrukcji. Instrukcje przypisane do roli developer lub system mają pierwszeństwo przed instrukcjami przypisanymi do roli user. Przyjmuje się, że komunikaty z rolą assistant zostały wygenerowane przez model w poprzednich interakcjach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | OpenAI.EvalItemContent | Dane wejściowe modelu — mogą zawierać ciągi szablonu. Obsługuje tekst, tekst wyjściowy, obrazy wejściowe i dźwięk wejściowy jako pojedynczy element lub tablicę elementów. | Yes | |
| rola | wyliczenie | Rola wejścia komunikatu.
userJeden z, assistant, system lubdeveloper.Możliwe wartości: user, , assistant, systemdeveloper |
Yes | |
| typ | wyliczenie | Typ danych wejściowych komunikatu. Zawsze message.Możliwe wartości: message |
Nie. |
OpenAI.EvalItemContent
Dane wejściowe modelu — mogą zawierać ciągi szablonu. Obsługuje tekst, tekst wyjściowy, obrazy wejściowe i dźwięk wejściowy jako pojedynczy element lub tablicę elementów.
Typ: OpenAI.EvalItemContentItem lub OpenAI.EvalItemContentArray
Dane wejściowe modelu — mogą zawierać ciągi szablonu. Obsługuje tekst, tekst wyjściowy, obrazy wejściowe i dźwięk wejściowy jako pojedynczy element lub tablicę elementów.
OpenAI.EvalItemContentArray
Lista danych wejściowych, z których każda może być tekstem wejściowym, tekstem wyjściowym, obrazem wejściowym lub wejściowym obiektem audio.
Tablica: OpenAI.EvalItemContentItem
OpenAI.EvalItemContentItemItem
Pojedynczy element zawartości: tekst wejściowy, tekst wyjściowy, obraz wejściowy lub dźwięk wejściowy.
Typ: OpenAI.EvalItemContentText lub OpenAI.EvalItemContentItemObject
Pojedynczy element zawartości: tekst wejściowy, tekst wyjściowy, obraz wejściowy lub dźwięk wejściowy.
OpenAI.EvalItemContentItemObject
Pojedynczy element zawartości: tekst wejściowy, tekst wyjściowy, obraz wejściowy lub dźwięk wejściowy.
Dyskryminujące dla obiektu OpenAI.EvalItemContentItemObject
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
output_text |
OpenAI.EvalItemContentOutputText |
input_image |
OpenAI.EvalItemInputImage |
input_audio |
OpenAI.InputAudio |
input_text |
OpenAI.EvalItemContentItemObjectInputTextContent |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.EvalItemContentItemObjectType | Yes |
OpenAI.EvalItemContentItemObjectInputTextContent
Wprowadzanie tekstu do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. | Yes | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Yes |
OpenAI.EvalItemContentItemObjectType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | input_textoutput_textinput_imageinput_audio |
OpenAI.EvalItemContentOutputText
Dane wyjściowe tekstowe z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Dane wyjściowe tekstu z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu wyjściowego. Zawsze output_text.Możliwe wartości: output_text |
Yes |
OpenAI.EvalItemContentText
Wprowadzanie tekstu do modelu.
Typ: ciąg
OpenAI.EvalItemInputImage
Blok wejściowy obrazu używany w tablicach zawartości EvalItem.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| detail | ciąg | Poziom szczegółowości obrazu, który ma zostać wysłany do modelu.
highJeden z , lowlub auto. Wartość domyślna to auto. |
Nie. | |
| image_url | ciąg | Adres URL danych wejściowych obrazu. | Yes | |
| typ | wyliczenie | Typ danych wejściowych obrazu. Zawsze input_image.Możliwe wartości: input_image |
Yes |
OpenAI.EvalJsonlFileContentSource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica obiektów OpenAI.EvalJsonlFileContentSourceContent | Zawartość pliku jsonl. | Yes | |
| typ | wyliczenie | Typ źródła jsonl. Zawsze file_content.Możliwe wartości: file_content |
Yes |
OpenAI.EvalJsonlFileContentSourceContent
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| element | obiekt | Yes | ||
| próbka | obiekt | Nie. |
OpenAI.EvalJsonlFileIdSource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Identyfikator pliku. | Yes | |
| typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Yes |
OpenAI.EvalResponsesSource
Obiekt EvalResponsesSource opisujący konfigurację uruchamiania źródła danych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| stworzone_po | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| utworzone_przed | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| wyszukiwanie_instrukcji | ciąg (dopuszczany do wartości null) | Nie. | ||
| metadane | object (dopuszczana wartość null) | Nie. | ||
| model | ciąg (dopuszczany do wartości null) | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort (dopuszczający wartość null) | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | ||
| Narzędzia | tablica ciągów | Nie. | ||
| top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | ||
| typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze responses.Możliwe wartości: responses |
Yes | |
| users | tablica ciągów | Nie. |
OpenAI.EvalRunOutputItemSample
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | OpenAI.EvalApiError | Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval. | Yes | |
| powód zakończenia | ciąg | Yes | ||
| dane wejściowe | tablica EvalRunOutputItemSampleInput | Yes | ||
| max_completion_tokens | OpenAI.integer | Yes | ||
| model | ciąg | Yes | ||
| We/Wy | tablica EvalRunOutputItemSampleOutput | Yes | ||
| seed | OpenAI.integer | Yes | ||
| temperatura | OpenAI.numeric | Yes | ||
| top_p | OpenAI.numeric | Yes | ||
| użycie | OpenAI.EvalRunOutputItemSampleUsage | Yes |
OpenAI.EvalRunOutputItemSampleUsage
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Yes | ||
| completion_tokens | OpenAI.integer | Yes | ||
| prompt_tokens | OpenAI.integer | Yes | ||
| total_tokens | OpenAI.integer | Yes |
OpenAI.EvalRunPerModelUsage
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Yes | ||
| completion_tokens | OpenAI.integer | Yes | ||
| invocation_count | OpenAI.integer | Yes | ||
| model_name | ciąg | Yes | ||
| prompt_tokens | OpenAI.integer | Yes | ||
| total_tokens | OpenAI.integer | Yes |
OpenAI.EvalRunPerTestingCriteriaResults
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| niepowodzenie | OpenAI.integer | Yes | ||
| Przekazywane | OpenAI.integer | Yes | ||
| kryteria_testowe | ciąg | Yes |
OpenAI.EvalRunResultCounts
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | OpenAI.integer | Yes | ||
| niepowodzenie | OpenAI.integer | Yes | ||
| Przekazywane | OpenAI.integer | Yes | ||
| Łącznych | OpenAI.integer | Yes |
OpenAI.EvalStoredCompletionsSource
Konfiguracja StoredCompletionsRunDataSource opisująca zestaw filtrów
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| stworzone_po | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| utworzone_przed | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| limit | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| model | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ źródła. Zawsze stored_completions.Możliwe wartości: stored_completions |
Yes |
OpenAI.FileCitationBody
Cytat do pliku.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Identyfikator pliku. | Yes | |
| filename | ciąg | Nazwa pliku cytowanego. | Yes | |
| indeks | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ cytowania pliku. Zawsze file_citation.Możliwe wartości: file_citation |
Yes |
OpenAI.FilePath
Ścieżka do pliku.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Identyfikator pliku. | Yes | |
| indeks | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ ścieżki pliku. Zawsze file_path.Możliwe wartości: file_path |
Yes |
OpenAI.FileSearchTool
Narzędzie wyszukujące odpowiednią zawartość z przekazanych plików.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| filters | OpenAI.Filters (dopuszczana wartość null) | Nie. | ||
| maks_liczba_wyników | OpenAI.integer | Nie. | ||
| opcje rankingu | OpenAI.RankingOptions | Nie. | ||
| └hybrid_search | OpenAI.HybridSearchOptions | Wagi kontrolujące sposób wzajemnego łączenia rangi równoważy semantyczne dopasowania osadzania w porównaniu z rozrzedzonych dopasowaniami słów kluczowych po włączeniu wyszukiwania hybrydowego. | Nie. | |
| └─ ranker | OpenAI.RankerVersionType | Klasyfikator używany do wyszukiwania plików. | Nie. | |
| └─ próg_punktowy | OpenAI.numeric | Próg oceny dla wyszukiwania plików, liczba z zakresu od 0 do 1. Liczby bliżej 1 będą próbować zwracać tylko najbardziej odpowiednie wyniki, ale mogą zwracać mniej wyników. | Nie. | |
| typ | wyliczenie | Typ narzędzia wyszukiwania plików. Zawsze file_search.Możliwe wartości: file_search |
Yes | |
| identyfikatory_sklepu_wektorów | tablica ciągów | Identyfikatory wektorów są przechowywane do wyszukiwania. | Yes |
OpenAI.FileSearchToolCallResults
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| attributes | OpenAI.VectorStoreFileAttributes (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze są ciągami znaków o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną wartością długość 512 znaków, wartość logiczna lub liczba. |
Nie. | |
| identyfikator_pliku | ciąg | Nie. | ||
| filename | ciąg | Nie. | ||
| wynik | number | Nie. | ||
| SMS | ciąg | Nie. |
OpenAI.Filters
Typ: OpenAI.ComparisonFilter lub OpenAI.CompoundFilter
OpenAI.FineTuneDPOHyperparameters
Hiperparametry używane do zadania dostrajania parametrów DPO.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rozmiar partii | string lub OpenAI.integer | Liczba przykładów w każdej partii. Większy rozmiar partii oznacza, że parametry modelu są aktualizowane rzadziej, ale z niższą wariancją. | Nie. | |
| wersja beta | string lub OpenAI.numeric | Wartość beta metody obiektu DPO. Wyższa wartość beta zwiększy wagę kary między zasadami a modelem referencyjnym. | Nie. | |
| mnożnik szybkości uczenia | string lub OpenAI.numeric | Współczynnik skalowania dla szybkości nauki. Mniejsze tempo nauki może być przydatne, aby uniknąć przeuczenia. | Nie. | |
| n_epochs (liczba epok) | string lub OpenAI.integer | Liczba epok, przez które trenowany jest model. Epoka oznacza jeden pełny cykl przez zbiór danych treningowych. | Nie. |
OpenAI.FineTuneDPOMethod
Konfiguracja metody dostrajania DPO.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| hiperparametry | OpenAI.FineTuneDPOHyperparameters | Hiperparametry używane do zadania dostrajania parametrów DPO. | Nie. |
OpenAI.FineTuneMethod
Metoda używana do dostrajania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dpo | OpenAI.FineTuneDPOMethod | Konfiguracja metody dostrajania DPO. | Nie. | |
| wzmocnienie | OpenAI.FineTuneReinforcementMethod | Konfiguracja metody dostrajania wzmocnienia. | Nie. | |
| Nadzorowany | OpenAI.FineTuneSupervisedMethod | Konfiguracja nadzorowanej metody dostrajania. | Nie. | |
| typ | wyliczenie | Typ metody. Ma wartość supervised, dpolub reinforcement.Możliwe wartości: supervised, , dporeinforcement |
Yes |
OpenAI.FineTuneReinforcementHyperparameters
Hiperparametry używane do zadania dostrajania wzmocnienia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rozmiar partii | string lub OpenAI.integer | Liczba przykładów w każdej partii. Większy rozmiar partii oznacza, że parametry modelu są aktualizowane rzadziej, ale z niższą wariancją. | Nie. | |
| compute_multiplier | string lub OpenAI.numeric | Mnożnik ilości zasobów obliczeniowych używanych do eksplorowania przestrzeni wyszukiwania podczas trenowania. | Nie. | |
| interwał oceny | string lub OpenAI.integer | Liczba kroków szkoleniowych między przebiegami oceny. | Nie. | |
| próbki_ewaluacyjne | string lub OpenAI.integer | Liczba próbek oceny do wygenerowania na krok trenowania. | Nie. | |
| mnożnik szybkości uczenia | string lub OpenAI.numeric | Współczynnik skalowania dla szybkości nauki. Mniejsze tempo nauki może być przydatne, aby uniknąć przeuczenia. | Nie. | |
| n_epochs (liczba epok) | string lub OpenAI.integer | Liczba epok, przez które trenowany jest model. Epoka oznacza jeden pełny cykl przez zbiór danych treningowych. | Nie. | |
| wysiłek rozumowania | wyliczenie | Poziom wysiłku rozumowania. Możliwe wartości: default, , low, mediumhigh |
Nie. |
OpenAI.FineTuneReinforcementMethod
Konfiguracja metody dostrajania wzmocnienia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Równiarka | OpenAI.GraderStringCheck lub OpenAI.GraderTextSimilarity lub OpenAI.GraderPython lub OpenAI.GraderScoreModel lub OpenAI.GraderMulti | Klasykator używany do zadania dostrajania. | Yes | |
| hiperparametry | OpenAI.FineTuneReinforcementHyperparameters | Hiperparametry używane do zadania dostrajania wzmocnienia. | Nie. |
OpenAI.FineTuneSupervisedHyperparameters
Hiperparametry używane do procesu dostrajania modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rozmiar partii | string lub OpenAI.integer | Liczba przykładów w każdej partii. Większy rozmiar partii oznacza, że parametry modelu są aktualizowane rzadziej, ale z niższą wariancją. | Nie. | |
| mnożnik szybkości uczenia | string lub OpenAI.numeric | Współczynnik skalowania dla szybkości nauki. Mniejsze tempo nauki może być przydatne, aby uniknąć przeuczenia. | Nie. | |
| n_epochs (liczba epok) | string lub OpenAI.integer | Liczba epok, przez które trenowany jest model. Epoka oznacza jeden pełny cykl przez zbiór danych treningowych. | Nie. |
OpenAI.FineTuneSupervisedMethod
Konfiguracja nadzorowanej metody dostrajania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| hiperparametry | OpenAI.FineTuneSupervisedHyperparameters | Hiperparametry używane do procesu dostrajania modelu. | Nie. |
OpenAI.FineTuningIntegration
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ włączonej integracji dla zadania dostrajania Możliwe wartości: wandb |
Yes | |
| wandb | OpenAI.FineTuningIntegrationWandb | Yes | ||
| Jednostka | ciąg (dopuszczany do wartości null) | Nie. | ||
| └─ nazwa | ciąg (dopuszczany do wartości null) | Nie. | ||
| └* projekt | ciąg | Yes | ||
| └─ Tagi | tablica ciągów | Nie. |
OpenAI.FineTuningIntegrationWandb
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| jednostka | ciąg (dopuszczany do wartości null) | Nie. | ||
| nazwa | ciąg (dopuszczany do wartości null) | Nie. | ||
| projekt | ciąg | Yes | ||
| tags | tablica ciągów | Nie. |
OpenAI.FineTuningJob
Obiekt fine_tuning.job reprezentuje zadanie dostrajania, które zostało utworzone za pośrednictwem interfejsu API.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu utworzenia zadania dostrajania. | Yes | |
| błąd | OpenAI.FineTuningJobError (dopuszczający wartość null) | Yes | ||
| └─ kod | ciąg | Yes | ||
| └─ Komunikat | ciąg | Yes | ||
| └* param | ciąg (dopuszczany do wartości null) | Yes | ||
| szacowany czas zakończenia | liczba całkowita | Nie. | ||
| fine_tuned_model | ciąg (dopuszczany do wartości null) | Yes | ||
| zakończono_o | liczba całkowita | Yes | ||
| hiperparametry | OpenAI.FineTuningJobHyperparameters | Yes | ||
| └batch_size | string lub OpenAI.integer | Nie. | samochód | |
| └ learning_rate_multiplier | string lub OpenAI.numeric | Nie. | ||
| └n_epochs | string lub OpenAI.integer | Nie. | samochód | |
| id | ciąg | Identyfikator obiektu, do którego można odwoływać się w punktach końcowych interfejsu API. | Yes | |
| Integracje | tablica openAI.FineTuningIntegration | Nie. | ||
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| metoda | OpenAI.FineTuneMethod | Metoda używana do dostrajania. | Nie. | |
| model | ciąg | Model podstawowy, który zostaje precyzyjnie dostrojony. | Yes | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "fine_tuning.job". Możliwe wartości: fine_tuning.job |
Yes | |
| id_organizacji | ciąg | Organizacja, która jest właścicielem zadania dostrajania. | Yes | |
| pliki_wynikowe | tablica ciągów | Skompilowane identyfikatory plików wyników dla zadania dostrajania. Wyniki można pobrać za pomocą interfejsu API plików. | Yes | |
| seed | OpenAI.integer | Yes | ||
| stan | wyliczenie | Bieżący stan zadania dostrajania, który może być jednym z następujących: validating_files, queued, running, succeeded, failed lub cancelled.Możliwe wartości: validating_files, , queuedrunning, succeeded, , failedcancelled |
Yes | |
| tokeny szkoleniowe | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| plik szkoleniowy | ciąg | Identyfikator pliku używany do trenowania. Dane szkoleniowe można pobrać za pomocą interfejsu API plików. | Yes | |
| plik walidacji | ciąg (dopuszczany do wartości null) | Yes |
OpenAI.FineTuningJobCheckpoint
Obiekt fine_tuning.job.checkpoint reprezentuje punkt kontrolny modelu dla zadania dostrajania, które jest gotowe do użycia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu utworzenia punktu kontrolnego. | Yes | |
| punkt kontrolny modelu dostrojonego | ciąg | Nazwa utworzonego, dopracowanego modelu punktów kontrolnych. | Yes | |
| identyfikator_zadania_dostrajania | ciąg | Nazwa zadania dostrajania, na podstawie którego utworzono ten punkt kontrolny. | Yes | |
| id | ciąg | Identyfikator punktu kontrolnego, do którego można odwoływać się w punktach końcowych interfejsu API. | Yes | |
| metryki | OpenAI.FineTuningJobCheckpointMetrics | Yes | ||
| └─full_valid_loss | OpenAI.numeric | Nie. | ||
| └ pełna_weryfikowalna_średnia_dokładność_tokenu (full_valid_mean_token_accuracy) | OpenAI.numeric | Nie. | ||
| └─ Krok | OpenAI.numeric | Nie. | ||
| └─ train_loss | OpenAI.numeric | Nie. | ||
| └- dokładność_średniego_tokena_treningowego | OpenAI.numeric | Nie. | ||
| └ valid_loss | OpenAI.numeric | Nie. | ||
| └─ poprawna_średnia_dokładność_tokena | OpenAI.numeric | Nie. | ||
| obiekt | wyliczenie | Typ obiektu, który zawsze jest "fine_tuning.job.checkpoint". Możliwe wartości: fine_tuning.job.checkpoint |
Yes | |
| numer_kroku | OpenAI.integer | Yes |
OpenAI.FineTuningJobCheckpointMetrics
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| full_valid_loss | OpenAI.numeric | Nie. | ||
| full_valid_mean_token_accuracy | OpenAI.numeric | Nie. | ||
| krok | OpenAI.numeric | Nie. | ||
| train_loss | OpenAI.numeric | Nie. | ||
| train_mean_token_accuracy | OpenAI.numeric | Nie. | ||
| valid_loss | OpenAI.numeric | Nie. | ||
| valid_mean_token_accuracy | OpenAI.numeric | Nie. |
OpenAI.FineTuningJobError
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg | Yes | ||
| komunikat | ciąg | Yes | ||
| param | ciąg (dopuszczany do wartości null) | Yes |
OpenAI.FineTuningJobEvent
Obiekt zdarzenia procesu dostrajania
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu utworzenia zadania dostrajania. | Yes | |
| dane | OpenAI.FineTuningJobEventData | Nie. | ||
| id | ciąg | Identyfikator obiektu. | Yes | |
| poziom | wyliczenie | Poziom rejestrowania zdarzenia. Możliwe wartości: info, , warnerror |
Yes | |
| komunikat | ciąg | Komunikat zdarzenia. | Yes | |
| obiekt | wyliczenie | Typ obiektu, który zawsze jest "fine_tuning.job.event". Możliwe wartości: fine_tuning.job.event |
Yes | |
| typ | wyliczenie | Typ zdarzenia. Możliwe wartości: message, metrics |
Nie. |
OpenAI.FineTuningJobEventData
Typ: obiekt
OpenAI.FineTuningJobHyperparameters
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rozmiar partii | string lub OpenAI.integer | Nie. | ||
| mnożnik szybkości uczenia | string lub OpenAI.numeric | Nie. | ||
| n_epochs (liczba epok) | string lub OpenAI.integer | Nie. |
OpenAI.FunctionAndCustomToolCallOutput
Dyskryminujące dla openAI.FunctionAndCustomToolCallOutput
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
input_text |
OpenAI.FunctionAndCustomToolCallOutputInputTextContent |
input_image |
OpenAI.FunctionAndCustomToolCallOutputInputImageContent |
input_file |
OpenAI.FunctionAndCustomToolCallOutputInputFileContent |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.FunctionAndCustomToolCallOutputType | Yes |
OpenAI.FunctionAndCustomToolCallOutputInputFileContent
Plik wejściowy do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| file_data | ciąg | Zawartość pliku, który ma zostać wysłany do modelu. | Nie. | |
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| file_url | ciąg | Adres URL pliku, który ma zostać wysłany do modelu. | Nie. | |
| filename | ciąg | Nazwa pliku, który ma zostać wysłany do modelu. | Nie. | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_file.Możliwe wartości: input_file |
Yes |
OpenAI.FunctionAndCustomToolCallOutputInputImageContent
Dane wejściowe obrazu do modelu. Dowiedz się więcej o danych wejściowych obrazów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Yes | ||
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| image_url | ciąg | Nie. | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_image.Możliwe wartości: input_image |
Yes |
OpenAI.FunctionAndCustomToolCallOutputInputTextContent
Wprowadzanie tekstu do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. | Yes | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Yes |
OpenAI.FunctionAndCustomToolCallOutputType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | input_textinput_imageinput_file |
OpenAI.FunctionCallItemStatus
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompletedincomplete |
OpenAI.FunctionObject
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do wywołania. Musi składać się z a-z, A-Z, 0-9 lub zawierać podkreślniki i kreski, z maksymalną długością 64 znaków. | Yes | |
| parameters | OpenAI.FunctionParameters | Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. Zapoznaj się z przewodnikiem , aby zapoznać się z przykładami i dokumentacją dotyczącą schematu JSON , aby uzyskać dokumentację dotyczącą formatu. Pominięcie parameters definiuje funkcję z pustą listą parametrów. |
Nie. | |
| surowy | Wartość logiczna (dopuszczana do wartości null) | Nie. |
OpenAI.FunctionParameters
Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. Zapoznaj się z przewodnikiem , aby zapoznać się z przykładami i dokumentacją dotyczącą schematu JSON , aby uzyskać dokumentację dotyczącą formatu.
Pominięcie parameters definiuje funkcję z pustą listą parametrów.
Typ: obiekt
OpenAI.FunctionShellAction
Wykonaj polecenie powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| commands | tablica ciągów | Yes | ||
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| limit_czasu_ms | OpenAI.integer (dopuszczający wartość null) | Yes |
OpenAI.FunctionShellActionParam
Polecenia i limity opisujące sposób uruchamiania wywołania narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| commands | tablica ciągów | Uporządkowane polecenia powłoki dla środowiska wykonawczego do uruchomienia. | Yes | |
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| limit_czasu_ms | OpenAI.integer (dopuszczający wartość null) | Nie. |
OpenAI.FunctionShellCallItemStatus
Wartości stanu zgłaszane dla wywołań narzędzi powłoki.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompletedincomplete |
OpenAI.FunctionShellCallOutputContent
Zawartość danych wyjściowych wywołania narzędzia powłoki, które zostały wyemitowane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| utworzone_przez | ciąg | Identyfikator aktora, który utworzył element. | Nie. | |
| wynik | OpenAI.FunctionShellCallOutputOutcome | Reprezentuje wynik zakończenia (z kodem zakończenia) lub wynik przekroczenia limitu czasu dla fragmentu wyjściowego wywołania powłoki. | Yes | |
| └typ | OpenAI.FunctionShellCallOutputOutcomeType | Yes | ||
| Stderr | ciąg | Standardowe dane wyjściowe błędu przechwycone. | Yes | |
| stdout | ciąg | Standardowe dane wyjściowe przechwycone. | Yes |
OpenAI.FunctionShellCallOutputContentParam
Przechwycono stdout i stderr dla części danych wyjściowych wywołania narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wynik | OpenAI.FunctionShellCallOutputOutcomeParam | Wynik zakończenia lub przekroczenia limitu czasu skojarzony z tym wywołaniem powłoki. | Yes | |
| └typ | OpenAI.FunctionShellCallOutputOutcomeParamType | Yes | ||
| Stderr | ciąg | Przechwycone dane wyjściowe stderr dla wywołania powłoki. Ograniczenia: maxLength: 10485760 |
Yes | |
| stdout | ciąg | Przechwycone dane wyjściowe stdout dla wywołania powłoki. Ograniczenia: maxLength: 10485760 |
Yes |
OpenAI.FunctionShellCallOutputExitOutcome
Wskazuje, że polecenia powłoki zostały zakończone i zwróciły kod zakończenia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| exit_code | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ wyniku. Zawsze exit.Możliwe wartości: exit |
Yes |
OpenAI.FunctionShellCallOutputExitOutcomeParam
Wskazuje, że polecenia powłoki zostały zakończone i zwróciły kod zakończenia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| exit_code | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ wyniku. Zawsze exit.Możliwe wartości: exit |
Yes |
OpenAI.FunctionShellCallOutputOutcome
Reprezentuje wynik zakończenia (z kodem zakończenia) lub wynik przekroczenia limitu czasu dla fragmentu wyjściowego wywołania powłoki.
Dyskryminujące dla openAI.FunctionShellCallOutputOutcome
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
timeout |
OpenAI.FunctionShellCallOutputTimeoutOutcome |
exit |
OpenAI.FunctionShellCallOutputExitOutcome |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.FunctionShellCallOutputOutcomeType | Yes |
OpenAI.FunctionShellCallOutputOutcomeParam
Wynik zakończenia lub przekroczenia limitu czasu skojarzony z tym wywołaniem powłoki.
Dyskryminujące dla openAI.FunctionShellCallOutputOutcomeParam
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
timeout |
OpenAI.FunctionShellCallOutputTimeoutOutcomeParam |
exit |
OpenAI.FunctionShellCallOutputExitOutcomeParam |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.FunctionShellCallOutputOutcomeParamType | Yes |
OpenAI.FunctionShellCallOutputOutcomeParamType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | timeoutexit |
OpenAI.FunctionShellCallOutputOutcomeType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | timeoutexit |
OpenAI.FunctionShellCallOutputTimeoutOutcome
Wskazuje, że wywołanie powłoki przekroczyło skonfigurowany limit czasu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ wyniku. Zawsze timeout.Możliwe wartości: timeout |
Yes |
OpenAI.FunctionShellCallOutputTimeoutOutcomeParam
Wskazuje, że wywołanie powłoki przekroczyło skonfigurowany limit czasu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ wyniku. Zawsze timeout.Możliwe wartości: timeout |
Yes |
OpenAI.FunctionShellToolParam
Narzędzie, które umożliwia modelowi wykonywanie poleceń powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ narzędzia powłoki. Zawsze shell.Możliwe wartości: shell |
Yes |
OpenAI.FunctionTool
Definiuje funkcję w swoim kodzie, którą model może wywołać.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg (dopuszczany do wartości null) | Nie. | ||
| nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| parameters | object (dopuszczana wartość null) | Yes | ||
| surowy | Wartość logiczna (dopuszczana do wartości null) | Yes | ||
| typ | wyliczenie | Typ narzędzia funkcji. Zawsze function.Możliwe wartości: function |
Yes |
OpenAI.GraderLabelModel
Obiekt LabelModelGrader, który używa modelu do przypisywania etykiet do każdego elementu w ocenie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | tablica openAI.EvalItem | Yes | ||
| labels | tablica ciągów | Etykiety do przypisania do każdego elementu w ocenie. | Yes | |
| model | ciąg | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| przechodzące_etykiety | tablica ciągów | Etykiety wskazujące wynik pozytywny. Musi być podzbiorem etykiet. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: label_model |
Yes |
OpenAI.GraderMulti
Obiekt MultiGrader łączy dane wyjściowe wielu ocenianek w celu utworzenia pojedynczego wyniku.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| oblicz_wynik | ciąg | Formuła do obliczenia wyniku na podstawie wyników oceniającego. | Yes | |
| Równiarki | OpenAI.GraderStringCheck lub OpenAI.GraderTextSimilarity lub OpenAI.GraderPython lub OpenAI.GraderScoreModel lub OpenAI.GraderLabelModel | Yes | ||
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze multi.Możliwe wartości: multi |
Yes |
OpenAI.GraderPython
Obiekt PythonGrader, który uruchamia skrypt języka Python na danych wejściowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| znacznik_obrazu | ciąg | Tag obrazu do użycia dla skryptu języka Python. | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| przesłać źródło | ciąg | Kod źródłowy skryptu języka Python. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze python.Możliwe wartości: python |
Yes |
OpenAI.GraderScoreModel
Obiekt ScoreModelGrader, który używa modelu do przypisania wyniku do danych wejściowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | tablica openAI.EvalItem | Komunikaty wejściowe oceniane przez klasykator. Obsługuje tekst, tekst wyjściowy, obraz wejściowy i wejściowe bloki zawartości audio i mogą zawierać ciągi szablonu. | Yes | |
| model | ciąg | Model do użycia do oceny. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| zakres | tablica openAI.numeric | Zakres wyniku Wartość domyślna to [0, 1]. |
Nie. | |
| parametry_próbowania | OpenAI.EvalGraderScoreModelSamplingParams | Nie. | ||
| └max_completions_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─ wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| └─ nasion | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| typ | wyliczenie | Typ obiektu, który jest zawsze score_model.Możliwe wartości: score_model |
Yes |
OpenAI.GraderStringCheck
Obiekt StringCheckGrader, który wykonuje porównanie ciągów między danymi wejściowymi i odwołaniami przy użyciu określonej operacji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | ciąg | Tekst wejściowy. Może to obejmować ciągi szablonu. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| operacja | wyliczenie | Operacja sprawdzania ciągów, którą należy wykonać.
eqJeden z , ne, likelub ilike.Możliwe wartości: eq, , ne, likeilike |
Yes | |
| odwołanie | ciąg | Tekst odwołania. Może to obejmować ciągi szablonu. | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze string_check.Możliwe wartości: string_check |
Yes |
OpenAI.GraderTextSimilarity
Obiekt TextSimilarityGrader, który klasyfikuje tekst na podstawie metryk podobieństwa.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| miara oceny | wyliczenie | Metryka oceny do użycia. Jeden z cosine, , fuzzy_match, , bleugleu, meteor, , rouge_1, rouge_2rouge_3, , rouge_4, , rouge_5lub rouge_l.Możliwe wartości: cosine, fuzzy_matchbleugleumeteorrouge_1rouge_2rouge_3rouge_4rouge_5rouge_l |
Yes | |
| dane wejściowe | ciąg | Tekst jest oceniany. | Yes | |
| nazwa | ciąg | Nazwa oceniającego. | Yes | |
| odwołanie | ciąg | Tekst oceniany względem. | Yes | |
| typ | wyliczenie | Typ klasyra. Możliwe wartości: text_similarity |
Yes |
OpenAI.GrammarSyntax1
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | larkregex |
OpenAI.HybridSearchOptions
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| embedding_weight | OpenAI.numeric | Yes | ||
| text_weight | OpenAI.numeric | Yes |
OpenAI.ImageDetail
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | lowhighauto |
OpenAI.ImageGenTool
Narzędzie, które generuje obrazy przy użyciu modeli obrazów GPT.
Prawidłowe modele:
gpt-image-1
gpt-image-1-mini
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| tło | wyliczenie | Typ tła wygenerowanego obrazu. Jeden z transparentopaquelub auto. Wartość domyślna: auto.Możliwe wartości: transparent, , opaqueauto |
Nie. | |
| input_fidelity | OpenAI.InputFidelity (dopuszczana wartość null) | Kontroluj, ile wysiłku model podejmie, aby dopasować styl i cechy, zwłaszcza cechy twarzy, obrazów wejściowych. Ten parametr jest obsługiwany tylko dla programu gpt-image-1. Nieobsługiwane dla elementu gpt-image-1-mini. Obsługuje i highlow. Wartość domyślna to low. |
Nie. | |
| maska_wprowadzania_obrazu | OpenAI.ImageGenToolInputImageMask | Nie. | ||
| └ file_id | ciąg | Nie. | ||
| └─ image_url | ciąg | Nie. | ||
| model | ciąg (zobacz prawidłowe modele poniżej) | Nie. | ||
| Umiarem | wyliczenie | Poziom moderowania wygenerowanego obrazu. Wartość domyślna: auto.Możliwe wartości: auto, low |
Nie. | |
| kompresja wyjściowa | OpenAI.integer | Nie. | 100 | |
| format_wyjściowy | wyliczenie | Format danych wyjściowych wygenerowanego obrazu.
pngJeden zwebp, lubjpeg. Wartość domyślna: png.Możliwe wartości: png, , webpjpeg |
Nie. | |
| częściowe_obrazy | OpenAI.integer | Nie. | ||
| jakość | wyliczenie | Jakość wygenerowanego obrazu. Jeden z low, , medium, , highlub auto. Wartość domyślna: auto.Możliwe wartości: low, , medium, highauto |
Nie. | |
| size | wyliczenie | Rozmiar wygenerowanego obrazu.
1024x1024Jeden z , , 1024x15361536x1024lub auto. Wartość domyślna: auto.Możliwe wartości: 1024x1024, , 1024x1536, 1536x1024auto |
Nie. | |
| typ | wyliczenie | Typ narzędzia do generowania obrazów. Zawsze image_generation.Możliwe wartości: image_generation |
Yes |
OpenAI.ImageGenToolInputImageMask
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Nie. | ||
| image_url | ciąg | Nie. |
OpenAI.IncludeEnum
Określ dodatkowe dane wyjściowe do uwzględnienia w odpowiedzi modelu. Obecnie obsługiwane wartości to:
-
web_search_call.action.sources: dołącz źródła wywołania narzędzia wyszukiwania internetowego. -
code_interpreter_call.outputs: Zawiera dane wyjściowe z wykonywania kodu w języku Python w elementach wywołań narzędzia interpretera kodu. -
computer_call_output.output.image_url: dołącz adresy URL obrazów z wyniku wywołania komputera. -
file_search_call.results: uwzględnij wyniki operacji narzędzia do wyszukiwania plików. -
message.input_image.image_url: dołącz adresy URL obrazów z komunikatu wejściowego. -
message.output_text.logprobs: Dołącz logprobs do komunikatów asystenta. -
reasoning.encrypted_content: zawiera zaszyfrowaną wersję tokenów rozumowania w danych wyjściowych elementu rozumowania. Dzięki temu elementy rozumowania mogą być używane w wielowariantowych rozmowach podczas bezstanowego korzystania z interfejsu API odpowiedzi (na przykład gdystoreparametr jest ustawiony nafalse, lub gdy organizacja jest zarejestrowana w programie zerowego przechowywania danych).
| Property | Value |
|---|---|
| Opis | Określ dodatkowe dane wyjściowe do uwzględnienia w odpowiedzi modelu. Obecnie obsługiwane wartości to: |
-
web_search_call.action.sources: dołącz źródła wywołania narzędzia wyszukiwania internetowego. -
code_interpreter_call.outputs: Zawiera dane wyjściowe z wykonywania kodu w języku Python w elementach wywołań narzędzia interpretera kodu. -
computer_call_output.output.image_url: dołącz adresy URL obrazów z wyniku wywołania komputera. -
file_search_call.results: uwzględnij wyniki operacji narzędzia do wyszukiwania plików. -
message.input_image.image_url: dołącz adresy URL obrazów z komunikatu wejściowego. -
message.output_text.logprobs: Dołącz logprobs do komunikatów asystenta. -
reasoning.encrypted_content: zawiera zaszyfrowaną wersję tokenów rozumowania w danych wyjściowych elementu rozumowania. Dzięki temu elementy rozumowania mogą być używane w wielowariantowych rozmowach podczas bezstanowego korzystania z interfejsu API odpowiedzi (na przykład gdystoreparametr jest ustawiony nafalse, lub gdy organizacja jest zarejestrowana w programie zerowego przechowywania danych). | | Typ | ciąg | | Wartości |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
Dane audio jako wejście do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| input_audio | OpenAI.InputAudioInputAudio | Yes | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_audio.Możliwe wartości: input_audio |
Yes |
OpenAI.InputAudioInputAudio
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane | ciąg | Yes | ||
| format | wyliczenie | Możliwe wartości: mp3, wav |
Yes |
OpenAI.InputContent
Dyskryminujący dla interfejsu OpenAI.InputContent
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
input_text |
OpenAI.InputContentInputTextContent |
input_image |
OpenAI.InputContentInputImageContent |
input_file |
OpenAI.InputContentInputFileContent |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.InputContentType | Yes |
OpenAI.InputContentInputFileContent
Plik wejściowy do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| file_data | ciąg | Zawartość pliku, który ma zostać wysłany do modelu. | Nie. | |
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| file_url | ciąg | Adres URL pliku, który ma zostać wysłany do modelu. | Nie. | |
| filename | ciąg | Nazwa pliku, który ma zostać wysłany do modelu. | Nie. | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_file.Możliwe wartości: input_file |
Yes |
OpenAI.InputContentInputImageContent
Dane wejściowe obrazu do modelu. Dowiedz się więcej o danych wejściowych obrazów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Yes | ||
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| image_url | ciąg | Nie. | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_image.Możliwe wartości: input_image |
Yes |
OpenAI.InputContentInputTextContent
Wprowadzanie tekstu do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. | Yes | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Yes |
OpenAI.InputContentType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | input_textinput_imageinput_file |
OpenAI.InputFidelity
Kontroluj, ile wysiłku model podejmie, aby dopasować styl i cechy, zwłaszcza cechy twarzy, obrazów wejściowych. Ten parametr jest obsługiwany tylko dla programu gpt-image-1. Nieobsługiwane dla elementu gpt-image-1-mini. Obsługuje i highlow. Wartość domyślna to low.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | highlow |
OpenAI.InputFileContent
Plik wejściowy do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| file_data | ciąg | Zawartość pliku, który ma zostać wysłany do modelu. | Nie. | |
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| file_url | ciąg | Adres URL pliku, który ma zostać wysłany do modelu. | Nie. | |
| filename | ciąg | Nazwa pliku, który ma zostać wysłany do modelu. | Nie. | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_file.Możliwe wartości: input_file |
Yes |
OpenAI.InputFileContentParam
Plik wejściowy do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| file_data | ciąg (dopuszczany do wartości null) | Nie. | ||
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| file_url | ciąg | Nie. | ||
| filename | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_file.Możliwe wartości: input_file |
Yes |
OpenAI.InputImageContent
Dane wejściowe obrazu do modelu. Dowiedz się więcej o danych wejściowych obrazów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Yes | ||
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| image_url | ciąg | Nie. | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_image.Możliwe wartości: input_image |
Yes |
OpenAI.InputImageContentParamAutoParam
Dane wejściowe obrazu do modelu. Dowiedz się więcej o danych wejściowych obrazów
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| detail | OpenAI.DetailEnum (dopuszczana wartość null) | Nie. | ||
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| image_url | ciąg | Nie. | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_image.Możliwe wartości: input_image |
Yes |
OpenAI.InputItem
Element reprezentujący część kontekstu odpowiedzi, która ma zostać wygenerowana przez model. Może zawierać tekst, obrazy i dane wejściowe audio, a także poprzednie odpowiedzi asystenta i dane wyjściowe wywołania narzędzia.
Dyskryminator openAI.InputItem
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.InputItemType | Yes |
OpenAI.InputItemApplyPatchToolCallItemParam
Wywołanie narzędzia reprezentujące żądanie tworzenia, usuwania lub aktualizowania plików przy użyciu poprawek różnicowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| operacja | OpenAI.ApplyPatchOperationParam | Jeden z create_file, delete_file lub update_file operacji dostarczonych do narzędzia apply_patch. | Yes | |
| └typ | OpenAI.ApplyPatchOperationParamType | Yes | ||
| stan | OpenAI.ApplyPatchCallStatusParam | Wartości stanu zgłaszane dla wywołań narzędzi apply_patch. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call.Możliwe wartości: apply_patch_call |
Yes |
OpenAI.InputItemApplyPatchToolCallOutputItemParam
Przesyłane strumieniowo dane wyjściowe emitowane przez wywołanie narzędzia zastosuj poprawkę.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| stan | OpenAI.ApplyPatchCallOutputStatusParam | Wartości wyników zgłaszane dla danych wyjściowych wywołań narzędzia apply_patch. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call_output.Możliwe wartości: apply_patch_call_output |
Yes |
OpenAI.InputItemCodeInterpreterToolCall
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia interpretera kodu. | Yes | |
| outputs | tablica obiektów OpenAI.CodeInterpreterOutputLogs lub OpenAI.CodeInterpreterOutputImage | Yes | ||
| stan | wyliczenie | Stan wywołania narzędzia interpretera kodu. Prawidłowe wartości to in_progress, , completedincomplete, interpreting, i failed.Możliwe wartości: in_progress, , completedincomplete, , interpretingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia interpretera kodu. Zawsze code_interpreter_call.Możliwe wartości: code_interpreter_call |
Yes |
OpenAI.InputItemCompactionSummaryItemParam
Element kompaktowania generowany przez v1/responses/compact interfejs API.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| encrypted_content | ciąg | Zaszyfrowana zawartość podsumowania kompaktowania. Ograniczenia: maxLength: 10485760 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze compaction.Możliwe wartości: compaction |
Yes |
OpenAI.InputItemComputerCallOutputItemParam
Dane wyjściowe z wywołania narzędzia komputerowego.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| acknowledged_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Nie. | ||
| call_id | ciąg | Identyfikator wywołania narzędzia komputerowego, które wygenerowało dane wyjściowe. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| We/Wy | OpenAI.ComputerScreenshotImage | Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera. | Yes | |
| stan | OpenAI.FunctionCallItemStatus (dopuszczana wartość null) | Nie. | ||
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia komputerowego. Zawsze computer_call_output.Możliwe wartości: computer_call_output |
Yes |
OpenAI.InputItemComputerToolCall
Narzędzie wywołujące narzędzie do korzystania z komputera. Aby uzyskać więcej informacji, zobacz przewodnik dotyczący korzystania z komputera .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Yes | ||
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania komputera. | Yes | |
| pending_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ wywołania komputera. Zawsze computer_call.Możliwe wartości: computer_call |
Yes |
OpenAI.InputItemCustomToolCall
Wywołanie niestandardowego narzędzia utworzonego przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Identyfikator używany do mapowania tego niestandardowego wywołania narzędzia na dane wyjściowe wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator niestandardowego wywołania narzędzia na platformie OpenAI. | Nie. | |
| dane wejściowe | ciąg | Dane wejściowe dla niestandardowego wywołania narzędzia wygenerowanego przez model. | Yes | |
| nazwa | ciąg | Nazwa wywoływanego narzędzia niestandardowego. | Yes | |
| typ | wyliczenie | Typ niestandardowego wywołania narzędzia. Zawsze custom_tool_call.Możliwe wartości: custom_tool_call |
Yes |
OpenAI.InputItemCustomToolCallOutput
Dane wyjściowe niestandardowego wywołania narzędzia z kodu wysyłanego z powrotem do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Identyfikator wywołania używany do mapowania tego niestandardowego narzędzia wywołania danych wyjściowych do niestandardowego wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania niestandardowego narzędzia na platformie OpenAI. | Nie. | |
| We/Wy | ciąg lub tablica obiektu OpenAI.FunctionAndCustomToolCallOutput | Dane wyjściowe z wywołania niestandardowego narzędzia wygenerowanego przez kod. Może być ciągiem lub listą zawartości wyjściowej. |
Yes | |
| typ | wyliczenie | Typ danych wyjściowych wywołania niestandardowego narzędzia. Zawsze custom_tool_call_output.Możliwe wartości: custom_tool_call_output |
Yes |
OpenAI.InputItemFileSearchToolCall
Wyniki wywołania narzędzia wyszukiwania plików. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania plików .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania plików. | Yes | |
| queries | tablica ciągów | Zapytania używane do wyszukiwania plików. | Yes | |
| results | tablica obiektów OpenAI.FileSearchToolCallResults | Nie. | ||
| stan | wyliczenie | Stan wywołania narzędzia do wyszukiwania plików. Jeden z in_progresssearching, lub incomplete, failedMożliwe wartości: in_progress, , searchingcompleted, , incompletefailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania plików. Zawsze file_search_call.Możliwe wartości: file_search_call |
Yes |
OpenAI.InputItemFunctionCallOutputItemParam
Dane wyjściowe wywołania narzędzia funkcji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| We/Wy | ciąg lub tablica wartości OpenAI.InputTextContentParam lub OpenAI.InputImageContentParamAutoParam lub OpenAI.InputFileContentParam | Tekst, obraz lub dane wyjściowe pliku wywołania narzędzia funkcji. | Yes | |
| stan | OpenAI.FunctionCallItemStatus (dopuszczana wartość null) | Nie. | ||
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia funkcji. Zawsze function_call_output.Możliwe wartości: function_call_output |
Yes |
OpenAI.InputItemFunctionShellCallItemParam
Narzędzie reprezentujące żądanie wykonania co najmniej jednego polecenia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.FunctionShellActionParam | Polecenia i limity opisujące sposób uruchamiania wywołania narzędzia powłoki. | Yes | |
| Polecenia └* | tablica ciągów | Uporządkowane polecenia powłoki dla środowiska wykonawczego do uruchomienia. | Yes | |
| └max_output_length | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └timeout_ms | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| stan | OpenAI.FunctionShellCallItemStatus (dopuszczana wartość null) | Wartości stanu zgłaszane dla wywołań narzędzi powłoki. | Nie. | |
| typ | wyliczenie | Typ elementu. Zawsze shell_call.Możliwe wartości: shell_call |
Yes |
OpenAI.InputItemFunctionShellCallOutputItemParam
Przesyłane strumieniowo elementy wyjściowe emitowane przez wywołanie narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| We/Wy | tablica openAI.FunctionShellCallOutputContentParam | Przechwycone fragmenty danych wyjściowych stdout i stderr wraz ze skojarzonymi wynikami. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze shell_call_output.Możliwe wartości: shell_call_output |
Yes |
OpenAI.InputItemFunctionToolCall
Wywołanie narzędzia w celu uruchomienia funkcji. Aby uzyskać więcej informacji, zobacz przewodnik wywoływania funkcji .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia funkcjonalnego. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ wywołania funkcji narzędziowej. Zawsze function_call.Możliwe wartości: function_call |
Yes |
OpenAI.InputItemImageGenToolCall
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania generowania obrazu. | Yes | |
| result | ciąg (dopuszczany do wartości null) | Yes | ||
| stan | wyliczenie | Stan wywołania generowania obrazu. Możliwe wartości: in_progress, , completed, generatingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania generowania obrazu. Zawsze image_generation_call.Możliwe wartości: image_generation_call |
Yes |
OpenAI.InputItemLocalShellToolCall
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator lokalnego wywołania powłoki. | Yes | |
| stan | wyliczenie | Stan lokalnego wywołania powłoki. Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ lokalnego wywołania powłoki. Zawsze local_shell_call.Możliwe wartości: local_shell_call |
Yes |
OpenAI.InputItemLocalShellToolCallOutput
Dane wyjściowe lokalnego wywołania narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| We/Wy | ciąg | Ciąg JSON reprezentujący dane wyjściowe z wywołania lokalnego narzędzia powłoki. | Yes | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ lokalnego narzędzia powłoki wywołuje dane wyjściowe. Zawsze local_shell_call_output.Możliwe wartości: local_shell_call_output |
Yes |
OpenAI.InputItemMcpApprovalRequest
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator żądania zatwierdzenia. | Yes | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_request.Możliwe wartości: mcp_approval_request |
Yes |
OpenAI.InputItemMcpApprovalResponse
Odpowiedź na żądanie zatwierdzenia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg | Identyfikator odpowiedzi na żądanie zatwierdzenia. | Yes | |
| approve | boolean | Czy żądanie zostało zatwierdzone. | Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| powód | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_response.Możliwe wartości: mcp_approval_response |
Yes |
OpenAI.InputItemMcpListTools
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator listy. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Yes | |
| Narzędzia | tablica narzędzi OpenAI.MCPListToolsTools | Narzędzia dostępne na serwerze. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_list_tools.Możliwe wartości: mcp_list_tools |
Yes |
OpenAI.InputItemMcpToolCall
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Yes | |
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator wywołania narzędzia. | Yes | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Yes | |
| stan | OpenAI.MCPToolCallStatus | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_call.Możliwe wartości: mcp_call |
Yes |
OpenAI.InputItemOutputMessage
Komunikat wyjściowy z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica elementów OpenAI.OutputMessageContent | Zawartość komunikatu wyjściowego. | Yes | |
| id | ciąg | Unikatowy identyfikator komunikatu wyjściowego. | Yes | |
| rola | wyliczenie | Rola komunikatu wyjściowego. Zawsze assistant.Możliwe wartości: assistant |
Yes | |
| stan | wyliczenie | Stan danych wejściowych komunikatu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy wejściowe są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ komunikatu wyjściowego. Zawsze message.Możliwe wartości: output_message |
Yes |
OpenAI.InputItemReasoningItemItem
Opis łańcucha myśli używanego przez model rozumowania podczas generowania odpowiedzi. Pamiętaj, aby uwzględnić te elementy w input interfejsie API odpowiedzi na kolejne etapy konwersacji, jeśli ręcznie zarządzasz kontekstem.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica obiektu OpenAI.ReasoningTextContent | Wnioskowanie zawartości tekstowej. | Nie. | |
| encrypted_content | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator zawartości rozumowania. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| podsumowanie | tablica interfejsu OpenAI.Summary | Rozumowanie zawartości podsumowania. | Yes | |
| typ | wyliczenie | Typ obiektu. Zawsze reasoning.Możliwe wartości: reasoning |
Yes |
OpenAI.InputItemType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Wyniki wywołania narzędzia wyszukiwania w Internecie. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania w Internecie .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.WebSearchActionSearch lub OpenAI.WebSearchActionOpenPage lub OpenAI.WebSearchActionFind | Obiekt opisujący określoną akcję podjętą w tym wywołaniu wyszukiwania w sieci Web. Zawiera szczegółowe informacje na temat sposobu użycia modelu w Internecie (wyszukiwanie, open_page, znajdowanie). |
Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania w Internecie. | Yes | |
| stan | wyliczenie | Stan działania wyszukiwarki internetowej. Możliwe wartości: in_progress, , searching, completedfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania w Internecie. Zawsze web_search_call.Możliwe wartości: web_search_call |
Yes |
OpenAI.InputMessage
Wiadomość jako wejście do modelu z rolą wskazującą przestrzeganie hierarchii instrukcji. Instrukcje przypisane do roli developer lub system mają pierwszeństwo przed instrukcjami przypisanymi do roli user.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | OpenAI.InputMessageContentList | Lista jednego lub wielu elementów wejściowych do modelu zawierająca inną zawartość types. |
Yes | |
| rola | wyliczenie | Rola wejścia komunikatu.
userJeden z , systemlub developer.Możliwe wartości: user, , systemdeveloper |
Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wejściowych komunikatu. Zawsze ustaw na message.Możliwe wartości: message |
Yes |
OpenAI.InputMessageContentList
Lista jednego lub wielu elementów wejściowych do modelu zawierająca różne typy zawartości.
Tablica: OpenAI.InputContent
OpenAI.InputMessageResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | OpenAI.InputMessageContentList | Lista jednego lub wielu elementów wejściowych do modelu zawierająca inną zawartość types. |
Yes | |
| id | ciąg | Unikatowy identyfikator wejściowy wiadomości. | Yes | |
| rola | wyliczenie | Rola wejścia komunikatu.
userJeden z , systemlub developer.Możliwe wartości: user, , systemdeveloper |
Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wejściowych komunikatu. Zawsze ustaw na message.Możliwe wartości: message |
Yes |
OpenAI.InputParam
Dane wejściowe tekstu, obrazu lub pliku w modelu używane do generowania odpowiedzi. Więcej informacji:
- Wprowadzanie tekstu i dane wyjściowe
- Dane wejściowe obrazu
- Dane wejściowe pliku
- Stan konwersacji
- Wywoływanie funkcji
Typ: ciąg lub tablica openAI.InputItem
Dane wejściowe tekstu, obrazu lub pliku w modelu używane do generowania odpowiedzi. Więcej informacji:
- Wprowadzanie tekstu i dane wyjściowe
- Dane wejściowe obrazu
- Dane wejściowe pliku
- Stan konwersacji
- Wywoływanie funkcji
OpenAI.InputTextContent
Wprowadzanie tekstu do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. | Yes | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Yes |
OpenAI.InputTextContentParam
Wprowadzanie tekstu do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. Ograniczenia: maxLength: 10485760 |
Yes | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Yes |
OpenAI.Item
Element zawartości używany do generowania odpowiedzi.
Dyskryminujący element OpenAI.Item
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ItemType | Yes |
OpenAI.ItemApplyPatchToolCallItemParam
Wywołanie narzędzia reprezentujące żądanie tworzenia, usuwania lub aktualizowania plików przy użyciu poprawek różnicowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| operacja | OpenAI.ApplyPatchOperationParam | Jeden z create_file, delete_file lub update_file operacji dostarczonych do narzędzia apply_patch. | Yes | |
| └typ | OpenAI.ApplyPatchOperationParamType | Yes | ||
| stan | OpenAI.ApplyPatchCallStatusParam | Wartości stanu zgłaszane dla wywołań narzędzi apply_patch. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call.Możliwe wartości: apply_patch_call |
Yes |
OpenAI.ItemApplyPatchToolCallOutputItemParam
Przesyłane strumieniowo dane wyjściowe emitowane przez wywołanie narzędzia zastosuj poprawkę.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| stan | OpenAI.ApplyPatchCallOutputStatusParam | Wartości wyników zgłaszane dla danych wyjściowych wywołań narzędzia apply_patch. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call_output.Możliwe wartości: apply_patch_call_output |
Yes |
OpenAI.ItemCodeInterpreterToolCall
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia interpretera kodu. | Yes | |
| outputs | tablica obiektów OpenAI.CodeInterpreterOutputLogs lub OpenAI.CodeInterpreterOutputImage | Yes | ||
| stan | wyliczenie | Stan wywołania narzędzia interpretera kodu. Prawidłowe wartości to in_progress, , completedincomplete, interpreting, i failed.Możliwe wartości: in_progress, , completedincomplete, , interpretingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia interpretera kodu. Zawsze code_interpreter_call.Możliwe wartości: code_interpreter_call |
Yes |
OpenAI.ItemCompactionSummaryItemParam
Element kompaktowania generowany przez v1/responses/compact interfejs API.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| encrypted_content | ciąg | Zaszyfrowana zawartość podsumowania kompaktowania. Ograniczenia: maxLength: 10485760 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze compaction.Możliwe wartości: compaction |
Yes |
OpenAI.ItemComputerCallOutputItemParam
Dane wyjściowe z wywołania narzędzia komputerowego.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| acknowledged_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Nie. | ||
| call_id | ciąg | Identyfikator wywołania narzędzia komputerowego, które wygenerowało dane wyjściowe. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| We/Wy | OpenAI.ComputerScreenshotImage | Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera. | Yes | |
| stan | OpenAI.FunctionCallItemStatus (dopuszczana wartość null) | Nie. | ||
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia komputerowego. Zawsze computer_call_output.Możliwe wartości: computer_call_output |
Yes |
OpenAI.ItemComputerToolCall
Narzędzie wywołujące narzędzie do korzystania z komputera. Aby uzyskać więcej informacji, zobacz przewodnik dotyczący korzystania z komputera .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Yes | ||
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania komputera. | Yes | |
| pending_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ wywołania komputera. Zawsze computer_call.Możliwe wartości: computer_call |
Yes |
OpenAI.ItemCustomToolCall
Wywołanie niestandardowego narzędzia utworzonego przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Identyfikator używany do mapowania tego niestandardowego wywołania narzędzia na dane wyjściowe wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator niestandardowego wywołania narzędzia na platformie OpenAI. | Nie. | |
| dane wejściowe | ciąg | Dane wejściowe dla niestandardowego wywołania narzędzia wygenerowanego przez model. | Yes | |
| nazwa | ciąg | Nazwa wywoływanego narzędzia niestandardowego. | Yes | |
| typ | wyliczenie | Typ niestandardowego wywołania narzędzia. Zawsze custom_tool_call.Możliwe wartości: custom_tool_call |
Yes |
OpenAI.ItemCustomToolCallOutput
Dane wyjściowe niestandardowego wywołania narzędzia z kodu wysyłanego z powrotem do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Identyfikator wywołania używany do mapowania tego niestandardowego narzędzia wywołania danych wyjściowych do niestandardowego wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania niestandardowego narzędzia na platformie OpenAI. | Nie. | |
| We/Wy | ciąg lub tablica obiektu OpenAI.FunctionAndCustomToolCallOutput | Dane wyjściowe z wywołania niestandardowego narzędzia wygenerowanego przez kod. Może być ciągiem lub listą zawartości wyjściowej. |
Yes | |
| typ | wyliczenie | Typ danych wyjściowych wywołania niestandardowego narzędzia. Zawsze custom_tool_call_output.Możliwe wartości: custom_tool_call_output |
Yes |
OpenAI.ItemFileSearchToolCall
Wyniki wywołania narzędzia wyszukiwania plików. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania plików .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania plików. | Yes | |
| queries | tablica ciągów | Zapytania używane do wyszukiwania plików. | Yes | |
| results | tablica obiektów OpenAI.FileSearchToolCallResults | Nie. | ||
| stan | wyliczenie | Stan wywołania narzędzia do wyszukiwania plików. Jeden z in_progresssearching, lub incomplete, failedMożliwe wartości: in_progress, , searchingcompleted, , incompletefailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania plików. Zawsze file_search_call.Możliwe wartości: file_search_call |
Yes |
OpenAI.ItemFunctionCallOutputItemParam
Dane wyjściowe wywołania narzędzia funkcji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| We/Wy | ciąg lub tablica wartości OpenAI.InputTextContentParam lub OpenAI.InputImageContentParamAutoParam lub OpenAI.InputFileContentParam | Tekst, obraz lub dane wyjściowe pliku wywołania narzędzia funkcji. | Yes | |
| stan | OpenAI.FunctionCallItemStatus (dopuszczana wartość null) | Nie. | ||
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia funkcji. Zawsze function_call_output.Możliwe wartości: function_call_output |
Yes |
OpenAI.ItemFunctionShellCallItemParam
Narzędzie reprezentujące żądanie wykonania co najmniej jednego polecenia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.FunctionShellActionParam | Polecenia i limity opisujące sposób uruchamiania wywołania narzędzia powłoki. | Yes | |
| Polecenia └* | tablica ciągów | Uporządkowane polecenia powłoki dla środowiska wykonawczego do uruchomienia. | Yes | |
| └max_output_length | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └timeout_ms | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| stan | OpenAI.FunctionShellCallItemStatus (dopuszczana wartość null) | Wartości stanu zgłaszane dla wywołań narzędzi powłoki. | Nie. | |
| typ | wyliczenie | Typ elementu. Zawsze shell_call.Możliwe wartości: shell_call |
Yes |
OpenAI.ItemFunctionShellCallOutputItemParam
Przesyłane strumieniowo elementy wyjściowe emitowane przez wywołanie narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. Ograniczenia: minLength: 1, maxLength: 64 |
Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| We/Wy | tablica openAI.FunctionShellCallOutputContentParam | Przechwycone fragmenty danych wyjściowych stdout i stderr wraz ze skojarzonymi wynikami. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze shell_call_output.Możliwe wartości: shell_call_output |
Yes |
OpenAI.ItemFunctionToolCall
Wywołanie narzędzia w celu uruchomienia funkcji. Aby uzyskać więcej informacji, zobacz przewodnik wywoływania funkcji .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia funkcjonalnego. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ wywołania funkcji narzędziowej. Zawsze function_call.Możliwe wartości: function_call |
Yes |
OpenAI.ItemImageGenToolCall
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania generowania obrazu. | Yes | |
| result | ciąg (dopuszczany do wartości null) | Yes | ||
| stan | wyliczenie | Stan wywołania generowania obrazu. Możliwe wartości: in_progress, , completed, generatingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania generowania obrazu. Zawsze image_generation_call.Możliwe wartości: image_generation_call |
Yes |
OpenAI.ItemLocalShellToolCall
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator lokalnego wywołania powłoki. | Yes | |
| stan | wyliczenie | Stan lokalnego wywołania powłoki. Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ lokalnego wywołania powłoki. Zawsze local_shell_call.Możliwe wartości: local_shell_call |
Yes |
OpenAI.ItemLocalShellToolCallOutput
Dane wyjściowe lokalnego wywołania narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| We/Wy | ciąg | Ciąg JSON reprezentujący dane wyjściowe z wywołania lokalnego narzędzia powłoki. | Yes | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ lokalnego narzędzia powłoki wywołuje dane wyjściowe. Zawsze local_shell_call_output.Możliwe wartości: local_shell_call_output |
Yes |
OpenAI.ItemMcpApprovalRequest
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator żądania zatwierdzenia. | Yes | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_request.Możliwe wartości: mcp_approval_request |
Yes |
OpenAI.ItemMcpApprovalResponse
Odpowiedź na żądanie zatwierdzenia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg | Identyfikator odpowiedzi na żądanie zatwierdzenia. | Yes | |
| approve | boolean | Czy żądanie zostało zatwierdzone. | Yes | |
| id | ciąg (dopuszczany do wartości null) | Nie. | ||
| powód | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_response.Możliwe wartości: mcp_approval_response |
Yes |
OpenAI.ItemMcpListTools
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator listy. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Yes | |
| Narzędzia | tablica narzędzi OpenAI.MCPListToolsTools | Narzędzia dostępne na serwerze. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_list_tools.Możliwe wartości: mcp_list_tools |
Yes |
OpenAI.ItemMcpToolCall
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Yes | |
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator wywołania narzędzia. | Yes | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Yes | |
| stan | OpenAI.MCPToolCallStatus | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_call.Możliwe wartości: mcp_call |
Yes |
OpenAI.ItemOutputMessage
Komunikat wyjściowy z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica elementów OpenAI.OutputMessageContent | Zawartość komunikatu wyjściowego. | Yes | |
| id | ciąg | Unikatowy identyfikator komunikatu wyjściowego. | Yes | |
| rola | wyliczenie | Rola komunikatu wyjściowego. Zawsze assistant.Możliwe wartości: assistant |
Yes | |
| stan | wyliczenie | Stan danych wejściowych komunikatu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy wejściowe są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ komunikatu wyjściowego. Zawsze message.Możliwe wartości: output_message |
Yes |
OpenAI.ItemReasoningItem
Opis łańcucha myśli używanego przez model rozumowania podczas generowania odpowiedzi. Pamiętaj, aby uwzględnić te elementy w input interfejsie API odpowiedzi na kolejne etapy konwersacji, jeśli ręcznie zarządzasz kontekstem.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica obiektu OpenAI.ReasoningTextContent | Wnioskowanie zawartości tekstowej. | Nie. | |
| encrypted_content | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator zawartości rozumowania. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| podsumowanie | tablica interfejsu OpenAI.Summary | Rozumowanie zawartości podsumowania. | Yes | |
| typ | wyliczenie | Typ obiektu. Zawsze reasoning.Możliwe wartości: reasoning |
Yes |
OpenAI.ItemReferenceParam
Wewnętrzny identyfikator elementu do celów odniesienia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Identyfikator elementu referencyjnego. | Yes | |
| typ | wyliczenie | Typ elementu referencyjnego. Zawsze item_reference.Możliwe wartości: item_reference |
Yes |
OpenAI.ItemResource
Element zawartości używany do generowania odpowiedzi.
Dyskryminujący element OpenAI.ItemResource
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ItemResourceType | Yes |
OpenAI.ItemResourceApplyPatchToolCall
Wywołanie narzędzia, które stosuje różnice plików przez tworzenie, usuwanie lub aktualizowanie plików.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to wywołanie narzędzia. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| operacja | OpenAI.ApplyPatchFileOperation | Jedną z operacji create_file, delete_file lub update_file stosowanych za pośrednictwem apply_patch. | Yes | |
| └typ | OpenAI.ApplyPatchFileOperationType | Yes | ||
| stan | OpenAI.ApplyPatchCallStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call.Możliwe wartości: apply_patch_call |
Yes |
OpenAI.ItemResourceApplyPatchToolCallOutput
Dane wyjściowe emitowane przez wywołanie narzędzia zastosuj poprawkę.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to narzędzie, wywołuje dane wyjściowe. | Nie. | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania narzędzia stosowania poprawek. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| stan | OpenAI.ApplyPatchCallOutputStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call_output.Możliwe wartości: apply_patch_call_output |
Yes |
OpenAI.ItemResourceCodeInterpreterToolCall
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia interpretera kodu. | Yes | |
| outputs | tablica obiektów OpenAI.CodeInterpreterOutputLogs lub OpenAI.CodeInterpreterOutputImage | Yes | ||
| stan | wyliczenie | Stan wywołania narzędzia interpretera kodu. Prawidłowe wartości to in_progress, , completedincomplete, interpreting, i failed.Możliwe wartości: in_progress, , completedincomplete, , interpretingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia interpretera kodu. Zawsze code_interpreter_call.Możliwe wartości: code_interpreter_call |
Yes |
OpenAI.ItemResourceComputerToolCall
Narzędzie wywołujące narzędzie do korzystania z komputera. Aby uzyskać więcej informacji, zobacz przewodnik dotyczący korzystania z komputera .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Yes | ||
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania komputera. | Yes | |
| pending_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ wywołania komputera. Zawsze computer_call.Możliwe wartości: computer_call |
Yes |
OpenAI.ItemResourceComputerToolCallOutputResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| acknowledged_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Kontrole bezpieczeństwa, które zgłoszono za pomocą interfejsu API i zostały potwierdzone przez wywoływacz. |
Nie. | |
| call_id | ciąg | Identyfikator wywołania narzędzia komputerowego, które wygenerowało dane wyjściowe. | Yes | |
| id | ciąg | Identyfikator wyniku wywołania komputerowego narzędzia. | Nie. | |
| We/Wy | OpenAI.ComputerScreenshotImage | Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera. | Yes | |
| stan | wyliczenie | Stan danych wejściowych komunikatu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy wejściowe są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia komputerowego. Zawsze computer_call_output.Możliwe wartości: computer_call_output |
Yes |
OpenAI.ItemResourceFileSearchToolCall
Wyniki wywołania narzędzia wyszukiwania plików. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania plików .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania plików. | Yes | |
| queries | tablica ciągów | Zapytania używane do wyszukiwania plików. | Yes | |
| results | tablica obiektów OpenAI.FileSearchToolCallResults | Nie. | ||
| stan | wyliczenie | Stan wywołania narzędzia do wyszukiwania plików. Jeden z in_progresssearching, lub incomplete, failedMożliwe wartości: in_progress, , searchingcompleted, , incompletefailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania plików. Zawsze file_search_call.Możliwe wartości: file_search_call |
Yes |
OpenAI.ItemResourceFunctionShellCall
Wywołanie narzędzia, które wykonuje co najmniej jedno polecenie powłoki w środowisku zarządzanym.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.FunctionShellAction | Wykonaj polecenie powłoki. | Yes | |
| Polecenia └* | tablica ciągów | Yes | ||
| └max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| └timeout_ms | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to wywołanie narzędzia. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| stan | OpenAI.LocalShellCallStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze shell_call.Możliwe wartości: shell_call |
Yes |
OpenAI.ItemResourceFunctionShellCallOutput
Dane wyjściowe wywołania narzędzia powłoki, które zostało wyemitowane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator aktora, który utworzył element. | Nie. | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania powłoki. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| We/Wy | tablica elementów OpenAI.FunctionShellCallOutputContent | Tablica zawartości danych wyjściowych wywołań powłoki | Yes | |
| typ | wyliczenie | Typ danych wyjściowych wywołania powłoki. Zawsze shell_call_output.Możliwe wartości: shell_call_output |
Yes |
OpenAI.ItemResourceFunctionToolCallOutputResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania narzędzia funkcji. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. |
Nie. | |
| We/Wy | ciąg lub tablica obiektu OpenAI.FunctionAndCustomToolCallOutput | Dane wyjściowe wywołania funkcji wygenerowanego przez kod. Może być ciągiem lub listą zawartości wyjściowej. |
Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ danych wyjściowych wywołania narzędzia funkcji. Zawsze function_call_output.Możliwe wartości: function_call_output |
Yes |
OpenAI.ItemResourceFunctionToolCallResource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia funkcjonalnego. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Yes | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ wywołania funkcji narzędziowej. Zawsze function_call.Możliwe wartości: function_call |
Yes |
OpenAI.ItemResourceImageGenToolCall
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator wywołania generowania obrazu. | Yes | |
| result | ciąg (dopuszczany do wartości null) | Yes | ||
| stan | wyliczenie | Stan wywołania generowania obrazu. Możliwe wartości: in_progress, , completed, generatingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania generowania obrazu. Zawsze image_generation_call.Możliwe wartości: image_generation_call |
Yes |
OpenAI.ItemResourceLocalShellToolCall
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator lokalnego wywołania powłoki. | Yes | |
| stan | wyliczenie | Stan lokalnego wywołania powłoki. Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ lokalnego wywołania powłoki. Zawsze local_shell_call.Możliwe wartości: local_shell_call |
Yes |
OpenAI.ItemResourceLocalShellToolCallOutput
Dane wyjściowe lokalnego wywołania narzędzia powłoki.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| We/Wy | ciąg | Ciąg JSON reprezentujący dane wyjściowe z wywołania lokalnego narzędzia powłoki. | Yes | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ lokalnego narzędzia powłoki wywołuje dane wyjściowe. Zawsze local_shell_call_output.Możliwe wartości: local_shell_call_output |
Yes |
OpenAI.ItemResourceMcpApprovalRequest
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator żądania zatwierdzenia. | Yes | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_request.Możliwe wartości: mcp_approval_request |
Yes |
OpenAI.ItemResourceMcpApprovalResponseResource
Odpowiedź na żądanie zatwierdzenia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg | Identyfikator odpowiedzi na żądanie zatwierdzenia. | Yes | |
| approve | boolean | Czy żądanie zostało zatwierdzone. | Yes | |
| id | ciąg | Unikatowy identyfikator odpowiedzi zatwierdzenia | Yes | |
| powód | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_response.Możliwe wartości: mcp_approval_response |
Yes |
OpenAI.ItemResourceMcpListTools
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator listy. | Yes | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Yes | |
| Narzędzia | tablica narzędzi OpenAI.MCPListToolsTools | Narzędzia dostępne na serwerze. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_list_tools.Możliwe wartości: mcp_list_tools |
Yes |
OpenAI.ItemResourceMcpToolCall
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| approval_request_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Yes | |
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator wywołania narzędzia. | Yes | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Yes | |
| stan | OpenAI.MCPToolCallStatus | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_call.Możliwe wartości: mcp_call |
Yes |
OpenAI.ItemResourceOutputMessage
Komunikat wyjściowy z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | tablica elementów OpenAI.OutputMessageContent | Zawartość komunikatu wyjściowego. | Yes | |
| id | ciąg | Unikatowy identyfikator komunikatu wyjściowego. | Yes | |
| rola | wyliczenie | Rola komunikatu wyjściowego. Zawsze assistant.Możliwe wartości: assistant |
Yes | |
| stan | wyliczenie | Stan danych wejściowych komunikatu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy wejściowe są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ komunikatu wyjściowego. Zawsze message.Możliwe wartości: output_message |
Yes |
OpenAI.ItemResourceType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Wyniki wywołania narzędzia wyszukiwania w Internecie. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania w Internecie .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.WebSearchActionSearch lub OpenAI.WebSearchActionOpenPage lub OpenAI.WebSearchActionFind | Obiekt opisujący określoną akcję podjętą w tym wywołaniu wyszukiwania w sieci Web. Zawiera szczegółowe informacje na temat sposobu użycia modelu w Internecie (wyszukiwanie, open_page, znajdowanie). |
Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania w Internecie. | Yes | |
| stan | wyliczenie | Stan działania wyszukiwarki internetowej. Możliwe wartości: in_progress, , searching, completedfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania w Internecie. Zawsze web_search_call.Możliwe wartości: web_search_call |
Yes |
OpenAI.ItemType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Wyniki wywołania narzędzia wyszukiwania w Internecie. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania w Internecie .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.WebSearchActionSearch lub OpenAI.WebSearchActionOpenPage lub OpenAI.WebSearchActionFind | Obiekt opisujący określoną akcję podjętą w tym wywołaniu wyszukiwania w sieci Web. Zawiera szczegółowe informacje na temat sposobu użycia modelu w Internecie (wyszukiwanie, open_page, znajdowanie). |
Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania w Internecie. | Yes | |
| stan | wyliczenie | Stan działania wyszukiwarki internetowej. Możliwe wartości: in_progress, , searching, completedfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania w Internecie. Zawsze web_search_call.Możliwe wartości: web_search_call |
Yes |
OpenAI.KeyPressAction
Kolekcja naciśnięć klawiszy, które model chciałby wykonać.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| keys | tablica ciągów | Kombinacja klawiszy, którą model żąda naciśnięcia. Jest to tablica ciągów, z których każdy reprezentuje klucz. | Yes | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji keypress ta właściwość jest zawsze ustawiona na wartość keypress.Możliwe wartości: keypress |
Yes |
OpenAI.ListFineTuningJobCheckpointsResponse
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane | tablica openAI.FineTuningJobCheckpoint | Yes | ||
| first_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| zawiera_więcej | boolean | Yes | ||
| last_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Yes |
OpenAI.ListFineTuningJobEventsResponse
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane | tablica obiektów OpenAI.FineTuningJobEvent | Yes | ||
| zawiera_więcej | boolean | Yes | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Yes |
OpenAI.ListPaginatedFineTuningJobsResponse
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane | tablica obiektów OpenAI.FineTuningJob | Yes | ||
| zawiera_więcej | boolean | Yes | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Yes |
OpenAI.LocalShellCallStatus
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompletedincomplete |
OpenAI.LocalShellExecAction
Wykonaj polecenie powłoki na serwerze.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| polecenie | tablica ciągów | Polecenie do uruchomienia. | Yes | |
| środowisko | obiekt | Zmienne środowiskowe, które należy ustawić dla polecenia. | Yes | |
| limit_czasu_ms | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| typ | wyliczenie | Typ akcji lokalnego interfejsu powłoki. Zawsze exec.Możliwe wartości: exec |
Yes | |
| użytkownik | ciąg (dopuszczany do wartości null) | Nie. | ||
| katalog roboczy | ciąg (dopuszczany do wartości null) | Nie. |
OpenAI.LocalShellToolParam
Narzędzie, które umożliwia modelowi wykonywanie poleceń powłoki w środowisku lokalnym.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ lokalnego narzędzia powłoki systemowej. Zawsze local_shell.Możliwe wartości: local_shell |
Yes |
OpenAI.LogProb
Prawdopodobieństwo logarytmiczne tokenu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| bytes | tablica wartości OpenAI.integer | Yes | ||
| logprob | OpenAI.numeric | Yes | ||
| kod przedpłaty | ciąg | Yes | ||
| top_logprobs | tablica biblioteki OpenAI.TopLogProb | Yes |
OpenAI.MCPListToolsTool
Narzędzie dostępne na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| annotations | OpenAI.MCPListToolsToolsAnnotations (dopuszczana wartość null) | Nie. | ||
| opis | ciąg (dopuszczany do wartości null) | Nie. | ||
| input_schema | OpenAI.MCPListToolsToolsToolInputSchema | Yes | ||
| nazwa | ciąg | Nazwa narzędzia. | Yes |
OpenAI.MCPListToolsToolsAnnotations
Typ: obiekt
OpenAI.MCPListToolsToolsToolInputSchema
Typ: obiekt
OpenAI.MCPTool
Nadaj modelowi dostęp do dodatkowych narzędzi za pośrednictwem zdalnych serwerów protokołu MCP (Model Context Protocol). Dowiedz się więcej o mcp.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dozwolone_narzędzia | tablica ciągów lub OpenAI.MCPToolFilter | Nie. | ||
| autoryzacja | ciąg | Token dostępu OAuth, który może być używany ze zdalnym serwerem MCP, albo z niestandardowym adresem URL serwera MCP lub łącznikiem usługi. Twoja aplikacja Musi obsługiwać przepływ autoryzacji OAuth i podać tutaj token. |
Nie. | |
| connector_id | wyliczenie | Identyfikator łączników usług, takich jak te dostępne w module ChatGPT. Jeden zserver_url lub connector_id musi być podany. Dowiedz się więcej o usłudzełączniki tutaj. Obecnie obsługiwane connector_id wartości to:-Dropbox: connector_dropbox-Gmail: connector_gmail- Kalendarz Google: connector_googlecalendar- Dysk Google: connector_googledrive— Microsoft Teams: connector_microsoftteams- Kalendarz programu Outlook: connector_outlookcalendar- Poczta e-mail programu Outlook: connector_outlookemail-Programu sharepoint: connector_sharepointMożliwe wartości: connector_dropbox, , connector_gmailconnector_googlecalendar, connector_googledriveconnector_microsoftteams, , connector_outlookcalendar, , connector_outlookemailconnector_sharepoint |
Nie. | |
| headers | object (dopuszczana wartość null) | Nie. | ||
| project_connection_id | ciąg | Identyfikator połączenia w project dla serwera MCP. W połączeniu przechowywane są dane uwierzytelniające i inne szczegóły połączenia potrzebne do nawiązania połączenia z serwerem MCP. | Nie. | |
| wymaga_akceptacji | object (zobacz prawidłowe modele poniżej) | Nie. | ||
| server_description | ciąg | Opcjonalny opis serwera MCP używany do zapewnienia większej liczby kontekstów. | Nie. | |
| etykieta_serwera | ciąg | Etykieta dla tego serwera MCP używana do identyfikowania go w wywołaniach narzędzi. | Yes | |
| adres_serwera | ciąg | Adres URL serwera MCP. Jeden z lub server_urlconnector_id musi byćDostarczane. |
Nie. | |
| typ | wyliczenie | Typ narzędzia MCP. Zawsze mcp.Możliwe wartości: mcp |
Yes |
OpenAI.MCPToolCallStatus
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompletedincompletecallingfailed |
OpenAI.MCPToolFilter
Obiekt filtru określający, które narzędzia są dozwolone.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Tylko_do_odczytu | boolean | Wskazuje, czy narzędzie modyfikuje dane, czy jest tylko do odczytu. Jeśli Serwer MCP jest oznaczony adnotacjami za pomocą polecenia readOnlyHint,będzie pasować do tego filtru. |
Nie. | |
| tool_names | tablica ciągów | Lista dozwolonych nazw narzędzi. | Nie. |
OpenAI.MCPToolRequireApproval
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Zawsze | OpenAI.MCPToolFilter | Obiekt filtru określający, które narzędzia są dozwolone. | Nie. | |
| nigdy | OpenAI.MCPToolFilter | Obiekt filtru określający, które narzędzia są dozwolone. | Nie. |
OpenAI.MessageContent
Część zawartości tworząca element wejściowy lub wyjściowy.
Dyskryminujący plik OpenAI.MessageContent
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
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 |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.MessageContentType | Yes |
OpenAI.MessageContentInputFileContent
Plik wejściowy do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| file_data | ciąg | Zawartość pliku, który ma zostać wysłany do modelu. | Nie. | |
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| file_url | ciąg | Adres URL pliku, który ma zostać wysłany do modelu. | Nie. | |
| filename | ciąg | Nazwa pliku, który ma zostać wysłany do modelu. | Nie. | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_file.Możliwe wartości: input_file |
Yes |
OpenAI.MessageContentInputImageContent
Dane wejściowe obrazu do modelu. Dowiedz się więcej o danych wejściowych obrazów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| detail | OpenAI.ImageDetail | Yes | ||
| identyfikator_pliku | ciąg (dopuszczany do wartości null) | Nie. | ||
| image_url | ciąg | Nie. | ||
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_image.Możliwe wartości: input_image |
Yes |
OpenAI.MessageContentInputTextContent
Wprowadzanie tekstu do modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. | Yes | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Yes |
OpenAI.MessageContentOutputTextContent
Dane wyjściowe tekstowe z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| annotations | tablica adnotacji OpenAI.Annotation | Adnotacje tekstu wyjściowego. | Yes | |
| logprobs | tablica biblioteki OpenAI.LogProb | Nie. | ||
| SMS | ciąg | Dane wyjściowe tekstu z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu wyjściowego. Zawsze output_text.Możliwe wartości: output_text |
Yes |
OpenAI.MessageContentReasoningTextContent
Tekst rozumowania z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Tekst rozumowania z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu rozumowania. Zawsze reasoning_text.Możliwe wartości: reasoning_text |
Yes |
OpenAI.MessageContentRefusalContent
Odmowa ze strony modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| refusal | ciąg | Wyjaśnienie odmowy dostarczone przez model. | Yes | |
| typ | wyliczenie | Rodzaj odmowy. Zawsze refusal.Możliwe wartości: refusal |
Yes |
OpenAI.MessageContentType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | input_textoutput_texttextsummary_textreasoning_textrefusalinput_imagecomputer_screenshotinput_file |
OpenAI.MessageRole
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | unknownuserassistantsystemcriticdiscriminatordevelopertool |
OpenAI.MessageStatus
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | in_progresscompletedincomplete |
OpenAI.Metadata
Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w formacie ustrukturyzowanym i wykonywania zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków.
Typ: obiekt
OpenAI.ModelIdsCompaction
Identyfikator modelu używany do generowania odpowiedzi, na przykład gpt-5 lub o3. Platforma OpenAI oferuje szeroką gamę modeli z różnymi możliwościami, charakterystykami wydajności i punktami cenowymi. Zapoznaj się z przewodnikiem po modelu , aby przeglądać i porównywać dostępne modele.
Typ: OpenAI.ModelIdsResponses lub ciąg
Identyfikator modelu używany do generowania odpowiedzi, na przykład gpt-5 lub o3. Platforma OpenAI oferuje szeroką gamę modeli z różnymi możliwościami, charakterystykami wydajności i punktami cenowymi. Zapoznaj się z przewodnikiem po modelu , aby przeglądać i porównywać dostępne modele.
OpenAI.ModelIdsResponses
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Typ: ciąg lub OpenAI.ChatModel
OpenAI.Move
Akcja ruchu myszy.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku ruchu, ta właściwość to zawsze ustawiony na move.Możliwe wartości: move |
Yes | |
| x | OpenAI.integer | Yes | ||
| y | OpenAI.integer | Yes |
OpenAI.OutputContent
Dyskryminujące dla interfejsu OpenAI.OutputContent
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
output_text |
OpenAI.OutputContentOutputTextContent |
refusal |
OpenAI.OutputContentRefusalContent |
reasoning_text |
OpenAI.OutputContentReasoningTextContent |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.OutputContentType | Yes |
OpenAI.OutputContentOutputTextContent
Dane wyjściowe tekstowe z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| annotations | tablica adnotacji OpenAI.Annotation | Adnotacje tekstu wyjściowego. | Yes | |
| logprobs | tablica biblioteki OpenAI.LogProb | Nie. | ||
| SMS | ciąg | Dane wyjściowe tekstu z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu wyjściowego. Zawsze output_text.Możliwe wartości: output_text |
Yes |
OpenAI.OutputContentReasoningTextContent
Tekst rozumowania z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Tekst rozumowania z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu rozumowania. Zawsze reasoning_text.Możliwe wartości: reasoning_text |
Yes |
OpenAI.OutputContentRefusalContent
Odmowa ze strony modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| refusal | ciąg | Wyjaśnienie odmowy dostarczone przez model. | Yes | |
| typ | wyliczenie | Rodzaj odmowy. Zawsze refusal.Możliwe wartości: refusal |
Yes |
OpenAI.OutputContentType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | output_textrefusalreasoning_text |
OpenAI.OutputItem
Dyskryminujące dla openAI.OutputItem
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| typ | OpenAI.OutputItemType | Yes |
OpenAI.OutputItemApplyPatchToolCall
Wywołanie narzędzia, które stosuje różnice plików przez tworzenie, usuwanie lub aktualizowanie plików.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to wywołanie narzędzia. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| operacja | OpenAI.ApplyPatchFileOperation | Jedną z operacji create_file, delete_file lub update_file stosowanych za pośrednictwem apply_patch. | Yes | |
| └typ | OpenAI.ApplyPatchFileOperationType | Yes | ||
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | OpenAI.ApplyPatchCallStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call.Możliwe wartości: apply_patch_call |
Yes |
OpenAI.OutputItemApplyPatchToolCallOutput
Dane wyjściowe emitowane przez wywołanie narzędzia zastosuj poprawkę.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia stosowania poprawek wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to narzędzie, wywołuje dane wyjściowe. | Nie. | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania narzędzia stosowania poprawek. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | OpenAI.ApplyPatchCallOutputStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze apply_patch_call_output.Możliwe wartości: apply_patch_call_output |
Yes |
OpenAI.OutputItemCodeInterpreterToolCall
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia interpretera kodu. | Yes | |
| outputs | tablica obiektów OpenAI.CodeInterpreterOutputLogs lub OpenAI.CodeInterpreterOutputImage | Yes | ||
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan wywołania narzędzia interpretera kodu. Prawidłowe wartości to in_progress, , completedincomplete, interpreting, i failed.Możliwe wartości: in_progress, , completedincomplete, , interpretingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia interpretera kodu. Zawsze code_interpreter_call.Możliwe wartości: code_interpreter_call |
Yes |
OpenAI.OutputItemCompactionBody
Element kompaktowania generowany przez v1/responses/compact interfejs API.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| utworzone_przez | ciąg | Identyfikator aktora, który utworzył element. | Nie. | |
| encrypted_content | ciąg | Zaszyfrowana zawartość, która została utworzona przez kompaktowanie. | Yes | |
| id | ciąg | Unikatowy identyfikator elementu kompaktowania. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| typ | wyliczenie | Typ elementu. Zawsze compaction.Możliwe wartości: compaction |
Yes |
OpenAI.OutputItemComputerToolCall
Narzędzie wywołujące narzędzie do korzystania z komputera. Aby uzyskać więcej informacji, zobacz przewodnik dotyczący korzystania z komputera .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Yes | ||
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania komputera. | Yes | |
| pending_safety_checks | tablica openAI.ComputerCallSafetyCheckParam | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ wywołania komputera. Zawsze computer_call.Możliwe wartości: computer_call |
Yes |
OpenAI.OutputItemCustomToolCall
Wywołanie niestandardowego narzędzia utworzonego przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Identyfikator używany do mapowania tego niestandardowego wywołania narzędzia na dane wyjściowe wywołania narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator niestandardowego wywołania narzędzia na platformie OpenAI. | Nie. | |
| dane wejściowe | ciąg | Dane wejściowe dla niestandardowego wywołania narzędzia wygenerowanego przez model. | Yes | |
| nazwa | ciąg | Nazwa wywoływanego narzędzia niestandardowego. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| typ | wyliczenie | Typ niestandardowego wywołania narzędzia. Zawsze custom_tool_call.Możliwe wartości: custom_tool_call |
Yes |
OpenAI.OutputItemFileSearchToolCall
Wyniki wywołania narzędzia wyszukiwania plików. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania plików .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania plików. | Yes | |
| queries | tablica ciągów | Zapytania używane do wyszukiwania plików. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| results | tablica obiektów OpenAI.FileSearchToolCallResults | Nie. | ||
| stan | wyliczenie | Stan wywołania narzędzia do wyszukiwania plików. Jeden z in_progresssearching, lub incomplete, failedMożliwe wartości: in_progress, , searchingcompleted, , incompletefailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania plików. Zawsze file_search_call.Możliwe wartości: file_search_call |
Yes |
OpenAI.OutputItemFunctionShellCall
Wywołanie narzędzia, które wykonuje co najmniej jedno polecenie powłoki w środowisku zarządzanym.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.FunctionShellAction | Wykonaj polecenie powłoki. | Yes | |
| Polecenia └* | tablica ciągów | Yes | ||
| └max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| └timeout_ms | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator jednostki, która utworzyła to wywołanie narzędzia. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | OpenAI.LocalShellCallStatus | Yes | ||
| typ | wyliczenie | Typ elementu. Zawsze shell_call.Możliwe wartości: shell_call |
Yes |
OpenAI.OutputItemFunctionShellCallOutput
Dane wyjściowe wywołania narzędzia powłoki, które zostało wyemitowane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Unikatowy identyfikator wywołania narzędzia powłoki wygenerowany przez model. | Yes | |
| utworzone_przez | ciąg | Identyfikator aktora, który utworzył element. | Nie. | |
| id | ciąg | Unikatowy identyfikator danych wyjściowych wywołania powłoki. Wypełniane, gdy ten element jest zwracany za pośrednictwem interfejsu API. | Yes | |
| max_output_length | OpenAI.integer (dopuszczający wartość null) | Yes | ||
| We/Wy | tablica elementów OpenAI.FunctionShellCallOutputContent | Tablica zawartości danych wyjściowych wywołań powłoki | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| typ | wyliczenie | Typ danych wyjściowych wywołania powłoki. Zawsze shell_call_output.Możliwe wartości: shell_call_output |
Yes |
OpenAI.OutputItemFunctionToolCall
Wywołanie narzędzia w celu uruchomienia funkcji. Aby uzyskać więcej informacji, zobacz przewodnik wywoływania funkcji .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Yes | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia funkcjonalnego. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| typ | wyliczenie | Typ wywołania funkcji narzędziowej. Zawsze function_call.Możliwe wartości: function_call |
Yes |
OpenAI.OutputItemImageGenToolCall
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania generowania obrazu. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| result | ciąg (dopuszczany do wartości null) | Yes | ||
| stan | wyliczenie | Stan wywołania generowania obrazu. Możliwe wartości: in_progress, , completed, generatingfailed |
Yes | |
| typ | wyliczenie | Typ wywołania generowania obrazu. Zawsze image_generation_call.Możliwe wartości: image_generation_call |
Yes |
OpenAI.OutputItemLocalShellToolCall
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Yes | |
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| call_id | ciąg | Unikalny identyfikator wywołania lokalnego narzędzia shella wygenerowanego przez model. | Yes | |
| id | ciąg | Unikatowy identyfikator lokalnego wywołania powłoki. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan lokalnego wywołania powłoki. Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ lokalnego wywołania powłoki. Zawsze local_shell_call.Możliwe wartości: local_shell_call |
Yes |
OpenAI.OutputItemMcpApprovalRequest
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Yes | |
| id | ciąg | Unikatowy identyfikator żądania zatwierdzenia. | Yes | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_approval_request.Możliwe wartości: mcp_approval_request |
Yes |
OpenAI.OutputItemMcpListTools
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator listy. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Yes | |
| Narzędzia | tablica narzędzi OpenAI.MCPListToolsTools | Narzędzia dostępne na serwerze. | Yes | |
| typ | wyliczenie | Typ elementu. Zawsze mcp_list_tools.Możliwe wartości: mcp_list_tools |
Yes |
OpenAI.OutputItemMcpToolCall
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| approval_request_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Yes | |
| błąd | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator wywołania narzędzia. | Yes | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Yes | |
| We/Wy | ciąg (dopuszczany do wartości null) | Nie. | ||
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Yes | |
| stan | OpenAI.MCPToolCallStatus | Nie. | ||
| typ | wyliczenie | Typ elementu. Zawsze mcp_call.Możliwe wartości: mcp_call |
Yes |
OpenAI.OutputItemOutputMessage
Komunikat wyjściowy z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| zawartość | tablica elementów OpenAI.OutputMessageContent | Zawartość komunikatu wyjściowego. | Yes | |
| id | ciąg | Unikatowy identyfikator komunikatu wyjściowego. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| rola | wyliczenie | Rola komunikatu wyjściowego. Zawsze assistant.Możliwe wartości: assistant |
Yes | |
| stan | wyliczenie | Stan danych wejściowych komunikatu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy wejściowe są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Yes | |
| typ | wyliczenie | Typ komunikatu wyjściowego. Zawsze message.Możliwe wartości: output_message |
Yes |
OpenAI.OutputItemReasoningItem
Opis łańcucha myśli używanego przez model rozumowania podczas generowania odpowiedzi. Pamiętaj, aby uwzględnić te elementy w input interfejsie API odpowiedzi na kolejne etapy konwersacji, jeśli ręcznie zarządzasz kontekstem.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| zawartość | tablica obiektu OpenAI.ReasoningTextContent | Wnioskowanie zawartości tekstowej. | Nie. | |
| encrypted_content | ciąg (dopuszczany do wartości null) | Nie. | ||
| id | ciąg | Unikatowy identyfikator zawartości rozumowania. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan elementu.
in_progressJeden zcompleted, lubincomplete. Wypełniane, gdy elementy są zwracane za pośrednictwem interfejsu API.Możliwe wartości: in_progress, , completedincomplete |
Nie. | |
| podsumowanie | tablica interfejsu OpenAI.Summary | Rozumowanie zawartości podsumowania. | Yes | |
| typ | wyliczenie | Typ obiektu. Zawsze reasoning.Możliwe wartości: reasoning |
Yes |
OpenAI.OutputItemType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Wyniki wywołania narzędzia wyszukiwania w Internecie. Aby uzyskać więcej informacji, zobacz przewodnik wyszukiwania w Internecie .
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| akcja | OpenAI.WebSearchActionSearch lub OpenAI.WebSearchActionOpenPage lub OpenAI.WebSearchActionFind | Obiekt opisujący określoną akcję podjętą w tym wywołaniu wyszukiwania w sieci Web. Zawiera szczegółowe informacje na temat sposobu użycia modelu w Internecie (wyszukiwanie, open_page, znajdowanie). |
Yes | |
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| id | ciąg | Unikatowy identyfikator wywołania narzędzia wyszukiwania w Internecie. | Yes | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan działania wyszukiwarki internetowej. Możliwe wartości: in_progress, , searching, completedfailed |
Yes | |
| typ | wyliczenie | Typ wywołania narzędzia wyszukiwania w Internecie. Zawsze web_search_call.Możliwe wartości: web_search_call |
Yes |
OpenAI.OutputMessageContent
Dyskryminujące dla elementu OpenAI.OutputMessageContent
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
output_text |
OpenAI.OutputMessageContentOutputTextContent |
refusal |
OpenAI.OutputMessageContentRefusalContent |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.OutputMessageContentType | Yes |
OpenAI.OutputMessageContentOutputTextContent
Dane wyjściowe tekstowe z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| annotations | tablica adnotacji OpenAI.Annotation | Adnotacje tekstu wyjściowego. | Yes | |
| logprobs | tablica biblioteki OpenAI.LogProb | Nie. | ||
| SMS | ciąg | Dane wyjściowe tekstu z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu wyjściowego. Zawsze output_text.Możliwe wartości: output_text |
Yes |
OpenAI.OutputMessageContentRefusalContent
Odmowa ze strony modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| refusal | ciąg | Wyjaśnienie odmowy dostarczone przez model. | Yes | |
| typ | wyliczenie | Rodzaj odmowy. Zawsze refusal.Możliwe wartości: refusal |
Yes |
OpenAI.OutputMessageContentType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | output_textrefusal |
OpenAI.Prompt
Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| id | ciąg | Unikatowy identyfikator szablonu monitu do użycia. | Yes | |
| variables | OpenAI.ResponsePromptVariables (dopuszczana wartość null) | Opcjonalna mapa wartości, które mają być zastępowane zmiennymi w prompt. Wartości podstawienia mogą być ciągami znaków lub innymi wartościami. Typy danych wejściowych odpowiedzi, takie jak obrazy lub pliki. |
Nie. | |
| wersja | ciąg (dopuszczany do wartości null) | Nie. |
OpenAI.RankerVersionType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | autodefault-2024-11-15 |
OpenAI.RankingOptions
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| hybrid_search | OpenAI.HybridSearchOptions | Nie. | ||
| └embedding_weight | OpenAI.numeric | Waga osadzania w wzajemnym połączeniu rankingowym. | Yes | |
| └text_weight | OpenAI.numeric | Waga tekstu w wzajemnym połączeniu klasyfikacji. | Yes | |
| klasyfikator | OpenAI.RankerVersionType | Nie. | ||
| próg punktowy | OpenAI.numeric | Nie. |
OpenAI.Reasoning
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modeli rozumowania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nakład pracy | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| generate_summary | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. |
OpenAI.ReasoningEffort
Ogranicza nakład pracy na modele rozumowania.
Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi.
-
gpt-5.1wartość domyślna tonone, która nie wykonuje rozumowania. Obsługiwane wartościgpt-5.1rozumowania tonone,low,mediumihigh. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. - Wszystkie modele przed
gpt-5.1ustawieniem domyślnym namediumpotrzeby uczenia się i nie obsługują elementunone. - Domyślnie
gpt-5-promodel ma (i obsługuje tylko)highwysiłek rozumowania. -
xhighjest obsługiwany dla wszystkich modeli pogpt-5.1-codex-max.
| Property | Value |
|---|---|
| Type | ciąg |
| Nullable | Yes |
| Wartości | noneminimallowmediumhighxhigh |
OpenAI.ReasoningTextContent
Tekst rozumowania z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Tekst rozumowania z modelu. | Yes | |
| typ | wyliczenie | Typ tekstu rozumowania. Zawsze reasoning_text.Możliwe wartości: reasoning_text |
Yes |
OpenAI.Response
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference (dopuszczana wartość null) | Yes | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| zakończono_o | liczba całkowita | Nie. | ||
| konwersacja | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator konwersacji, z którą została skojarzona ta odpowiedź. | Yes | |
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ kod | OpenAI.ResponseErrorCode | Kod błędu odpowiedzi. | Yes | |
| └─ Komunikat | ciąg | Czytelny dla człowieka opis błędu. | Yes | |
| id | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| incomplete_details | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └* przyczyna | wyliczenie | Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| instructions | ciąg lub tablica elementu OpenAI.InputItem | Yes | ||
| max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| maks_liczba_wywołań_narzędzi | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| We/Wy | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| wywołania_narzędzia_równoległe | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| monit | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| reasoning | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └─ wysiłek | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| └─ generuj_podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| └─ Podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| poziom usługi | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| stan | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| SMS | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| tool_choice | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| truncation | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. |
OpenAI.ResponseAudioDeltaEvent
Występuje w przypadku częściowej odpowiedzi głosowej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Fragment bajtów audio odpowiedzi zakodowanych w formacie Base64. | Yes | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.audio.delta.Możliwe wartości: response.audio.delta |
Yes |
OpenAI.ResponseAudioDoneEvent
Emitowane po zakończeniu odpowiedzi audio.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.audio.done.Możliwe wartości: response.audio.done |
Yes |
OpenAI.ResponseAudioTranscriptDeltaEvent
Emitowane w przypadku częściowej transkrypcji dźwięku.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Częściowa transkrypcja odpowiedzi audio. | Yes | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.audio.transcript.delta.Możliwe wartości: response.audio.transcript.delta |
Yes |
OpenAI.ResponseAudioTranscriptDoneEvent
Emitowany po zakończeniu pełnej transkrypcji audio.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.audio.transcript.done.Możliwe wartości: response.audio.transcript.done |
Yes |
OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent
Emitowane, gdy częściowy fragment kodu jest przesyłany w strumieniu przez interpreter kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Fragment kodu przesyłany strumieniowo przez interpreter kodu. | Yes | |
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call_code.delta.Możliwe wartości: response.code_interpreter_call_code.delta |
Yes |
OpenAI.ResponseCodeInterpreterCallCodeDoneEvent
Emitowane, gdy fragment kodu jest finalizowany przez interpreter kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg | Ostateczny wynik fragmentu kodu generowany przez interpretatora kodu. | Yes | |
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call_code.done.Możliwe wartości: response.code_interpreter_call_code.done |
Yes |
OpenAI.ResponseCodeInterpreterCallCompletedEvent
Emitowane po zakończeniu wywołania interpretera kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call.completed.Możliwe wartości: response.code_interpreter_call.completed |
Yes |
OpenAI.ResponseCodeInterpreterCallInProgressEvent
Emitowane, gdy trwa wywołanie interpretera kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call.in_progress.Możliwe wartości: response.code_interpreter_call.in_progress |
Yes |
OpenAI.ResponseCodeInterpreterCallInterpretingEvent
Emitowane, gdy interpreter kodu aktywnie interpretuje fragment kodu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call.interpreting.Możliwe wartości: response.code_interpreter_call.interpreting |
Yes |
OpenAI.ResponseCompletedEvent
Emitowane po zakończeniu odpowiedzi modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| response | OpenAI.Response | Yes | ||
| └agent_reference | AgentReference (dopuszczana wartość null) | Agent używany na potrzeby tej odpowiedzi | Yes | |
| └* tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| └completed_at | Liczba całkowita (dopuszczana do wartości null) | Nie. | ||
| Konwersacja └* | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| └─ błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| └niekompletne_szczegóły | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └─ instrukcje | ciąg lub tablica elementu OpenAI.InputItem (dopuszczana do wartości null) | Yes | ||
| └─ max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └max_tool_calls | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Metadane └* | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| └─ Model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| └─ Dane wyjściowe | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| └output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| └parallel_tool_calls | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| └previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| └prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| └─ Status | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* tekst | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| └─ Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| └ top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* skrócenie | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| └─ użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| └─ Użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.completed.Możliwe wartości: response.completed |
Yes |
OpenAI.ResponseContentPartAddedEvent
Emitowane po dodaniu nowej części zawartości.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego została dodana część zawartości. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| część | OpenAI.OutputContent | Yes | ||
| └typ | OpenAI.OutputContentType | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.content_part.added.Możliwe wartości: response.content_part.added |
Yes |
OpenAI.ResponseContentPartDoneEvent
Emitowane po zakończeniu części zawartości.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego została dodana część zawartości. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| część | OpenAI.OutputContent | Yes | ||
| └typ | OpenAI.OutputContentType | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.content_part.done.Możliwe wartości: response.content_part.done |
Yes |
OpenAI.ResponseCreatedEvent
Zdarzenie emitowane podczas tworzenia odpowiedzi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| response | OpenAI.Response | Yes | ||
| └agent_reference | AgentReference (dopuszczana wartość null) | Agent używany na potrzeby tej odpowiedzi | Yes | |
| └* tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| └completed_at | Liczba całkowita (dopuszczana do wartości null) | Nie. | ||
| Konwersacja └* | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| └─ błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| └niekompletne_szczegóły | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └─ instrukcje | ciąg lub tablica elementu OpenAI.InputItem (dopuszczana do wartości null) | Yes | ||
| └─ max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └max_tool_calls | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Metadane └* | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| └─ Model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| └─ Dane wyjściowe | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| └output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| └parallel_tool_calls | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| └previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| └prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| └─ Status | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* tekst | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| └─ Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| └ top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* skrócenie | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| └─ użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| └─ Użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.created.Możliwe wartości: response.created |
Yes |
OpenAI.ResponseCustomToolCallInputDeltaEvent
Zdarzenie reprezentujące różnicę (częściową aktualizację) do danych wejściowych niestandardowego wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Przyrostowe dane wejściowe (delta) dla niestandardowego wywołania narzędzia. | Yes | |
| item_id | ciąg | Unikatowy identyfikator elementu interfejsu API skojarzonego z tym zdarzeniem. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Identyfikator typu zdarzenia. Możliwe wartości: response.custom_tool_call_input.delta |
Yes |
OpenAI.ResponseCustomToolCallInputDoneEvent
Zdarzenie wskazujące, że dane wejściowe dla niestandardowego wywołania narzędzia są ukończone.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dane wejściowe | ciąg | Pełne dane wejściowe dla wywołania niestandardowego narzędzia. | Yes | |
| item_id | ciąg | Unikatowy identyfikator elementu interfejsu API skojarzonego z tym zdarzeniem. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Identyfikator typu zdarzenia. Możliwe wartości: response.custom_tool_call_input.done |
Yes |
OpenAI.ResponseError
Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | OpenAI.ResponseErrorCode | Kod błędu odpowiedzi. | Yes | |
| komunikat | ciąg | Czytelny dla człowieka opis błędu. | Yes |
OpenAI.ResponseErrorCode
Kod błędu odpowiedzi.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Emitowane w przypadku wystąpienia błędu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| kod | ciąg (dopuszczany do wartości null) | Yes | ||
| komunikat | ciąg | Komunikat o błędzie. | Yes | |
| param | ciąg (dopuszczany do wartości null) | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze error.Możliwe wartości: error |
Yes |
OpenAI.ResponseFailedEvent
Zdarzenie emitowane w przypadku niepowodzenia odpowiedzi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| response | OpenAI.Response | Yes | ||
| └agent_reference | AgentReference (dopuszczana wartość null) | Agent używany na potrzeby tej odpowiedzi | Yes | |
| └* tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| └completed_at | Liczba całkowita (dopuszczana do wartości null) | Nie. | ||
| Konwersacja └* | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| └─ błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| └niekompletne_szczegóły | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └─ instrukcje | ciąg lub tablica elementu OpenAI.InputItem (dopuszczana do wartości null) | Yes | ||
| └─ max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └max_tool_calls | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Metadane └* | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| └─ Model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| └─ Dane wyjściowe | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| └output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| └parallel_tool_calls | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| └previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| └prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| └─ Status | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* tekst | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| └─ Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| └ top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* skrócenie | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| └─ użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| └─ Użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.failed.Możliwe wartości: response.failed |
Yes |
OpenAI.ResponseFileSearchCallCompletedEvent
Emitowane po zakończeniu wywołania wyszukiwania plików (znaleziono wyniki).
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.file_search_call.completed.Możliwe wartości: response.file_search_call.completed |
Yes |
OpenAI.ResponseFileSearchCallInProgressEvent
Emitowane po zainicjowaniu wywołania wyszukiwania plików.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.file_search_call.in_progress.Możliwe wartości: response.file_search_call.in_progress |
Yes |
OpenAI.ResponseFileSearchCallSearchingEvent
Emitowane, gdy wyszukiwanie plików jest obecnie przeszukiwane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.file_search_call.searching.Możliwe wartości: response.file_search_call.searching |
Yes |
OpenAI.ResponseFormatJsonObject
Format odpowiedzi obiektu JSON. Starsza metoda generowania odpowiedzi JSON.
Użycie json_schema jest zalecane w przypadku modeli, które go obsługują. Należy pamiętać, że model nie wygeneruje kodu JSON bez komunikatu systemu lub użytkownika z instrukcjami, aby to zrobił.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_object.Możliwe wartości: json_object |
Yes |
OpenAI.ResponseFormatJsonSchema
Format odpowiedzi schematu JSON. Służy do generowania ustrukturyzowanych odpowiedzi JSON. Dowiedz się więcej o danych wyjściowych ze strukturą.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| json_schema | OpenAI.ResponseFormatJsonSchemaJsonSchemaSchema | Yes | ||
| Opis └* | ciąg | Nie. | ||
| └─ nazwa | ciąg | Yes | ||
| Schemat └* | OpenAI.ResponseFormatJsonSchemaSchema | Schemat formatu odpowiedzi, opisany jako obiekt schematu JSON. Dowiedz się, jak tworzyć schematy JSON tutaj. |
Nie. | |
| └* ścisłe | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_schema.Możliwe wartości: json_schema |
Yes |
OpenAI.ResponseFormatJsonSchemaJsonSchemaSchema
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Nie. | ||
| nazwa | ciąg | Yes | ||
| schemat | OpenAI.ResponseFormatJsonSchemaSchema | Schemat formatu odpowiedzi, opisany jako obiekt schematu JSON. Dowiedz się, jak tworzyć schematy JSON tutaj. |
Nie. | |
| surowy | Wartość logiczna (dopuszczana do wartości null) | Nie. |
OpenAI.ResponseFormatJsonSchemaSchema
Schemat formatu odpowiedzi, opisany jako obiekt schematu JSON. Dowiedz się, jak tworzyć schematy JSON tutaj.
Typ: obiekt
OpenAI.ResponseFormatText
Domyślny format odpowiedzi. Służy do generowania odpowiedzi tekstowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze text.Możliwe wartości: text |
Yes |
OpenAI.ResponseFunctionCallArgumentsDeltaEvent
Emitowane, gdy występuje różnica w argumentach wywołania funkcji częściowej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Dodano argument delta w wywołaniu funkcji. | Yes | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego dodano różnicę argumentów wywołania funkcji. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.function_call_arguments.delta.Możliwe wartości: response.function_call_arguments.delta |
Yes |
OpenAI.ResponseFunctionCallArgumentsDoneEvent
Emitowane, gdy argumenty wywołania funkcji są finalizowane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Argumenty wywołania funkcji. | Yes | |
| item_id | ciąg | Identyfikator elementu. | Yes | |
| nazwa | ciąg | Nazwa funkcji, która została wywołana. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Możliwe wartości: response.function_call_arguments.done |
Yes |
OpenAI.ResponseImageGenCallCompletedEvent
Emitowane, gdy wywołanie narzędzia do generowania obrazów się zakończyło i dostępny jest końcowy obraz.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.image_generation_call.completed". Możliwe wartości: response.image_generation_call.completed |
Yes |
OpenAI.ResponseImageGenCallGeneratingEvent
Emitowane, gdy wywołanie narzędzia do generowania obrazów aktywnie generuje obraz (stan pośredni).
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.image_generation_call.generating". Możliwe wartości: response.image_generation_call.generating |
Yes |
OpenAI.ResponseImageGenCallInProgressEvent
Emitowane jest, gdy trwa wywołanie narzędzia do generowania obrazów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.image_generation_call.in_progress". Możliwe wartości: response.image_generation_call.in_progress |
Yes |
OpenAI.ResponseImageGenCallPartialImageEvent
Emitowany sygnał, gdy częściowy obraz staje się dostępny podczas przesyłania strumieniowego generowanych obrazów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| partial_image_b64 | ciąg | Dane częściowe obrazu zakodowane w formacie Base64, odpowiednie do renderowania jako obrazu. | Yes | |
| partial_image_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze „response.image_generation_call.partial_image”. Możliwe wartości: response.image_generation_call.partial_image |
Yes |
OpenAI.ResponseInProgressEvent
Emitowane, gdy odpowiedź jest w toku.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| response | OpenAI.Response | Yes | ||
| └agent_reference | AgentReference (dopuszczana wartość null) | Agent używany na potrzeby tej odpowiedzi | Yes | |
| └* tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| └completed_at | Liczba całkowita (dopuszczana do wartości null) | Nie. | ||
| Konwersacja └* | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| └─ błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| └niekompletne_szczegóły | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └─ instrukcje | ciąg lub tablica elementu OpenAI.InputItem (dopuszczana do wartości null) | Yes | ||
| └─ max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └max_tool_calls | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Metadane └* | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| └─ Model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| └─ Dane wyjściowe | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| └output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| └parallel_tool_calls | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| └previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| └prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| └─ Status | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* tekst | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| └─ Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| └ top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* skrócenie | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| └─ użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| └─ Użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.in_progress.Możliwe wartości: response.in_progress |
Yes |
OpenAI.ResponseIncompleteDetails
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| powód | wyliczenie | Możliwe wartości: max_output_tokens, content_filter |
Nie. |
OpenAI.ResponseIncompleteEvent
Zdarzenie emitowane, gdy odpowiedź jest zakończona jako niekompletna.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| response | OpenAI.Response | Yes | ||
| └agent_reference | AgentReference (dopuszczana wartość null) | Agent używany na potrzeby tej odpowiedzi | Yes | |
| └* tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| └completed_at | Liczba całkowita (dopuszczana do wartości null) | Nie. | ||
| Konwersacja └* | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| └─ błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| └niekompletne_szczegóły | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └─ instrukcje | ciąg lub tablica elementu OpenAI.InputItem (dopuszczana do wartości null) | Yes | ||
| └─ max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └max_tool_calls | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Metadane └* | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| └─ Model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| └─ Dane wyjściowe | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| └output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| └parallel_tool_calls | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| └previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| └prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| └─ Status | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* tekst | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| └─ Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| └ top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* skrócenie | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| └─ użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| └─ Użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.incomplete.Możliwe wartości: response.incomplete |
Yes |
OpenAI.ResponseLogProb
Logprob to prawdopodobieństwo logarytmicznych przypisywane przez model do tworzenia określonego tokenu na danej pozycji w sekwencji. Mniej ujemne (wyższe) wartości logprob wskazują większe zaufanie modelu do wyboru tokenu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| logprob | OpenAI.numeric | Yes | ||
| kod przedpłaty | ciąg | Możliwy token tekstowy. | Yes | |
| top_logprobs | tablica openAI.ResponseLogProbTopLogprobs | Prawdopodobieństwo dziennika pierwszych 20 najbardziej prawdopodobnych tokenów. | Nie. |
OpenAI.ResponseLogProbTopLogprobs
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| logprob | OpenAI.numeric | Nie. | ||
| kod przedpłaty | ciąg | Nie. |
OpenAI.ResponseMCPCallArgumentsDeltaEvent
Emituje się, gdy następuje różnica (częściowa aktualizacja) w argumentach wywołania narzędzia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Ciąg JSON zawierający częściową aktualizację argumentów wywołania narzędzia MCP. | Yes | |
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call_arguments.delta". Możliwe wartości: response.mcp_call_arguments.delta |
Yes |
OpenAI.ResponseMCPCallArgumentsDoneEvent
Emitowane, gdy argumenty wywołania narzędzia MCP są finalizowane.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON zawierający finalizowane argumenty wywołania narzędzia MCP. | Yes | |
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call_arguments.done". Możliwe wartości: response.mcp_call_arguments.done |
Yes |
OpenAI.ResponseMCPCallCompletedEvent
Emitowane po pomyślnym zakończeniu wywołania narzędzia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wywołania narzędzia MCP, który został ukończony. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.completed". Możliwe wartości: response.mcp_call.completed |
Yes |
OpenAI.ResponseMCPCallFailedEvent
Emitowane, gdy wywołanie narzędzia MCP nie powiodło się.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wywołania narzędzia MCP, który zakończył się niepowodzeniem. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.failed". Możliwe wartości: response.mcp_call.failed |
Yes |
OpenAI.ResponseMCPCallInProgressEvent
Emitowane, gdy trwa wywołanie narzędzia MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.in_progress". Możliwe wartości: response.mcp_call.in_progress |
Yes |
OpenAI.ResponseMCPListToolsCompletedEvent
Emitowane po pomyślnym pobraniu listy dostępnych narzędzi MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wywołania narzędzia MCP, który wygenerował te dane wyjściowe. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze „response.mcp_list_tools.completed”. Możliwe wartości: response.mcp_list_tools.completed |
Yes |
OpenAI.ResponseMCPListToolsFailedEvent
Emitowane, gdy próba wyświetlenia listy dostępnych narzędzi MCP nie powiodła się.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wywołania narzędzia MCP, który zakończył się niepowodzeniem. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_list_tools.failed". Możliwe wartości: response.mcp_list_tools.failed |
Yes |
OpenAI.ResponseMCPListToolsInProgressEvent
Emitowane, gdy system jest w trakcie pobierania listy dostępnych narzędzi MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_list_tools.in_progress". Możliwe wartości: response.mcp_list_tools.in_progress |
Yes |
OpenAI.ResponseOutputItemAddedEvent
Emitowane po dodaniu nowego elementu wyjściowego.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| element | OpenAI.OutputItem | Yes | ||
| └agent_reference | AgentReference | Agent, który utworzył element. | Nie. | |
| └response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| └typ | OpenAI.OutputItemType | Yes | ||
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_item.added.Możliwe wartości: response.output_item.added |
Yes |
OpenAI.ResponseOutputItemDoneEvent
Emitowane, gdy element wyjściowy jest oznaczony jako zakończony.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| element | OpenAI.OutputItem | Yes | ||
| └agent_reference | AgentReference | Agent, który utworzył element. | Nie. | |
| └response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| └typ | OpenAI.OutputItemType | Yes | ||
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_item.done.Możliwe wartości: response.output_item.done |
Yes |
OpenAI.ResponseOutputTextAnnotationAddedEvent
Emitowane po dodaniu adnotacji do wyjściowej zawartości tekstowej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| adnotacja | OpenAI.Annotation | Adnotacja, która ma zastosowanie do zakresu tekstu wyjściowego. | Yes | |
| └typ | OpenAI.AnnotationType | Yes | ||
| annotation_index | OpenAI.integer | Yes | ||
| content_index | OpenAI.integer | Yes | ||
| item_id | ciąg | Unikatowy identyfikator elementu, do którego jest dodawana adnotacja. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.output_text.adnotacja.added". Możliwe wartości: response.output_text.annotation.added |
Yes |
OpenAI.ResponsePromptVariables
Opcjonalna mapa wartości, które mają być zastępowane zmiennymi w wierszu polecenia. Wartości podstawienia mogą być ciągami lub innymi typami wejściowymi odpowiedzi, takimi jak obrazy lub pliki.
Typ: obiekt
OpenAI.ResponseQueuedEvent
Emitowane, gdy odpowiedź czeka w kolejce na przetworzenie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| response | OpenAI.Response | Yes | ||
| └agent_reference | AgentReference (dopuszczana wartość null) | Agent używany na potrzeby tej odpowiedzi | Yes | |
| └* tło | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| └completed_at | Liczba całkowita (dopuszczana do wartości null) | Nie. | ||
| Konwersacja └* | OpenAI.ConversationReference (dopuszczana wartość null) | Konwersacja, do którego należała ta odpowiedź. Elementy wejściowe i elementy wyjściowe z tej odpowiedzi zostały automatycznie dodane do tej konwersacji. | Nie. | |
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Yes | |
| └─ błąd | OpenAI.ResponseError (dopuszczana wartość null) | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Yes | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Yes | |
| └niekompletne_szczegóły | OpenAI.ResponseIncompleteDetails (dopuszczana wartość null) | Yes | ||
| └─ instrukcje | ciąg lub tablica elementu OpenAI.InputItem (dopuszczana do wartości null) | Yes | ||
| └─ max_output_tokens | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └max_tool_calls | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| Metadane └* | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| └─ Model | ciąg | Wdrożenie modelu do użycia na potrzeby tworzenia tej odpowiedzi. | Nie. | |
| └─ obiekt | wyliczenie | Typ obiektu tego zasobu — zawsze ustawiony na response.Możliwe wartości: response |
Yes | |
| └─ Dane wyjściowe | tablica openAI.OutputItem | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. Zamiast uzyskać dostęp do pierwszego elementu tablicy output:zakładając, że jest to komunikat z zawartością assistant wygenerowaną przezmodelu, można rozważyć użycie właściwości output_text.obsługiwane w zestawach SDK. |
Yes | |
| └output_text | ciąg (dopuszczany do wartości null) | Nie. | ||
| └parallel_tool_calls | boolean | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Yes | True |
| └previous_response_id | ciąg (dopuszczany do wartości null) | Nie. | ||
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └prompt_cache_key | ciąg | Używany przez interfejs OpenAI do buforowania odpowiedzi dla podobnych żądań w celu zoptymalizowania współczynników trafień pamięci podręcznej.
user Zamienia pole.
Dowiedz się więcej. |
Nie. | |
| └prompt_cache_retention | wyliczenie | Możliwe wartości: in-memory, 24h |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └safety_identifier | ciąg | Stabilny identyfikator używany do wykrywania użytkowników aplikacji, którzy mogą naruszać zasady użycia interfejsu OpenAI. Identyfikatory powinny być ciągiem, który jednoznacznie identyfikuje każdego użytkownika. Zalecamy wyznaczanie wartości skrótu nazwy użytkownika lub adresu e-mail, aby uniknąć wysyłania nam wszelkich informacji identyfikacyjnych. Dowiedz się więcej. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Określa typ przetwarzania używany do obsługi żądania. — Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowanej w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej. — Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu. — Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone z odpowiednią warstwą usługi. — Jeśli nie jest ustawiona, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać service_tier wartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze . |
Nie. | |
| └─ Status | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
Nie. | |
| └* temperatura | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* tekst | OpenAI.ResponseTextParam | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być prosty tekstowe lub ustrukturyzowane dane JSON. Więcej informacji: - Wprowadzanie tekstu i dane wyjściowe - Dane wyjściowe ze strukturą |
Nie. | |
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceParam | Nie. | ||
| └─ Narzędzia | OpenAI.ToolsArray | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice .Obsługujemy następujące kategorie narzędzi: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowane narzędzia. - Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowane łączniki, takie jak Dysk Google i Program SharePoint. Dowiedz się więcej o Narzędzia MCP. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelu wywoływania własnego kodu za pomocą silnie typiowanych argumentów i dane wyjściowe. Dowiedz się więcej o wywoływanie funkcji. Możesz również użyć niestandardowe narzędzia do wywoływania własnego kodu. |
Nie. | |
| └ top_logprobs | OpenAI.integer (dopuszczający wartość null) | Nie. | ||
| └─top_p | OpenAI.numeric (dopuszczana do wartości null) | Nie. | 1 | |
| └* skrócenie | wyliczenie | Możliwe wartości: auto, disabled |
Nie. | |
| └─ użycie | OpenAI.ResponseUsage | Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączna liczba użytych tokenów. |
Nie. | |
| └─ Użytkownik | ciąg (przestarzałe) | To pole jest zastępowane przez i safety_identifierprompt_cache_key. Zamiast tego użyj prompt_cache_key polecenia , aby zachować optymalizacje buforowania.Stabilny identyfikator dla użytkowników końcowych. Służy do zwiększania szybkości trafień pamięci podręcznej przez lepsze zasobniki podobnych żądań i pomaga wykrywać i zapobiegać nadużyciom w usłudze OpenAI. Dowiedz się więcej. |
Nie. | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.queued". Możliwe wartości: response.queued |
Yes |
OpenAI.ResponseReasoningSummaryPartAddedEvent
Emitowane po dodaniu nowej części podsumowania rozumowania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu, z którym ta część podsumowania jest skojarzona. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| część | OpenAI.ResponseReasoningSummaryPartAddedEventPart | Yes | ||
| └* tekst | ciąg | Yes | ||
| └typ | wyliczenie | Możliwe wartości: summary_text |
Yes | |
| sequence_number | OpenAI.integer | Yes | ||
| summary_index | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_part.added.Możliwe wartości: response.reasoning_summary_part.added |
Yes |
OpenAI.ResponseReasoningSummaryPartAddedEventPart
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Yes | ||
| typ | wyliczenie | Możliwe wartości: summary_text |
Yes |
OpenAI.ResponseReasoningSummaryPartDoneEvent
Emitowane po ukończeniu części podsumowującej wnioskowanie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu, z którym ta część podsumowania jest skojarzona. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| część | OpenAI.ResponseReasoningSummaryPartDoneEventPart | Yes | ||
| └* tekst | ciąg | Yes | ||
| └typ | wyliczenie | Możliwe wartości: summary_text |
Yes | |
| sequence_number | OpenAI.integer | Yes | ||
| summary_index | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_part.done.Możliwe wartości: response.reasoning_summary_part.done |
Yes |
OpenAI.ResponseReasoningSummaryPartDoneEventPart
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Yes | ||
| typ | wyliczenie | Możliwe wartości: summary_text |
Yes |
OpenAI.ResponseReasoningSummaryTextDeltaEvent
Emitowane po dodaniu zmiany do tekstu podsumowującego rozumowanie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| delta | ciąg | Delta tekstu dodana do podsumowania. | Yes | |
| item_id | ciąg | Identyfikator elementu, z który jest skojarzona ta delta tekstu podsumowania. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| summary_index | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_text.delta.Możliwe wartości: response.reasoning_summary_text.delta |
Yes |
OpenAI.ResponseReasoningSummaryTextDoneEvent
Emitowany po zakończeniu tekstu podsumowania rozumowania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu, z którym jest powiązany ten tekst podsumowania. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| summary_index | OpenAI.integer | Yes | ||
| SMS | ciąg | Pełny tekst ukończonego podsumowania rozumowania. | Yes | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_text.done.Możliwe wartości: response.reasoning_summary_text.done |
Yes |
OpenAI.ResponseReasoningTextDeltaEvent
Emitowane po dodaniu różnicy do tekstu rozumowania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| delta | ciąg | Delta tekstu, która została dodana do zawartości rozumowania. | Yes | |
| item_id | ciąg | Identyfikator elementu, z którego jest skojarzona ta różnica tekstu rozumowania. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_text.delta.Możliwe wartości: response.reasoning_text.delta |
Yes |
OpenAI.ResponseReasoningTextDoneEvent
Emitowane po zakończeniu tekstu rozumowania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| item_id | ciąg | Identyfikator elementu, z tym tekstem rozumowania jest skojarzony. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| SMS | ciąg | Pełny tekst ukończonej zawartości rozumowania. | Yes | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_text.done.Możliwe wartości: response.reasoning_text.done |
Yes |
OpenAI.ResponseRefusalDeltaEvent
Emitowane w przypadku częściowego tekstu odmowy.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| delta | ciąg | Tekst odmowy, który został dodany. | Yes | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego jest dodawany tekst odmowy. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.refusal.delta.Możliwe wartości: response.refusal.delta |
Yes |
OpenAI.ResponseRefusalDoneEvent
Emitowane, gdy tekst odmowy jest sfinalizowany.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego tekst odmowy jest finalizowany. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| refusal | ciąg | Tekst odmowy, który jest sfinalizowany. | Yes | |
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.refusal.done.Możliwe wartości: response.refusal.done |
Yes |
OpenAI.ResponseStreamOptions
Opcje przesyłania strumieniowego odpowiedzi. Ustaw tę wartość tylko po ustawieniu stream: true.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| include_obfuscation | boolean | W przypadku wartości true funkcja zaciemnienia strumienia zostanie włączona. Dodawanie zaciemniania strumienia losowe znaki do pola w przypadku zdarzeń różnicowych przesyłania strumieniowego obfuscation donormalizuj rozmiary ładunków jako środki zaradcze dla niektórych ataków kanału bocznego. Te pola zaciemniania są domyślnie uwzględniane, ale dodaj niewielką ilość narzut na strumień danych. Możesz ustawić wartość include_obfuscation nafalse, aby zoptymalizować przepustowość, jeśli ufasz łączem sieciowym między aplikacja i interfejs API openAI. |
Nie. |
OpenAI.ResponseTextDeltaEvent
Emitowane w przypadku dodatkowej zmiany tekstu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| delta | ciąg | Dodano zmianę tekstu. | Yes | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego dodano różnicę tekstu. | Yes | |
| logprobs | tablica biblioteki OpenAI.ResponseLogProb | Prawdopodobieństwo dziennika tokenów w delcie. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_text.delta.Możliwe wartości: response.output_text.delta |
Yes |
OpenAI.ResponseTextDoneEvent
Emitowane po sfinalizowaniu zawartości tekstowej.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| content_index | OpenAI.integer | Yes | ||
| item_id | ciąg | Identyfikator elementu wyjściowego, którego zawartość tekstowa jest finalizowana. | Yes | |
| logprobs | tablica biblioteki OpenAI.ResponseLogProb | Prawdopodobieństwo dziennika tokenów w delcie. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| SMS | ciąg | Zawartość tekstowa, która jest sfinalizowana. | Yes | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_text.done.Możliwe wartości: response.output_text.done |
Yes |
OpenAI.ResponseTextParam
Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może to być zwykły tekst lub dane JSON ze strukturą. Więcej informacji:
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Obiekt określający format, który musi zostać wygenerowany przez model. Konfigurowanie { "type": "json_schema" } włącza dane wyjściowe o strukturze.zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej na tej witrynie Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.*Niezalecane w przypadku modeli gpt-4o i nowszych:** Ustawienie { "type": "json_object" } włącza starszy tryb JSON, którygwarantuje, że komunikat generowany przez model jest prawidłowym kodem JSON. Korzystanie z json_schemajest preferowany w przypadku modeli, które go obsługują. |
Nie. | |
| szczegółowość | OpenAI.Verbosity | Ogranicza szczegółowość odpowiedzi modelu. Niższe wartości spowodują bardziej zwięzłe odpowiedzi, podczas gdy wyższe wartości spowodują bardziej pełne odpowiedzi. Obecnie obsługiwane wartości to low, mediumi high. |
Nie. |
OpenAI.ResponseUsage
Reprezentuje szczegóły użycia tokenu, w tym tokeny wejściowe, tokeny wyjściowe, podział tokenów wyjściowych i łączną liczbę użytych tokenów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| input_tokens | OpenAI.integer | Yes | ||
| input_tokens_details | OpenAI.ResponseUsageInputTokensDetails | Yes | ||
| └cached_tokens | OpenAI.integer | Yes | ||
| output_tokens | OpenAI.integer | Yes | ||
| output_tokens_details | OpenAI.ResponseUsageOutputTokensDetails | Yes | ||
| └─ tokeny_rozumowania | OpenAI.integer | Yes | ||
| total_tokens | OpenAI.integer | Yes |
OpenAI.ResponseUsageInputTokensDetails
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Yes |
OpenAI.ResponseUsageOutputTokensDetails
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| tokeny_rozumowania | OpenAI.integer | Yes |
OpenAI.ResponseWebSearchCallCompletedEvent
Emitowane po zakończeniu wywołania wyszukiwania w Internecie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wyjściowego skojarzonego z wywołaniem wyszukiwania w Internecie. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.web_search_call.completed.Możliwe wartości: response.web_search_call.completed |
Yes |
OpenAI.ResponseWebSearchCallInProgressEvent
Emitowane po zainicjowaniu wywołania wyszukiwania w Sieci Web.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wyjściowego skojarzonego z wywołaniem wyszukiwania w Internecie. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.web_search_call.in_progress.Możliwe wartości: response.web_search_call.in_progress |
Yes |
OpenAI.ResponseWebSearchCallSearchingEvent
Emitowane podczas wykonywania wywołania wyszukiwania w Internecie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wyjściowego skojarzonego z wywołaniem wyszukiwania w Internecie. | Yes | |
| output_index | OpenAI.integer | Yes | ||
| sequence_number | OpenAI.integer | Yes | ||
| typ | wyliczenie | Typ zdarzenia. Zawsze response.web_search_call.searching.Możliwe wartości: response.web_search_call.searching |
Yes |
OpenAI.Zrzut ekranu
Akcja zrzutu ekranu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji zrzutu ekranu ta właściwość to zawsze ustawiony na screenshot.Możliwe wartości: screenshot |
Yes |
OpenAI.Scroll
Akcja przewijania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| scroll_x | OpenAI.integer | Yes | ||
| scroll_y | OpenAI.integer | Yes | ||
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji przewijania właściwość ta to zawsze ustawiony na scroll.Możliwe wartości: scroll |
Yes | |
| x | OpenAI.integer | Yes | ||
| y | OpenAI.integer | Yes |
OpenAI.SearchContextSize
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | lowmediumhigh |
OpenAI.ServiceTier
Określa typ przetwarzania używany do obsługi żądania.
- Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone z warstwą usługi skonfigurowaną w ustawieniach Project. Jeśli nie skonfigurowano inaczej, Project będzie używać wartości domyślnej.
- Jeśli zostanie ustawiona wartość "domyślna", żądanie zostanie przetworzone przy użyciu standardowych cen i wydajności dla wybranego modelu.
- Jeśli ustawiono wartość "flex" lub "priority", żądanie zostanie przetworzone przy użyciu odpowiedniej warstwy usługi.
- Jeśli nie zostanie ustawiona, domyślne zachowanie to "auto".
Po ustawieniu parametru
service_tiertreść odpowiedzi będzie zawieraćservice_tierwartość opartą na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może różnić się od wartości ustawionej w parametrze .
| Property | Value |
|---|---|
| Type | ciąg |
| Nullable | Yes |
| Wartości | autodefaultflexscalepriority |
OpenAI.SpecificApplyPatchParam
Wymusza wywołanie narzędzia apply_patch przez model podczas wykonywania wywołania narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Narzędzie do wywołania. Zawsze apply_patch.Możliwe wartości: apply_patch |
Yes |
OpenAI.SpecificFunctionShellParam
Wymusza wywołanie narzędzia powłoki przez model, gdy jest wymagane wywołanie narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Narzędzie do wywołania. Zawsze shell.Możliwe wartości: shell |
Yes |
OpenAI.Summary
Tekst podsumowania z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Podsumowanie danych wyjściowych rozumowania z modelu do tej pory. | Yes | |
| typ | wyliczenie | Typ obiektu. Zawsze summary_text.Możliwe wartości: summary_text |
Yes |
OpenAI.SummaryTextContent
Tekst podsumowania z modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Podsumowanie danych wyjściowych rozumowania z modelu do tej pory. | Yes | |
| typ | wyliczenie | Typ obiektu. Zawsze summary_text.Możliwe wartości: summary_text |
Yes |
OpenAI.TextContent
Zawartość tekstowa.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Yes | ||
| typ | wyliczenie | Możliwe wartości: text |
Yes |
OpenAI.TextResponseFormatConfiguration
Obiekt określający format, który musi zostać wygenerowany przez model.
Konfigurowanie { "type": "json_schema" } umożliwia korzystanie ze strukturowych danych wyjściowych, co zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej na tej witrynie
Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.
Niezalecane w przypadku modeli gpt-4o i nowszych:* Ustawienie { "type": "json_object" } umożliwia korzystanie ze starszego trybu JSON, co gwarantuje, że komunikat generowany przez model jest prawidłowym kodem JSON. Użycie json_schema jest preferowane w przypadku modeli, które go obsługują.
Dyskryminowanie dla elementu OpenAI.TextResponseFormatConfiguration
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
json_schema |
OpenAI.TextResponseFormatJsonSchema |
text |
OpenAI.TextResponseFormatConfigurationResponseFormatText |
json_object |
OpenAI.TextResponseFormatConfigurationResponseFormatJsonObject |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.TextResponseFormatConfigurationType | Yes |
OpenAI.TextResponseFormatConfigurationResponseFormatJsonObject
Format odpowiedzi obiektu JSON. Starsza metoda generowania odpowiedzi JSON.
Użycie json_schema jest zalecane w przypadku modeli, które go obsługują. Należy pamiętać, że model nie wygeneruje kodu JSON bez komunikatu systemu lub użytkownika z instrukcjami, aby to zrobił.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_object.Możliwe wartości: json_object |
Yes |
OpenAI.TextResponseFormatConfigurationResponseFormatText
Domyślny format odpowiedzi. Służy do generowania odpowiedzi tekstowych.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze text.Możliwe wartości: text |
Yes |
OpenAI.TextResponseFormatConfigurationType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | textjson_schemajson_object |
OpenAI.TextResponseFormatJsonSchema
Format odpowiedzi schematu JSON. Służy do generowania ustrukturyzowanych odpowiedzi JSON. Dowiedz się więcej o danych wyjściowych ze strukturą.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis tego, do czego służy format odpowiedzi, używany przez model do określ, jak reagować w ustalonym formacie. |
Nie. | |
| nazwa | ciąg | Nazwa formatu odpowiedzi. Musi być a-z, A-Z, 0-9 lub zawierać podkreślenia i kreski o maksymalnej długości 64. |
Yes | |
| schemat | OpenAI.ResponseFormatJsonSchemaSchema | Schemat formatu odpowiedzi, opisany jako obiekt schematu JSON. Dowiedz się, jak tworzyć schematy JSON tutaj. |
Yes | |
| surowy | Wartość logiczna (dopuszczana do wartości null) | Nie. | ||
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_schema.Możliwe wartości: json_schema |
Yes |
OpenAI.Tool
Narzędzie, które może służyć do generowania odpowiedzi.
Dyskryminator dla OpenAI.Tool
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
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 |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ToolType | Yes |
OpenAI.ToolChoiceAllowed
Ogranicza narzędzia dostępne dla modelu do wstępnie zdefiniowanego zestawu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| mode | wyliczenie | Ogranicza narzędzia dostępne dla modelu do wstępnie zdefiniowanego zestawu.auto umożliwia modelowi wybór spośród dozwolonych narzędzi i generowaniewiadomość. required wymaga, aby model wywoływać co najmniej jedno z dozwolonych narzędzi.Możliwe wartości: auto, required |
Yes | |
| Narzędzia | tablica obiektu | Lista definicji narzędzi, które powinny być dozwolone do wywołania modelu. W przypadku interfejsu API odpowiedzi lista definicji narzędzi może wyglądać następująco: json<br> [<br> { "type": "function", "name": "get_weather" },<br> { "type": "mcp", "server_label": "deepwiki" },<br> { "type": "image_generation" }<br> ]<br> |
Yes | |
| typ | wyliczenie | Dozwolony typ konfiguracji narzędzia. Zawsze allowed_tools.Możliwe wartości: allowed_tools |
Yes |
OpenAI.ToolChoiceCodeInterpreter
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: code_interpreter |
Yes |
OpenAI.ToolChoiceComputerUsePreview
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: computer_use_preview |
Yes |
OpenAI.ToolChoiceCustom
Użyj tej opcji, aby wymusić wywołanie określonego narzędzia niestandardowego przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa niestandardowego narzędzia do wywołania. | Yes | |
| typ | wyliczenie | W przypadku wywoływania niestandardowych narzędzi typ to zawsze custom.Możliwe wartości: custom |
Yes |
OpenAI.ToolChoiceFileSearch
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: file_search |
Yes |
OpenAI.ToolChoiceFunction
Użyj tej opcji, aby wymusić wywołanie określonej funkcji przez model.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| typ | wyliczenie | W przypadku wywoływania funkcji typ to zawsze function.Możliwe wartości: function |
Yes |
OpenAI.ToolChoiceImageGeneration
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: image_generation |
Yes |
OpenAI.ToolChoiceMCP
Użyj tej opcji, aby wymusić wywołanie określonego narzędzia na zdalnym serwerze MCP.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa | ciąg (dopuszczany do wartości null) | Nie. | ||
| etykieta_serwera | ciąg | Etykieta serwera MCP do użycia. | Yes | |
| typ | wyliczenie | W przypadku narzędzi MCP typ to zawsze mcp.Możliwe wartości: mcp |
Yes |
OpenAI.ToolChoiceOptions
Określa, które narzędzie (jeśli istnieje) jest wywoływane przez model.
none oznacza, że model nie wywoła żadnego narzędzia i zamiast tego generuje komunikat.
auto oznacza, że model może wybierać między generowaniem komunikatu lub wywoływaniem co najmniej jednego narzędzia.
required oznacza, że model musi wywoływać co najmniej jedno narzędzie.
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | noneautorequired |
OpenAI.ToolChoiceParam
W jaki sposób model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedzi. Zobacz parametr , tools aby zobaczyć, jak określić narzędzia, które może wywołać model.
Dyskryminujące dla openAI.ToolChoiceParam
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
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 |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenAI.ToolChoiceParamType | Yes |
OpenAI.ToolChoiceParamType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | allowed_toolsfunctionmcpcustomapply_patchshellfile_searchweb_search_previewcomputer_use_previewweb_search_preview_2025_03_11image_generationcode_interpreter |
OpenAI.ToolChoiceWebSearchPreview
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: web_search_preview |
Yes |
OpenAI.ToolChoiceWebSearchPreview20250311
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: web_search_preview_2025_03_11 |
Yes |
OpenAI.ToolType
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | 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
Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Możesz określić, którego narzędzia użyć, ustawiając tool_choice parametr .
Obsługujemy następujące kategorie narzędzi:
- Wbudowane narzędzia: narzędzia udostępniane przez usługę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie w Internecie lub wyszukiwanie plików. Dowiedz się więcej o wbudowanych narzędziach.
- Narzędzia MCP: integracje z systemami innych firm za pośrednictwem niestandardowych serwerów MCP lub wstępnie zdefiniowanych łączników, takich jak Dysk Google i Program SharePoint. Dowiedz się więcej o narzędziach MCP.
- Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika, umożliwiając modelowi wywoływanie własnego kodu za pomocą silnie typiowanych argumentów i danych wyjściowych. Dowiedz się więcej o wywoływaniu funkcji. Możesz również użyć narzędzi niestandardowych do wywołania własnego kodu.
Tablica: OpenAI.Tool
OpenAI.TopLogProb
Najwyższy logarytm prawdopodobieństwa tokenu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| bytes | tablica wartości OpenAI.integer | Yes | ||
| logprob | OpenAI.numeric | Yes | ||
| kod przedpłaty | ciąg | Yes |
OpenAI.Type
Akcja wpisywania tekstu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SMS | ciąg | Tekst do wpisania. | Yes | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji typu ta właściwość to zawsze ustawiony na type.Możliwe wartości: type |
Yes |
OpenAI.UpdateConversationBody
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Yes |
OpenAI.UrlCitationBody
Cytat dotyczący zasobu internetowego używanego do generowania odpowiedzi modelu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| end_index | OpenAI.integer | Yes | ||
| start_index | OpenAI.integer | Yes | ||
| title | ciąg | Tytuł zasobu internetowego. | Yes | |
| typ | wyliczenie | Typ cytatu adresu URL. Zawsze url_citation.Możliwe wartości: url_citation |
Yes | |
| url | ciąg | Adres URL zasobu internetowego. | Yes |
OpenAI.VectorStoreFileAttributes
Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w formacie ustrukturyzowanym i wykonywania zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków, wartości logiczne lub liczby.
Typ: obiekt
OpenAI.Verbosity
Ogranicza szczegółowość odpowiedzi modelu. Niższe wartości spowodują bardziej zwięzłe odpowiedzi, a wyższe wartości spowodują bardziej pełne odpowiedzi.
Obecnie obsługiwane wartości to low, mediumi high.
| Property | Value |
|---|---|
| Type | ciąg |
| Nullable | Yes |
| Wartości | lowmediumhigh |
OpenAI.Wait
Akcja oczekiwania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji oczekiwania ta właściwość to zawsze ustawiony na wait.Możliwe wartości: wait |
Yes |
OpenAI.WebSearchActionFind
Typ akcji "find": wyszukuje wzorzec na załadowanej stronie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wzorzec | ciąg | Wzorzec lub tekst do wyszukania na stronie. | Yes | |
| typ | wyliczenie | Typ akcji. Możliwe wartości: find_in_page |
Yes | |
| url | ciąg | Adres URL strony, na której wyszukiwano wzorzec. | Yes |
OpenAI.WebSearchActionOpenPage
Typ akcji "open_page" — otwiera określony adres URL z wyników wyszukiwania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ akcji. Możliwe wartości: open_page |
Yes | |
| url | ciąg | Adres URL otwarty przez model. | Yes |
OpenAI.WebSearchActionSearch
Typ akcji "search" — wykonuje zapytanie wyszukiwania w Internecie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| queries | tablica ciągów | Zapytania wyszukiwania. | Nie. | |
| kwerenda | ciąg (przestarzałe) | [PRZESTARZAŁE] Zapytanie wyszukiwania. | Yes | |
| Źródeł | tablica obiektów OpenAI.WebSearchActionSearchSources | Źródła używane w wyszukiwaniu. | Nie. | |
| typ | wyliczenie | Typ akcji. Możliwe wartości: search |
Yes |
OpenAI.WebSearchActionSearchSources
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: url |
Yes | |
| url | ciąg | Yes |
OpenAI.WebSearchApproximateLocation
Przybliżona lokalizacja użytkownika.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Miasta | ciąg (dopuszczany do wartości null) | Nie. | ||
| kraj | ciąg (dopuszczany do wartości null) | Nie. | ||
| region | ciąg (dopuszczany do wartości null) | Nie. | ||
| timezone | ciąg (dopuszczany do wartości null) | Nie. | ||
| typ | wyliczenie | Typ przybliżenia lokalizacji. Zawsze approximate.Możliwe wartości: approximate |
Nie. |
OpenAI.WebSearchPreviewTool
To narzędzie przeszukuje internet w poszukiwaniu odpowiednich wyników do wykorzystania w odpowiedzi. Dowiedz się więcej o narzędziu wyszukiwania web.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rozmiar_kontekstu_wyszukiwania | OpenAI.SearchContextSize | Nie. | ||
| typ | wyliczenie | Typ narzędzia wyszukiwania w Internecie. Jeden z web_search_preview lub web_search_preview_2025_03_11.Możliwe wartości: web_search_preview |
Yes | |
| lokalizacja_użytkownika | OpenAI.ApproximateLocation (dopuszczana wartość null) | Nie. | ||
| └* miasto | ciąg (dopuszczany do wartości null) | Nie. | ||
| └* kraj | ciąg (dopuszczany do wartości null) | Nie. | ||
| └region | ciąg (dopuszczany do wartości null) | Nie. | ||
| └* strefa czasowa | ciąg (dopuszczany do wartości null) | Nie. | ||
| └typ | wyliczenie | Typ przybliżenia lokalizacji. Zawsze approximate.Możliwe wartości: approximate |
Yes |
OpenAI.WebSearchTool
Przeszukaj Internet w poszukiwaniu źródeł związanych z tym tematem. Dowiedz się więcej o narzędziu wyszukiwania web.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| custom_search_configuration | WebSearchConfiguration | Konfiguracja wyszukiwania w Internecie dla wyszukiwania niestandardowego bing | Nie. | |
| └instance_name | ciąg | Nazwa wystąpienia konfiguracji niestandardowej podane do konfiguracji. | Yes | |
| └project_connection_id | ciąg | Project identyfikator połączenia dla uziemienia za pomocą wyszukiwania niestandardowego bing | Yes | |
| filters | OpenAI.WebSearchToolFilters (dopuszczający wartość null) | Nie. | ||
| └allowed_domains | tablica ciągu (dopuszczana do wartości null) | Nie. | ||
| rozmiar_kontekstu_wyszukiwania | wyliczenie | Ogólne wskazówki dotyczące ilości miejsca w oknie kontekstowym do użycia w wyszukiwaniu.
lowJeden z , mediumlub high. Wartość domyślna to medium.Możliwe wartości: low, , mediumhigh |
Nie. | |
| typ | wyliczenie | Typ narzędzia wyszukiwania w Internecie. Jeden z web_search lub web_search_2025_08_26.Możliwe wartości: web_search |
Yes | |
| lokalizacja_użytkownika | OpenAI.WebSearchApproximateLocation (dopuszczana wartość null) | Przybliżona lokalizacja użytkownika. | Nie. | |
| └* miasto | ciąg (dopuszczany do wartości null) | Nie. | ||
| └* kraj | ciąg (dopuszczany do wartości null) | Nie. | ||
| └region | ciąg (dopuszczany do wartości null) | Nie. | ||
| └* strefa czasowa | ciąg (dopuszczany do wartości null) | Nie. | ||
| └typ | wyliczenie | Typ przybliżenia lokalizacji. Zawsze approximate.Możliwe wartości: approximate |
Nie. |
OpenAI.WebSearchToolFilters
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| allowed_domains | tablica ciągów | Nie. |
OpenAI.integer
Typ: liczba całkowita
Format: int64
OpenAI.numeric
Typ: liczba
Format: podwójne
OpenApiAnonymousAuthDetails
Szczegóły zabezpieczeń uwierzytelniania anonimowego openApi
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | wyliczenie | Typ obiektu, który jest zawsze "anonimowy". Możliwe wartości: anonymous |
Yes |
OpenApiAuthDetails
szczegóły uwierzytelniania dla elementu OpenApiFunctionDefinition
Dyskryminujące dla openApiAuthDetails
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
anonymous |
OpenApiAnonymousAuthDetails |
project_connection |
OpenApiProjectConnectionAuthDetails |
managed_identity |
OpenApiManagedAuthDetails |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | OpenApiAuthType | Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to: — Anonimowe (bez wymaganego uwierzytelniania) — połączenie Project (wymaga project_connection_id do punktu końcowego, zgodnie z konfiguracją w narzędziu AI Foundry) - Managed_Identity (wymaga odbiorców uwierzytelniania opartego na tożsamościach) |
Yes |
OpenApiAuthType
Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to:
- Anonimowy (uwierzytelnianie nie jest wymagane)
- Project Connection (wymaga project_connection_id do punktu końcowego, jak ustawione w AI Foundry)
- Managed_Identity (wymaga odbiorców do uwierzytelniania opartego na tożsamości)
| Property | Value |
|---|---|
| Opis | Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to: — Anonimowe (bez wymaganego uwierzytelniania) — połączenie Project (wymaga project_connection_id do punktu końcowego, zgodnie z konfiguracją w narzędziu AI Foundry) - Managed_Identity (wymaga odbiorców uwierzytelniania opartego na tożsamościach) |
| Type | ciąg |
| Wartości | anonymousproject_connectionmanaged_identity |
OpenApiFunctionDefinition
Informacje o definicji danych wejściowych dla funkcji openapi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| auth | OpenApiAuthDetails | szczegóły uwierzytelniania dla elementu OpenApiFunctionDefinition | Yes | |
| └typ | OpenApiAuthType | Typ uwierzytelniania musi być anonimowy/project_connection/managed_identity | Yes | |
| default_params | tablica ciągów | Lista parametrów specyfikacji interfejsu OpenAPI, które będą używać domyślnych ustawień udostępnionych przez użytkownika | Nie. | |
| opis | ciąg | Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję. | Nie. | |
| functions | tablica obiektu | Lista definicji funkcji używanych przez narzędzie OpenApi | Nie. | |
| nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| spec | obiekt | Kształt funkcji openapi opisany jako obiekt schematu JSON. | Yes |
OpenApiManagedAuthDetails
Szczegóły zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| security_scheme | OpenApiManagedSecurityScheme | Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity | Yes | |
| └odbiorców | ciąg | Zakres uwierzytelniania dla typu uwierzytelniania managed_identity | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze "managed_identity". Możliwe wartości: managed_identity |
Yes |
OpenApiManagedSecurityScheme
Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| audience | ciąg | Zakres uwierzytelniania dla typu uwierzytelniania managed_identity | Yes |
OpenApiProjectConnectionAuthDetails
Szczegóły zabezpieczeń uwierzytelniania połączeń interfejsu OpenApi project
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| security_scheme | OpenApiProjectConnectionSecurityScheme | Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity | Yes | |
| └project_connection_id | ciąg | identyfikator połączenia Project dla typu uwierzytelniania połączenia Project | Yes | |
| typ | wyliczenie | Typ obiektu, który jest zawsze "project_connection". Możliwe wartości: project_connection |
Yes |
OpenApiProjectConnectionSecurityScheme
Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| project_connection_id | ciąg | identyfikator połączenia Project dla typu uwierzytelniania połączenia Project | Yes |
OpenApiTool
Informacje o definicji danych wejściowych narzędzia OpenAPI używane do konfigurowania agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| openapi | OpenApiFunctionDefinition | Informacje o definicji danych wejściowych dla funkcji openapi. | Yes | |
| └* uwierzytelnianie | OpenApiAuthDetails | Szczegóły uwierzytelniania interfejsu API | Yes | |
| └default_params | tablica ciągów | Lista parametrów specyfikacji interfejsu OpenAPI, które będą używać domyślnych ustawień udostępnionych przez użytkownika | Nie. | |
| Opis └* | ciąg | Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję. | Nie. | |
| Funkcje └* | tablica obiektów (tylko do odczytu) | Lista definicji funkcji używanych przez narzędzie OpenApi | Nie. | |
| Opis └* | ciąg | Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję. | Nie. | |
| └─ nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| Parametry | obiekt | Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. | Yes | |
| └─ nazwa | ciąg | Nazwa funkcji do wywołania. | Yes | |
| └* specyfikacja | obiekt | Kształt funkcji openapi opisany jako obiekt schematu JSON. | Yes | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'openapi'. Możliwe wartości: openapi |
Yes |
PageOrder
| Property | Value |
|---|---|
| Type | ciąg |
| Wartości | ascdesc |
PagedConnection
Stronicowana kolekcja elementów połączenia
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica połączeń | Elementy połączenia na tej stronie | Yes |
PagedDatasetVersion
Stronicowana kolekcja elementów DatasetVersion
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica elementu DatasetVersion | Elementy DatasetVersion na tej stronie | Yes |
PagedDeployment
Stronicowana kolekcja elementów wdrożenia
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica wdrożenia | Elementy wdrożenia na tej stronie | Yes |
PagedEvaluationRule
Stronicowana kolekcja elementów EvaluationRule
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica wartości EvaluationRule | Elementy EvaluationRule na tej stronie | Yes |
PagedEvaluationTaxonomy
Stronicowana kolekcja elementów EvaluationTaxonomy
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica wartości EvaluationTaxonomy | Elementy EvaluationTaxonomy na tej stronie | Yes |
PagedEvaluatorVersion
Stronicowana kolekcja elementów EvaluatorVersion
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica EwaluatorVersion | Elementy EvaluatorVersion na tej stronie | Yes |
PagedIndex
Stronicowana kolekcja elementów indeksu
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica indeksu | Elementy indeksu na tej stronie | Yes |
PagedInsight
Stronicowana kolekcja elementów szczegółowych informacji
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica szczegółowych informacji | Elementy szczegółowych informacji na tej stronie | Yes |
PagedRedTeam
Stronicowana kolekcja elementów RedTeam
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica redteam | Elementy RedTeam na tej stronie | Yes |
PagedSchedule
Stronicowana kolekcja elementów harmonogramu
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica harmonogramu | Elementy harmonogramu na tej stronie | Yes |
PagedScheduleRun
Stronicowana kolekcja elementów ScheduleRun
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| value | tablica funkcji ScheduleRun | Elementy ScheduleRun na tej stronie | Yes |
PendingUploadRequest
Reprezentuje prośbę o oczekujące przesłanie.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Connectionname | ciąg | Nazwa połączenia konta usługi Azure Storage do użycia do generowania tymczasowego tokenu SAS | Nie. | |
| pendingUploadId | ciąg | Jeśli PendingUploadId nie zostanie podany, zostanie użyty losowy identyfikator GUID. | Nie. | |
| pendingUploadType | wyliczenie | Funkcja BlobReference jest jedynym obsługiwanym typem. Możliwe wartości: BlobReference |
Yes |
PendingUploadResponse
Reprezentuje odpowiedź na oczekujące żądanie przesłania
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| BlobReference | BlobReference | Szczegóły odwołania do obiektu blob. | Yes | |
| └* identyfikator blobUri | ciąg | Ścieżka identyfikatora URI obiektu blob dla klienta w celu przekazania danych. Przykład: https://blob.windows.core.net/Container/Path |
Yes | |
| Poświadczenie └* | SasCredential | Informacje o poświadczeniach umożliwiające uzyskanie dostępu do konta magazynu. | Yes | |
| └* storageAccountArmId | ciąg | Identyfikator arm konta magazynu do użycia. | Yes | |
| pendingUploadId | ciąg | Identyfikator tego żądania przesłania. | Yes | |
| pendingUploadType | wyliczenie | BlobReference jest jedynym obsługiwanym typem Możliwe wartości: BlobReference |
Yes | |
| wersja | ciąg | Wersja zasobu, która ma zostać utworzona, jeśli użytkownik nie określił wersji podczas początkowego tworzenia przesyłania | Nie. |
PromptAgentDefinition
Definicja agenta monitu
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| instructions | ciąg (dopuszczany do wartości null) | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. | Nie. | |
| rodzaj | wyliczenie | Możliwe wartości: prompt |
Yes | |
| model | ciąg | Wdrożenie modelu do użycia dla tego agenta. | Yes | |
| rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| └rai_policy_name | ciąg | Nazwa zasad RAI do zastosowania. | Yes | |
| reasoning | OpenAI.Reasoning (dopuszczające wartość null) |
Tylko modele gpt-5 i serii o Opcje konfiguracji dla modele rozumowania. |
Nie. | |
| └─ wysiłek | OpenAI.ReasoningEffort | Ogranicza wysiłek w rozumowaniu modele rozumowania. Obecnie obsługiwane wartości to none, , minimal, lowmedium, high, i xhigh. Zmniejszeniewysiłek na rzecz przetwarzania może prowadzić do szybszych odpowiedzi i mniejszej liczby używanych tokenów rozumowanie w odpowiedzi. - gpt-5.1 wartość domyślna to none, która nie wykonuje rozumowania. Obsługiwane wartości gpt-5.1 rozumowania to none, low, mediumi high. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.— Wszystkie modele przed gpt-5.1 ustawieniem domyślnym do medium uczenia się i nie obsługują noneelementu .— Model gpt-5-pro domyślnie (i obsługuje tylko) high wysiłek rozumowania.- xhigh jest obsługiwany dla wszystkich modeli po gpt-5.1-codex-max. |
Nie. | |
| └─ generuj_podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| └─ Podsumowanie | wyliczenie | Możliwe wartości: auto, , concisedetailed |
Nie. | |
| structured_inputs | obiekt | Zestaw ustrukturyzowanych danych wejściowych, które mogą uczestniczyć w zastępowaniu szablonów monitów lub powiązaniach argumentów narzędzia. | Nie. | |
| temperatura | number | Jaka temperatura próbkowania ma być używana z zakresu od 0 do 2. Wyższe wartości, takie jak 0,8, sprawią, że dane wyjściowe będą bardziej losowe, a niższe wartości, takie jak 0,2, sprawią, że będą bardziej skoncentrowane i deterministyczne. Ogólnie zalecamy zmienić to lub top_p, ale nie obu jednocześnie. |
Nie. | 1 |
| SMS | PromptAgentDefinitionTextOptions | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może to być zwykły tekst lub dane JSON ze strukturą. | Nie. | |
| Format └─ | OpenAI.TextResponseFormatConfiguration | Obiekt określający format, który musi zostać wygenerowany przez model. Konfigurowanie { "type": "json_schema" } włącza dane wyjściowe o strukturze.zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej na tej witrynie Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.*Niezalecane w przypadku modeli gpt-4o i nowszych:** Ustawienie { "type": "json_object" } włącza starszy tryb JSON, którygwarantuje, że komunikat generowany przez model jest prawidłowym kodem JSON. Korzystanie z json_schemajest preferowany w przypadku modeli, które go obsługują. |
Nie. | |
| tool_choice | string lub OpenAI.ToolChoiceParam | W jaki sposób model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedzi. Zobacz parametr , tools aby zobaczyć, jak określić narzędzia, które może wywołać model. |
Nie. | |
| Narzędzia | tablica narzędzi OpenAI.Tool | Tablica narzędzi, które model może wywołać podczas generowania odpowiedzi. Ty może określić, które narzędzie ma być używane przez ustawienie parametru tool_choice . |
Nie. | |
| top_p | number | Alternatywa dla próbkowania z temperaturą, nazywana próbkowaniem jądra, gdzie model uwzględnia wyniki tokenów o prawdopodobieństwie "top_p" masa. Tak więc 0,1 oznacza tylko tokeny składające się z 10 pierwszych% masy prawdopodobieństwa są brane pod uwagę. Ogólnie zalecamy zmienić to lub temperature, ale nie obu jednocześnie. |
Nie. | 1 |
PromptAgentDefinitionTextOptions
Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może to być zwykły tekst lub dane JSON ze strukturą.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Obiekt określający format, który musi zostać wygenerowany przez model. Konfigurowanie { "type": "json_schema" } włącza dane wyjściowe o strukturze.zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej na tej witrynie Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.*Niezalecane w przypadku modeli gpt-4o i nowszych:** Ustawienie { "type": "json_object" } włącza starszy tryb JSON, którygwarantuje, że komunikat generowany przez model jest prawidłowym kodem JSON. Korzystanie z json_schemajest preferowany w przypadku modeli, które go obsługują. |
Nie. |
PromptBasedEvaluatorDefinition
Ewaluator oparty na podpowiedziach
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| data_schema | obiekt | Schemat JSON (wersja robocza 2020-12) dla danych wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| init_parameters | obiekt | Schemat JSON (wersja robocza 2020-12) dla parametrów wejściowych ewaluatora. Obejmuje to parametry, takie jak typ, właściwości, wymagane. | Nie. | |
| metryki | obiekt | Lista wskaźników wyjściowych opracowanych przez tego ewaluatora | Nie. | |
| prompt_text | ciąg | Tekst monitu używany do oceny | Yes | |
| typ | wyliczenie | Możliwe wartości: prompt |
Yes |
ProtocolVersionRecord
Mapowanie rekordu dla pojedynczego protokołu i jego wersji.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| protokół | AgentProtocol | Yes | ||
| wersja | ciąg | Ciąg wersji protokołu, np. "v0.1.1". | Yes |
RaiConfig
Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI).
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rai_policy_name | ciąg | Nazwa zasad RAI do zastosowania. | Yes |
RecurrenceSchedule
Model harmonogramu cykli.
Dyskryminujący dla cykluSchedule
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
Hourly |
HourlyRecurrenceSchedule |
Daily |
DailyRecurrenceSchedule |
Weekly |
WeeklyRecurrenceSchedule |
Monthly |
MonthlyRecurrenceSchedule |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | Typ cyklu | Typ cyklu. | Yes |
RecurrenceTrigger
Wyzwalacz oparty na cyklu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| endTime | ciąg | Godzina zakończenia harmonogramu cyklu w formacie ISO 8601. | Nie. | |
| interwał | liczba całkowita | Interwał harmonogramu cyklu. | Yes | |
| schedule | RecurrenceSchedule | Model harmonogramu cykli. | Yes | |
| └typ | Typ cyklu | Typ cyklu dla harmonogramu cyklu. | Yes | |
| startTime | ciąg | Godzina rozpoczęcia harmonogramu cyklu w formacie ISO 8601. | Nie. | |
| timeZone | ciąg | Strefa czasowa dla harmonogramu cyklu. | Nie. | UTC |
| typ | wyliczenie | Typ wyzwalacza. Możliwe wartości: Recurrence |
Yes |
Typ cyklu
Typ cyklu.
| Property | Value |
|---|---|
| Opis | Typ cyklu. |
| Type | ciąg |
| Wartości | HourlyDailyWeeklyMonthly |
RedTeam
Szczegóły czerwonej drużyny.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| applicationScenario | ciąg | Scenariusz aplikacji dla czerwonej operacji zespołu w celu wygenerowania konkretnych ataków scenariusza. | Nie. | |
| attackStrategies | tablica strategii ataków | Lista strategii ataku lub zagnieżdżonych list strategii ataku. | Nie. | |
| displayName | ciąg | Nazwa uruchomienia czerwonego zespołu. | Nie. | |
| id | ciąg (tylko do odczytu) | Identyfikator czerwonego przebiegu zespołu. | Yes | |
| liczbawywracania | liczba całkowita | Liczba rund symulacji. | Nie. | |
| properties | obiekt | Właściwości zespołu czerwonego. W przeciwieństwie do tagów właściwości są tylko do dodawania. Po dodaniu nie można usunąć właściwości. | Nie. | |
| riskCategories | tablica kategorii ryzyka | Lista kategorii ryzyka do generowania celów ataku. | Nie. | |
| symulacjaOnly | boolean | Tylko symulacja lub Symulacja i ocena. Wartość domyślna false, jeśli wartość true skanowania generuje wynik konwersacji, która nie jest wynikiem oceny. | Nie. | Nieprawda |
| stan | ciąg (tylko do odczytu) | Stan czerwonego zespołu. Jest on ustawiany przez usługę i jest tylko do odczytu. | Nie. | |
| tags | obiekt | Tagi czerwonego zespołu. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| miejsce docelowe | TargetConfig | Klasa abstrakcyjna dla konfiguracji docelowej. | Yes | |
| └typ | ciąg | Typ konfiguracji modelu. | Yes |
RedTeamEvalRunDataSource
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| item_generation_params | ItemGenerationParams | Reprezentuje zestaw parametrów używanych do sterowania operacjami generowania elementów. | Yes | |
| └typ | ItemGenerationParamsType | Typ parametrów generowania elementu do użycia. | Yes | |
| miejsce docelowe | Obiekt docelowy | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Yes | |
| └typ | ciąg | Typ obiektu docelowego. | Yes | |
| typ | wyliczenie | Typ źródła danych. Zawsze azure_ai_red_team.Możliwe wartości: azure_ai_red_team |
Yes |
RedTeamItemGenerationParams
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| attack_strategies | tablica strategii ataków | Kolekcja strategii ataków, które mają być używane. | Yes | |
| num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Yes | 20 |
| typ | wyliczenie | Typ parametrów generowania elementu. Możliwe wartości: red_team |
Yes |
RedTeamSeedPromptsItemGenerationParams
Reprezentuje parametry generowania elementu z czerwonym inicjatorem zespołu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| attack_strategies | tablica strategii ataków | Kolekcja strategii ataków, które mają być używane. | Yes | |
| num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Yes | 20 |
| przesłać źródło | OpenAI.EvalJsonlFileContentSource | Yes | ||
| └─ zawartość | tablica obiektów OpenAI.EvalJsonlFileContentSourceContent | Zawartość pliku jsonl. | Yes | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_content.Możliwe wartości: file_content |
Yes | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze red_team_seed_prompts.Możliwe wartości: red_team_seed_prompts |
Yes |
RedTeamTaxonomyItemGenerationParams
Reprezentuje parametry generowania elementów taksonomii zespołu czerwonego.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| attack_strategies | tablica strategii ataków | Kolekcja strategii ataków, które mają być używane. | Yes | |
| num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Yes | 20 |
| przesłać źródło | OpenAI.EvalJsonlFileContentSource | Yes | ||
| └─ zawartość | tablica obiektów OpenAI.EvalJsonlFileContentSourceContent | Zawartość pliku jsonl. | Yes | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_content.Możliwe wartości: file_content |
Yes | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze red_team_taxonomy.Możliwe wartości: red_team_taxonomy |
Yes |
ResponseRetrievalItemGenerationParams
Reprezentuje parametry generowania elementu pobierania odpowiedzi.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| mapowanie danych | obiekt | Mapowanie z pól źródłowych na pole response_id wymagane do pobierania historii czatu. | Yes | |
| max_num_turns | liczba całkowita | Maksymalna liczba zakrętów historii czatów do oceny. | Yes | |
| przesłać źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource | Źródło, z którego jest odczytywana zawartość JSONL. | Yes | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze response_retrieval.Możliwe wartości: response_retrieval |
Yes |
Kategoria ryzyka
Kategoria ryzyka dla celu ataku.
| Property | Value |
|---|---|
| Opis | Kategoria ryzyka dla celu ataku. |
| Type | ciąg |
| Wartości | HateUnfairnessViolenceSexualSelfHarmProtectedMaterialCodeVulnerabilityUngroundedAttributesProhibitedActionsSensitiveDataLeakageTaskAdherence |
Sygnatury dostępu współdzielonego
Definicja poświadczeń sygnatury dostępu współdzielonego (SAS)
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| SAS | ciąg (tylko do odczytu) | token SAS | Nie. | |
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: SAS |
Yes |
SampleType
Rodzaj próbki użytej w analizie.
| Property | Value |
|---|---|
| Opis | Rodzaj próbki użytej w analizie. |
| Type | ciąg |
| Wartości | EvaluationResultSample |
SasCredential
Definicja poświadczeń sygnatury dostępu współdzielonego
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| sasUri | ciąg (tylko do odczytu) | Identyfikator URI sygnatury dostępu współdzielonego | Yes | |
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: SAS |
Yes |
Schedule
Model harmonogramu.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis harmonogramu. | Nie. | |
| displayName | ciąg | Nazwa harmonogramu. | Nie. | |
| enabled | boolean | Włączony stan harmonogramu. | Yes | |
| id | ciąg (tylko do odczytu) | Identyfikator harmonogramu. | Yes | |
| properties | obiekt | Właściwości harmonogramu. W przeciwieństwie do tagów właściwości są tylko do dodawania. Po dodaniu nie można usunąć właściwości. | Nie. | |
| provisioningStatus (stan aprowizacji) | ScheduleProvisioningStatus (tylko do odczytu) | Zaplanuj stan apryfikacji. | Nie. | |
| daneSystemowe | obiekt (tylko do odczytu) | Metadane systemu dla zasobu. | Yes | |
| tags | obiekt | Tagi harmonogramu. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| zadanie | ScheduleTask | Zaplanuj model zadań. | Yes | |
| Konfiguracja └* | obiekt | Konfiguracja zadania. | Nie. | |
| └typ | ScheduleTaskType | Typ zadania. | Yes | |
| wyzwalacz | Trigger | Model podstawowy dla wyzwalacza harmonogramu. | Yes | |
| └typ | Typ wyzwalacza | Typ wyzwalacza. | Yes |
ScheduleProvisioningStatus
Zaplanuj stan apryfikacji.
| Property | Value |
|---|---|
| Opis | Zaplanuj stan apryfikacji. |
| Type | ciąg |
| Wartości | CreatingUpdatingDeletingSucceededFailed |
ScheduleRun
Zaplanuj model uruchamiania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| błąd | ciąg (tylko do odczytu) | Informacje o błędzie dotyczące przebiegu harmonogramu. | Nie. | |
| id | ciąg (tylko do odczytu) | Identyfikator przebiegu harmonogramu. | Yes | |
| properties | obiekt (tylko do odczytu) | Właściwości przebiegu harmonogramu. | Yes | |
| identyfikator harmonogramu | ciąg | Identyfikator harmonogramu. | Yes | |
| success | Wartość logiczna (tylko do odczytu) | Stan powodzenia wyzwalacza przebiegu harmonogramu. | Yes | |
| triggerTime | ciąg | Czas wyzwalania przebiegu harmonogramu. | Nie. |
ZaplanowaneZadanie
Zaplanuj model zadań.
Dyskryminujący dla harmonogramuTask
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
Evaluation |
EvaluationScheduleTask |
Insight |
InsightScheduleTask |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| konfiguracja | obiekt | Konfiguracja zadania. | Nie. | |
| typ | ScheduleTaskType | Typ zadania. | Yes |
ScheduleTaskType
Typ zadania.
| Property | Value |
|---|---|
| Opis | Typ zadania. |
| Type | ciąg |
| Wartości | EvaluationInsight |
SharepointGroundingToolParameters
Parametry narzędzia do uziemiania programu sharepoint.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| project_connections | tablica toolProjectConnection | Połączenia project dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Nie. |
SharepointPreviewTool
Informacje o definicji danych wejściowych narzędzia sharepoint używane do konfigurowania agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| sharepoint_grounding_preview | SharepointGroundingToolParameters | Parametry narzędzia do uziemiania programu sharepoint. | Yes | |
| └project_connections | tablica toolProjectConnection | Połączenia project dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. Ograniczenia: maxItems: 1 |
Nie. | |
| typ | wyliczenie | Typ obiektu, który zawsze jest "sharepoint_grounding_preview". Możliwe wartości: sharepoint_grounding_preview |
Yes |
Sku
Informacje o jednostce SKU
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| dyspozycyjność | liczba całkowita | Pojemność jednostki SKU | Yes | |
| family | ciąg | Rodzina jednostek SKU | Yes | |
| nazwa | ciąg | Nazwa jednostki SKU | Yes | |
| size | ciąg | Rozmiar jednostki SKU | Yes | |
| warstwa | ciąg | Warstwa jednostki SKU | Yes |
StructuredInputDefinition
Ustrukturyzowane dane wejściowe, które mogą uczestniczyć w monitujących podstawieniach szablonów i wiązaniu argumentów narzędzia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| default_value | Wartość domyślna danych wejściowych, jeśli nie podano wartości czasu wykonywania. | Nie. | ||
| opis | ciąg | Czytelny dla człowieka opis danych wejściowych. | Nie. | |
| required | boolean | Określa, czy właściwość wejściowa jest wymagana, gdy agent jest wywoływany. | Nie. | Nieprawda |
| schemat | obiekt | Schemat JSON dla danych wejściowych ze strukturą (opcjonalnie). | Nie. |
StructuredOutputDefinition
Ustrukturyzowane dane wyjściowe, które mogą być generowane przez agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis danych wyjściowych do emisji. Używany przez model do określania, kiedy emitować dane wyjściowe. | Yes | |
| nazwa | ciąg | Nazwa danych wyjściowych ze strukturą. | Yes | |
| schemat | obiekt | Schemat JSON dla danych wyjściowych ze strukturą. | Yes | |
| surowy | Wartość logiczna (dopuszczana do wartości null) | Czy wymuszać ścisłą walidację. Wartość domyślna true. |
Yes |
StructuredOutputsOutputsOutputItem
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| We/Wy | Dane wyjściowe ze strukturą przechwycone podczas odpowiedzi. | Yes | ||
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| typ | wyliczenie | Możliwe wartości: structured_outputs |
Yes |
SyntheticDataGenerationPreviewEvalRunDataSource
Reprezentuje źródło danych dla przebiegów oceny, które ocenia na podstawie wygenerowanych syntetycznych danych na potrzeby testowania.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wiadomości wejściowe | OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate | Nie. | ||
| └─ szablon | tablica obiektów lub OpenAI.EvalItem | Yes | ||
| └typ | wyliczenie | Możliwe wartości: template |
Yes | |
| item_generation_params | SyntheticDataGenerationPreviewItemGenerationParams | Yes | ||
| └model_deployment_name | ciąg | Nazwa wdrożenia modelu do użycia do generowania danych syntetycznych. | Yes | |
| └output_dataset_id | ciąg (tylko do odczytu) | Identyfikator wyjściowego zestawu danych, w którym są przechowywane wygenerowane dane syntetyczne. Wygenerowane dane to plik jsonl z identyfikatorem kolumn, zapytaniem i test_description. | Nie. | |
| └output_dataset_name | ciąg | Nazwa wyjściowego zestawu danych, w którym będą przechowywane wygenerowane syntetyczne dane. Jeśli nie zostanie podana, usługa automatycznie generuje nazwę zestawu danych. | Nie. | |
| Zachęta └* | ciąg | Monit używany do generowania danych syntetycznych. Jest to opcja, jeśli element docelowy ma typ "azure_ai_agent" z instrukcjami skonfigurowanymi w agencie. | Nie. | |
| └samples_count | liczba całkowita | Maksymalna liczba próbek danych do wygenerowania. | Yes | |
| Źródła └* | tablica pliku OpenAI.EvalJsonlFileIdSource | Opcjonalne pliki źródłowe zawartości danych inicjuj na potrzeby generowania danych. | Yes | |
| └typ | wyliczenie | Typ parametrów generowania elementu. Możliwe wartości: synthetic_data_gen_preview |
Yes | |
| miejsce docelowe | Obiekt docelowy | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Yes | |
| └typ | ciąg | Typ obiektu docelowego. | Yes | |
| typ | wyliczenie | Typ źródła danych, zawsze azure_ai_synthetic_data_gen_preview.Możliwe wartości: azure_ai_synthetic_data_gen_preview |
Yes |
SyntheticDataGenerationPreviewItemGenerationParams
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| nazwa_wdrożenia_modelu | ciąg | Nazwa wdrożenia modelu do użycia do generowania danych syntetycznych. | Yes | |
| output_dataset_id | ciąg (tylko do odczytu) | Identyfikator wyjściowego zestawu danych, w którym są przechowywane wygenerowane dane syntetyczne. Wygenerowane dane to plik jsonl z identyfikatorem kolumn, zapytaniem i test_description. | Nie. | |
| output_dataset_name | ciąg | Nazwa wyjściowego zestawu danych, w którym będą przechowywane wygenerowane syntetyczne dane. Jeśli nie zostanie podana, usługa automatycznie generuje nazwę zestawu danych. | Nie. | |
| monit | ciąg | Monit używany do generowania danych syntetycznych. Jest to opcja, jeśli element docelowy ma typ "azure_ai_agent" z instrukcjami skonfigurowanymi w agencie. | Nie. | |
| samples_count | liczba całkowita | Maksymalna liczba próbek danych do wygenerowania. | Yes | |
| Źródeł | tablica pliku OpenAI.EvalJsonlFileIdSource | Opcjonalne pliki źródłowe zawartości danych inicjuj na potrzeby generowania danych. | Yes | |
| typ | wyliczenie | Typ parametrów generowania elementu. Możliwe wartości: synthetic_data_gen_preview |
Yes |
Target
Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora.
Dyskryminujący cel
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
azure_ai_model |
AzureAIModelTarget |
azure_ai_agent |
AzureAIAgentTarget |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | ciąg | Typ obiektu docelowego. | Yes |
TargetCompletionEvalRunDataSource
Reprezentuje źródło danych dla docelowej konfiguracji oceny ukończenia.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| wiadomości wejściowe | OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference | Nie. | ||
| └item_reference | ciąg | Yes | ||
| └typ | wyliczenie | Możliwe wartości: item_reference |
Yes | |
| przesłać źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource | Konfiguracja źródła dla danych wbudowanych lub plików. | Yes | |
| miejsce docelowe | Obiekt docelowy | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Yes | |
| └typ | ciąg | Typ obiektu docelowego. | Yes | |
| typ | wyliczenie | Typ źródła danych, zawsze azure_ai_target_completions.Możliwe wartości: azure_ai_target_completions |
Yes |
TargetConfig
Klasa abstrakcyjna dla konfiguracji docelowej.
Dyskryminujące dla elementu TargetConfig
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
AzureOpenAIModel |
AzureOpenAIModelConfiguration |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | ciąg | Typ konfiguracji modelu. | Yes |
TargetUpdate
Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora.
Dyskryminujący dla elementu TargetUpdate
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
azure_ai_model |
AzureAIModelTargetUpdate |
azure_ai_agent |
AzureAIAgentTargetUpdate |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | ciąg | Typ obiektu docelowego. | Yes |
TaksonomiaCategory
Definicja kategorii taksonomii.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis kategorii taksonomii. | Nie. | |
| id | ciąg | Unikatowy identyfikator kategorii taksonomii. | Yes | |
| nazwa | ciąg | Nazwa kategorii taksonomii. | Yes | |
| properties | obiekt | Dodatkowe właściwości kategorii taksonomii. | Nie. | |
| riskCategory | Kategoria ryzyka | Kategoria ryzyka dla celu ataku. | Yes | |
| Podkategorie | tablica taksonomiiSubCategory | Lista podkategorii taksonomii. | Yes |
TaksonomiaSubCategory
Definicja podkategorii taksonomii.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Opis podkategoii taksonomii. | Nie. | |
| enabled | boolean | Lista elementów taksonomii w tej podkategoii. | Yes | |
| id | ciąg | Unikatowy identyfikator podkategoii taksonomii. | Yes | |
| nazwa | ciąg | Nazwa podkategoii taksonomii. | Yes | |
| properties | obiekt | Dodatkowe właściwości podkategoii taksonomii. | Nie. |
ToolDescription
Opis narzędzia, które może być używane przez agenta.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Krótki opis przeznaczenia narzędzia. | Nie. | |
| nazwa | ciąg | Nazwa narzędzia. | Nie. |
ToolProjectConnection
Zasób połączenia project.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| project_connection_id | ciąg | Połączenie projektu w narzędziu ToolProjectConnectionList dołączone do tego narzędzia. | Yes |
TracesPreviewEvalRunDataSource
Reprezentuje źródło danych na potrzeby przebiegów oceny, które działają na podstawie śladów agenta przechowywanych w usłudze Application Insights.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Agent_id | ciąg | Identyfikator agenta używany do filtrowania śladów na potrzeby oceny. | Nie. | |
| agent_name | ciąg | Nazwa agenta używana do filtrowania śladów na potrzeby oceny. | Nie. | |
| czas zakończenia | liczba całkowita | Znacznik czasu systemu Unix (w sekundach) oznaczający koniec okna zapytania śledzenia. Domyślnie ustawiony jest aktualny czas. | Nie. | |
| ingestion_delay_seconds | liczba całkowita | Opóźnienie, które ma dotyczyć pozyskiwania podczas wykonywania zapytań dotyczących śladów. | Nie. | 300 |
| lookback_hours | liczba całkowita | Okno wyszukiwania (w godzinach) stosowane podczas pobierania śladów z usługi Application Insights. W przypadku zaplanowanych ocen jest to wnioskowane z interwału cyklu. |
Nie. | 168 |
| max_traces | liczba całkowita | Limit próbkowania zastosowany do śladów pobranych do oceny. | Nie. | 1000 |
| trace_ids | tablica ciągów | Kolekcja identyfikatorów śledzenia agenta, które powinny być oceniane. | Nie. | |
| typ | wyliczenie | Typ źródła danych, zawsze azure_ai_traces_preview.Możliwe wartości: azure_ai_traces_preview |
Yes |
TreatmentEffectType
Rodzaj efektu zabiegu.
| Property | Value |
|---|---|
| Opis | Rodzaj efektu zabiegu. |
| Type | ciąg |
| Wartości | TooFewSamplesInconclusiveChangedImprovedDegraded |
Trigger
Model podstawowy dla wyzwalacza harmonogramu.
Dyskryminujący wyzwalacz
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Typ wartości | Schema |
|---|---|
Cron |
CronTrigger (Wyzwalacz Crona) |
Recurrence |
Wyzwalacz cyklu |
OneTime |
OneTimeTrigger |
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| typ | Typ wyzwalacza | Typ wyzwalacza. | Yes |
Typ wyzwalacza
Typ wyzwalacza.
| Property | Value |
|---|---|
| Opis | Typ wyzwalacza. |
| Type | ciąg |
| Wartości | CronRecurrenceOneTime |
UpdateAgentFromManifestRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Yes | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Yes |
UpdateAgentRequest
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| definicja | AgentDefinition | Yes | ||
| Rodzaj └* | AgentKind | Yes | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. Ograniczenia: maxLength: 512 |
Nie. | |
| metadane | obiekt | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. |
UpdateEvalParametersBody
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| metadane | OpenAI.Metadata (dopuszczana wartość null) | Zestaw 16 par kluczy i wartości, które można dołączyć do obiektu. Może to być przydatne do przechowywania dodatkowych informacji o obiekcie w ustrukturyzowanej strukturze formatowanie i wykonywanie zapytań dotyczących obiektów za pośrednictwem interfejsu API lub pulpitu nawigacyjnego. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi z maksymalną długością 512 znaków. |
Nie. | |
| nazwa | ciąg | Nie. | ||
| properties | obiekt | Zestaw niezmiennych par klucz-wartość 16, które można dołączyć do obiektu w celu przechowywania dodatkowych informacji. Klucze to ciągi o maksymalnej długości 64 znaków. Wartości to ciągi o maksymalnej długości 512 znaków. |
Nie. |
UserProfileMemoryItem
Element pamięci zawierający informacje o profilu użytkownika wyodrębnione z konwersacji, takie jak preferencje, zainteresowania i dane osobowe.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| zawartość | ciąg | Zawartość pamięci. | Yes | |
| rodzaj | wyliczenie | Rodzaj elementu pamięci. Możliwe wartości: user_profile |
Yes | |
| memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Yes | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Yes | |
| updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Yes |
WebSearchConfiguration
Konfiguracja wyszukiwania w Internecie dla wyszukiwania niestandardowego bing
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| instance_name | ciąg | Nazwa wystąpienia konfiguracji niestandardowej podane do konfiguracji. | Yes | |
| project_connection_id | ciąg | Project identyfikator połączenia dla uziemienia za pomocą wyszukiwania niestandardowego bing | Yes |
WeeklyRecurrenceSchedule
Tygodniowy harmonogram nawrotów.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| Dni tygodnia | tablica DayOfWeek | Dni tygodnia dla harmonogramu cyklu. | Yes | |
| typ | wyliczenie | Typ cyklu tygodniowego. Możliwe wartości: Weekly |
Yes |
WorkflowActionOutputItem
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| action_id | ciąg | Unikatowy identyfikator akcji. | Yes | |
| agent_reference | AgentReference | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. Ograniczenia: maxLength: 256 |
Yes | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Yes | |
| └─ wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| rodzaj | ciąg | Rodzaj akcji CSDL (np. "SetVariable", "InvokeAzureAgent"). | Yes | |
| parent_action_id | ciąg | Identyfikator akcji nadrzędnej, jeśli jest to akcja zagnieżdżona. | Nie. | |
| previous_action_id | ciąg | Identyfikator poprzedniej akcji, jeśli ta akcja jest zgodna z inną akcją. | Nie. | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| stan | wyliczenie | Stan akcji (np. "in_progress", "completed", "failed", "cancelled". Możliwe wartości: completed, , failed, in_progresscancelled |
Yes | |
| typ | wyliczenie | Możliwe wartości: workflow_action |
Yes |
WorkflowAgentDefinition
Definicja agenta przepływu pracy.
| Name | Typ | Description | Obowiązkowy | Wartość domyślna |
|---|---|---|---|---|
| rodzaj | wyliczenie | Możliwe wartości: workflow |
Yes | |
| rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| └rai_policy_name | ciąg | Nazwa zasad RAI do zastosowania. | Yes | |
| przepływ pracy | ciąg | Definicja YAML CSDL przepływu pracy. | Nie. |
liczba całkowita
Typ: liczba całkowita
Format: int64