Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Wersja interfejsu API: 2025-11-15-preview
Agenci — tworzenie agenta
POST {endpoint}/agents?api-version=2025-11-15-preview
Tworzy agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Tak | ||
| Rodzaj └* | AgentKind | Nie. | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — lista agentów
GET {endpoint}/agents?api-version=2025-11-15-preview
Zwraca listę wszystkich agentów.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| rodzaj | kwerenda | Nie. | Filtruj agentów według rodzaju. Jeśli nie zostanie podany, zostaną zwrócone wszystkie agenty. | |
| 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — uzyskiwanie agenta
GET {endpoint}/agents/{agent_name}?api-version=2025-11-15-preview
Pobiera agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — aktualizowanie agenta
POST {endpoint}/agents/{agent_name}?api-version=2025-11-15-preview
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 | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Tak | ||
| Rodzaj └* | AgentKind | Nie. | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — usuwanie agenta
DELETE {endpoint}/agents/{agent_name}?api-version=2025-11-15-preview
Usuwa agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DeleteAgentResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — aktualizowanie agenta z manifestu
POST {endpoint}/agents/{agent_name}/import?api-version=2025-11-15-preview
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 | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta do zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — wyświetlanie listy operacji kontenera agenta
GET {endpoint}/agents/{agent_name}/operations?api-version=2025-11-15-preview
Wyświetlanie listy operacji kontenera dla agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — pobieranie operacji kontenera agenta
GET {endpoint}/agents/{agent_name}/operations/{operation_id}?api-version=2025-11-15-preview
Uzyskaj stan operacji kontenera dla agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| operation_id | ścieżka | Tak | ciąg | Identyfikator operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentContainerOperationObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse lub ApiErrorResponse |
Agenci — tworzenie wersji agenta
POST {endpoint}/agents/{agent_name}/versions?api-version=2025-11-15-preview
Utwórz nową wersję agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Tak | ||
| Rodzaj └* | AgentKind | Nie. | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentVersionObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — wyświetlanie listy wersji agentów
GET {endpoint}/agents/{agent_name}/versions?api-version=2025-11-15-preview
Zwraca listę wersji agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — uzyskiwanie wersji agenta
GET {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=2025-11-15-preview
Pobiera określoną wersję agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta do pobrania. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentVersionObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — usuwanie wersji agenta
DELETE {endpoint}/agents/{agent_name}/versions/{agent_version}?api-version=2025-11-15-preview
Usuwa określoną wersję agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta do usunięcia. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta do usunięcia |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DeleteAgentVersionResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — pobieranie kontenera agenta
GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default?api-version=2025-11-15-preview
Pobierz kontener dla określonej wersji agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentContainerObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — wyświetlanie listy operacji kontenera wersji agenta
GET {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default/operations?api-version=2025-11-15-preview
Wyświetlanie listy operacji kontenera dla określonej wersji agenta.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Tak | 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — usuwanie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:delete?api-version=2025-11-15-preview
Usuń kontener dla określonej wersji agenta. Jeśli kontener nie istnieje, operacja zostanie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST platformy Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentContainerOperationObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — uruchamianie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:start?api-version=2025-11-15-preview
Uruchom kontener dla określonej wersji agenta. Jeśli kontener jest już uruchomiony, operacja zostanie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST platformy Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentContainerOperationObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — zatrzymywanie kontenera agentów
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:stop?api-version=2025-11-15-preview
Zatrzymaj kontener dla określonej wersji agenta. Jeśli kontener nie jest uruchomiony lub został już zatrzymany, operacja zostanie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST platformy Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 202
Opis: Żądanie zostało zaakceptowane do przetwarzania, ale przetwarzanie nie zostało jeszcze ukończone.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentContainerOperationObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse lub ApiErrorResponse |
Agenci — aktualizowanie kontenera agenta
POST {endpoint}/agents/{agent_name}/versions/{agent_version}/containers/default:update?api-version=2025-11-15-preview
Aktualizowanie kontenera dla określonej wersji agenta. Jeśli kontener nie jest uruchomiony, operacja zostanie no-op. Operacja jest długotrwałą operacją. Zgodnie z wytycznymi projektowymi dotyczącymi długotrwałych operacji w interfejsach API REST platformy Azure. https://github.com/microsoft/api-guidelines/blob/vNext/azure/ConsiderationsForServiceDesign.md#action-operations
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | ciąg | Nazwa agenta. |
| agent_version | ścieżka | Tak | ciąg | Wersja agenta. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentContainerOperationObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — tworzenie wersji agenta na podstawie manifestu
POST {endpoint}/agents/{agent_name}/versions:import?api-version=2025-11-15-preview
Utwórz nową wersję agenta na podstawie manifestu.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| agent_name | ścieżka | Tak | 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentVersionObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Agenci — tworzenie agenta na podstawie manifestu
POST {endpoint}/agents:import?api-version=2025-11-15-preview
Tworzy agenta na podstawie manifestu.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AgentObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Połączenia — lista
GET {endpoint}/connections?api-version=2025-11-15-preview
Wyświetlanie listy wszystkich połączeń w projekcie bez wypełniania poświadczeń połączenia
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ połączenia | kwerenda | Nie. | Wyświetlanie listy połączeń tego konkretnego typu | |
| defaultConnection | kwerenda | Nie. | typ logiczny (boolowski) | Wyświetlanie listy połączeń, które są połączeniami domyślnymi |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedConnection |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Połączenia — pobierz
GET {endpoint}/connections/{name}?api-version=2025-11-15-preview
Pobieranie połączenia według nazwy bez wypełniania poświadczeń połączenia
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Przyjazna nazwa połączenia podana przez użytkownika. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Połączenie |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Połączenia — pobieranie przy użyciu poświadczeń
POST {endpoint}/connections/{name}/getConnectionWithCredentials?api-version=2025-11-15-preview
Pobieranie połączenia według nazwy z jego poświadczeniami połączenia
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Przyjazna nazwa połączenia podana przez użytkownika. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Połączenie |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — lista najnowszych
GET {endpoint}/datasets?api-version=2025-11-15-preview
Wyświetlanie listy najnowszych wersji każdego elementu DatasetVersion
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedDatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — wersje listy
GET {endpoint}/datasets/{name}/versions?api-version=2025-11-15-preview
Wyświetlanie listy wszystkich wersji danego elementu DatasetVersion
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedDatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — pobieranie wersji
GET {endpoint}/datasets/{name}/versions/{version}?api-version=2025-11-15-preview
Pobierz określoną wersję elementu DatasetVersion. Usługa zwraca błąd 404 Nie znaleziono, jeśli DatasetVersion nie istnieje.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Określony identyfikator wersji elementu DatasetVersion do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — usuwanie wersji
DELETE {endpoint}/datasets/{name}/versions/{version}?api-version=2025-11-15-preview
Usuń określoną wersję elementu DatasetVersion. Usługa zwraca wartość 204 No Content, jeśli element DatasetVersion został pomyślnie usunięty lub jeśli element DatasetVersion nie istnieje.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Wersja elementu DatasetVersion do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — tworzenie lub aktualizowanie wersji
PATCH {endpoint}/datasets/{name}/versions/{version}?api-version=2025-11-15-preview
Utwórz nowy lub zaktualizuj istniejący element DatasetVersion przy użyciu podanego identyfikatora wersji
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Konkretny identyfikator wersji elementu DatasetVersion do utworzenia lub zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ treści: application/merge-patch+json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | obiekt | Wyliczenie w celu określenia typu danych. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DatasetVersion |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DatasetVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — uzyskiwanie poświadczeń
POST {endpoint}/datasets/{name}/versions/{version}/credentials?api-version=2025-11-15-preview
Pobierz poświadczenia sygnatury dostępu współdzielonego, aby uzyskać dostęp do konta magazynu skojarzonego z wersją zestawu danych.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Konkretny identyfikator wersji elementu DatasetVersion, na którym ma być wykonywana operacja. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | AssetCredentialResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Zestawy danych — rozpoczynanie oczekiwania na przekazanie wersji
POST {endpoint}/datasets/{name}/versions/{version}/startPendingUpload?api-version=2025-11-15-preview
Rozpocznij nowy lub pobierz istniejące oczekujące przekazanie zestawu danych dla określonej wersji.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Konkretny identyfikator wersji elementu DatasetVersion, na którym ma być wykonywana operacja. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| connectionName (nazwa_połączenia) | 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 | BlobReference jest jedynym obsługiwanym typem. Możliwe wartości: BlobReference |
Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PendingUploadResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Wdrożenia — lista
GET {endpoint}/deployments?api-version=2025-11-15-preview
Wyświetlanie listy wszystkich wdrożonych modeli w projekcie
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| modelPublisher | kwerenda | Nie. | ciąg | Wydawca modeli, według którego można filtrować modele |
| modelName | kwerenda | Nie. | ciąg | Nazwa modelu (nazwa specyficzna dla wydawcy), według której można filtrować modele |
| deploymentType | kwerenda | Nie. | Typ wdrożenia do filtrowania listy według | |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedDeployment |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Wdrożenia — pobieranie
GET {endpoint}/deployments/{name}?api-version=2025-11-15-preview
Pobierz wdrożony model.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa wdrożenia |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Wdrożenie |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Reguły oceny — lista
GET {endpoint}/evaluationrules?api-version=2025-11-15-preview
Wyświetl listę wszystkich reguł oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| actionType | kwerenda | Nie. | Filtruj według typu reguły oceny. | |
| agentName | kwerenda | Nie. | ciąg | Filtruj według nazwy agenta. |
| włączony | kwerenda | Nie. | typ logiczny (boolowski) | Filtruj według stanu włączenia. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedEvaluationRule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Reguły oceny — pobieranie
GET {endpoint}/evaluationrules/{id}?api-version=2025-11-15-preview
Pobierz regułę oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Niepowtarzalny identyfikator reguły oceny. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationRule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Reguły oceny — usuwanie
DELETE {endpoint}/evaluationrules/{id}?api-version=2025-11-15-preview
Usuwanie reguły oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Niepowtarzalny identyfikator reguły oceny. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Reguły oceny — tworzenie lub aktualizowanie
PUT {endpoint}/evaluationrules/{id}?api-version=2025-11-15-preview
Tworzenie lub aktualizowanie reguły oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Niepowtarzalny identyfikator reguły oceny. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | obiekt | Model działania ewaluacyjnego. | Tak | |
| └typ | EvaluationRuleActionType | Rodzaj działania w ramach oceny. | Nie. | |
| opis | ciąg | Opis reguły oceny. | Nie. | |
| displayName | ciąg | Nazwa wyświetlana reguły oceny. | Nie. | |
| włączony | typ logiczny (boolowski) | Wskazuje, czy reguła oceny jest włączona. Wartość domyślna to true. | Tak | |
| eventType | obiekt | Typ zdarzenia reguły oceny. | Tak | |
| filtr | obiekt | Model filtru oceny. | Nie. | |
| └} agentName | ciąg | Filtruj według nazwy agenta. | Nie. | |
| identyfikator | ciąg | Niepowtarzalny identyfikator reguły oceny. | Tak | |
| daneSystemowe | obiekt | Metadane systemowe dla reguły oceny. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationRule |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationRule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Taksonomie oceny — lista
GET {endpoint}/evaluationtaxonomies?api-version=2025-11-15-preview
Lista taksonomii oceny
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| inputName | kwerenda | Nie. | ciąg | Filtruj według nazwy danych wejściowych oceny. |
| inputType | kwerenda | Nie. | ciąg | Filtrowanie według typu danych wejściowych taksonomii. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedEvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Taksonomie oceny — pobierz
GET {endpoint}/evaluationtaxonomies/{name}?api-version=2025-11-15-preview
Pobierz ocenę uruchomioną według nazwy.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Taksonomie oceny — usuwanie
DELETE {endpoint}/evaluationtaxonomies/{name}?api-version=2025-11-15-preview
Usuń taksonomię oceny według nazwy.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Taksonomie oceny — tworzenie
PUT {endpoint}/evaluationtaxonomies/{name}?api-version=2025-11-15-preview
Utwórz taksonomię oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa taksonomii oceny. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | macierz | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | obiekt | Konfiguracja danych wejściowych dla taksonomii oceny. | Tak | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationTaxonomy |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Taksonomie oceny — aktualizacja
PATCH {endpoint}/evaluationtaxonomies/{name}?api-version=2025-11-15-preview
Aktualizowanie taksonomii oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa taksonomii oceny. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | macierz | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | obiekt | Konfiguracja danych wejściowych dla taksonomii oceny. | Nie. | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluationTaxonomy |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Ewaluatory — lista najnowszych wersji
GET {endpoint}/evaluators?api-version=2025-11-15-preview
Lista najnowszych wersji każdego ewaluatora
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ | kwerenda | Nie. | Filtruj oceniających 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 | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedEvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Ewaluatory — wersje listy
GET {endpoint}/evaluators/{name}/versions?api-version=2025-11-15-preview
Lista wszystkich wersji danego ewaluatora
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| typ | kwerenda | Nie. | Filtruj oceniających 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 | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedEvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Ewaluatory — tworzenie wersji
POST {endpoint}/evaluators/{name}/versions?api-version=2025-11-15-preview
Utwórz nową wersję EvaluatorVersion z automatycznie zwiększanym identyfikatorem wersji
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| categories | macierz | Kategorie osoby oceniającej | Tak | |
| definicja | obiekt | Podstawowa konfiguracja ewaluatora z dyskryminatorem | Tak | |
| └data_schema | 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 | 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 | Nie. | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Pomaga łatwo znaleźć ewaluatora w Foundry. Nie musi być unikalny. | Nie. | |
| evaluator_type | obiekt | Rodzaj osoby oceniającej | Tak | |
| 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Ewaluatory — pobieranie wersji
GET {endpoint}/evaluators/{name}/versions/{version}?api-version=2025-11-15-preview
Pobierz konkretną wersję EvaluatorVersion. Usługa zwraca błąd 404 Nie znaleziono, jeśli EvaluatorVersion nie istnieje.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Określony identyfikator wersji ewaluatorVersion do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Ewaluatory — usuwanie wersji
DELETE {endpoint}/evaluators/{name}/versions/{version}?api-version=2025-11-15-preview
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 | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Wersja ewaluatorVersion do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Ewaluatorzy — wersja aktualizacji
PATCH {endpoint}/evaluators/{name}/versions/{version}?api-version=2025-11-15-preview
Zaktualizuj istniejącą wersję EvaluatorVersion przy użyciu podanego identyfikatora wersji
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Wersja ewaluatorVersion do aktualizacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| categories | macierz | Kategorie osoby oceniającej | Nie. | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Pomaga łatwo znaleźć ewaluatora w 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | EvaluatorVersion |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Indeksy — najnowsza lista
GET {endpoint}/indexes?api-version=2025-11-15-preview
Wyświetlanie listy najnowszych wersji każdego indeksu
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedIndex |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Indeksy — wersje listy
GET {endpoint}/indexes/{name}/versions?api-version=2025-11-15-preview
Wyświetla listę wszystkich wersji danego indeksu
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedIndex |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Indeksy — pobieranie wersji
GET {endpoint}/indexes/{name}/versions/{version}?api-version=2025-11-15-preview
Pobierz konkretną wersję indeksu. Usługa zwraca błąd 404 Nie znaleziono, jeśli indeks nie istnieje.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Konkretny identyfikator wersji indeksu do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Indeks |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Indeksy — usuwanie wersji
DELETE {endpoint}/indexes/{name}/versions/{version}?api-version=2025-11-15-preview
Usuń określoną wersję indeksu. Usługa zwraca wartość 204 Brak zawartości, jeśli indeks został pomyślnie usunięty lub jeśli indeks nie istnieje.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Wersja indeksu do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Indeksy — tworzenie lub aktualizowanie wersji
PATCH {endpoint}/indexes/{name}/versions/{version}?api-version=2025-11-15-preview
Utwórz nowy lub zaktualizuj istniejący indeks o podanym identyfikatorze wersji
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa zasobu |
| wersja | ścieżka | Tak | ciąg | Konkretny identyfikator wersji indeksu do utworzenia lub zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ treści: application/merge-patch+json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | obiekt | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Indeks |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Indeks |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Szczegółowe informacje — generowanie
POST {endpoint}/insights?api-version=2025-11-15-preview
Generowanie szczegółowych informacji
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| Powtarzalność —Request-ID | nagłówek | Nie. | 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 | nagłówek | Nie. | 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| displayName | ciąg | Przyjazna dla użytkownika nazwa wyświetlana dla szczegółowych informacji. | Tak | |
| identyfikator | ciąg | Unikatowy identyfikator raportu ze statystykami. | Tak | |
| metadane | obiekt | Metadane dotyczące szczegółowych informacji. | Tak | |
| └* completedAt | ciąg | Sygnatura czasowa, kiedy szczegółowe informacje zostały ukończone. | Nie. | |
| └} createdAt | ciąg | Sygnatura czasowa utworzenia szczegółowych informacji. | Nie. | |
| żądanie | obiekt | Żądanie raportu szczegółowych informacji. | Tak | |
| └typ | InsightType | Typ żądania. | Nie. | |
| wynik | obiekt | Wynik spostrzeżeń. | Nie. | |
| └typ | InsightType | Typ wyniku szczegółowych informacji. | Nie. | |
| stan | obiekt | Wyliczenie opisujące dozwolone stany operacji. | Tak |
Responses
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Wgląd |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Szczegółowe informacje — lista
GET {endpoint}/insights?api-version=2025-11-15-preview
Wyświetl listę wszystkich szczegółowych informacji w odwrotnej kolejności chronologicznej (od najnowszych).
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| typ | kwerenda | Nie. | 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. | typ logiczny (boolowski) | Określa, czy w odpowiedzi mają być uwzględniane współrzędne wizualizacji. Wartość domyślna to fałsz. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedInsight |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Szczegółowe informacje — uzyskiwanie
GET {endpoint}/insights/{id}?api-version=2025-11-15-preview
Uzyskaj szczegółowe informacje na podstawie identyfikatora.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Unikatowy identyfikator raportu ze statystykami. |
| includeCoordinates | kwerenda | Nie. | typ logiczny (boolowski) | Określa, czy w odpowiedzi mają być uwzględniane współrzędne wizualizacji. Wartość domyślna to fałsz. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Wgląd |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Tworzenie magazynu pamięci
POST {endpoint}/memory_stores?api-version=2025-11-15-preview
Utwórz magazyn pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Podstawowa definicja konfiguracji magazynu pamięci. | Tak | |
| Rodzaj └* | MemoryStoreKind | Rodzaj magazynu pamięci. | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis magazynu pamięci. | Nie. | |
| metadane | obiekt | Dowolne metadane klucz-wartość do skojarzenia z magazynem pamięci. | Nie. | |
| nazwa | ciąg | Nazwa magazynu pamięci. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Lista magazynów pamięci
GET {endpoint}/memory_stores?api-version=2025-11-15-preview
Wyświetla listę wszystkich magazynów pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Aktualizowanie magazynu pamięci
POST {endpoint}/memory_stores/{name}?api-version=2025-11-15-preview
Aktualizowanie magazynu pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci do zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis magazynu pamięci. | 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Pobieranie magazynu pamięci
GET {endpoint}/memory_stores/{name}?api-version=2025-11-15-preview
Pobieranie magazynu pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreObject |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Usuwanie magazynu pamięci
DELETE {endpoint}/memory_stores/{name}?api-version=2025-11-15-preview
Usuń magazyn pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DeleteMemoryStoreResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Pobieranie wyniku aktualizacji
GET {endpoint}/memory_stores/{name}/updates/{update_id}?api-version=2025-11-15-preview
Pobierz wynik aktualizacji magazynu pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci. |
| update_id | ścieżka | Tak | ciąg | Identyfikator operacji aktualizacji pamięci. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreUpdateResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Usuwanie wspomnień zakresu
POST {endpoint}/memory_stores/{name}:delete_scope?api-version=2025-11-15-preview
Usuń wszystkie wspomnienia skojarzone z określonym zakresem z magazynu pamięci.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje pamięci do usunięcia, na przykład identyfikator użytkownika. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreDeleteScopeResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyszukiwanie wspomnień
POST {endpoint}/memory_stores/{name}:search_memories?api-version=2025-11-15-preview
Wyszukaj odpowiednie wspomnienia z magazynu wspomnień na podstawie kontekstu rozmowy.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci do wyszukania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| items | macierz | Przedmioty, dla których należy wyszukać odpowiednie wspomnienia. | Nie. | |
| options | obiekt | 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 w pamięci od miejsca, w którym zakończono ostatnią operację. | Nie. | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreSearchResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Aktualizowanie pamięci
POST {endpoint}/memory_stores/{name}:update_memories?api-version=2025-11-15-preview
Zaktualizuj magazyn pamięci o wspomnienia z rozmów.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Nazwa magazynu pamięci do zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| items | macierz | Elementy konwersacji, z których można wyodrębnić wspomnienia. | Nie. | |
| previous_update_id | ciąg | Unikatowy identyfikator poprzedniego żądania aktualizacji, umożliwiający przyrostowe aktualizacje pamięci od miejsca, w którym została przerwana ostatnia operacja. | Nie. | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Tak | |
| update_delay | liczba całkowita | Limit czasu przed przetworzeniem aktualizacji pamięci w sekundach. Jeśli w tym okresie zostanie odebrane nowe żądanie aktualizacji, zostanie anulowane bieżące żądanie i zresetowany 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | MemoryStoreUpdateResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Tworzenie konwersacji
POST {endpoint}/openai/conversations?api-version=2025-11-15-preview
Utwórz konwersację.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| items | macierz | Początkowe elementy do uwzględnienia kontekstu konwersacji. Jednocześnie możesz dodać maksymalnie 20 elementów. |
Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy konwersacji
GET {endpoint}/openai/conversations?api-version=2025-11-15-preview
Zwraca listę wszystkich konwersacji.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Aktualizowanie konwersacji
POST {endpoint}/openai/conversations/{conversation_id}?api-version=2025-11-15-preview
Aktualizowanie konwersacji.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | ciąg | Identyfikator konwersacji do zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Uzyskiwanie konwersacji
GET {endpoint}/openai/conversations/{conversation_id}?api-version=2025-11-15-preview
Pobiera konwersację.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | ciąg | Identyfikator konwersacji do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Usuwanie konwersacji
DELETE {endpoint}/openai/conversations/{conversation_id}?api-version=2025-11-15-preview
Usuwa konwersację.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | ciąg | Identyfikator konwersacji do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.DeletedConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Tworzenie elementów konwersacji
POST {endpoint}/openai/conversations/{conversation_id}/items?api-version=2025-11-15-preview
Utwórz elementy w konwersacji z danym identyfikatorem.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | ciąg | Identyfikator konwersacji, na której należy utworzyć element. |
| include | kwerenda | Nie. | macierz | Dodatkowe pola do uwzględnienia w odpowiedzi.include Aby uzyskać więcej informacji, zobacz parametr zawierający listę elementów konwersacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| items | macierz | Elementy do dodania do konwersacji. Jednocześnie możesz dodać maksymalnie 20 elementów. | Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ConversationItemList |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy elementów konwersacji
GET {endpoint}/openai/conversations/{conversation_id}/items?api-version=2025-11-15-preview
Wyświetl listę wszystkich elementów konwersacji z danym identyfikatorem.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. | Filtruj według typu elementu. Jeśli zostanie podana, zostaną zwrócone tylko elementy określonego typu. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Pobieranie elementu konwersacji
GET {endpoint}/openai/conversations/{conversation_id}/items/{item_id}?api-version=2025-11-15-preview
Pobierz pojedynczy element z konwersacji z podanymi identyfikatorami.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | ciąg | Identyfikator konwersacji zawierającej element. |
| item_id | ścieżka | Tak | ciąg | Identyfikator elementu konwersacji do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ItemResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Usuwanie elementu konwersacji
DELETE {endpoint}/openai/conversations/{conversation_id}/items/{item_id}?api-version=2025-11-15-preview
Usuń element z konwersacji z podanymi identyfikatorami.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| conversation_id | ścieżka | Tak | ciąg | Identyfikator konwersacji, z której należy usunąć element. |
| item_id | ścieżka | Tak | ciąg | Identyfikator elementu konwersacji do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ConversationResource |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — evals list
GET {endpoint}/openai/evals?api-version=2025-11-15-preview
Wyświetl listę wszystkich ocen Lista ocen dla projektu.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| after | kwerenda | Nie. | ciąg | Identyfikator ostatniego uruchomienia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | 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. |
| sortuj_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żyjcreated_at czas utworzenia lub updated_at czas ostatniej aktualizacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — tworzenie eval
POST {endpoint}/openai/evals?api-version=2025-11-15-preview
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
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| konfiguracja źródła danych | obiekt | 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 |
Tak | |
| └ dołącz_przykładowy_schemat | typ logiczny (boolowski) | 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. | Nie. | |
| Metadane └* | obiekt | Filtry metadanych dla przechowywanego źródła danych uzupełniania. | Nie. | |
| Scenariusz └* | wyliczenie | Scenariusz schematu danych. Możliwe wartości: red_team, , responsestraces |
Nie. | |
| └typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: azure_ai_source |
Nie. | |
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | macierz | 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}}). |
Tak |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Eval |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — usuwanie eval
DELETE {endpoint}/openai/evals/{eval_id}?api-version=2025-11-15-preview
Usuń ocenę Usuń ocenę.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DeleteEvalResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — uzyskiwanie oceny
GET {endpoint}/openai/evals/{eval_id}?api-version=2025-11-15-preview
Uzyskaj ocenę Pobierz ocenę według identyfikatora.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny do odzyskania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Eval |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — eval aktualizacji
POST {endpoint}/openai/evals/{eval_id}?api-version=2025-11-15-preview
Zaktualizuj ocenę Zaktualizuj niektóre właściwości oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny do zaktualizowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Eval |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — uruchomienia listy
GET {endpoint}/openai/evals/{eval_id}/runs?api-version=2025-11-15-preview
Pobierz listę przebiegów oceny Pobierz listę przebiegów do oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny, dla której mają zostać pobrane przebiegi. |
| after | kwerenda | Nie. | ciąg | Identyfikator ostatniego uruchomienia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — tworzenie przebiegu oceny
POST {endpoint}/openai/evals/{eval_id}/runs?api-version=2025-11-15-preview
Tworzenie przebiegu oceny
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny potrzebny do utworzenia przebiegu. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| źródło danych | obiekt | Obiekt JsonlRunDataSource, który określa plik JSONL odpowiadający ewaluacji. | Tak | |
| └input_messages | 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. | |
| └item_generation_params | RedTeamItemGenerationParams | Parametry generowania elementów. | Nie. | |
| Model └* | ciąg | Nazwa modelu do użycia do generowania uzupełniania (np. "o3-mini"). | Nie. | |
| └parametry_próbkowania | OpenAI.CreateEvalResponsesRunDataSourceSamplingParams | Nie. | ||
| └— ź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. |
Nie. | |
| └* docelowy | Obiekt docelowy | Konfiguracja docelowa oceny. | Nie. | |
| └typ | ciąg | Dyskryminujący typ źródła danych. | Nie. | |
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | EvalRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — usuwanie przebiegu oceny
DELETE {endpoint}/openai/evals/{eval_id}/runs/{run_id}?api-version=2025-11-15-preview
Usuń przebieg oceny Usuń przebieg oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny, z której ma zostać usunięty przebieg. |
| run_id | ścieżka | Tak | ciąg | Identyfikator przebiegu do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DeleteEvalRunResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — uzyskiwanie przebiegu oceny
GET {endpoint}/openai/evals/{eval_id}/runs/{run_id}?api-version=2025-11-15-preview
Pobierz przebieg oceny Pobierz ocenę uruchamianą według identyfikatora.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny, dla której mają zostać pobrane przebiegi. |
| run_id | ścieżka | Tak | ciąg | Identyfikator przebiegu do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvalRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — anulowanie przebiegu oceny
POST {endpoint}/openai/evals/{eval_id}/runs/{run_id}?api-version=2025-11-15-preview
Anuluj przebieg oceny Anuluj trwający przebieg oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator ewaluacji, której wykonanie chcesz anulować. |
| run_id | ścieżka | Tak | ciąg | Identyfikator uruchomienia do anulowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvalRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — uzyskiwanie elementów wyjściowych przebiegu oceny
GET {endpoint}/openai/evals/{eval_id}/runs/{run_id}/output_items?api-version=2025-11-15-preview
Pobierz elementy wyjściowe przebiegu oceny Pobierz listę elementów wyjściowych dla przebiegu oceny.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | |
| run_id | ścieżka | Tak | ciąg | Identyfikator przebiegu w celu pobrania elementów wyjściowych. |
| after | kwerenda | Nie. | ciąg | Identyfikator ostatniego uruchomienia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Evals OpenAI — uzyskiwanie elementu wyjściowego przebiegu oceny
GET {endpoint}/openai/evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}?api-version=2025-11-15-preview
Pobierz element wyjściowy przebiegu oceny Pobierz element wyjściowy przebiegu oceny według identyfikatora.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| eval_id | ścieżka | Tak | ciąg | Identyfikator oceny, dla której mają zostać pobrane przebiegi. |
| run_id | ścieżka | Tak | ciąg | Identyfikator przebiegu do pobrania. |
| output_item_id | ścieżka | Tak | ciąg | Identyfikator elementu wyjściowego do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | EvalRunOutputItem |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Tworzenie zadania dostrajania
POST {endpoint}/openai/fine-tuning/jobs?api-version=2025-11-15-preview
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 i nazwę dostosowanych modeli po zakończeniu.
Dowiedz się więcej o dostrajaniu
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| hiperparametry | obiekt | Hiperparametry używane do zadania dostrajania. Ta wartość jest teraz przestarzała na rzecz parametru methodi powinna zostać przekazana w parametrze method . |
Nie. | |
| └batch_size | wyliczenie | Możliwe wartości: auto |
Nie. | |
| └learning_rate_multiplier | wyliczenie | Możliwe wartości: auto |
Nie. | |
| └n_epochs | wyliczenie | Możliwe wartości: auto |
Nie. | |
| Integracje | macierz | Lista integracji umożliwiających dostrajanie zadania. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| seed | liczba całkowita | Nasiono kontroluje reproduktywność procesu. Przekazywanie tych samych parametrów nasion i zadania powinno generować te same wyniki, ale mogą się różnić w rzadkich przypadkach. Jeśli ziarno nie zostanie określone, zostanie wygenerowane dla Ciebie. |
Nie. | |
| przyrostek | ciąg | Ciąg zawierający maksymalnie 64 znaki, które zostaną dodane do precyzyjnej nazwy modelu. Na przykład wartość suffix "custom-model-name" spowoduje wygenerowanie nazwy modelu, takiej jak ft:gpt-4o-mini:openai:custom-model-name:7p4lURel. |
Nie. | Żaden |
| plik szkoleniowy | ciąg | Identyfikator przekazanego pliku zawierającego dane szkoleniowe. Zestaw danych musi być sformatowany jako plik JSONL. Ponadto należy przekazać 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 . |
Tak | |
| plik walidacji | ciąg | Identyfikator przekazanego pliku zawierającego dane walidacji. Jeśli podasz ten plik, dane są używane do generowania walidacji metryki okresowo podczas dostrajania. Te metryki można wyświetlić w programie plik wyników dostrajania. Te same dane nie powinny być obecne zarówno w plikach trenowania, jak i sprawdzania poprawności. 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 | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy zadań dostrajania podzielonego na strony
GET {endpoint}/openai/fine-tuning/jobs?api-version=2025-11-15-preview
Wyświetlanie listy zadań dostrajania organizacji
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| after | kwerenda | Nie. | ciąg | Identyfikator ostatniego zadania z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba zadań dostrajania do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ListPaginatedFineTuningJobsResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Pobieranie zadania dostrajania
GET {endpoint}/openai/fine-tuning/jobs/{fine_tuning_job_id}?api-version=2025-11-15-preview
Uzyskaj informacje o zadaniu dostrajania.
Dowiedz się więcej o dostrajaniu
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator_zadania_dostrajania | ścieżka | Tak | ciąg | Identyfikator zadania dostrajania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Anulowanie zadania dostrajania
POST {endpoint}/openai/fine-tuning/jobs/{fine_tuning_job_id}/cancel?api-version=2025-11-15-preview
Natychmiast anuluj zadanie dostrajania.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator_zadania_dostrajania | ścieżka | Tak | ciąg | Identyfikator zadania dostrajania do anulowania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy punktów kontrolnych zadań dostrajania
GET {endpoint}/openai/fine-tuning/jobs/{fine_tuning_job_id}/checkpoints?api-version=2025-11-15-preview
Wyświetlanie listy punktów kontrolnych dla zadania dostrajania.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator_zadania_dostrajania | ścieżka | Tak | ciąg | Identyfikator zadania dostrajania w celu pobrania punktów kontrolnych. |
| after | kwerenda | Nie. | ciąg | Identyfikator ostatniego identyfikatora punktu kontrolnego z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba punktów kontrolnych do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ListFineTuningJobCheckpointsResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy zdarzeń zadania dostrajania
GET {endpoint}/openai/fine-tuning/jobs/{fine_tuning_job_id}/events?api-version=2025-11-15-preview
Uzyskaj szczegółowe aktualizacje stanu dla zadania dostrajania.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator_zadania_dostrajania | ścieżka | Tak | ciąg | Identyfikator zadania dostrajania w celu pobrania zdarzeń. |
| after | kwerenda | Nie. | ciąg | Identyfikator ostatniego zdarzenia z poprzedniego żądania stronicowania. |
| limit | kwerenda | Nie. | liczba całkowita | Liczba zdarzeń do pobrania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.ListFineTuningJobEventsResponse |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wstrzymaj zadanie dostrajania
POST {endpoint}/openai/fine-tuning/jobs/{fine_tuning_job_id}/pause?api-version=2025-11-15-preview
Wstrzymaj uruchomione zadanie dostrajania.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator_zadania_dostrajania | ścieżka | Tak | ciąg | Identyfikator zadania dostrajania do wstrzymania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wznawianie zadania dostrajania
POST {endpoint}/openai/fine-tuning/jobs/{fine_tuning_job_id}/resume?api-version=2025-11-15-preview
Wznów wstrzymane zadanie dostrajania.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator_zadania_dostrajania | ścieżka | Tak | ciąg | Identyfikator zadania dostrajania do wznowienia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.FineTuningJob |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Tworzenie odpowiedzi — tworzenie strumienia odpowiedzi
POST {endpoint}/openai/responses?api-version=2025-11-15-preview
Tworzy odpowiedź modelu. Tworzy odpowiedź modelu (odpowiedź strumieniowa).
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Nie. | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agent | AgentReference | Agent do użycia do generowania odpowiedzi. | Nie. | |
| tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| konwersacja | ciąg lub obiekt | Nie. | ||
| include | macierz | Określ dodatkowe dane wyjściowe do uwzględnienia w odpowiedzi modelu. Obecnie obsługiwane wartości to: - code_interpreter_call.outputs: zawiera dane wyjściowe wykonywania kodu w języku Pythonw elementy wywołania narzędzia interpretera kodu. - computer_call_output.output.image_url: dołącz adresy URL obrazów z wyników procesu komputerowego.- file_search_call.results: uwzględnij wyniki wyszukiwaniawywołanie narzędzia wyszukiwania plików. - message.input_image.image_url: dołącz adresy URL obrazów z komunikatu wejściowego.- message.output_text.logprobs: dołączanie logprobs z komunikatami asystenta.- reasoning.encrypted_content: zawiera zaszyfrowaną wersję rozumowaniatokeny w danych wyjściowych elementu rozumowania. Dzięki temu elementy rozumowania mogą być używane w programie konwersacje wieloetapowe przy bezstanowym korzystaniu z interfejsu API Odpowiedzi (na przykład gdy store parametr jest ustawiony na false lub gdy organizacja jestzapisane w programie nieprzechowywania żadnych danych). |
Nie. | |
| dane wejściowe | ciąg lub tablica | 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 - Zarządzanie stanem konwersacji - Wywoływanie funkcji |
Nie. | |
| instructions | ciąg | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| monit | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| reasoning | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| poziom usługi | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| przechowywać | typ logiczny (boolowski) | Czy zapisać wygenerowaną odpowiedź modelu do późniejszego pobrania? API. |
Nie. | Prawda |
| odtwarzać strumieniowo | typ logiczny (boolowski) | W przypadku ustawienia wartości true dane odpowiedzi modelu będą przesyłane strumieniowo do klienta generowane przy użyciu zdarzeń wysyłanych przez serwer. aby uzyskać więcej informacji. |
Nie. | Nieprawda |
| 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 | Liczba | 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 | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| tool_choice | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie plików. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. |
Nie. | |
| top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| top_p | Liczba | 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 |
| truncation | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. Możliwe wartości: auto, disabled |
Nie. | |
| użytkownik | ciąg | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.Response | |
| text/event-stream | OpenAI.ResponseStreamEvent |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy odpowiedzi
GET {endpoint}/openai/responses?api-version=2025-11-15-preview
Zwraca listę wszystkich odpowiedzi.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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ą. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Uzyskiwanie odpowiedzi — pobieranie strumienia odpowiedzi
GET {endpoint}/openai/responses/{response_id}?api-version=2025-11-15-preview
Pobiera odpowiedź modelu z danym identyfikatorem. Pobiera odpowiedź modelu z danym identyfikatorem (odpowiedź strumieniowa).
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Nie. | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| response_id | ścieżka | Tak | ciąg | |
| include[] | kwerenda | Nie. | macierz | |
| odtwarzać strumieniowo | kwerenda | Nie. | typ logiczny (boolowski) | |
| starting_after | kwerenda | Nie. | liczba całkowita | |
| akceptuj | nagłówek | Nie. | ciąg Możliwe wartości: text/event-stream |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.Response | |
| text/event-stream | OpenAI.ResponseStreamEvent |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Usuń odpowiedź
DELETE {endpoint}/openai/responses/{response_id}?api-version=2025-11-15-preview
Usuwa odpowiedź modelu.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| response_id | ścieżka | Tak | ciąg | Identyfikator odpowiedzi do usunięcia. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | DeleteResponseResult |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Anuluj odpowiedź
POST {endpoint}/openai/responses/{response_id}/cancel?api-version=2025-11-15-preview
Anuluje odpowiedź modelu.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| response_id | ścieżka | Tak | ciąg | Identyfikator odpowiedzi na anulowanie. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | OpenAI.Response |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Wyświetlanie listy elementów wejściowych
GET {endpoint}/openai/responses/{response_id}/input_items?api-version=2025-11-15-preview
Zwraca listę elementów wejściowych dla danej odpowiedzi.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| response_id | ścieżka | Tak | 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. |
| after | kwerenda | Nie. | ciąg | Kursor do użycia 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 użycia 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. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | obiekt | Dane odpowiedzi dla żądanej listy elementów. |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ApiErrorResponse |
Redteams - lista
GET {endpoint}/redTeams/runs?api-version=2025-11-15-preview
Wymień czerwoną drużynę według nazwy.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedRedTeam |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Redteams – zdobądź
GET {endpoint}/redTeams/runs/{name}?api-version=2025-11-15-preview
Zdobądź redteam według nazwy.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| nazwa | ścieżka | Tak | ciąg | Identyfikator biegu drużyny czerwonej. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | RedTeam |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Redteams — tworzenie
POST {endpoint}/redTeams/runs:run?api-version=2025-11-15-preview
Tworzy przebieg redteam.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| applicationScenario | ciąg | Scenariusz aplikacji dla operacji red team, w celu wygenerowania ataków specyficznych dla scenariusza. | Nie. | |
| attackStrategies | macierz | Lista strategii ataku lub zagnieżdżone listy strategii ataku. | Nie. | |
| displayName | ciąg | Nazwa biegu czerwonej drużyny. | Nie. | |
| identyfikator | ciąg | Identyfikator biegu drużyny czerwonej. | Tak | |
| liczbawywracania | liczba całkowita | Liczba rund symulacji. | Nie. | |
| properties | obiekt | Właściwości czerwonej drużyny. 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 | macierz | Lista kategorii ryzyka, dla których mają być generowane cele ataku. | Nie. | |
| symulacjaOnly | typ logiczny (boolowski) | Tylko symulacja lub Symulacja + ocena. Wartość domyślna false, jeśli true skanowanie generuje wynik konwersacji, a nie wynik oceny. | Nie. | Nieprawda |
| stan | ciąg | Status czerwonej drużyny. Jest on ustawiany przez usługę i jest tylko do odczytu. | Nie. | |
| tags | obiekt | Tagi czerwonej drużyny. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| miejsce docelowe | obiekt | Klasa abstrakcyjna dla konfiguracji docelowej. | Tak | |
| └typ | ciąg | Typ konfiguracji modelu. | Nie. |
Responses
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | RedTeam |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Harmonogramy — lista
GET {endpoint}/schedules?api-version=2025-11-15-preview
Wyświetl listę wszystkich harmonogramów.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedSchedule |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Harmonogramy — usuwanie
DELETE {endpoint}/schedules/{id}?api-version=2025-11-15-preview
Usuń harmonogram.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Identyfikator harmonogramu. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
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 | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Harmonogramy — pobierz
GET {endpoint}/schedules/{id}?api-version=2025-11-15-preview
Uzyskaj harmonogram według identyfikatora.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Identyfikator harmonogramu. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Harmonogram |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Harmonogramy — tworzenie lub aktualizowanie
PUT {endpoint}/schedules/{id}?api-version=2025-11-15-preview
Tworzenie lub aktualizowanie harmonogramu według identyfikatora.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Identyfikator harmonogramu. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Treść żądania
Typ zawartości: aplikacja/json
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis harmonogramu. | Nie. | |
| displayName | ciąg | Nazwa harmonogramu. | Nie. | |
| włączony | typ logiczny (boolowski) | Włączony stan harmonogramu. | Tak | |
| identyfikator | ciąg | Identyfikator harmonogramu. | Tak | |
| 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) | obiekt | Zaplanuj stan apryfikacji. | Nie. | |
| daneSystemowe | obiekt | Metadane systemowe zasobu. | Tak | |
| tags | obiekt | Tagi harmonogramu. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| zadanie | obiekt | Zaplanuj model zadań. | Tak | |
| Konfiguracja └* | obiekt | Konfiguracja dla zadania. | Nie. | |
| └typ | ScheduleTaskType | Typ zadania. | Nie. | |
| wyzwalacz | obiekt | Model podstawowy dla wyzwalacza harmonogramu. | Tak | |
| └typ | Typ wyzwalacza | Typ wyzwalacza. | Nie. |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Harmonogram |
Kod stanu: 201
Opis: Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Harmonogram |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Harmonogramy — uruchomienia listy
GET {endpoint}/schedules/{id}/runs?api-version=2025-11-15-preview
Wyświetl listę wszystkich przebiegów harmonogramu.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator | ścieżka | Tak | ciąg | Identyfikator harmonogramu. |
| x-ms-client-request-id | nagłówek | Nie. | Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | PagedScheduleRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Harmonogramy — pobieranie przebiegu
GET {endpoint}/schedules/{scheduleId}/runs/{runId}?api-version=2025-11-15-preview
Pobierz harmonogram uruchamiany przez identyfikator.
Parametry identyfikatora URI
| Name | In | Wymagane | Typ | Opis |
|---|---|---|---|---|
| punkt końcowy | ścieżka | Tak | ciąg Adres URL |
Punkt końcowy programu Foundry Project w postaci https://{ai-services-account-name}.services.ai.azure.com/api/projects/{project-name}. Jeśli masz tylko jeden projekt w usłudze Foundry Hub lub w celu kierowania domyślnego projektu w centrum, użyj formularza https://{ai-services-account-name}.services.ai.azure.com/api/projects/_project |
| wersja API | kwerenda | Tak | ciąg | Wersja interfejsu API do użycia dla tej operacji. |
| identyfikator harmonogramu | ścieżka | Tak | ciąg | Identyfikator harmonogramu. |
| identyfikator uruchomienia | ścieżka | Tak | ciąg | Identyfikator przebiegu harmonogramu. |
Nagłówek żądania
| Name | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | ciąg |
Przykład:Authorization: Bearer {Azure_AI_Foundry_Project_Auth_Token}Aby wygenerować token uwierzytelniania przy użyciu interfejsu wiersza polecenia platformy Azure: az account get-access-token --resource https://ai.azure.com/Typ: oauth2 Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorizezakres: https://ai.azure.com/.default |
Responses
Kod stanu: 200
Opis: Żądanie zakończyło się pomyślnie.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | ScheduleRun |
Kod stanu: wartość domyślna
Opis: Nieoczekiwana odpowiedź na błąd.
| Typ zawartości | Typ | Opis |
|---|---|---|
| aplikacja/json | Azure.Core.Foundations.ErrorResponse |
Components
A2ATool
Agent implementujący protokół A2A.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 projekcie 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.Możliwe wartości: a2a_preview |
Tak |
AISearchIndexResource
Zasób AI Search Index.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| filtr | ciąg | Filtruj ciąg 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 elemencie IndexResource dołączonym do tego agenta. | Nie. | |
| typ_zapytania | obiekt | Dostępne typy zapytań dla narzędzia Azure AI Search. | Nie. | |
| top_k | liczba całkowita | Liczba dokumentów do pobrania z wyszukiwania i prezentowania do modelu. | Nie. |
AgentClusterInsightResult
Szczegółowe informacje z analizy skupień agentów.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| clusterInsight | ClusterInsightResult | Wnioski z analizy skupień. | Tak | |
| typ | wyliczenie | Typ wyniku szczegółowych informacji. Możliwe wartości: AgentClusterInsight |
Tak |
AgentClusterInsightsRequest
Wgląd w zestaw wyników oceny agenta
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agentName | ciąg | Identyfikator agenta. | Tak | |
| modelKonfiguracja | obiekt | Konfiguracja modelu używanego w generowaniu wniosków. | Nie. | |
| └* modelDeploymentName | ciąg | Wdrożenie modelu, które ma zostać ocenione. Akceptuje nazwę wdrożenia samodzielnie lub z nazwą połączenia jako {connectionName}/<modelDeploymentName>. |
Nie. | |
| typ | wyliczenie | Typ żądania. Możliwe wartości: AgentClusterInsight |
Tak |
AgentContainerObject
Szczegóły kontenera określonej wersji agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | ciąg | Czas tworzenia kontenera. | Tak | |
| error_message | ciąg | Komunikat o błędzie, jeśli kontener nie może działać, jeśli istnieje. | 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 |
Tak | |
| stan | obiekt | Stan kontenera określonej wersji agenta. | Tak | |
| updated_at | ciąg | Czas ostatniej aktualizacji kontenera. | Tak |
AgentContainerOperationError
Szczegóły błędu operacji kontenera, jeśli istnieją.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Kod błędu operacji kontenera, jeśli istnieje. | Tak | |
| komunikat | ciąg | Komunikat o błędzie operacji kontenera, jeśli istnieje. | Tak | |
| typ | ciąg | Typ błędu operacji kontenera, jeśli istnieje. | Tak |
AgentContainerOperationObject
Operacja kontenera dla określonej wersji agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agent_id | ciąg | Identyfikator agenta. | Tak | |
| agent_version_id | ciąg | Identyfikator wersji agenta. | Tak | |
| kontener | obiekt | Szczegóły kontenera określonej wersji agenta. | Nie. | |
| └─ utworzono_o | ciąg | Czas tworzenia kontenera. | Nie. | |
| └error_message | ciąg | Komunikat o błędzie, jeśli kontener nie może działać, jeśli istnieje. | 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 |
Nie. | |
| Stan └* | AgentContainerStatus | Stan kontenera określonej wersji agenta. | Nie. | |
| └updated_at | ciąg | Czas ostatniej aktualizacji kontenera. | Nie. | |
| błąd | obiekt | Szczegóły błędu operacji kontenera, jeśli istnieją. | Nie. | |
| └─ kod | ciąg | Kod błędu operacji kontenera, jeśli istnieje. | Nie. | |
| └─ Komunikat | ciąg | Komunikat o błędzie operacji kontenera, jeśli istnieje. | Nie. | |
| └typ | ciąg | Typ błędu operacji kontenera, jeśli istnieje. | Nie. | |
| identyfikator | ciąg | Identyfikator operacji kontenera. Ten identyfikator jest unikatowym identyfikatorem w systemie. | Tak | |
| stan | obiekt | Stan operacji kontenera dla określonej wersji agenta. | Tak |
AgentContainerOperationStatus
Stan operacji kontenera dla określonej wersji agenta.
| Majątek | Wartość |
|---|---|
| Opis | Stan operacji kontenera dla określonej wersji agenta. |
| Typ | ciąg |
| Wartości | NotStartedInProgressSucceededFailed |
AgentContainerStatus
Stan kontenera określonej wersji agenta.
| Majątek | Wartość |
|---|---|
| Opis | Stan kontenera określonej wersji agenta. |
| Typ | 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:
| Wartość typu | Schema |
|---|---|
workflow |
WorkflowAgentDefinition |
hosted |
HostedAgentDefinition |
container_app |
ContainerAppAgentDefinition |
prompt |
PromptAgentDefinition |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rodzaj | AgentKind | Tak | ||
| rai_config | obiekt | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| └rai_policy_name | ciąg | Nazwa zasady RAI, która ma zostać zastosowana. | Nie. |
Identyfikator agenta
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa agenta. | Tak | |
| typ | wyliczenie | Możliwe wartości: agent_id |
Tak | |
| wersja | ciąg | Identyfikator wersji agenta. | Tak |
AgentKind
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | prompthostedcontainer_appworkflow |
AgentObject
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Niepowtarzalny identyfikator agenta. | Tak | |
| nazwa | ciąg | Nazwa agenta. | Tak | |
| obiekt | wyliczenie | Typ obiektu, którym zawsze jest "agent". Możliwe wartości: agent |
Tak | |
| versions | obiekt | Najnowsza wersja agenta. | Tak | |
| └* najnowsze | AgentVersionObject | Nie. |
AgentProtocol
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | activity_protocolresponses |
Odniesienie do agenta
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa agenta. | Tak | |
| typ | wyliczenie | Możliwe wartości: agent_reference |
Tak | |
| wersja | ciąg | Identyfikator wersji agenta. | Nie. |
AgentTaxonomyInput
Konfiguracja danych wejściowych dla taksonomii oceny, gdy typ danych wejściowych to agent.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| riskCategories | macierz | Lista kategorii ryzyka, w odniesieniu do których należy dokonać oceny. | Tak | |
| miejsce docelowe | obiekt | Reprezentuje element docelowy określający agenta sztucznej inteligencji platformy Azure. | Tak | |
| └─ nazwa | ciąg | Unikatowy identyfikator agenta sztucznej inteligencji platformy Azure. | Nie. | |
| └tool_descriptions | macierz | 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 |
Nie. | |
| └* wersja | ciąg | Wersja agenta sztucznej inteligencji platformy Azure. | Nie. | |
| typ | wyliczenie | Typ danych wejściowych taksonomii oceny. Możliwe wartości: agent |
Tak |
AgentTaxonomyInputUpdate
Konfiguracja danych wejściowych dla taksonomii oceny, gdy typ danych wejściowych to agent.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| riskCategories | macierz | Lista kategorii ryzyka, w odniesieniu do których należy dokonać oceny. | Nie. | |
| miejsce docelowe | obiekt | Reprezentuje element docelowy określający agenta sztucznej inteligencji platformy Azure. | Nie. | |
| └─ nazwa | ciąg | Unikatowy identyfikator agenta sztucznej inteligencji platformy Azure. | Nie. | |
| └tool_descriptions | macierz | 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 |
Nie. | |
| └* wersja | ciąg | Wersja agenta sztucznej inteligencji platformy Azure. | Nie. | |
| typ | wyliczenie | Typ danych wejściowych taksonomii oceny. Możliwe wartości: agent |
Nie. |
AgentVersionObject
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) w momencie utworzenia agenta. | Tak | |
| definicja | AgentDefinition | Tak | ||
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| identyfikator | ciąg | Unikatowy identyfikator wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| nazwa | ciąg | Nazwa agenta. Nazwa może służyć do pobierania/aktualizowania/usuwania agenta. | Tak | |
| obiekt | wyliczenie | Typ obiektu, którym zawsze jest "agent.version". Możliwe wartości: agent.version |
Tak | |
| wersja | ciąg | Identyfikator wersji agenta. Agenci są niezmienni, a każda aktualizacja tworzy nową wersję, zachowując tę samą nazwę. | Tak |
AgenticIdentityCredentials
Definicja poświadczeń tożsamości agenta
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: AgenticIdentityToken |
Tak |
ApiErrorResponse
Odpowiedź na błąd w przypadku awarii interfejsu API.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | OpenAI.Error | Tak |
ApiKeyCredentials
Definicja poświadczeń klucza interfejsu API
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| klucz | ciąg | Klucz interfejsu API | Nie. | |
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: ApiKey |
Tak |
AssetCredentialResponse
Reprezentuje odwołanie do obiektu blob do użycia
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| BlobReference | obiekt | Szczegóły odwołania do obiektu blob. | Tak | |
| └* 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 |
Nie. | |
| Poświadczenie └* | SasCredential | Informacje o poświadczeniach w celu uzyskania dostępu do konta magazynu. | Nie. | |
| └* storageAccountArmId | ciąg | Identyfikator usługi ARM konta magazynu do użycia. | Nie. |
Identyfikator zasobu
Identyfikator zapisanego zasobu.
Typ: ciąg
AttackStrategy
Strategie ataków.
| Majątek | Wartość |
|---|---|
| Opis | Strategie ataków. |
| Typ | ciąg |
| Wartości | easymoderatedifficultascii_artascii_smuggleratbashbase64binarycaesarcharacter_spacejailbreakansii_attackcharacter_swapsuffix_appendstring_joinunicode_confusableunicode_substitutiondiacriticflipleetspeakrot13morseurlbaselineindirect_jailbreaktensemulti_turncrescendo |
Azure.Core.Foundations.Error
Obiekt błędu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Tak | |
| details | macierz | Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu. | Nie. | |
| innererror | obiekt | Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu API REST platformy Azure — 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. | Tak | |
| miejsce docelowe | ciąg | Element docelowy błędu. | Nie. |
Azure.Core.Foundations.ErrorResponse
Odpowiedź zawierająca szczegóły błędu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | obiekt | Obiekt błędu. | Tak | |
| └─ kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Nie. | |
| └szczegóły | macierz | 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. | Nie. | |
| └* docelowy | ciąg | Element docelowy błędu. | Nie. |
Azure.Core.Foundations.InnerError
Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu API REST platformy Azure — https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Jeden z zdefiniowanych przez serwer zestaw kodów błędów. | Nie. | |
| innererror | obiekt | Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu API REST platformy Azure — 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.
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | NotStartedRunningSucceededFailedCanceled |
Azure.Core.uuid
Unikatowy identyfikator uniwersalny
Typ: ciąg
Format: uuid
AzureAIAgentTarget
Reprezentuje element docelowy określający agenta sztucznej inteligencji platformy Azure.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Unikatowy identyfikator agenta sztucznej inteligencji platformy Azure. | Tak | |
| tool_descriptions | macierz | 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 |
Tak | |
| wersja | ciąg | Wersja agenta sztucznej inteligencji platformy Azure. | Nie. |
AzureAIAgentTargetUpdate
Reprezentuje element docelowy określający agenta sztucznej inteligencji platformy Azure.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Unikatowy identyfikator agenta sztucznej inteligencji platformy Azure. | Nie. | |
| tool_descriptions | macierz | 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 |
Nie. | |
| wersja | ciąg | Wersja agenta sztucznej inteligencji platformy Azure. | Nie. |
AzureAIAssistantTarget
Reprezentuje element docelowy określający punkt końcowy asystenta sztucznej inteligencji platformy Azure (agenta w wersji 1), w tym jego identyfikator.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Unikatowy identyfikator asystenta sztucznej inteligencji platformy Azure. | Nie. | |
| tool_descriptions | macierz | Opisy narzędzi dostępnych dla asystenta. | Tak | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_assistant.Możliwe wartości: azure_ai_assistant |
Tak |
AzureAIAssistantTargetUpdate
Reprezentuje element docelowy określający punkt końcowy asystenta sztucznej inteligencji platformy Azure (agenta w wersji 1), w tym jego identyfikator.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Unikatowy identyfikator asystenta sztucznej inteligencji platformy Azure. | Nie. | |
| tool_descriptions | macierz | Opisy narzędzi dostępnych dla asystenta. | Nie. | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_assistant.Możliwe wartości: azure_ai_assistant |
Nie. |
AzureAIEvaluator
Definicja ewaluatora sztucznej inteligencji platformy Azure dla ewaluatorów znalezionych.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| mapowanie danych | obiekt | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Nie. | |
| evaluator_name | ciąg | Nazwa ewaluatora. | Tak | |
| evaluator_version | ciąg | Wersja ewaluatora. | Nie. | |
| initialization_parameters | obiekt | Parametry inicjowania oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: azure_ai_evaluator |
Tak |
AzureAIModelTarget
Reprezentuje cel określający model AI platformy Azure dla operacji wymagających wyboru modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| model | ciąg | Unikatowy identyfikator modelu AI platformy Azure. | Nie. | |
| parametry_próbowania | obiekt | Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu. | Nie. | |
| └max_completion_tokens | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Nie. | |
| └─ nasion | liczba całkowita | Losowe inicjatory do odtworzenia. | Nie. | |
| └* temperatura | Liczba | Parametr temperatury do próbkowania. | Nie. | |
| └─top_p | Liczba | Parametr top-p próbkowania jądra. | Nie. | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_model.Możliwe wartości: azure_ai_model |
Tak |
AzureAIModelTargetUpdate
Reprezentuje cel określający model AI platformy Azure dla operacji wymagających wyboru modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| model | ciąg | Unikatowy identyfikator modelu AI platformy Azure. | Nie. | |
| parametry_próbowania | obiekt | Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu. | Nie. | |
| └max_completion_tokens | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Nie. | |
| └─ nasion | liczba całkowita | Losowe inicjatory do odtworzenia. | Nie. | |
| └* temperatura | Liczba | Parametr temperatury do próbkowania. | Nie. | |
| └─top_p | Liczba | Parametr top-p próbkowania jądra. | Nie. | |
| typ | wyliczenie | Typ celu, zawsze azure_ai_model.Możliwe wartości: azure_ai_model |
Nie. |
AzureAIRedTeam
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_generation_params | obiekt | Reprezentuje parametry generowania elementów zespołu czerwonego. | Tak | |
| └attack_strategies | macierz | Kolekcja strategii ataków, które mają być używane. | Nie. | |
| └num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Nie. | |
| └typ | wyliczenie | Typ parametrów generowania elementów, zawsze red_team.Możliwe wartości: red_team |
Nie. | |
| miejsce docelowe | obiekt | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Tak | |
| └typ | ciąg | Typ obiektu docelowego. | Nie. | |
| typ | wyliczenie | Typ źródła danych. Zawsze azure_ai_red_team.Możliwe wartości: azure_ai_red_team |
Tak |
AzureAIResponses
Reprezentuje źródło danych dla przebiegów oceny, które są specyficzne dla scenariuszy ciągłej oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| event_configuration_id | ciąg | Nazwa konfiguracji zdarzenia skojarzona z tym przebiegiem oceny. | Tak | |
| item_generation_params | obiekt | Reprezentuje parametry generowania elementu ciągłej oceny. | Tak | |
| └data_mapping | obiekt | Mapowanie z pól źródłowych na pole response_id wymagane do pobierania historii czatu. | Nie. | |
| └max_num_turns | liczba całkowita | Maksymalna liczba zakrętów historii czatów do oceny. | Nie. | |
| └— źródło | OpenAI.EvalJsonlFileContentSource lub OpenAI.EvalJsonlFileIdSource | Źródło, z którego jest odczytywana zawartość JSONL. | Nie. | |
| └typ | wyliczenie | Typ parametrów generowania elementów, zawsze ResponseRetrieval.Możliwe wartości: response_retrieval |
Nie. | |
| max_runs_hourly | liczba całkowita | Maksymalna dozwolona liczba przebiegów oceny na godzinę. | Tak | |
| typ | wyliczenie | Typ źródła danych, zawsze AzureAIResponses.Możliwe wartości: azure_ai_responses |
Tak |
AzureAISearchAgentTool
Informacje o definicji danych wejściowych narzędzia wyszukiwania sztucznej inteligencji platformy Azure używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| azure_ai_search | obiekt | Zestaw zasobów indeksu używanych przez narzędzie azure_ai_search. |
Tak | |
| Indeksy └* | macierz | Indeksy dołączone do tego agenta. Może istnieć maksymalnie 1 indeks zasób dołączony do agenta. |
Nie. | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'azure_ai_search'. Możliwe wartości: azure_ai_search |
Tak |
Indeks wyszukiwania Azure AI
Definicja indeksu wyszukiwania w usłudze Azure AI
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Rodzaj indeksu Możliwe wartości: AzureSearch |
Tak |
AzureAISearchIndexUpdate
Definicja indeksu wyszukiwania w usłudze Azure AI
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Rodzaj indeksu Możliwe wartości: AzureSearch |
Tak |
AzureAISearchQueryType
Dostępne typy zapytań dla narzędzia Azure AI Search.
| Majątek | Wartość |
|---|---|
| Opis | Dostępne typy zapytań dla narzędzia Azure AI Search. |
| Typ | ciąg |
| Wartości | simplesemanticvectorvector_simple_hybridvector_semantic_hybrid |
AzureAISearchToolResource
Zestaw zasobów indeksu używanych przez narzędzie azure_ai_search.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Indeksy | macierz | Indeksy dołączone do tego agenta. Może istnieć maksymalnie 1 indeks zasób dołączony do agenta. |
Tak |
AzureAISource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| scenariusz | wyliczenie | Scenariusz schematu danych. Możliwe wartości: red_team, , responsestraces |
Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: azure_ai_source |
Tak |
AzureFunctionAgentTool
Informacje o definicji danych wejściowych dla narzędzia funkcji platformy Azure używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| azure_function | obiekt | Definicja funkcji platformy Azure. | Tak | |
| └* , funkcja | obiekt | Definicja funkcji platformy Azure i jej parametrów. | 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. | Nie. | |
| Parametry | Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. | Nie. | ||
| └input_binding | AzureFunctionBinding | Kolejka magazynu wejściowego. Wyzwalacz magazynu kolejek uruchamia funkcję w miarę dodawania do niej komunikatów. | Nie. | |
| └output_binding | AzureFunctionBinding | Kolejka magazynu wyjściowego. Funkcja zapisuje dane wyjściowe w tej kolejce po przetworzeniu elementów wejściowych. | Nie. | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest "browser_automation". Możliwe wartości: azure_function |
Tak |
AzureFunctionBinding
Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| storage_queue | obiekt | Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI. | Tak | |
| └queue_name | ciąg | Nazwa kolejki usługi Azure Function Storage. | Nie. | |
| └queue_service_endpoint | ciąg | Identyfikator URI usługi Azure Storage Queue Service umożliwiający manipulowanie kolejką. | Nie. | |
| typ | wyliczenie | Typ powiązania, który jest zawsze "storage_queue". Możliwe wartości: storage_queue |
Tak |
AzureFunctionDefinition
Definicja funkcji platformy Azure.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| funkcja | obiekt | Definicja funkcji platformy Azure i jej parametrów. | Tak | |
| 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. | Nie. | |
| Parametry | Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON. | Nie. | ||
| input_binding | obiekt | Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI. | Tak | |
| └storage_queue | AzureFunctionStorageQueue | Kolejka magazynu. | Nie. | |
| └typ | wyliczenie | Typ powiązania, który jest zawsze "storage_queue". Możliwe wartości: storage_queue |
Nie. | |
| output_binding | obiekt | Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI. | Tak | |
| └storage_queue | AzureFunctionStorageQueue | Kolejka magazynu. | Nie. | |
| └typ | wyliczenie | Typ powiązania, który jest zawsze "storage_queue". Możliwe wartości: storage_queue |
Nie. |
AzureFunctionStorageQueue
Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| queue_name | ciąg | Nazwa kolejki usługi Azure Function Storage. | Tak | |
| queue_service_endpoint | ciąg | Identyfikator URI usługi Azure Storage Queue Service umożliwiający manipulowanie kolejką. | Tak |
AzureOpenAIModelConfiguration
Konfiguracja modelu usługi Azure OpenAI. Wersja interfejsu API zostanie wybrana przez usługę do wykonywania zapytań dotyczących modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| modelDeploymentName | ciąg | Nazwa wdrożenia dla modelu AOAI. Przykład: gpt-4o, jeśli w AISservicess lub oparty na connection_name/deployment_name połączeniu (np. my-aoai-connection/gpt-4o). |
Tak | |
| typ | wyliczenie | Możliwe wartości: AzureOpenAIModel |
Tak |
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:
| Wartość typu | Schema |
|---|---|
ApiKey |
ApiKeyCredentials |
AAD |
EntraIDCredentials |
CustomKeys |
CustomCredential |
SAS |
Sygnatury dostępu współdzielonego |
None |
NoAuthenticationCredentials |
AgenticIdentityToken |
AgenticIdentityCredentials |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Typ poświadczeń używany przez połączenie | Tak |
BingCustomSearchAgentTool
Informacje o definicji danych wejściowych dla niestandardowego narzędzia wyszukiwania Bing używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| bing_custom_search_preview | obiekt | Parametry narzędzia wyszukiwania niestandardowego Bing. | Tak | |
| └search_configurations | macierz | Połączenia projektu dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Nie. | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'bing_custom_search'. Możliwe wartości: bing_custom_search_preview |
Tak |
BingCustomSearchConfiguration
Konfiguracja wyszukiwania niestandardowego Bing.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| count | liczba całkowita | Liczba wyników wyszukiwania do zwrócenia 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. | Tak | |
| rynek | ciąg | Rynek, z którego pochodzą wyniki. | Nie. | |
| project_connection_id | ciąg | Identyfikator połączenia projektu dla uziemienia za pomocą wyszukiwania Bing | Tak | |
| set_lang | ciąg | Język, który ma być używany dla ciągów interfejsu użytkownika podczas wywoływania interfejsu API Bing. | Nie. |
BingCustomSearchToolParameters
Parametry narzędzia wyszukiwania niestandardowego Bing.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| search_configurations | macierz | Połączenia projektu dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Tak |
BingGroundingAgentTool
Informacje o definicji danych wejściowych narzędzia wyszukiwania uziemieniowego bing używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| bing_grounding | obiekt | Parametry narzędzia wyszukiwania uziemienia Bing. | Tak | |
| └search_configurations | macierz | Konfiguracje wyszukiwania dołączone do tego narzędzia. Może istnieć maksymalnie 1 zasób konfiguracji wyszukiwania dołączony do narzędzia. |
Nie. | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'bing_grounding'. Możliwe wartości: bing_grounding |
Tak |
BingGroundingSearchConfiguration
Wyszukaj konfigurację dla Bing Grounding
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| count | liczba całkowita | Liczba wyników wyszukiwania do zwrócenia w odpowiedzi interfejsu API Bing | Nie. | |
| freshness | ciąg | Filtruj wyniki wyszukiwania według określonego zakresu czasu. Zobacz akceptowane wartości tutaj. | Nie. | |
| rynek | ciąg | Rynek, z którego pochodzą wyniki. | Nie. | |
| project_connection_id | ciąg | Identyfikator połączenia projektu dla uziemienia za pomocą wyszukiwania Bing | Tak | |
| set_lang | ciąg | Język, który ma być używany dla ciągów interfejsu użytkownika podczas wywoływania interfejsu API Bing. | Nie. |
BingGroundingSearchToolParameters
Parametry narzędzia wyszukiwania uziemienia Bing.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| search_configurations | macierz | Konfiguracje wyszukiwania dołączone do tego narzędzia. Może istnieć maksymalnie 1 zasób konfiguracji wyszukiwania dołączony do narzędzia. |
Tak |
BlobReference
Szczegóły odwołania do obiektu blob.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 |
Tak | |
| poświadczenie | obiekt | Definicja poświadczeń sygnatury dostępu współdzielonego | Tak | |
| └* sasUri | ciąg | Identyfikator URI sygnatury dostępu współdzielonego | Nie. | |
| └typ | wyliczenie | Rodzaj poświadczenia Możliwe wartości: SAS |
Nie. | |
| storageAccountArmId | ciąg | Identyfikator usługi ARM konta magazynu do użycia. | Tak |
BrowserAutomationAgentTool
Informacje o definicji danych wejściowych dla narzędzia Browser Automation Tool, które służy do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| browser_automation_preview | obiekt | Definicja parametrów wejściowych dla narzędzia Browser Automation Tool. | Tak | |
| Połączenie └* | BrowserAutomationToolConnectionParameters | Parametry połączenia projektu skojarzone z narzędziem Browser Automation Tool. | Nie. | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest "browser_automation". Możliwe wartości: browser_automation_preview |
Tak |
BrowserAutomationToolConnectionParameters
Definicja parametrów wejściowych dla połączenia używanego przez narzędzie Browser Automation Tool.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| project_connection_id | ciąg | Identyfikator połączenia projektu z zasobem usługi Azure Playwright. | Tak |
BrowserAutomationToolParameters
Definicja parametrów wejściowych dla narzędzia Browser Automation Tool.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| połączenie | obiekt | Definicja parametrów wejściowych dla połączenia używanego przez narzędzie Browser Automation Tool. | Tak | |
| └project_connection_id | ciąg | Identyfikator połączenia projektu z zasobem usługi Azure Playwright. | Nie. |
CaptureStructuredOutputsTool
Narzędzie do przechwytywania ustrukturyzowanych danych wyjściowych
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Wyniki | obiekt | Ustrukturyzowane dane wyjściowe, które mogą być generowane przez agenta. | Tak | |
| Opis └* | ciąg | Opis danych wyjściowych, które mają zostać wyemitowane. Używany przez model do określania, kiedy należy wyemitować dane wyjściowe. | Nie. | |
| └─ nazwa | ciąg | Nazwa ustrukturyzowanych danych wyjściowych. | Nie. | |
| Schemat └* | Schemat JSON dla ustrukturyzowanych danych wyjściowych. | Nie. | ||
| └* ścisłe | typ logiczny (boolowski) | Określa, czy wymuszać ścisłą walidację. Wartość domyślna true. |
Nie. | |
| typ | wyliczenie | Typ narzędzia. Zawsze capture_structured_outputs.Możliwe wartości: capture_structured_outputs |
Tak |
Wykres współrzędny
Współrzędne wykresu analizy.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rozmiar | liczba całkowita | Rozmiar elementu wykresu. | Tak | |
| x | liczba całkowita | Współrzędna osi X. | Tak | |
| y | liczba całkowita | Współrzędna osi Y. | Tak |
ChatSummaryMemoryItem
Element pamięci zawierający podsumowanie wyodrębnione z konwersacji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rodzaj | wyliczenie | Rodzaj elementu pamięci. Możliwe wartości: chat_summary |
Tak |
ClusterInsightResult
Wnioski z analizy skupień.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| clusters | macierz | Lista klastrów zidentyfikowanych w szczegółowych informacjach. | Tak | |
| współrzędne | obiekt | Opcjonalne mapowanie identyfikatorów na współrzędne 2D używane przez środowisko 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 | obiekt | Podsumowanie analizy skupień błędów. | Tak | |
| └* metoda | ciąg | Metoda stosowana do grupowania. | Nie. | |
| └* sampleCount | liczba całkowita | Łączna liczba przeanalizowanych próbek. | Nie. | |
| └* uniqueClusterCount | liczba całkowita | Łączna liczba unikatowych klastrów. | Nie. | |
| └(*) uniqueSubclusterCount | liczba całkowita | Łączna liczba unikatowych etykiet podklastrów. | Nie. | |
| └─ użycie | ClusterTokenUsage | Użycie tokenów podczas wykonywania analizy klastrowania | Nie. |
ClusterTokenUsage
Użycie tokenu do analizy skupień
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| inputTokenUsage | liczba całkowita | Użycie tokenu wejściowego | Tak | |
| outputTokenUsage | liczba całkowita | Użycie tokenu wyjściowego | Tak | |
| totalTokenUsage | liczba całkowita | Całkowite użycie tokenów | Tak |
CodeBasedEvaluatorDefinition
Definicja ewaluatora opartego na kodzie przy użyciu kodu w języku Python
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| code_text | ciąg | Tekst kodu wbudowanego dla osoby oceniającej | Tak | |
| typ | wyliczenie | Możliwe wartości: code |
Tak |
Połączenie
Operacje odpowiedzi z listy i pobierania połączeń
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane logowania | obiekt | Klasa bazowa dla poświadczeń połączenia | Tak | |
| └typ | Typ poświadczeń | Typ poświadczenia używanego przez połączenie | Nie. | |
| identyfikator | ciąg | Unikatowy identyfikator połączenia generowany przez usługę | Tak | |
| isDefault | typ logiczny (boolowski) | Czy połączenie jest oznaczone jako połączenie domyślne danego typu | Tak | |
| metadane | obiekt | Metadane połączenia | Tak | |
| nazwa | ciąg | Przyjazna nazwa połączenia podana przez użytkownika. | Tak | |
| miejsce docelowe | ciąg | Adres URL połączenia, który ma być używany dla tej usługi | Tak | |
| typ | obiekt | Typ (lub kategoria) połączenia | Tak |
Typ Połączenia
Typ (lub kategoria) połączenia
| Majątek | Wartość |
|---|---|
| Opis | Typ (lub kategoria) połączenia |
| Typ | ciąg |
| Wartości | AzureOpenAIAzureBlobAzureStorageAccountCognitiveSearchCosmosDBApiKeyAppConfigAppInsightsCustomKeysRemoteTool |
ContainerAppAgentDefinition
Definicja agenta aplikacji kontenera.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| container_app_resource_id | ciąg | Identyfikator zasobu aplikacji kontenera platformy Azure, która hostuje tego agenta. Nie można modyfikować między wersjami. | Tak | |
| container_protocol_versions | macierz | Protokoły obsługiwane przez agenta na potrzeby komunikacji przychodzącej kontenerów. | Tak | |
| ingress_subdomain_suffix | ciąg | Sufiks, który ma być stosowany do poddomeny aplikacji podczas wysyłania ruchu przychodzącego do agenta. Może to być etykieta (np. "---bieżąca"), określona poprawka (np. "--0000001") lub pusta, aby użyć domyślnego punktu końcowego dla aplikacji kontenera. | Tak | |
| rodzaj | wyliczenie | Możliwe wartości: container_app |
Tak |
ContinuousEvalItemGenerationParams
Reprezentuje parametry generowania elementu ciągłej oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| mapowanie danych | obiekt | Mapowanie z pól źródłowych na pole response_id wymagane do pobierania historii czatu. | Tak | |
| max_num_turns | liczba całkowita | Maksymalna liczba zakrętów historii czatów do oceny. | Tak | |
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Nie. | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze ResponseRetrieval.Możliwe wartości: response_retrieval |
Tak |
ContinuousEvaluationRuleAction
Akcja reguły oceny dla ciągłej oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| evalId | ciąg | Identyfikator ewaluacji, do którego mają zostać dodane ciągłe przebiegi oceny. | Tak | |
| maxHourlyRuns | liczba całkowita | Maksymalna dozwolona liczba przebiegów oceny na godzinę. | Nie. | |
| typ | wyliczenie | Możliwe wartości: continuousEvaluation |
Tak |
Indeks CosmosDB
Definicja indeksu magazynu wektorów usługi CosmosDB
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Rodzaj indeksu Możliwe wartości: CosmosDBNoSqlVectorStore |
Tak |
CosmosDBIndexUpdate
Definicja indeksu magazynu wektorów usługi CosmosDB
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Rodzaj indeksu Możliwe wartości: CosmosDBNoSqlVectorStore |
Tak |
CreateAgentFromManifestRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| parameter_values | obiekt | Dane wejściowe manifestu, które spowodują w pełni zmaterializowany agent. | Tak |
CreateAgentRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Tak | ||
| Rodzaj └* | AgentKind | Nie. | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak |
CreateAgentVersionFromManifestRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. | Tak |
CreateAgentVersionRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Tak | ||
| Rodzaj └* | AgentKind | Nie. | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| konfiguracja źródła danych | obiekt | 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 |
Tak | |
| └ dołącz_przykładowy_schemat | typ logiczny (boolowski) | 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. | Nie. | |
| Metadane └* | obiekt | Filtry metadanych dla przechowywanego źródła danych uzupełniania. | Nie. | |
| Scenariusz └* | wyliczenie | Scenariusz schematu danych. Możliwe wartości: red_team, , responsestraces |
Nie. | |
| └typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: azure_ai_source |
Nie. | |
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | macierz | 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}}). |
Tak |
CreateEvalRunRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| źródło danych | obiekt | Obiekt JsonlRunDataSource, który określa plik JSONL odpowiadający ewaluacji. | Tak | |
| └input_messages | 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. | |
| └item_generation_params | RedTeamItemGenerationParams | Parametry generowania elementów. | Nie. | |
| Model └* | ciąg | Nazwa modelu do użycia do generowania uzupełniania (np. "o3-mini"). | Nie. | |
| └parametry_próbkowania | OpenAI.CreateEvalResponsesRunDataSourceSamplingParams | Nie. | ||
| └— ź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. |
Nie. | |
| └* docelowy | Obiekt docelowy | Konfiguracja docelowa oceny. | Nie. | |
| └typ | ciąg | Dyskryminujący typ źródła danych. | Nie. | |
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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. |
Utworzone przez
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agent | obiekt | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. | Nie. | |
| └typ | wyliczenie | Możliwe wartości: agent_id |
Nie. | |
| └* wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. |
Typ poświadczeń
Typ poświadczeń używany przez połączenie
| Majątek | Wartość |
|---|---|
| Opis | Typ poświadczeń używany przez połączenie |
| Typ | ciąg |
| Wartości | ApiKeyAADSASCustomKeysNoneAgenticIdentityToken |
CronTrigger
Wyzwalacz oparty na Cronie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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. | Tak | |
| startTime | ciąg | Godzina rozpoczęcia harmonogramu cron w formacie ISO 8601. | Nie. | |
| strefa czasowa | ciąg | Strefa czasowa dla harmonogramu cron. | Nie. | UTC |
| typ | wyliczenie | Możliwe wartości: Cron |
Tak |
CustomCredential
Niestandardowa definicja poświadczeń
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: CustomKeys |
Tak |
DailyRecurrenceSchedule
Harmonogram codziennych cykli.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Godzin | macierz | Godziny dla harmonogramu cyklu. | Tak | |
| typ | wyliczenie | Typ nawrotu dziennego. Możliwe wartości: Daily |
Tak |
Typ zestawu danych
Wyliczenie w celu określenia typu danych.
| Majątek | Wartość |
|---|---|
| Opis | Wyliczenie w celu określenia typu danych. |
| Typ | 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:
| Wartość typu | Schema |
|---|---|
uri_file |
FileDatasetVersion |
uri_folder |
FolderDatasetVersion |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| connectionName (nazwa_połączenia) | ciąg | Nazwa połączenia konta usługi Azure Storage. Wymagane, jeśli startPendingUploadVersion nie została wywołana przed utworzeniem zestawu danych | Nie. | |
| dataUri | ciąg | Identyfikator URI danych (przykład) | Tak | |
| identyfikator | ciąg | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| isReference | typ logiczny (boolowski) | Wskazuje, czy zestaw danych zawiera odwołanie do magazynu, czy też zestaw danych sam zarządza magazynem. Jeśli to prawda, dane źródłowe nie zostaną usunięte po usunięciu wersji zestawu danych | Nie. | |
| nazwa | ciąg | Nazwa zasobu | Tak | |
| typ | obiekt | Wyliczenie w celu określenia typu danych. | Tak | |
| wersja | ciąg | Wersja zasobu | Tak |
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:
| Wartość typu | Schema |
|---|---|
uri_file |
FileDatasetVersionUpdate |
uri_folder |
FolderDatasetVersionUpdate |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | obiekt | Wyliczenie w celu określenia typu danych. | Tak |
DzieńTygodnia
Dni tygodnia dla harmonogramu cyklu.
| Majątek | Wartość |
|---|---|
| Opis | Dni tygodnia dla harmonogramu cyklu. |
| Typ | ciąg |
| Wartości | SundayMondayTuesdayWednesdayThursdayFridaySaturday |
DeleteAgentResponse
Usunięty obiekt agenta
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | Określa, czy agent został pomyślnie usunięty. | Tak | |
| nazwa | ciąg | Nazwa agenta. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "agent.deleted". Możliwe wartości: agent.deleted |
Tak |
DeleteAgentVersionResponse
Usunięta wersja agenta Object
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | Określa, czy agent został pomyślnie usunięty. | Tak | |
| nazwa | ciąg | Nazwa agenta. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "agent.deleted". Możliwe wartości: agent.version.deleted |
Tak | |
| wersja | ciąg | Identyfikator wersji agenta. | Tak |
DeleteEvalResponse
Usunięty obiekt oceny
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | Czy eval został pomyślnie usunięty. | Tak | |
| eval_id | ciąg | identyfikator ewalu. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.deleted". Możliwe wartości: eval.deleted |
Tak |
DeleteEvalRunResponse
Usunięty obiekt przebiegu oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | Określa, czy magazyn pamięci został pomyślnie usunięty. | Tak | |
| nazwa | ciąg | Nazwa magazynu pamięci. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "memory_store.usunięte". Możliwe wartości: memory_store.deleted |
Tak |
DeleteResponseResult
Wynik operacji usuwania odpowiedzi.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | wyliczenie | Zawsze zwracaj wartość true Możliwe wartości: True |
Tak | |
| identyfikator | ciąg | Identyfikator operacji. | Tak | |
| obiekt | wyliczenie | Zawsze zwracaj wartość "response". Możliwe wartości: response |
Tak |
Wdrożenie
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:
| Wartość typu | Schema |
|---|---|
ModelDeployment |
ModelDeployment |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa wdrożenia | Tak | |
| typ | obiekt | Tak |
Deploymenttype
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | ModelDeployment |
EntraIDCredentials
Definicja poświadczeń identyfikatora Entra
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: AAD |
Tak |
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ć:
- 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | obiekt | Tak | ||
| utworzone_przez | ciąg | imię i nazwisko osoby, która utworzyła przebieg. | Nie. | |
| konfiguracja źródła danych | obiekt | 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 |
Tak | |
| └ dołącz_przykładowy_schemat | typ logiczny (boolowski) | 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. | Nie. | |
| Metadane └* | obiekt | Filtry metadanych dla przechowywanego źródła danych uzupełniania. | Nie. | |
| Scenariusz └* | wyliczenie | Scenariusz schematu danych. Możliwe wartości: red_team, , responsestraces |
Nie. | |
| └typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: azure_ai_source |
Nie. | |
| identyfikator | ciąg | Unikatowy identyfikator oceny. | Tak | |
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| modified_at | obiekt | Nie. | ||
| nazwa | ciąg | Nazwa oceny. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Możliwe wartości: eval |
Tak | |
| 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 | macierz | Lista kryteriów testowania. | Tak |
EvalCompareReport
Wnioski z porównania ewaluacji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Porównania | macierz | Wyniki porównania dla każdego leczenia są sprzeczne z wartością wyjściową. | Tak | |
| metoda | ciąg | Metoda statystyczna zastosowana do porównania. | Tak | |
| typ | wyliczenie | Typ wyniku szczegółowych informacji. Możliwe wartości: EvaluationComparison |
Tak |
EvalResult
Wynik oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa czeku | Tak | |
| Przekazywane | typ logiczny (boolowski) | Wskazuje, czy test zakończył się powodzeniem, czy niepowodzeniem | Tak | |
| wynik | Liczba | wynik | Tak | |
| typ | ciąg | Rodzaj kontroli | Tak |
EvalRun
Schemat reprezentujący przebieg oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | obiekt | Tak | ||
| utworzone_przez | ciąg | imię i nazwisko osoby, która utworzyła przebieg. | Nie. | |
| źródło danych | obiekt | Obiekt JsonlRunDataSource, który określa plik JSONL odpowiadający ewaluacji. | Tak | |
| └input_messages | 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. | |
| └item_generation_params | RedTeamItemGenerationParams | Parametry generowania elementów. | Nie. | |
| Model └* | ciąg | Nazwa modelu do użycia do generowania uzupełniania (np. "o3-mini"). | Nie. | |
| └parametry_próbkowania | OpenAI.CreateEvalResponsesRunDataSourceSamplingParams | Nie. | ||
| └— ź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. |
Nie. | |
| └* docelowy | Obiekt docelowy | Konfiguracja docelowa oceny. | Nie. | |
| └typ | ciąg | Dyskryminujący typ źródła danych. | Nie. | |
| błąd | OpenAI.EvalApiError | Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval. | Tak | |
| eval_id | ciąg | Identyfikator skojarzonej oceny. | Tak | |
| identyfikator | ciąg | Unikatowy identyfikator przebiegu oceny. | Tak | |
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| model | ciąg | Model, który jest oceniany, jeśli ma zastosowanie. | Tak | |
| modified_at | obiekt | Nie. | ||
| nazwa | ciąg | Nazwa przebiegu oceny. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.run". Możliwe wartości: eval.run |
Tak | |
| użycie na model | macierz | Statystyki użycia dla każdego modelu podczas przebiegu oceny. | Tak | |
| wyniki_wg_kryteriów_testowych | macierz | Wyniki na kryteria testowania stosowane podczas przebiegu oceny. | Tak | |
| 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. | Tak | |
| wyniki_liczby | obiekt | Tak | ||
| └─ Wystąpił błąd | OpenAI.integer | Nie. | ||
| └* nie powiodło się | OpenAI.integer | Nie. | ||
| └* zaliczone | OpenAI.integer | Nie. | ||
| └─ suma | OpenAI.integer | Nie. | ||
| stan | ciąg | Stan przebiegu oceny. | Tak |
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:
| Wartość typu | Schema |
|---|---|
azure_ai_traces |
TracesEvalRunDataSource |
azure_ai_responses |
AzureAIResponses |
azure_ai_target_completions |
TargetCompletions |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg | Dyskryminujący typ źródła danych. | Tak |
EvalRunOutputItem
Schemat reprezentujący element wyjściowy przebiegu oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | obiekt | Tak | ||
| element źródła danych | obiekt | Szczegóły elementu wejściowego źródła danych. | Tak | |
| "identyfikator_elementu_źródła_danych (datasource_item_id)" | obiekt | Tak | ||
| eval_id | ciąg | Identyfikator grupy ewaluacyjnej. | Tak | |
| identyfikator | ciąg | Unikatowy identyfikator elementu wyjściowego procesu oceny. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "eval.run.output_item". Możliwe wartości: eval.run.output_item |
Tak | |
| results | macierz | Lista wyników klasyzatora dla tego elementu wyjściowego. | Tak | |
| run_id | ciąg | Identyfikator przebiegu oceny skojarzonego z tym elementem wyjściowym. | Tak | |
| próbka | obiekt | Tak | ||
| └─ błąd | OpenAI.EvalApiError | Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval. | Nie. | |
| └ finish_reason | ciąg | Nie. | ||
| └─ Wejście | macierz | Nie. | ||
| └max_completion_tokens | OpenAI.integer | Nie. | ||
| Model └* | ciąg | Nie. | ||
| └─ Dane wyjściowe | macierz | Nie. | ||
| └─ nasion | OpenAI.integer | Nie. | ||
| └* temperatura | OpenAI.numeric | Nie. | ||
| └─top_p | OpenAI.numeric | Nie. | ||
| └─ użycie | OpenAI.EvalRunOutputItemSampleUsage | Nie. | ||
| stan | ciąg | Stan przebiegu oceny. | Tak |
EvalRunOutputItemResult
Pojedynczy wynik klasykatora dla elementu wyjściowego przebiegu oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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. | Tak | |
| Przekazywane | typ logiczny (boolowski) | Czy klasyk uznał dane wyjściowe za przekazywanie. | Tak | |
| properties | obiekt | Dodatkowe szczegóły dotyczące metryki kryteriów testu. | Nie. | |
| powód | ciąg | Przyczyna metryki kryteriów testu. | Nie. | |
| próbka | obiekt | Opcjonalne próbki lub dane pośrednie generowane przez klasykator. | Nie. | |
| wynik | obiekt | Tak | ||
| próg | Liczba | 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. |
EvalRunResultCompareItem
Porównanie wskaźników leczenia w stosunku do wartości wyjściowej.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| deltaEstimate | Liczba | Szacowana różnica między leczeniem a wartością wyjściową. | Tak | |
| pValue | Liczba | Wartość P dla efektu leczenia. | Tak | |
| leczenieEffect | obiekt | Rodzaj efektu zabiegu. | Tak | |
| leczenieRunId | ciąg | Przebieg leczenia ID. | Tak | |
| leczenieRunSummary | obiekt | Statystyki podsumowujące metrykę w przebiegu oceny. | Tak | |
| └* średnia | Liczba | Średnia wartość metryki w przebiegu oceny. | Nie. | |
| └* runId | ciąg | Identyfikator przebiegu oceny. | Nie. | |
| └* sampleCount | liczba całkowita | Liczba próbek w przebiegu oceny. | Nie. | |
| └* standardowaDeviation | Liczba | Odchylenie standardowe metryki w przebiegu oceny. | Nie. |
EvalRunResultComparison
Wyniki porównania dla leczenia są sprzeczne z wartością wyjściową.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| baselineRunSummary | obiekt | Statystyki podsumowujące metrykę w przebiegu oceny. | Tak | |
| └* średnia | Liczba | Średnia wartość metryki w przebiegu oceny. | Nie. | |
| └* runId | ciąg | Identyfikator przebiegu oceny. | Nie. | |
| └* sampleCount | liczba całkowita | Liczba próbek w przebiegu oceny. | Nie. | |
| └* standardowaDeviation | Liczba | Odchylenie standardowe metryki w przebiegu oceny. | Nie. | |
| compareItems | macierz | Lista wyników porównawczych dla każdego cyklu leczenia. | Tak | |
| ewaluator | ciąg | Imię i nazwisko osoby oceniającej niniejsze kryteria badania. | Tak | |
| metryka | ciąg | Metryka jest oceniana. | Tak | |
| testingCriteria | ciąg | Nazwa kryteriów testowania. | Tak |
EvalRunResultSummary
Statystyki podsumowujące metrykę w przebiegu oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| średnia | Liczba | Średnia wartość metryki w przebiegu oceny. | Tak | |
| identyfikator uruchomienia | ciąg | Identyfikator przebiegu oceny. | Tak | |
| sampleCount | liczba całkowita | Liczba próbek w przebiegu oceny. | Tak | |
| StandardowaDeviation | Liczba | Odchylenie standardowe metryki w przebiegu oceny. | Tak |
EvaluationComparisonRequest
Prośba o porównanie oceny
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| baselineRunId | ciąg | Identyfikator uruchomienia punktu odniesienia do porównania. | Tak | |
| evalId | ciąg | Identyfikator oceny. | Tak | |
| leczenieRunIds | macierz | Lista identyfikatorów przebiegów leczenia dla porównania. | Tak | |
| typ | wyliczenie | Typ żądania. Możliwe wartości: EvaluationComparison |
Tak |
EvaluationResultSample
Próbka z wyniku oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| evaluationResult | obiekt | Wynik oceny. | Tak | |
| └─ nazwa | ciąg | Nazwa czeku | Nie. | |
| └* zaliczone | typ logiczny (boolowski) | Wskazuje, czy test zakończył się powodzeniem, czy niepowodzeniem | Nie. | |
| └* wynik | Liczba | wynik | Nie. | |
| └typ | ciąg | Rodzaj kontroli | Nie. | |
| typ | wyliczenie | Wynik oceny Typ próbki Możliwe wartości: EvaluationResultSample |
Tak |
Reguła oceny
Model reguły oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | obiekt | Model działania ewaluacyjnego. | Tak | |
| └typ | EvaluationRuleActionType | Rodzaj działania w ramach oceny. | Nie. | |
| opis | ciąg | Opis reguły oceny. | Nie. | |
| displayName | ciąg | Nazwa wyświetlana reguły oceny. | Nie. | |
| włączony | typ logiczny (boolowski) | Wskazuje, czy reguła oceny jest włączona. Wartość domyślna to true. | Tak | |
| eventType | obiekt | Typ zdarzenia reguły oceny. | Tak | |
| filtr | obiekt | Model filtru oceny. | Nie. | |
| └} agentName | ciąg | Filtruj według nazwy agenta. | Nie. | |
| identyfikator | ciąg | Niepowtarzalny identyfikator reguły oceny. | Tak | |
| daneSystemowe | obiekt | Metadane systemowe dla reguły oceny. | Tak |
EvaluationRuleAction
Model działania ewaluacyjnego.
Dyskryminowanie ocenyRuleAction
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
continuousEvaluation |
ContinuousEvaluationRuleAction |
humanEvaluation |
HumanEvaluationRuleAction |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Rodzaj działania w ramach oceny. | Tak |
EvaluationRuleActionType
Rodzaj działania w ramach oceny.
| Majątek | Wartość |
|---|---|
| Opis | Rodzaj działania w ramach oceny. |
| Typ | ciąg |
| Wartości | continuousEvaluationhumanEvaluation |
EvaluationRuleEventType
Typ zdarzenia reguły oceny.
| Majątek | Wartość |
|---|---|
| Opis | Typ zdarzenia reguły oceny. |
| Typ | ciąg |
| Wartości | responseCompletedmanual |
EvaluationRuleFilter
Model filtru oceny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agentName | ciąg | Filtruj według nazwy agenta. | Tak |
EvaluationRunClusterInsightResult
Szczegółowe informacje z oceny uruchamiają analizę skupień.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| clusterInsight | ClusterInsightResult | Wnioski z analizy skupień. | Tak | |
| typ | wyliczenie | Typ wyniku szczegółowych informacji. Możliwe wartości: EvaluationRunClusterInsight |
Tak |
EvaluationRunClusterInsightsRequest
Wgląd w zestaw wyników ewaluacji
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| evalId | ciąg | Identyfikator oceny dla szczegółowych informacji. | Tak | |
| modelKonfiguracja | obiekt | Konfiguracja modelu używanego w generowaniu wniosków. | Nie. | |
| └* modelDeploymentName | ciąg | Wdrożenie modelu, które ma zostać ocenione. Akceptuje nazwę wdrożenia samodzielnie lub z nazwą połączenia jako {connectionName}/<modelDeploymentName>. |
Nie. | |
| identyfikatory runId | macierz | Lista identyfikatorów przebiegów oceny dla szczegółowych informacji. | Tak | |
| typ | wyliczenie | Typ żądania szczegółowych informacji. Możliwe wartości: EvaluationRunClusterInsight |
Tak |
EvaluationScheduleTask
Zadanie oceny harmonogramu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| evalId | ciąg | Identyfikator grupy oceniającej. | Tak | |
| evalRun | obiekt | Ładunek przebiegu oceny. | Tak | |
| typ | wyliczenie | Możliwe wartości: Evaluation |
Tak |
EvaluationTaxonomy
Definicja taksonomii oceny
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg | Nazwa zasobu | Tak | |
| properties | obiekt | Dodatkowe właściwości taksonomii oceny. | Nie. | |
| taksonomiaKategorie | macierz | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | obiekt | Konfiguracja danych wejściowych dla taksonomii oceny. | Tak | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Nie. | |
| wersja | ciąg | Wersja zasobu | Tak |
EvaluationTaxonomyCreateOrUpdate
Definicja taksonomii oceny
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | macierz | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | obiekt | Konfiguracja danych wejściowych dla taksonomii oceny. | Tak | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Nie. |
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:
| Wartość typu | Schema |
|---|---|
agent |
AgentTaxonomyInput |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Rodzaj danych wejściowych oceny taksonomii. | Tak |
EvaluationTaxonomyInputType
Rodzaj danych wejściowych oceny taksonomii.
| Majątek | Wartość |
|---|---|
| Opis | Rodzaj danych wejściowych oceny taksonomii. |
| Typ | 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:
| Wartość typu | Schema |
|---|---|
agent |
AgentTaxonomyInputUpdate |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Rodzaj danych wejściowych oceny taksonomii. | Tak |
EvaluationTaxonomyUpdate
Definicja taksonomii oceny
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | macierz | Lista kategorii taksonomii. | Nie. | |
| taksonomiaInput | obiekt | Konfiguracja danych wejściowych dla taksonomii oceny. | Nie. | |
| └typ | EvaluationTaxonomyInputType | Typ danych wejściowych taksonomii oceny. | Nie. |
EwaluatorCategory
Kategoria osoby oceniającej
| Majątek | Wartość |
|---|---|
| Opis | Kategoria osoby oceniającej |
| Typ | 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:
| Wartość typu | Schema |
|---|---|
code |
CodeBasedEvaluatorDefinition |
prompt |
PromptBasedEvaluatorDefinition |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| data_schema | 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 | 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 | obiekt | Definicja rodzaju osoby ewaluującej | Tak |
EwaluatorDefinitionType
Definicja rodzaju osoby ewaluującej
| Majątek | Wartość |
|---|---|
| Opis | Definicja rodzaju osoby ewaluującej |
| Typ | ciąg |
| Wartości | promptcodeprompt_and_codeserviceopenai_graders |
EwaluatorMetric
Metryka ewaluatora
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| desirable_direction | obiekt | Kierunek metryki wskazujący, czy wyższa wartość jest lepsza, niższa wartość jest lepsza, czy neutralna | Nie. | |
| is_primary | typ logiczny (boolowski) | Wskazuje, czy ta metryka jest podstawowa, gdy istnieje wiele metryk. | Nie. | |
| max_value | Liczba | Maksymalna wartość metryki. Jeśli nie zostanie określony, zakłada się, że jest niepowiązany. | Nie. | |
| min_value | Liczba | Minimalna wartość metryki | Nie. | |
| typ | obiekt | Rodzaj osoby oceniającej | Nie. |
EwaluatorMetricDirection
Kierunek metryki wskazujący, czy wyższa wartość jest lepsza, niższa wartość jest lepsza, czy neutralna
| Majątek | Wartość |
|---|---|
| Opis | Kierunek metryki wskazujący, czy wyższa wartość jest lepsza, niższa wartość jest lepsza, czy neutralna |
| Typ | ciąg |
| Wartości | increasedecreaseneutral |
EwaluatorMetricType
Rodzaj osoby oceniającej
| Majątek | Wartość |
|---|---|
| Opis | Rodzaj osoby oceniającej |
| Typ | ciąg |
| Wartości | ordinalcontinuousboolean |
Typ ewaluatora
Rodzaj osoby oceniającej
| Majątek | Wartość |
|---|---|
| Opis | Rodzaj osoby oceniającej |
| Typ | ciąg |
| Wartości | builtincustom |
EvaluatorVersion
Definicja ewaluatora
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| categories | macierz | Kategorie osoby oceniającej | Tak | |
| utworzono_o | liczba całkowita | Data/godzina utworzenia osoby oceniającej | Tak | |
| utworzone_przez | ciąg | Twórca ewaluatora | Tak | |
| definicja | obiekt | Podstawowa konfiguracja ewaluatora z dyskryminatorem | Tak | |
| └data_schema | 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 | 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 | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Pomaga łatwo znaleźć ewaluatora w Foundry. Nie musi być unikalny. | Nie. | |
| evaluator_type | obiekt | Rodzaj osoby oceniającej | Tak | |
| identyfikator | ciąg | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| metadane | obiekt | Metadane dotyczące osoby oceniającej | Nie. | |
| modified_at | liczba całkowita | Data/godzina ostatniej modyfikacji osoby oceniającej | Tak | |
| nazwa | ciąg | Nazwa zasobu | Tak | |
| wersja | ciąg | Wersja zasobu | Tak |
EvaluatorVersionTworzenie
Definicja ewaluatora
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| categories | macierz | Kategorie osoby oceniającej | Tak | |
| definicja | obiekt | Podstawowa konfiguracja ewaluatora z dyskryminatorem | Tak | |
| └data_schema | 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 | 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 | Nie. | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Pomaga łatwo znaleźć ewaluatora w Foundry. Nie musi być unikalny. | Nie. | |
| evaluator_type | obiekt | Rodzaj osoby oceniającej | Tak | |
| 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| categories | macierz | Kategorie osoby oceniającej | Nie. | |
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| display_name | ciąg | Nazwa wyświetlana dla ewaluatora. Pomaga łatwo znaleźć ewaluatora w 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| project_connections | macierz | Połączenia projektu 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_file |
Tak |
FileDatasetVersionUpdate
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_file |
Tak |
FolderDatasetVersion
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_folder |
Tak |
FolderDatasetVersionUpdate
Definicja wersji pliku FileDatasetVersion
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zestawu danych Możliwe wartości: uri_folder |
Tak |
HostedAgentDefinition
Definicja hostowanego agenta.
Dyskryminujące dla elementu HostedAgentDefinition
Ten składnik używa właściwości kind do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
hosted |
ImageBasedHostedAgentDefinition |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| container_protocol_versions | macierz | Protokoły obsługiwane przez agenta na potrzeby komunikacji przychodzącej kontenerów. | Tak | |
| cpu | ciąg | Konfiguracja procesora CPU dla hostowanego agenta. | Tak | |
| environment_variables | obiekt | Zmienne środowiskowe do ustawienia w kontenerze hostowanego agenta. | Nie. | |
| rodzaj | wyliczenie | Możliwe wartości: hosted |
Tak | |
| pamięć | ciąg | Konfiguracja pamięci hostowanego agenta. | Tak | |
| narzędzia | macierz | 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: Hourly |
Tak |
HumanEvaluationRuleAction
Akcja reguły oceny dla oceny przez człowieka.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Identyfikator szablonu | obiekt | Identyfikator zapisanego zasobu. | Tak | |
| typ | wyliczenie | Możliwe wartości: humanEvaluation |
Tak |
ImageBasedHostedAgentDefinition
Definicja wdrożenia opartego na obrazie dla hostowanego agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| obraz | ciąg | Obraz hostowanego agenta. | Tak | |
| rodzaj | wyliczenie | Możliwe wartości: hosted |
Tak |
Index
Definicja zasobu indeksu
Dyskryminujący indeks
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
AzureSearch |
AzureAISearchIndex |
ManagedAzureSearch |
ManagedAzureAISearchIndex |
CosmosDBNoSqlVectorStore |
CosmosDBIndex |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Identyfikator zasobu, unikatowy identyfikator zasobu | Nie. | |
| nazwa | ciąg | Nazwa zasobu | Tak | |
| typ | obiekt | Tak | ||
| wersja | ciąg | Wersja zasobu | Tak |
Typ indeksu
| Majątek | Wartość |
|---|---|
| Typ | 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:
| Wartość typu | Schema |
|---|---|
AzureSearch |
AzureAISearchIndexUpdate |
ManagedAzureSearch |
ManagedAzureAISearchIndexUpdate |
CosmosDBNoSqlVectorStore |
CosmosDBIndexUpdate |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Tekst opisu zasobu. | Nie. | |
| tags | obiekt | Słownik tagów. Tagi można dodawać, usuwać i aktualizować. | Nie. | |
| typ | obiekt | Tak |
Wgląd
Treść odpowiedzi dla szczegółowych informacji o klastrze.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| displayName | ciąg | Przyjazna dla użytkownika nazwa wyświetlana dla szczegółowych informacji. | Tak | |
| identyfikator | ciąg | Unikatowy identyfikator raportu ze statystykami. | Tak | |
| metadane | obiekt | Metadane dotyczące szczegółowych informacji. | Tak | |
| └* completedAt | ciąg | Sygnatura czasowa, kiedy szczegółowe informacje zostały ukończone. | Nie. | |
| └} createdAt | ciąg | Sygnatura czasowa utworzenia szczegółowych informacji. | Nie. | |
| żądanie | obiekt | Żądanie raportu szczegółowych informacji. | Tak | |
| └typ | InsightType | Typ żądania. | Nie. | |
| wynik | obiekt | Wynik spostrzeżeń. | Nie. | |
| └typ | InsightType | Typ wyniku szczegółowych informacji. | Nie. | |
| stan | obiekt | Wyliczenie opisujące dozwolone stany operacji. | Tak |
InsightCluster
Klaster próbek analitycznych.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis grupy analitycznej. | Tak | |
| identyfikator | ciąg | Identyfikator klastra analizy. | Tak | |
| etykieta | ciąg | Etykieta dla klastra | Tak | |
| Próbki | macierz | Lista próbek należących do tego klastra. Puste, jeśli próbki są częścią podklastrów. | Nie. | |
| subClusters | macierz | Lista podklastrów w tym klastrze. Puste, jeśli nie istnieją żadne podklastry. | Nie. | |
| sugestia | ciąg | Sugestia dotycząca klastra | Tak | |
| suggestionTitle | ciąg | Tytuł sugestii dla klastra | Tak | |
| weight | liczba całkowita | Waga klastra analizy. Wskazuje to liczbę próbek w klastrze. | Tak |
InsightModelConfiguration
Konfiguracja modelu używanego w generowaniu wniosków.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| modelDeploymentName | ciąg | Wdrożenie modelu, które ma zostać ocenione. Akceptuje nazwę wdrożenia samodzielnie lub z nazwą połączenia jako {connectionName}/<modelDeploymentName>. |
Tak |
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:
| Wartość typu | Schema |
|---|---|
EvaluationRunClusterInsight |
EvaluationRunClusterInsightsRequest |
AgentClusterInsight |
AgentClusterInsightsRequest |
EvaluationComparison |
EvaluationComparisonRequest |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Prośba o wglądy. | Tak |
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:
| Wartość typu | Schema |
|---|---|
EvaluationComparison |
EvalCompareReport |
EvaluationRunClusterInsight |
EvaluationRunClusterInsightResult |
AgentClusterInsight |
AgentClusterInsightResult |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Prośba o wglądy. | Tak |
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:
| Wartość typu | Schema |
|---|---|
EvaluationResultSample |
EvaluationResultSample |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| correlationInfo | obiekt | Informacja o korelacji dla próbki analizy. | Tak | |
| features | obiekt | Funkcje pomagające w dodatkowym filtrowaniu danych w UX. | Tak | |
| identyfikator | ciąg | Niepowtarzalny identyfikator próbki analitycznej. | Tak | |
| typ | obiekt | Rodzaj próbki użytej w analizie. | Tak |
InsightScheduleTask
Zadanie Wgląd dla harmonogramu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| analiza | obiekt | Treść odpowiedzi dla szczegółowych informacji o klastrze. | Tak | |
| └} displayName | ciąg | Przyjazna dla użytkownika nazwa wyświetlana dla szczegółowych informacji. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator raportu ze statystykami. | Nie. | |
| Metadane └* | InsightsMetadata | Metadane dotyczące raportu ze statystykami. | Nie. | |
| └* żądanie | InsightRequest | Prośba o analizę wniosków. | Nie. | |
| Wynik └* | Szczegółowe informacje | Wynik raportu szczegółowych informacji. | Nie. | |
| Stan └* | Azure.Core.Foundations.OperationState | Bieżący stan szczegółowych informacji. | Nie. | |
| typ | wyliczenie | Możliwe wartości: Insight |
Tak |
InsightSummary
Podsumowanie analizy skupień błędów.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| metoda | ciąg | Metoda stosowana do grupowania. | Tak | |
| sampleCount | liczba całkowita | Łączna liczba przeanalizowanych próbek. | Tak | |
| uniqueClusterCount | liczba całkowita | Łączna liczba unikatowych klastrów. | Tak | |
| uniqueSubclusterCount | liczba całkowita | Łączna liczba unikatowych etykiet podklastrów. | Tak | |
| użycie | obiekt | Użycie tokenu do analizy skupień | Tak | |
| └* inputTokenUsage | liczba całkowita | Użycie tokenu wejściowego | Nie. | |
| └} outputTokenUsage | liczba całkowita | Użycie tokenu wyjściowego | Nie. | |
| └* totalTokenUsage | liczba całkowita | Całkowite użycie tokenów | Nie. |
InsightType
Prośba o wglądy.
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | EvaluationRunClusterInsightAgentClusterInsightEvaluationComparison |
InsightsMetadata
Metadane dotyczące szczegółowych informacji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| completedAt | ciąg | Sygnatura czasowa, kiedy szczegółowe informacje zostały ukończone. | Nie. | |
| createdAt | ciąg | Sygnatura czasowa utworzenia szczegółowych informacji. | Tak |
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:
| Wartość typu | Schema |
|---|
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg | Typ parametrów generowania elementu do użycia. | Tak |
ManagedAzureAISearchIndex
Definicja indeksu wyszukiwania zarządzanej sztucznej inteligencji platformy Azure
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Rodzaj indeksu Możliwe wartości: ManagedAzureSearch |
Tak |
ManagedAzureAISearchIndexUpdate
Definicja indeksu wyszukiwania zarządzanej sztucznej inteligencji platformy Azure
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Rodzaj indeksu Możliwe wartości: ManagedAzureSearch |
Tak |
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:
| Wartość typu | Schema |
|---|---|
user_profile |
UserProfileMemoryItem |
chat_summary |
ChatSummaryMemoryItem |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg | Zawartość pamięci. | Tak | |
| rodzaj | obiekt | Rodzaj elementu pamięci. | Tak | |
| memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Tak | |
| zakres | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Tak | |
| updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Tak |
MemoryItemKind
Rodzaj elementu pamięci.
| Majątek | Wartość |
|---|---|
| Opis | Rodzaj elementu pamięci. |
| Typ | ciąg |
| Wartości | user_profilechat_summary |
MemoryOperation
Reprezentuje pojedynczą operację pamięci (tworzenie, aktualizowanie lub usuwanie) wykonywaną na elemencie pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rodzaj | obiekt | Rodzaj operacji pamięci. | Tak | |
| memory_item | obiekt | Pojedynczy element pamięci przechowywany w magazynie pamięci, zawierający zawartość i metadane. | Tak | |
| └─ zawartość | ciąg | Zawartość pamięci. | Nie. | |
| Rodzaj └* | MemoryItemKind | Rodzaj elementu pamięci. | Nie. | |
| └memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Nie. | |
| Zakres └* | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Nie. | |
| └updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Nie. |
MemoryOperationKind
Rodzaj operacji pamięci.
| Majątek | Wartość |
|---|---|
| Opis | Rodzaj operacji pamięci. |
| Typ | ciąg |
| Wartości | createupdatedelete |
MemorySearchItem
Pobrany element pamięci z wyszukiwania w pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| memory_item | obiekt | Pojedynczy element pamięci przechowywany w magazynie pamięci, zawierający zawartość i metadane. | Tak | |
| └─ zawartość | ciąg | Zawartość pamięci. | Nie. | |
| Rodzaj └* | MemoryItemKind | Rodzaj elementu pamięci. | Nie. | |
| └memory_id | ciąg | Unikatowy identyfikator elementu pamięci. | Nie. | |
| Zakres └* | ciąg | Przestrzeń nazw, która logicznie grupuje i izoluje wspomnienia, na przykład identyfikator użytkownika. | Nie. | |
| └updated_at | liczba całkowita | Czas ostatniej aktualizacji elementu pamięci. | Nie. |
MemorySearchOptions
Opcje wyszukiwania w pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| max_memories | liczba całkowita | Maksymalna liczba elementów pamięci do zwrócenia. | Nie. |
MemorySearchTool
Narzędzie do integracji wspomnień z agentem.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| memory_store_name | ciąg | Nazwa magazynu pamięci, który ma być używany. | Tak | |
| 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. |
Tak | |
| search_options | obiekt | 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.Możliwe wartości: memory_search |
Tak | |
| update_delay | liczba całkowita | Czas oczekiwania przed aktualizacją wspomnień po braku aktywności (w sekundach). Domyślnie 300. | Nie. | 300 |
MemorySearchToolCallItemParam
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| results | macierz | Wyniki zwrócone z wyszukiwania w pamięci. | Nie. | |
| typ | wyliczenie | Możliwe wartości: memory_search_call |
Tak |
MemorySearchToolCallItemResource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| results | macierz | Wyniki zwrócone z wyszukiwania w 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 |
Tak | |
| typ | wyliczenie | Możliwe wartości: memory_search_call |
Tak |
MemoryStoreDefaultDefinition
Domyślna implementacja magazynu pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| chat_model | ciąg | Nazwa lub identyfikator wdrożenia modelu uzupełniania czatu używanego do przetwarzania pamięci. | Tak | |
| embedding_model | ciąg | Nazwa lub identyfikator wdrożenia modelu osadzania używanego do przetwarzania pamięci. | Tak | |
| rodzaj | wyliczenie | Rodzaj magazynu pamięci. Możliwe wartości: default |
Tak | |
| options | obiekt | Domyślne konfiguracje magazynu pamięci. | Nie. | |
| └chat_summary_enabled | typ logiczny (boolowski) | Określa, czy włączyć wyodrębnianie i przechowywanie podsumowań czatów. Wartość domyślna to true. | Nie. | Prawda |
| └user_profile_details | ciąg | Określone kategorie lub typy informacji o profilu użytkownika do wyodrębnienia i przechowywania. | Nie. | |
| └user_profile_enabled | typ logiczny (boolowski) | Określa, czy włączyć wyodrębnianie i przechowywanie profilów użytkowników. Wartość domyślna to true. | Nie. | Prawda |
MemoryStoreDefaultOptions
Domyślne konfiguracje magazynu pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| chat_summary_enabled | typ logiczny (boolowski) | Określa, czy włączyć wyodrębnianie i przechowywanie podsumowań czatów. Wartość domyślna to true. | Tak | Prawda |
| user_profile_details | ciąg | Określone kategorie lub typy informacji o profilu użytkownika do wyodrębnienia i przechowywania. | Nie. | |
| user_profile_enabled | typ logiczny (boolowski) | Określa, czy włączyć wyodrębnianie i przechowywanie profilów użytkowników. Wartość domyślna to true. | Tak | Prawda |
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:
| Wartość typu | Schema |
|---|---|
default |
MemoryStoreDefaultDefinition |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rodzaj | obiekt | Typ implementacji magazynu pamięci, który ma być używany. | Tak |
MemoryStoreDeleteScopeResponse
Odpowiedź na usunięcie wspomnień z zakresu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | Czy operacja usuwania zakończyła się pomyślnie. | Tak | |
| nazwa | ciąg | Nazwa magazynu pamięci. | Tak | |
| obiekt | wyliczenie | Typ obiektu. Zawsze "memory_store.scope.deleted". Możliwe wartości: memory_store.scope.deleted |
Tak | |
| zakres | ciąg | Zakres, z którego usunięto wspomnienia. | Tak |
MemoryStoreKind
Typ implementacji magazynu pamięci, który ma być używany.
| Majątek | Wartość |
|---|---|
| Opis | Typ implementacji magazynu pamięci, który ma być używany. |
| Typ | ciąg |
| Wartości | default |
MemoryStoreObject
Magazyn pamięci, który może przechowywać i pobierać wspomnienia użytkownika.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Uniksowy znacznik czasu (w sekundach), kiedy został utworzony magazyn pamięci. | Tak | |
| definicja | obiekt | Podstawowa definicja konfiguracji magazynu pamięci. | Tak | |
| Rodzaj └* | MemoryStoreKind | Rodzaj magazynu pamięci. | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis magazynu pamięci. | Nie. | |
| identyfikator | ciąg | Niepowtarzalny identyfikator magazynu pamięci. | Tak | |
| metadane | obiekt | Dowolne metadane klucz-wartość do skojarzenia z magazynem pamięci. | Nie. | |
| nazwa | ciąg | Nazwa magazynu pamięci. | Tak | |
| obiekt | wyliczenie | Typ obiektu, którym zawsze jest wartość "memory_store". Możliwe wartości: memory_store |
Tak | |
| updated_at | liczba całkowita | Uniksowy znacznik czasu (w sekundach) ostatniej aktualizacji magazynu pamięci. | Tak |
MemoryStoreOperationUsage
Statystyki użycia operacji składnicy pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| embedding_tokens | liczba całkowita | Liczba tokenów osadzania. | Tak | |
| input_tokens | liczba całkowita | Liczba tokenów wejściowych. | Tak | |
| input_tokens_details | obiekt | Szczegółowy podział tokenów wejściowych. | Tak | |
| └cached_tokens | liczba całkowita | Liczba tokenów pobranych z pamięci podręcznej. Więcej informacji na temat buforowania monitów. |
Nie. | |
| output_tokens | liczba całkowita | Liczba tokenów wyjściowych. | Tak | |
| output_tokens_details | obiekt | Szczegółowy podział tokenów wyjściowych. | Tak | |
| └─ tokeny_rozumowania | liczba całkowita | Liczba tokenów rozumowania. | Nie. | |
| total_tokens | liczba całkowita | Całkowita liczba użytych tokenów. | Tak |
MemoryStoreSearchResponse
Odpowiedź na wyszukiwanie w pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Wspomnienia | macierz | Powiązane elementy pamięci znalezione podczas operacji wyszukiwania. | Tak | |
| search_id | ciąg | Unikatowy identyfikator tego żądania wyszukiwania. Użyj tej wartości jako previous_search_id w kolejnych żądaniach, aby przeprowadzić wyszukiwania przyrostowe. | Tak | |
| użycie | obiekt | Statystyki użycia operacji składnicy pamięci. | Tak | |
| └embedding_tokens | liczba całkowita | Liczba tokenów osadzania. | Nie. | |
| └input_tokens | liczba całkowita | Liczba tokenów wejściowych. | Nie. | |
| └input_tokens_details | obiekt | Szczegółowy podział tokenów wejściowych. | Nie. | |
| └cached_tokens | liczba całkowita | Liczba tokenów pobranych z pamięci podręcznej. Więcej informacji na temat buforowania monitów. |
Nie. | |
| └─ tokeny_wyjściowe | liczba całkowita | Liczba tokenów wyjściowych. | Nie. | |
| └output_tokens_details | obiekt | Szczegółowy podział tokenów wyjściowych. | Nie. | |
| └─ tokeny_rozumowania | liczba całkowita | Liczba tokenów rozumowania. | Nie. | |
| └total_tokens | liczba całkowita | Całkowita liczba użytych tokenów. | Nie. |
MemoryStoreUpdateCompletedResult
Wynik aktualizacji pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| memory_operations | macierz | Lista poszczególnych operacji na pamięci, które zostały wykonane podczas aktualizacji. | Tak | |
| użycie | obiekt | Statystyki użycia operacji składnicy pamięci. | Tak | |
| └embedding_tokens | liczba całkowita | Liczba tokenów osadzania. | Nie. | |
| └input_tokens | liczba całkowita | Liczba tokenów wejściowych. | Nie. | |
| └input_tokens_details | obiekt | Szczegółowy podział tokenów wejściowych. | Nie. | |
| └cached_tokens | liczba całkowita | Liczba tokenów pobranych z pamięci podręcznej. Więcej informacji na temat buforowania monitów. |
Nie. | |
| └─ tokeny_wyjściowe | liczba całkowita | Liczba tokenów wyjściowych. | Nie. | |
| └output_tokens_details | obiekt | Szczegółowy podział tokenów wyjściowych. | Nie. | |
| └─ tokeny_rozumowania | liczba całkowita | Liczba tokenów rozumowania. | Nie. | |
| └total_tokens | liczba całkowita | Całkowita liczba użytych tokenów. | Nie. |
MemoryStoreUpdateResponse
Określa stan operacji aktualizacji magazynu pamięci.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | obiekt | Nie. | ||
| └* additionalInfo | obiekt | Nie. | ||
| └─ kod | ciąg | Nie. | ||
| └* debugInfo | obiekt | Nie. | ||
| └szczegóły | macierz | Nie. | ||
| └─ Komunikat | ciąg | Nie. | ||
| └* param | ciąg | Nie. | ||
| └typ | ciąg | Nie. | ||
| wynik | obiekt | Wynik aktualizacji pamięci. | Nie. | |
| └memory_operations | macierz | Lista poszczególnych operacji na pamięci, które zostały wykonane podczas aktualizacji. | Nie. | |
| └─ użycie | MemoryStoreOperationUsage | Statystyki użycia skojarzone z operacją aktualizacji pamięci. | Nie. | |
| stan | obiekt | Stan operacji aktualizacji magazynu pamięci. | Tak | |
| superseded_by | ciąg | update_id operacji została zastąpiona przez sytuację, w której stan jest "zastąpiony". | Nie. | |
| update_id | ciąg | Unikatowy identyfikator tego żądania aktualizacji. Użyj tej wartości jako previous_update_id w kolejnych żądaniach, aby wykonać aktualizacje przyrostowe. | Tak |
MemoryStoreUpdateStatus
Stan operacji aktualizacji magazynu pamięci.
| Majątek | Wartość |
|---|---|
| Opis | Stan operacji aktualizacji magazynu pamięci. |
| Typ | ciąg |
| Wartości | queuedin_progresscompletedfailedsuperseded |
MicrosoftFabricAgentTool
Informacje o definicji danych wejściowych narzędzia Microsoft Fabric używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| fabric_dataagent_preview | obiekt | Parametry narzędzia agenta danych sieci szkieletowej. | Tak | |
| └project_connections | macierz | Połączenia projektu dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Nie. | |
| typ | wyliczenie | Typ obiektu, który jest zawsze "fabric_dataagent". Możliwe wartości: fabric_dataagent_preview |
Tak |
ModelDeployment
Definicja wdrożenia modelu
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| capabilities | obiekt | Możliwości wdrożonego modelu | Tak | |
| connectionName (nazwa_połączenia) | ciąg | Nazwa połączenia, z którego pochodzi wdrożenie | Nie. | |
| modelName | ciąg | Nazwa wdrożonego modelu specyficzna dla wydawcy | Tak | |
| modelPublisher | ciąg | Nazwa wydawcy wdrożonego modelu | Tak | |
| wersja modelu | ciąg | Wersja wdrożonego modelu specyficzna dla wydawcy | Tak | |
| sku | obiekt | Informacje o jednostce SKU | Tak | |
| Pojemność └* | liczba całkowita | Pojemność jednostki SKU | Nie. | |
| Rodzina └* | ciąg | Rodzina SKU | Nie. | |
| └─ nazwa | ciąg | Nazwa jednostki SKU | Nie. | |
| └* rozmiar | ciąg | Rozmiar jednostki SKU | Nie. | |
| Warstwa └* | ciąg | Warstwa jednostki SKU | Nie. | |
| typ | wyliczenie | Typ wdrożenia Możliwe wartości: ModelDeployment |
Tak |
ModelSamplingParams
Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| max_completion_tokens | liczba całkowita | Maksymalna liczba tokenów dozwolonych w zakończeniu. | Tak | |
| seed | liczba całkowita | Losowe inicjatory do odtworzenia. | Tak | |
| temperatura | Liczba | Parametr temperatury do próbkowania. | Tak | |
| top_p | Liczba | Parametr top-p próbkowania jądra. | Tak |
ModelSamplingParamsUpdate
Reprezentuje zestaw parametrów używanych do kontrolowania zachowania próbkowania modelu językowego podczas generowania tekstu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | Liczba | Parametr temperatury do próbkowania. | Nie. | |
| top_p | Liczba | Parametr top-p próbkowania jądra. | Nie. |
MonthlyRecurrenceSchedule
Miesięczny harmonogram cykli.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| daysOfMonth | macierz | Dni miesiąca dla harmonogramu cyklu. | Tak | |
| typ | wyliczenie | Typ cyklu miesięcznego. Możliwe wartości: Monthly |
Tak |
NoAuthenticationCredentials
Poświadczenia, które nie wymagają uwierzytelniania
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: None |
Tak |
OAuthConsentRequestItemResource
Żądanie od usługi, aby użytkownik wykonał zgodę OAuth.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| consent_link | ciąg | Link, za pomocą których użytkownik może wykonać zgodę OAuth. | Tak | |
| identyfikator | ciąg | Tak | ||
| etykieta_serwera | ciąg | Etykieta serwera dla żądania zgody OAuth. | Tak | |
| typ | wyliczenie | Możliwe wartości: oauth_consent_request |
Tak |
OneTimeTrigger
Jednorazowy spust.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| strefa czasowa | ciąg | Strefa czasowa dla wyzwalacza jednorazowego. | Nie. | UTC |
| triggerAt | ciąg | Data i godzina jednorazowego wyzwolenia w formacie ISO 8601. | Tak | |
| typ | wyliczenie | Możliwe wartości: OneTime |
Tak |
OpenAI.Annotation
Dyskryminator dla OpenAI.Annotation.
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
file_citation |
OpenAI.AnnotationFileCitation |
url_citation |
OpenAI.AnnotationUrlCitation |
file_path |
OpenAI.AnnotationFilePath |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.AnnotationType | Tak |
OpenAI.AnnotationFileCitation
Cytat do pliku.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Identyfikator pliku. | Tak | |
| filename | ciąg | Nazwa pliku cytowanego. | Tak | |
| indeks | liczba całkowita | Indeks pliku na liście plików. | Tak | |
| typ | wyliczenie | Typ cytowania pliku. Zawsze file_citation.Możliwe wartości: file_citation |
Tak |
OpenAI.AnnotationFilePath
Ścieżka do pliku.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Identyfikator pliku. | Tak | |
| indeks | liczba całkowita | Indeks pliku na liście plików. | Tak | |
| typ | wyliczenie | Typ ścieżki pliku. Zawsze file_path.Możliwe wartości: file_path |
Tak |
OpenAI.AnnotationType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | file_citationurl_citationfile_pathcontainer_file_citation |
OpenAI.AnnotationUrlCitation
Cytat dotyczący zasobu internetowego używanego do generowania odpowiedzi modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| end_index | liczba całkowita | Indeks ostatniego znaku cytatu adresu URL w komunikacie. | Tak | |
| start_index | liczba całkowita | Indeks pierwszego znaku cytatu adresu URL w komunikacie. | Tak | |
| title | ciąg | Tytuł zasobu internetowego. | Tak | |
| typ | wyliczenie | Typ cytatu adresu URL. Zawsze url_citation.Możliwe wartości: url_citation |
Tak | |
| Adres URL | ciąg | Adres URL zasobu internetowego. | Tak |
OpenAI.PrzybliżonaLokalizacja
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| city | ciąg | Nie. | ||
| country | ciąg | Nie. | ||
| region | ciąg | Nie. | ||
| timezone | ciąg | Nie. | ||
| typ | wyliczenie | Możliwe wartości: approximate |
Tak |
OpenAI.ChatCompletionTool
Narzędzie funkcji, które może służyć do generowania odpowiedzi.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| funkcja | OpenAI.FunctionObject | Tak | ||
| typ | wyliczenie | Typ narzędzia. Obecnie obsługiwany jest tylko function.Możliwe wartości: function |
Tak |
OpenAI.CodeInterpreterOutput
Dyskryminujące metody OpenAI.CodeInterpreterOutput
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
image |
OpenAI.CodeInterpreterOutputImage |
logs |
OpenAI.CodeInterpreterOutputLogs |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.CodeInterpreterOutputType | Tak |
OpenAI.CodeInterpreterOutputImage
Dane wyjściowe obrazu z interpretera kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ danych wyjściowych. Zawsze "obraz". Możliwe wartości: image |
Tak | |
| Adres URL | ciąg | Adres URL danych wyjściowych obrazu z interpretera kodu. | Tak |
OpenAI.CodeInterpreterOutputLogs
Dane wyjściowe dzienników z interpretera kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dzienniki | ciąg | Dane wyjściowe dzienników z interpretera kodu. | Tak | |
| typ | wyliczenie | Typ danych wyjściowych. Zawsze "dzienniki". Możliwe wartości: logs |
Tak |
OpenAI.CodeInterpreterOutputType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | logsimage |
OpenAI.CodeInterpreterTool
Narzędzie, które uruchamia kod języka Python, aby pomóc wygenerować odpowiedź na monit.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kontener | obiekt | Konfiguracja kontenera interpretera kodu. Opcjonalnie określ identyfikatory plików potrzebnych do uruchomienia kodu. |
Tak | |
| └ file_ids | macierz | Opcjonalna lista przesłanych plików, które mają być dostępne w Twoim kodzie. | Nie. | |
| └typ | wyliczenie | Zawsze auto.Możliwe wartości: auto |
Nie. | |
| typ | wyliczenie | Typ narzędzia interpretera kodu. Zawsze code_interpreter.Możliwe wartości: code_interpreter |
Tak |
OpenAI.CodeInterpreterToolAuto
Konfiguracja kontenera interpretera kodu. Opcjonalnie określ identyfikatory plików do uruchomienia kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikatory_plików | macierz | Opcjonalna lista przesłanych plików, które mają być dostępne w Twoim kodzie. | Nie. | |
| typ | wyliczenie | Zawsze auto.Możliwe wartości: auto |
Tak |
OpenAI.CodeInterpreterToolCallItemParam
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Kod do uruchomienia lub wartość null, jeśli nie jest dostępny. | Tak | |
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Tak | |
| Wyniki | macierz | Dane wyjściowe generowane przez interpreter kodu, takie jak dzienniki lub obrazy. Może mieć wartość null, jeśli żadne dane wyjściowe nie są dostępne. |
Tak | |
| typ | wyliczenie | Możliwe wartości: code_interpreter_call |
Tak |
OpenAI.CodeInterpreterToolCallItemResource
Wywołanie narzędzia w celu uruchomienia kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Kod do uruchomienia lub wartość null, jeśli nie jest dostępny. | Tak | |
| container_id | ciąg | Identyfikator kontenera używanego do uruchamiania kodu. | Tak | |
| Wyniki | macierz | Dane wyjściowe generowane przez interpreter kodu, takie jak dzienniki lub obrazy. Może mieć wartość null, jeśli żadne dane wyjściowe nie są dostępne. |
Tak | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete, , interpretingfailed |
Tak | |
| typ | wyliczenie | Możliwe wartości: code_interpreter_call |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| klucz | ciąg | Klucz do porównania z wartością. | Tak | |
| typ | wyliczenie | Określa operator porównania:eq(równe), (nie równe), negt (większe niż), gte (większe lub równe), (mniejsze niż lub równe), ltlte (mniejsze lub równe).Możliwe wartości: eq, , negt, gte, , ltlte |
Tak | |
| wartość | ciąg lub liczba lub wartość logiczna | Tak |
OpenAI.CompoundFilter
Połącz wiele filtrów przy użyciu polecenia and lub or.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| filters | macierz | Tablica filtrów do połączenia. Elementy mogą mieć wartość ComparisonFilter lub CompoundFilter. |
Tak | |
| typ | wyliczenie | Typ operacji: and lub or.Możliwe wartości: and, or |
Tak |
OpenAI.ComputerAction
Dyskryminujące dla openAI.ComputerAction
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
click |
OpenAI.ComputerActionClick |
double_click |
OpenAI.ComputerActionDoubleClick |
drag |
OpenAI.ComputerActionDrag |
move |
OpenAI.ComputerActionMove |
screenshot |
OpenAI.ComputerActionScreenshot |
scroll |
OpenAI.ComputerActionScroll |
type |
OpenAI.ComputerActionTypeKeys |
wait |
OpenAI.ComputerActionWait |
keypress |
OpenAI.ComputerActionKeyPress |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ComputerActionType | Tak |
OpenAI.ComputerActionClick
Akcja kliknięcia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| przycisk | wyliczenie | Wskazuje, który przycisk myszy został naciśnięty podczas kliknięcia.
leftJeden z , right, wheel, back, lub forward.Możliwe wartości: left, , rightwheel, , backforward |
Tak | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji kliknięcia ta właściwość to zawsze ustawiony na click.Możliwe wartości: click |
Tak | |
| x | liczba całkowita | Współrzędna x, w której wystąpiło kliknięcie. | Tak | |
| y | liczba całkowita | Współrzędna y, w której wystąpiło kliknięcie. | Tak |
OpenAI.ComputerActionDoubleClick
Dwukrotne kliknięcie myszy.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji dwukrotnego kliknięcia ta właściwość jest zawsze ustawiony na double_click.Możliwe wartości: double_click |
Tak | |
| x | liczba całkowita | Współrzędna x, w której wystąpiło dwukrotne kliknięcie. | Tak | |
| y | liczba całkowita | Współrzędna y, w której wystąpiło dwukrotne kliknięcie. | Tak |
OpenAI.ComputerActionDrag
Czynność przeciągania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| ścieżka | macierz | 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> |
Tak | |
| 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 |
Tak |
OpenAI.ComputerActionKeyPress
Kolekcja naciśnięć klawiszy, które model chciałby wykonać.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| keys | macierz | Kombinacja klawiszy, którą model żąda naciśnięcia. Jest to element tablica ciągów, z których każdy reprezentuje klucz. |
Tak | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji keypress ta właściwość jest zawsze ustawiony na keypress.Możliwe wartości: keypress |
Tak |
OpenAI.ComputerActionMove
Akcja ruchu myszy.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji przenoszenia ta właściwość to zawsze ustawiony na move.Możliwe wartości: move |
Tak | |
| x | liczba całkowita | Współrzędna x, do której należy się przesunąć. | Tak | |
| y | liczba całkowita | Współrzędna y, do której należy się przesunąć. | Tak |
OpenAI.ComputerActionScreenshot
Akcja zrzutu ekranu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 |
Tak |
OpenAI.ComputerActionScroll
Akcja przewijania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| scroll_x | liczba całkowita | Odległość przewijania poziomego. | Tak | |
| scroll_y | liczba całkowita | Odległość przewijania w pionie. | Tak | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji przewijania ta właściwość to zawsze ustawiony na scroll.Możliwe wartości: scroll |
Tak | |
| x | liczba całkowita | Współrzędna x, w której wystąpiło przewijanie. | Tak | |
| y | liczba całkowita | Współrzędna y, w której wystąpiło przewijanie. | Tak |
OpenAI.ComputerActionType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | screenshotclickdouble_clickscrolltypewaitkeypressdragmove |
OpenAI.ComputerActionTypeKeys
Akcja wpisywania tekstu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| SMS | ciąg | Tekst do wpisania. | Tak | |
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji typu ta właściwość to zawsze ustawiony na type.Możliwe wartości: type |
Tak |
OpenAI.ComputerActionWait
Akcja oczekiwania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Określa typ zdarzenia. W przypadku akcji oczekiwania ta właściwość to zawsze ustawiony na wait.Możliwe wartości: wait |
Tak |
OpenAI.ComputerToolCallItemParam
Narzędzie wywołujące narzędzie do korzystania z komputera. Więcej informacji można znaleźć w podręczniku użytkowania komputera .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Tak | ||
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Tak | |
| pending_safety_checks | macierz | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Tak | |
| typ | wyliczenie | Możliwe wartości: computer_call |
Tak |
OpenAI.ComputerToolCallItemResource
Narzędzie wywołujące narzędzie do korzystania z komputera. Więcej informacji można znaleźć w podręczniku użytkowania komputera .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | OpenAI.ComputerAction | Tak | ||
| call_id | ciąg | Identyfikator używany podczas odpowiadania na wywołanie narzędzia z danymi wyjściowymi. | Tak | |
| pending_safety_checks | macierz | Oczekujące kontrole bezpieczeństwa dla wywołania komputera. | Tak | |
| 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 |
Tak | |
| typ | wyliczenie | Możliwe wartości: computer_call |
Tak |
OpenAI.ComputerToolCallOutputItemOutput
Dyskryminujące dla openAI.ComputerToolCallOutputItemOutput
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
computer_screenshot |
OpenAI.ComputerToolCallOutputItemOutputComputerScreenshot |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ComputerToolCallOutputItemOutputType | Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera. | Tak |
OpenAI.ComputerToolCallOutputItemOutputComputerScreenshot
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator_pliku | ciąg | Nie. | ||
| image_url | ciąg | Nie. | ||
| typ | wyliczenie | Możliwe wartości: computer_screenshot |
Tak |
OpenAI.ComputerToolCallOutputItemOutputType
Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera.
| Majątek | Wartość |
|---|---|
| Opis | Obraz zrzutu ekranu komputera używany w narzędziu do obsługi komputera. |
| Typ | ciąg |
| Wartości | computer_screenshot |
OpenAI.ComputerToolCallOutputItemParam
Dane wyjściowe z wywołania narzędzia komputerowego.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| acknowledged_safety_checks | macierz | 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. | Tak | |
| We/Wy | OpenAI.ComputerToolCallOutputItemOutput | Tak | ||
| typ | wyliczenie | Możliwe wartości: computer_call_output |
Tak |
OpenAI.ComputerToolCallOutputItemResource
Dane wyjściowe z wywołania narzędzia komputerowego.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| acknowledged_safety_checks | macierz | 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. | Tak | |
| We/Wy | OpenAI.ComputerToolCallOutputItemOutput | Tak | ||
| 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 |
Tak | |
| typ | wyliczenie | Możliwe wartości: computer_call_output |
Tak |
OpenAI.ComputerToolCallSafetyCheck
Zaplanowana kontrola bezpieczeństwa dla komputerowego wezwania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Typ oczekującego sprawdzenia bezpieczeństwa. | Tak | |
| identyfikator | ciąg | Identyfikator oczekującego sprawdzenia bezpieczeństwa. | Tak | |
| komunikat | ciąg | Szczegółowe informacje na temat nadchodzących kontroli bezpieczeństwa. | Tak |
OpenAI.NarzędziePodgląduUżytkowaniaKomputera
Narzędzie kontrolujące komputer wirtualny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| wysokość ekranu | liczba całkowita | Wysokość wyświetlacza komputera. | Tak | |
| szerokość_wyświetlacza | liczba całkowita | Szerokość ekranu komputera. | Tak | |
| środowisko | wyliczenie | Typ środowiska komputera do sterowania. Możliwe wartości: windows, , maclinux, , ubuntubrowser |
Tak | |
| typ | wyliczenie | Typ narzędzia do użycia komputera. Zawsze computer_use_preview.Możliwe wartości: computer_use_preview |
Tak |
OpenAI.ConversationItemList
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane | macierz | Tak | ||
| first_id | ciąg | Tak | ||
| zawiera_więcej | typ logiczny (boolowski) | Tak | ||
| last_id | ciąg | Tak | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Tak |
OpenAI.ConversationResource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Tak | ||
| identyfikator | ciąg | Unikalny identyfikator rozmowy. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "konwersacją". Możliwe wartości: conversation |
Tak |
OpenAI.Coordinate
Para współrzędnych x/y, np. { x: 100, y: 200 }.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| x | liczba całkowita | Współrzędna x. | Tak | |
| y | liczba całkowita | Współrzędna y. | Tak |
OpenAI.CreateConversationRequest
Tworzenie konwersacji
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| items | macierz | Początkowe elementy do uwzględnienia kontekstu konwersacji. Jednocześnie możesz dodać maksymalnie 20 elementów. |
Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| wiadomości wejściowe | obiekt | Nie. | ||
| └item_reference | ciąg | Nie. | ||
| └─ szablon | macierz | Nie. | ||
| └typ | wyliczenie | Możliwe wartości: item_reference |
Nie. | |
| model | ciąg | Nazwa modelu do użycia do generowania uzupełniania (np. "o3-mini"). | Nie. | |
| parametry_próbowania | OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams | Nie. | ||
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └created_after | OpenAI.integer | Nie. | ||
| └created_before | OpenAI.integer | Nie. | ||
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └* limit | OpenAI.integer | Nie. | ||
| Metadane └* | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | Nie. | ||
| └typ | wyliczenie | Typ źródła. Zawsze stored_completions.Możliwe wartości: stored_completions |
Nie. | |
| typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze completions.Możliwe wartości: completions |
Tak |
OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesItemReference
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_reference | ciąg | Tak | ||
| typ | wyliczenie | Możliwe wartości: item_reference |
Tak |
OpenAI.CreateEvalCompletionsRunDataSourceInputMessagesTemplate
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| szablon | macierz | Tak | ||
| typ | wyliczenie | Możliwe wartości: template |
Tak |
OpenAI.CreateEvalCompletionsRunDataSourceSamplingParams
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| max_completion_tokens | OpenAI.integer | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| format_odpowiedzi | obiekt | Domyślny format odpowiedzi. Służy do generowania odpowiedzi tekstowych. | Nie. | |
| └json_schema | obiekt | Opcje konfiguracji danych wyjściowych ze strukturą, w tym schemat JSON. | Nie. | |
| 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. |
Nie. | |
| Schemat └* | obiekt | Nie. | ||
| └* ścisłe | typ logiczny (boolowski) | Czy włączyć ścisłe przestrzeganie schematu podczas generowania danych wyjściowych. W przypadku ustawienia wartości true model będzie zawsze przestrzegał dokładnego zdefiniowanego schematu W polu schema. Tylko podzbiór schematu JSON jest obsługiwany, gdyParametr strict ma wartość true. Aby dowiedzieć się więcej, przeczytaj ustrukturyzowane dane wyjścioweprzewodnik. |
Nie. | Nieprawda |
| └typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_object.Możliwe wartości: json_object |
Nie. | |
| seed | obiekt | Nie. | ||
| temperatura | obiekt | Nie. | ||
| narzędzia | macierz | Nie. | ||
| top_p | obiekt | Nie. |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| uwzględnij_przykładowy_schemat | typ logiczny (boolowski) | 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. | Tak | |
| typ | wyliczenie | Typ źródła danych. Zawsze custom.Możliwe wartości: custom |
Tak |
OpenAI.CreateEvalJsonlRunDataSource
Obiekt JsonlRunDataSource, który określa plik JSONL odpowiadający ewaluacji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Nie. | |
| typ | wyliczenie | Typ źródła danych. Zawsze jsonl.Możliwe wartości: jsonl |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 |
Tak |
OpenAI.CreateEvalResponsesRunDataSource
Obiekt ResponsesRunDataSource opisujący konfigurację próbkowania modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| wiadomości wejściowe | obiekt | Nie. | ||
| └item_reference | ciąg | Nie. | ||
| └─ szablon | macierz | Nie. | ||
| └typ | wyliczenie | Możliwe wartości: item_reference |
Nie. | |
| model | ciąg | Nazwa modelu do użycia do generowania uzupełniania (np. "o3-mini"). | Nie. | |
| parametry_próbowania | OpenAI.CreateEvalResponsesRunDataSourceSamplingParams | Nie. | ||
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └created_after | OpenAI.integer | Nie. | ||
| └created_before | OpenAI.integer | Nie. | ||
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └instructions_search | ciąg | Nie. | ||
| Metadane └* | obiekt | Nie. | ||
| Model └* | ciąg | Nie. | ||
| └reasoning_effort | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| └* temperatura | OpenAI.numeric | Nie. | ||
| └─ Narzędzia | macierz | Nie. | ||
| └─top_p | OpenAI.numeric | Nie. | ||
| └typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze responses.Możliwe wartości: responses |
Nie. | |
| Użytkownicy └* | macierz | Nie. | ||
| typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze responses.Możliwe wartości: responses |
Tak |
OpenAI.CreateEvalResponsesRunDataSourceInputMessagesItemReference
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_reference | ciąg | Tak | ||
| typ | wyliczenie | Możliwe wartości: item_reference |
Tak |
OpenAI.CreateEvalResponsesRunDataSourceInputMessagesTemplate
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| szablon | macierz | Tak | ||
| typ | wyliczenie | Możliwe wartości: template |
Tak |
OpenAI.CreateEvalResponsesRunDataSourceSamplingParams
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| max_completion_tokens | OpenAI.integer | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| seed | obiekt | Nie. | ||
| temperatura | obiekt | Nie. | ||
| SMS | OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText | Nie. | ||
| narzędzia | macierz | Nie. | ||
| top_p | obiekt | Nie. |
OpenAI.CreateEvalResponsesRunDataSourceSamplingParamsText
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| format | OpenAI.TextResponseFormatConfiguration | Obiekt określający format, który musi zostać wygenerowany przez model. Konfigurowanie { "type": "json_schema" } włącza dane wyjściowe ze strukturą,zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej w 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
Przestarzałe na rzecz logsDataSourceConfig.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 |
Tak |
OpenAI.CreateFineTuningJobRequest
Prawidłowe modele:
babbage-002
davinci-002
gpt-3.5-turbo
gpt-4o-mini
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| hiperparametry | obiekt | Hiperparametry używane do zadania dostrajania. Ta wartość jest teraz przestarzała na rzecz parametru methodi powinna zostać przekazana w parametrze method . |
Nie. | |
| └batch_size | wyliczenie | Możliwe wartości: auto |
Nie. | |
| └learning_rate_multiplier | wyliczenie | Możliwe wartości: auto |
Nie. | |
| └n_epochs | wyliczenie | Możliwe wartości: auto |
Nie. | |
| Integracje | macierz | Lista integracji umożliwiających dostrajanie zadania. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| seed | liczba całkowita | Nasiono kontroluje reproduktywność procesu. Przekazywanie tych samych parametrów nasion i zadania powinno generować te same wyniki, ale mogą się różnić w rzadkich przypadkach. Jeśli ziarno nie zostanie określone, zostanie wygenerowane dla Ciebie. |
Nie. | |
| przyrostek | ciąg | Ciąg zawierający maksymalnie 64 znaki, które zostaną dodane do precyzyjnej nazwy modelu. Na przykład wartość suffix "custom-model-name" spowoduje wygenerowanie nazwy modelu, takiej jak ft:gpt-4o-mini:openai:custom-model-name:7p4lURel. |
Nie. | Żaden |
| plik szkoleniowy | ciąg | Identyfikator przekazanego pliku zawierającego dane szkoleniowe. Zestaw danych musi być sformatowany jako plik JSONL. Ponadto należy przekazać 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 . |
Tak | |
| plik walidacji | ciąg | Identyfikator przekazanego pliku zawierającego dane walidacji. Jeśli podasz ten plik, dane są używane do generowania walidacji metryki okresowo podczas dostrajania. Te metryki można wyświetlić w programie plik wyników dostrajania. Te same dane nie powinny być obecne zarówno w plikach trenowania, jak i sprawdzania poprawności. 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.CreateFineTuningJobRequestIntegration
Dyskryminowanie dla elementu OpenAI.CreateFineTuningJobRequestIntegration
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
wandb |
OpenAI.CreateFineTuningJobRequestWandbIntegration |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg (zobacz prawidłowe modele poniżej) | Tak |
OpenAI.CreateFineTuningJobRequestWandbIntegration
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: wandb |
Tak | |
| wandb | obiekt | Tak | ||
| Jednostka └* | ciąg | Nie. | ||
| └─ nazwa | ciąg | Nie. | ||
| └* projekt | ciąg | Nie. | ||
| Tagi └* | macierz | Nie. |
OpenAI.CreateResponse
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agent | obiekt | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. | Nie. | |
| └typ | wyliczenie | Możliwe wartości: agent_reference |
Nie. | |
| └* wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| konwersacja | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| include | macierz | Określ dodatkowe dane wyjściowe do uwzględnienia w odpowiedzi modelu. Obecnie obsługiwane wartości to: - code_interpreter_call.outputs: zawiera dane wyjściowe wykonywania kodu w języku Pythonw elementy wywołania narzędzia interpretera kodu. - computer_call_output.output.image_url: dołącz adresy URL obrazów z wyników procesu komputerowego.- file_search_call.results: uwzględnij wyniki wyszukiwaniawywołanie narzędzia wyszukiwania plików. - message.input_image.image_url: dołącz adresy URL obrazów z komunikatu wejściowego.- message.output_text.logprobs: dołączanie logprobs z komunikatami asystenta.- reasoning.encrypted_content: zawiera zaszyfrowaną wersję rozumowaniatokeny w danych wyjściowych elementu rozumowania. Dzięki temu elementy rozumowania mogą być używane w programie konwersacje wieloetapowe przy bezstanowym korzystaniu z interfejsu API Odpowiedzi (na przykład gdy store parametr jest ustawiony na false lub gdy organizacja jestzapisane w programie nieprzechowywania żadnych danych). |
Nie. | |
| dane wejściowe | ciąg lub tablica | Nie. | ||
| instructions | ciąg | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| monit | obiekt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator szablonu monitu do użycia. | Nie. | |
| Zmienne └* | OpenAI.ResponsePromptVariables | Opcjonalna mapa wartości, które mają być zastępowane zmiennymi w monit. Wartości podstawienia mogą być ciągami lub innymi Typy danych wejściowych odpowiedzi, takie jak obrazy lub pliki. |
Nie. | |
| └* wersja | ciąg | Opcjonalna wersja szablonu monitu. | Nie. | |
| reasoning | obiekt |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └─ wysiłek | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| └─ generuj_podsumowanie | wyliczenie |
Przestarzałe: użyj summary zamiast. Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu.
autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. | |
| └─ Podsumowanie | wyliczenie | Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu. autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. | |
| poziom usługi | obiekt | Określa typ przetwarzania używany do obsługi żądania. * Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowane w ustawieniach programu Project. Jeśli nie skonfigurowano inaczej, projekt będzie używać wartości domyślnej. * Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardu ceny i wydajność wybranego modelu. * W przypadku ustawienia na wartość "flex" lub "priorytet", a następnie żądanie zostanie przetworzone z odpowiednią usługą kondygnacja. Skontaktuj się ze sprzedażą , aby dowiedzieć się więcej o przetwarzaniu priorytetu. * Jeśli nie ustawiono, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać wartość service_tierwartość oparta na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może się różnić od wartości ustawionej w parametrze . |
Nie. | |
| przechowywać | typ logiczny (boolowski) | Czy zapisać wygenerowaną odpowiedź modelu do późniejszego pobrania? API. |
Nie. | Prawda |
| odtwarzać strumieniowo | typ logiczny (boolowski) | W przypadku ustawienia wartości true dane odpowiedzi modelu będą przesyłane strumieniowo do klienta generowane przy użyciu zdarzeń wysyłanych przez serwer. aby uzyskać więcej informacji. |
Nie. | Nieprawda |
| 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 | Liczba | 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 | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| tool_choice | obiekt | 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 wiadomości a wykonywaniem połączeniawięcej narzędzi required oznacza, że model musi wywoływać co najmniej jedno narzędzie. |
Nie. | |
| └typ | OpenAI.ToolChoiceObjectType | Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach. |
Nie. | |
| narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: - Wbudowane narzędzia: narzędzia dostarczane przez firmę OpenAI, które rozszerzają możliwości modelu, takie jak wyszukiwanie plików. - Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. |
Nie. | |
| top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| top_p | Liczba | 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 |
| truncation | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. Możliwe wartości: auto, disabled |
Nie. | |
| użytkownik | ciąg | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. |
OpenAI.DeletedConversationResource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| usunięta | typ logiczny (boolowski) | Tak | ||
| identyfikator | ciąg | Tak | ||
| obiekt | wyliczenie | Możliwe wartości: conversation.deleted |
Tak |
OpenAI.EasyInputMessage
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg lub tablica | Tak | ||
| rola | ciąg | Tak |
OpenAI.Error
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dodatkoweInformacje | obiekt | Nie. | ||
| kod | ciąg | Tak | ||
| debugInfo (Informacje o debugu) | obiekt | Nie. | ||
| details | macierz | Nie. | ||
| komunikat | ciąg | Tak | ||
| param | ciąg | Tak | ||
| typ | ciąg | Tak |
OpenAI.EvalApiError
Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Kod błędu. | Tak | |
| komunikat | ciąg | Komunikat o błędzie. | Tak |
OpenAI.EvalGraderLabelModel
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane wejściowe | macierz | Tak | ||
| labels | macierz | Etykiety do przypisania do każdego elementu w ocenie. | Tak | |
| model | ciąg | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| przechodzące_etykiety | macierz | Etykiety wskazujące wynik pozytywny. Musi być podzbiorem etykiet. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: label_model |
Tak |
OpenAI.EvalGraderPython
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| image_tag | ciąg | Tag obrazu do użycia dla skryptu języka Python. | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| próg zaliczenia | obiekt | Nie. | ||
| przesłać źródło | ciąg | Kod źródłowy skryptu języka Python. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze python.Możliwe wartości: python |
Tak |
OpenAI.EvalGraderScoreModel
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane wejściowe | macierz | Tekst wejściowy. Może to obejmować ciągi szablonu. | Tak | |
| model | ciąg | Model do użycia do oceny. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| próg zaliczenia | obiekt | Nie. | ||
| zakres | macierz | Zakres wyniku Wartość domyślna to [0, 1]. |
Nie. | |
| parametry_próbowania | obiekt | Nie. | ||
| └max_completions_tokens | OpenAI.integer | Nie. | ||
| └reasoning_effort | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| └─ nasion | OpenAI.integer | Nie. | ||
| └* temperatura | OpenAI.numeric | Nie. | ||
| └─top_p | OpenAI.numeric | Nie. | ||
| typ | wyliczenie | Typ obiektu, który jest zawsze score_model.Możliwe wartości: score_model |
Tak |
OpenAI.EvalGraderScoreModelSamplingParams
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| max_completions_tokens | obiekt | Nie. | ||
| wysiłek rozumowania | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| seed | obiekt | Nie. | ||
| temperatura | obiekt | Nie. | ||
| top_p | obiekt | Nie. |
OpenAI.EvalGraderStringCheck
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane wejściowe | ciąg | Tekst wejściowy. Może to obejmować ciągi szablonu. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| operacja | wyliczenie | Operacja sprawdzania ciągów, którą należy wykonać.
eqJeden z , ne, likelub ilike.Możliwe wartości: eq, , ne, likeilike |
Tak | |
| odwołanie | ciąg | Tekst odwołania. Może to obejmować ciągi szablonu. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze string_check.Możliwe wartości: string_check |
Tak |
OpenAI.EvalGraderTextSimilarity
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 |
Tak | |
| dane wejściowe | ciąg | Tekst jest oceniany. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| próg zaliczenia | obiekt | Tak | ||
| odwołanie | ciąg | Tekst oceniany względem. | Tak | |
| typ | wyliczenie | Typ klasyra. Możliwe wartości: text_similarity |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | obiekt | Wprowadzanie tekstu do modelu. | Tak | |
| └─ dane | ciąg | Dane audio zakodowane w formacie Base64. | Nie. | |
| └* szczegóły | ciąg | Nie. | ||
| Format └─ | wyliczenie | Format danych audio. Obecnie obsługiwane formaty to mp3 iwav.Możliwe wartości: mp3, wav |
Nie. | |
| └image_url | ciąg | Nie. | ||
| └* tekst | ciąg | Nie. | ||
| └typ | wyliczenie | Typ elementu wejściowego. Zawsze input_audio.Możliwe wartości: input_audio |
Nie. | |
| rola | wyliczenie | Rola wejścia komunikatu.
userJeden z, assistant, system lubdeveloper.Możliwe wartości: user, , assistant, systemdeveloper |
Tak | |
| typ | wyliczenie | Typ danych wejściowych komunikatu. Zawsze message.Możliwe wartości: message |
Nie. |
OpenAI.EvalItemContentInputImage
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| detail | ciąg | Nie. | ||
| image_url | ciąg | Tak | ||
| typ | wyliczenie | Możliwe wartości: input_image |
Tak |
OpenAI.EvalItemContentOutputText
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| SMS | ciąg | Tak | ||
| typ | wyliczenie | Możliwe wartości: output_text |
Tak |
OpenAI.EvalJsonlFileContentSource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | macierz | Zawartość pliku jsonl. | Tak | |
| typ | wyliczenie | Typ źródła jsonl. Zawsze file_content.Możliwe wartości: file_content |
Tak |
OpenAI.EvalJsonlFileContentSourceContent
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| element | obiekt | Tak | ||
| próbka | obiekt | Nie. |
OpenAI.EvalJsonlFileIdSource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Identyfikator pliku. | Tak | |
| typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Tak |
OpenAI.EvalResponsesSource
Obiekt EvalResponsesSource opisujący konfigurację uruchamiania źródła danych.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| stworzone_po | obiekt | Nie. | ||
| utworzone_przed | obiekt | Nie. | ||
| instructions_search | ciąg | Nie. | ||
| metadane | obiekt | Nie. | ||
| model | ciąg | Nie. | ||
| wysiłek rozumowania | obiekt | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| temperatura | obiekt | Nie. | ||
| narzędzia | macierz | Nie. | ||
| top_p | obiekt | Nie. | ||
| typ | wyliczenie | Typ uruchomionego źródła danych. Zawsze responses.Możliwe wartości: responses |
Tak | |
| users | macierz | Nie. |
OpenAI.EvalRunOutputItemSample
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | OpenAI.EvalApiError | Obiekt reprezentujący odpowiedź o błędzie z interfejsu API Eval. | Tak | |
| powód zakończenia | ciąg | Tak | ||
| dane wejściowe | macierz | Tak | ||
| max_completion_tokens | OpenAI.integer | Tak | ||
| model | ciąg | Tak | ||
| We/Wy | macierz | Tak | ||
| seed | OpenAI.integer | Tak | ||
| temperatura | OpenAI.numeric | Tak | ||
| top_p | OpenAI.numeric | Tak | ||
| użycie | OpenAI.EvalRunOutputItemSampleUsage | Tak |
OpenAI.EvalRunOutputItemSampleInput
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg | Tak | ||
| rola | ciąg | Tak |
OpenAI.EvalRunOutputItemSampleOutput
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg | Nie. | ||
| rola | ciąg | Nie. |
OpenAI.EvalRunOutputItemSampleUsage
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Tak | ||
| completion_tokens | OpenAI.integer | Tak | ||
| prompt_tokens | OpenAI.integer | Tak | ||
| total_tokens | OpenAI.integer | Tak |
OpenAI.EvalRunPerModelUsage
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| cached_tokens | OpenAI.integer | Tak | ||
| completion_tokens | OpenAI.integer | Tak | ||
| invocation_count | OpenAI.integer | Tak | ||
| model_name | ciąg | Tak | ||
| prompt_tokens | OpenAI.integer | Tak | ||
| total_tokens | OpenAI.integer | Tak |
OpenAI.EvalRunPerTestingCriteriaResults
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| niepowodzenie | OpenAI.integer | Tak | ||
| Przekazywane | OpenAI.integer | Tak | ||
| kryteria_testowe | ciąg | Tak |
OpenAI.EvalRunResultCounts
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | OpenAI.integer | Tak | ||
| niepowodzenie | OpenAI.integer | Tak | ||
| Przekazywane | OpenAI.integer | Tak | ||
| łączny | OpenAI.integer | Tak |
OpenAI.EvalStoredCompletionsSource
Konfiguracja StoredCompletionsRunDataSource opisująca zestaw filtrów
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| stworzone_po | obiekt | Nie. | ||
| utworzone_przed | obiekt | Nie. | ||
| limit | obiekt | Nie. | ||
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | Nie. | ||
| typ | wyliczenie | Typ źródła. Zawsze stored_completions.Możliwe wartości: stored_completions |
Tak |
OpenAI.FileSearchTool
Narzędzie wyszukujące odpowiednią zawartość z przekazanych plików.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| filters | obiekt | Nie. | ||
| maks_liczba_wyników | liczba całkowita | Maksymalna liczba wyników do zwrócenia. Ta liczba powinna należeć do zakresu od 1 do 50 włącznie. | Nie. | |
| opcje rankingu | obiekt | Nie. | ||
| └} ranker | wyliczenie | Klasyfikator używany do wyszukiwania plików. Możliwe wartości: auto, default-2024-11-15 |
Nie. | |
| └─ próg_punktowy | Liczba | 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 |
Tak | |
| identyfikatory_sklepu_wektorów | macierz | Identyfikatory wektorów są przechowywane do wyszukiwania. | Tak |
OpenAI.FileSearchToolCallItemParam
Wyniki wywołania narzędzia wyszukiwania plików. Więcej informacji można znaleźć w przewodniku wyszukiwania plików .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| queries | macierz | Zapytania używane do wyszukiwania plików. | Tak | |
| results | macierz | Wyniki wywołania narzędzia wyszukiwania plików. | Nie. | |
| typ | wyliczenie | Możliwe wartości: file_search_call |
Tak |
OpenAI.FileSearchToolCallItemResource
Wyniki wywołania narzędzia wyszukiwania plików. Więcej informacji można znaleźć w przewodniku wyszukiwania plików .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| queries | macierz | Zapytania używane do wyszukiwania plików. | Tak | |
| results | macierz | Wyniki wywołania narzędzia wyszukiwania plików. | 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 |
Tak | |
| typ | wyliczenie | Możliwe wartości: file_search_call |
Tak |
OpenAI.Filters
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| filters | macierz | Tablica filtrów do połączenia. Elementy mogą mieć wartość ComparisonFilter lub CompoundFilter. |
Tak | |
| klucz | ciąg | Klucz do porównania z wartością. | Tak | |
| typ | wyliczenie | Typ operacji: and lub or.Możliwe wartości: and, or |
Tak | |
| wartość | ciąg lub liczba lub wartość logiczna | Wartość do porównania z kluczem atrybutu; obsługuje typy ciągów, liczb lub wartości logicznych. | Tak |
OpenAI.FineTuneDPOHyperparameters
Hiperparametry używane do zadania dostrajania obiektu DPO.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rozmiar partii | wyliczenie | Możliwe wartości: auto |
Nie. | |
| wersja beta | wyliczenie | Możliwe wartości: auto |
Nie. | |
| mnożnik szybkości uczenia | wyliczenie | Możliwe wartości: auto |
Nie. | |
| n_epochs (liczba epok) | wyliczenie | Możliwe wartości: auto |
Nie. |
OpenAI.FineTuneDPOMethod
Konfiguracja metody dostrajania obiektu DPO.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| hiperparametry | OpenAI.FineTuneDPOHyperparameters | Hiperparametry używane do zadania dostrajania obiektu DPO. | Nie. |
OpenAI.FineTuneMethod
Metoda używana do dostrajania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dpo | OpenAI.FineTuneDPOMethod | Konfiguracja metody dostrajania obiektu DPO. | Nie. | |
| Zbrojenia | 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 |
Tak |
OpenAI.FineTuneReinforcementHyperparameters
Hiperparametry używane do zadania dostrajania wzmocnienia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rozmiar partii | wyliczenie | Możliwe wartości: auto |
Nie. | |
| compute_multiplier | wyliczenie | Możliwe wartości: auto |
Nie. | |
| eval_interval | wyliczenie | Możliwe wartości: auto |
Nie. | |
| eval_samples | wyliczenie | Możliwe wartości: auto |
Nie. | |
| mnożnik szybkości uczenia | wyliczenie | Możliwe wartości: auto |
Nie. | |
| n_epochs (liczba epok) | wyliczenie | Możliwe wartości: auto |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| Równiarka | obiekt | Obiekt StringCheckGrader, który wykonuje porównanie ciągów między danymi wejściowymi i odwołaniami przy użyciu określonej operacji. | Tak | |
| └calculate_output | ciąg | Formuła do obliczenia danych wyjściowych na podstawie wyników klasyra. | Nie. | |
| └evaluation_metric | 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 |
Nie. | |
| └* klasy | OpenAI.GraderStringCheck lub OpenAI.GraderTextSimilarity lub OpenAI.GraderPython lub OpenAI.GraderScoreModel lub OpenAI.GraderLabelModel | Obiekt StringCheckGrader, który wykonuje porównanie ciągów między danymi wejściowymi i odwołaniami przy użyciu określonej operacji. | Nie. | |
| └image_tag | ciąg | Tag obrazu do użycia dla skryptu języka Python. | Nie. | |
| └─ Wejście | macierz | Tekst wejściowy. Może to obejmować ciągi szablonu. | Nie. | |
| Model └* | ciąg | Model do użycia do oceny. | Nie. | |
| └─ nazwa | ciąg | Nazwa oceniającego. | Nie. | |
| Operacja └* | wyliczenie | Operacja sprawdzania ciągów, którą należy wykonać.
eqJeden z , ne, likelub ilike.Możliwe wartości: eq, , ne, likeilike |
Nie. | |
| Zakres └* | macierz | Zakres wyniku Wartość domyślna to [0, 1]. |
Nie. | |
| └— odwołanie | ciąg | Tekst oceniany względem. | Nie. | |
| └parametry_próbkowania | OpenAI.EvalGraderScoreModelSamplingParams | Parametry próbkowania dla modelu. | Nie. | |
| └— źródło | ciąg | Kod źródłowy skryptu języka Python. | Nie. | |
| └typ | wyliczenie | Typ obiektu, który jest zawsze multi.Możliwe wartości: multi |
Nie. | |
| hiperparametry | OpenAI.FineTuneReinforcementHyperparameters | Hiperparametry używane do zadania dostrajania wzmocnienia. | Nie. |
OpenAI.FineTuneSupervisedHyperparameters
Hiperparametry używane do zadania dostrajania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rozmiar partii | wyliczenie | Możliwe wartości: auto |
Nie. | |
| mnożnik szybkości uczenia | wyliczenie | Możliwe wartości: auto |
Nie. | |
| n_epochs (liczba epok) | wyliczenie | Możliwe wartości: auto |
Nie. |
OpenAI.FineTuneSupervisedMethod
Konfiguracja nadzorowanej metody dostrajania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| hiperparametry | OpenAI.FineTuneSupervisedHyperparameters | Hiperparametry używane do zadania dostrajania. | Nie. |
OpenAI.FineTuningIntegration
Dyskryminowanie dla openAI.FineTuningIntegration
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
wandb |
OpenAI.FineTuningIntegrationWandb |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg (zobacz prawidłowe modele poniżej) | Tak |
OpenAI.FineTuningIntegrationWandb
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ włączonej integracji dla zadania dostrajania Możliwe wartości: wandb |
Tak | |
| wandb | obiekt | Ustawienia integracji z wagami i uprzedzeniami. Ten ładunek określa projekt, który metryki zostaną wysłane do. Opcjonalnie możesz ustawić jawną nazwę wyświetlaną przebiegu, dodać tagi na przebieg i ustaw domyślną jednostkę (zespół, nazwę użytkownika itp.), która ma być skojarzona z przebiegiem. |
Tak | |
| Jednostka └* | ciąg | Jednostka do użycia na potrzeby przebiegu. Dzięki temu możesz ustawić zespół lub nazwę użytkownika platformy WandB, którego chcesz uruchomić podobnie jak skojarzone z przebiegiem. Jeśli nie zostanie ustawiona, zostanie użyta domyślna jednostka zarejestrowanego klucza interfejsu API WandB. |
Nie. | |
| └─ nazwa | ciąg | Nazwa wyświetlana ustawiona dla przebiegu. Jeśli nie zostanie ustawiona, użyjemy identyfikatora zadania jako nazwy. | Nie. | |
| └* projekt | ciąg | Nazwa projektu, w ramach którego zostanie utworzone nowe uruchomienie. | Nie. | |
| Tagi └* | macierz | Lista tagów do dołączenia do nowo utworzonego przebiegu. Te tagi są przekazywane bezpośrednio do usługi WandB. Some tagi domyślne są generowane przez interfejs OpenAI: "openai/finetune", "openai/{base-model}", "openai/{ftjob-abcdef}". |
Nie. |
OpenAI.FineTuningJob
Obiekt fine_tuning.job reprezentuje zadanie dostrajania, które zostało utworzone za pośrednictwem interfejsu API.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu utworzenia zadania dostrajania. | Tak | |
| błąd | obiekt | W przypadku zadań dostrajania, które mają failedparametr , będzie to zawierać więcej informacji na temat przyczyny awarii. |
Tak | |
| └─ kod | ciąg | Kod błędu czytelny dla maszyny. | Nie. | |
| └─ Komunikat | ciąg | Czytelny dla człowieka komunikat o błędzie. | Nie. | |
| └* param | ciąg | Parametr, który był nieprawidłowy, zwykle training_file lub validation_file. To pole będzie miało wartość null, jeśli błąd nie był specyficzny dla parametru. |
Nie. | |
| szacowany czas zakończenia | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu zakończenia zadania dostrajania. Wartość będzie mieć wartość null, jeśli zadanie dostrajania szczegółowego nie jest uruchomione. | Nie. | |
| fine_tuned_model | ciąg | Nazwa tworzonego modelu. Wartość będzie mieć wartość null, jeśli zadanie dostrajania jest nadal uruchomione. | Tak | |
| zakończono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu zakończenia zadania dostrajania. Wartość będzie mieć wartość null, jeśli zadanie dostrajania jest nadal uruchomione. | Tak | |
| hiperparametry | obiekt | Hiperparametry używane do zadania dostrajania. Ta wartość zostanie zwrócona tylko podczas uruchamiania supervised zadań. |
Tak | |
| └batch_size | wyliczenie | Możliwe wartości: auto |
Nie. | |
| └learning_rate_multiplier | wyliczenie | Możliwe wartości: auto |
Nie. | |
| └n_epochs | wyliczenie | Możliwe wartości: auto |
Nie. | |
| identyfikator | ciąg | Identyfikator obiektu, do którego można odwoływać się w punktach końcowych interfejsu API. | Tak | |
| Integracje | macierz | Lista integracji umożliwiających wykonanie tego zadania dostrajania. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| metoda | OpenAI.FineTuneMethod | Metoda używana do dostrajania. | Nie. | |
| model | ciąg | Model podstawowy, który jest dostrojony. | Tak | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "fine_tuning.job". Możliwe wartości: fine_tuning.job |
Tak | |
| organization_id | ciąg | Organizacja, która jest właścicielem zadania dostrajania. | Tak | |
| pliki_wynikowe | macierz | Skompilowane identyfikatory plików wyników dla zadania dostrajania. Wyniki można pobrać za pomocą interfejsu API plików. | Tak | |
| seed | liczba całkowita | Nasiono używane do działania dostrajania. | Tak | |
| stan | wyliczenie | Bieżący stan zadania dostrajania, które może mieć validating_fileswartość , , queued, running, succeeded, failedlub cancelled.Możliwe wartości: validating_files, , queuedrunning, succeeded, , failedcancelled |
Tak | |
| tokeny szkoleniowe | liczba całkowita | Łączna liczba rozliczanych tokenów przetworzonych przez to zadanie dostrajania. Wartość będzie mieć wartość null, jeśli zadanie dostrajania jest nadal uruchomione. | Tak | |
| plik szkoleniowy | ciąg | Identyfikator pliku używany do trenowania. Dane szkoleniowe można pobrać za pomocą interfejsu API plików. | Tak | |
| user_provided_suffix | ciąg | Sufiks opisowy zastosowany do zadania, jak określono w żądaniu tworzenia zadania. | Nie. | |
| plik walidacji | ciąg | Identyfikator pliku używany do walidacji. Wyniki weryfikacji można pobrać za pomocą interfejsu API plików. | Tak |
OpenAI.FineTuningJobCheckpoint
Obiekt fine_tuning.job.checkpoint reprezentuje punkt kontrolny modelu dla zadania dostrajania, które jest gotowe do użycia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu utworzenia punktu kontrolnego. | Tak | |
| punkt kontrolny modelu dostrojonego | ciąg | Nazwa utworzonego modelu punktów kontrolnych. | Tak | |
| identyfikator_zadania_dostrajania | ciąg | Nazwa zadania dostrajania, na podstawie którego utworzono ten punkt kontrolny. | Tak | |
| identyfikator | ciąg | Identyfikator punktu kontrolnego, do którego można odwoływać się w punktach końcowych interfejsu API. | Tak | |
| metryki | obiekt | Metryki w numerze kroku podczas zadania dostrajania. | Tak | |
| └full_valid_loss | Liczba | Nie. | ||
| └full_valid_mean_token_accuracy | Liczba | Nie. | ||
| Krok └* | Liczba | Nie. | ||
| └train_loss | Liczba | Nie. | ||
| └train_mean_token_accuracy | Liczba | Nie. | ||
| └valid_loss | Liczba | Nie. | ||
| └valid_mean_token_accuracy | Liczba | Nie. | ||
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "fine_tuning.job.checkpoint". Możliwe wartości: fine_tuning.job.checkpoint |
Tak | |
| numer_kroku | liczba całkowita | Numer kroku, na który został utworzony punkt kontrolny. | Tak |
OpenAI.FineTuningJobEvent
Obiekt zdarzenia zadania dostrajania
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) dla momentu utworzenia zadania dostrajania. | Tak | |
| dane | Dane skojarzone ze zdarzeniem. | Nie. | ||
| identyfikator | ciąg | Identyfikator obiektu. | Tak | |
| poziom | wyliczenie | Poziom dziennika zdarzenia. Możliwe wartości: info, , warnerror |
Tak | |
| komunikat | ciąg | Komunikat zdarzenia. | Tak | |
| obiekt | wyliczenie | Typ obiektu, który jest zawsze "fine_tuning.job.event". Możliwe wartości: fine_tuning.job.event |
Tak | |
| typ | wyliczenie | Typ zdarzenia. Możliwe wartości: message, metrics |
Nie. |
OpenAI.FunctionObject
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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. | Tak | |
| parametry | 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 | typ logiczny (boolowski) | Czy włączyć ścisłe przestrzeganie schematu podczas generowania wywołania funkcji. Jeśli ustawiono wartość true, model będzie postępować zgodnie z dokładnym schematem zdefiniowanym parameters w polu. Tylko podzbiór schematu JSON jest obsługiwany, gdy strict ma wartość true. Dowiedz się więcej o danych wyjściowych ze strukturą w |
Nie. | Nieprawda |
OpenAI.FunctionTool
Definiuje funkcję w swoim kodzie, którą model może wywołać.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis funkcji. Używany przez model do określania, czy wywołać funkcję. | Nie. | |
| nazwa | ciąg | Nazwa funkcji do wywołania. | Tak | |
| parametry | Obiekt schematu JSON opisujący parametry funkcji. | Tak | ||
| surowy | typ logiczny (boolowski) | Czy wymusić ścisłą walidację parametrów. Wartość domyślna true. |
Tak | |
| typ | wyliczenie | Typ narzędzia funkcji. Zawsze function.Możliwe wartości: function |
Tak |
OpenAI.FunctionToolCallItemParam
Wywołanie narzędzia w celu uruchomienia funkcji. Aby uzyskać więcej informacji, zobacz przewodnik wywoływania funkcji .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Tak | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Tak | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Tak | |
| typ | wyliczenie | Możliwe wartości: function_call |
Tak |
OpenAI.FunctionToolCallItemResource
Wywołanie narzędzia w celu uruchomienia funkcji. Aby uzyskać więcej informacji, zobacz przewodnik wywoływania funkcji .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Łańcuch JSON zawierający argumenty do przekazania do funkcji. | Tak | |
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Tak | |
| nazwa | ciąg | Nazwa funkcji do uruchomienia. | Tak | |
| 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 |
Tak | |
| typ | wyliczenie | Możliwe wartości: function_call |
Tak |
OpenAI.FunctionToolCallOutputItemParam
Dane wyjściowe wywołania narzędzia funkcji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Tak | |
| We/Wy | ciąg | Ciąg JSON zawierający dane wyjściowe z wywołania narzędzia funkcji. | Tak | |
| typ | wyliczenie | Możliwe wartości: function_call_output |
Tak |
OpenAI.FunctionToolCallOutputItemResource
Dane wyjściowe wywołania narzędzia funkcji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| call_id | ciąg | Unikalny identyfikator wywołania funkcji narzędzia wygenerowany przez model. | Tak | |
| We/Wy | ciąg | Ciąg JSON zawierający dane wyjściowe z wywołania narzędzia funkcji. | Tak | |
| 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 |
Tak | |
| typ | wyliczenie | Możliwe wartości: function_call_output |
Tak |
OpenAI.GraderLabelModel
Obiekt LabelModelGrader, który używa modelu do przypisywania etykiet do każdego elementu w ocenie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane wejściowe | macierz | Tak | ||
| labels | macierz | Etykiety do przypisania do każdego elementu w ocenie. | Tak | |
| model | ciąg | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| przechodzące_etykiety | macierz | Etykiety wskazujące wynik pozytywny. Musi być podzbiorem etykiet. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: label_model |
Tak |
OpenAI.GraderMulti
Obiekt MultiGrader łączy dane wyjściowe wielu klasykatorów w celu utworzenia pojedynczego wyniku.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| calculate_output | ciąg | Formuła do obliczenia danych wyjściowych na podstawie wyników klasyra. | Tak | |
| Równiarki | obiekt | Obiekt StringCheckGrader, który wykonuje porównanie ciągów między danymi wejściowymi i odwołaniami przy użyciu określonej operacji. | Tak | |
| └evaluation_metric | 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 |
Nie. | |
| └image_tag | ciąg | Tag obrazu do użycia dla skryptu języka Python. | Nie. | |
| └─ Wejście | macierz | Nie. | ||
| Etykiety └* | macierz | Etykiety do przypisania do każdego elementu w ocenie. | Nie. | |
| Model └* | ciąg | Model do użycia do oceny. Musi obsługiwać dane wyjściowe ze strukturą. | Nie. | |
| └─ nazwa | ciąg | Nazwa oceniającego. | Nie. | |
| Operacja └* | wyliczenie | Operacja sprawdzania ciągów, którą należy wykonać.
eqJeden z , ne, likelub ilike.Możliwe wartości: eq, , ne, likeilike |
Nie. | |
| └passing_labels | macierz | Etykiety wskazujące wynik pozytywny. Musi być podzbiorem etykiet. | Nie. | |
| Zakres └* | macierz | Zakres wyniku Wartość domyślna to [0, 1]. |
Nie. | |
| └— odwołanie | ciąg | Tekst oceniany względem. | Nie. | |
| └parametry_próbkowania | OpenAI.EvalGraderScoreModelSamplingParams | Parametry próbkowania dla modelu. | Nie. | |
| └— źródło | ciąg | Kod źródłowy skryptu języka Python. | Nie. | |
| └typ | wyliczenie | Typ obiektu, który jest zawsze label_model.Możliwe wartości: label_model |
Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze multi.Możliwe wartości: multi |
Tak |
OpenAI.GraderPython
Obiekt PythonGrader, który uruchamia skrypt języka Python na danych wejściowych.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| image_tag | ciąg | Tag obrazu do użycia dla skryptu języka Python. | Nie. | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| przesłać źródło | ciąg | Kod źródłowy skryptu języka Python. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze python.Możliwe wartości: python |
Tak |
OpenAI.GraderScoreModel
Obiekt ScoreModelGrader, który używa modelu do przypisania wyniku do danych wejściowych.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane wejściowe | macierz | Tekst wejściowy. Może to obejmować ciągi szablonu. | Tak | |
| model | ciąg | Model do użycia do oceny. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| zakres | macierz | Zakres wyniku Wartość domyślna to [0, 1]. |
Nie. | |
| parametry_próbowania | obiekt | Nie. | ||
| └max_completions_tokens | OpenAI.integer | Nie. | ||
| └reasoning_effort | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| └─ nasion | OpenAI.integer | Nie. | ||
| └* temperatura | OpenAI.numeric | Nie. | ||
| └─top_p | OpenAI.numeric | Nie. | ||
| typ | wyliczenie | Typ obiektu, który jest zawsze score_model.Możliwe wartości: score_model |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane wejściowe | ciąg | Tekst wejściowy. Może to obejmować ciągi szablonu. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| operacja | wyliczenie | Operacja sprawdzania ciągów, którą należy wykonać.
eqJeden z , ne, likelub ilike.Możliwe wartości: eq, , ne, likeilike |
Tak | |
| odwołanie | ciąg | Tekst odwołania. Może to obejmować ciągi szablonu. | Tak | |
| typ | wyliczenie | Typ obiektu, który jest zawsze string_check.Możliwe wartości: string_check |
Tak |
OpenAI.GraderTextSimilarity
Obiekt TextSimilarityGrader, który klasyfikuje tekst na podstawie metryk podobieństwa.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 |
Tak | |
| dane wejściowe | ciąg | Tekst jest oceniany. | Tak | |
| nazwa | ciąg | Nazwa oceniającego. | Tak | |
| odwołanie | ciąg | Tekst oceniany względem. | Tak | |
| typ | wyliczenie | Typ klasyra. Możliwe wartości: text_similarity |
Tak |
OpenAI.ImageGenTool
Narzędzie, które generuje obrazy przy użyciu modelu, takiego jak gpt-image-1.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| tło | wyliczenie | Typ tła wygenerowanego obrazu. Jeden z transparentopaquelub auto. Wartość domyślna: auto.Możliwe wartości: transparent, , opaqueauto |
Nie. | |
| maska_wprowadzania_obrazu | obiekt | Opcjonalna maska do inpaintingu. Zawiera image_url(ciąg, opcjonalny) i file_id (ciąg, opcjonalny). |
Nie. | |
| └ file_id | ciąg | Identyfikator pliku dla obrazu maski. | Nie. | |
| └image_url | ciąg | Obraz maski zakodowanej w formacie Base64. | Nie. | |
| model | wyliczenie | Model generowania obrazów do użycia. Wartość domyślna: gpt-image-1.Możliwe wartości: gpt-image-1 |
Nie. | |
| moderation | wyliczenie | Poziom moderowania wygenerowanego obrazu. Wartość domyślna: auto.Możliwe wartości: auto, low |
Nie. | |
| kompresja wyjściowa | liczba całkowita | Poziom kompresji obrazu wyjściowego. Wartość domyślna: 100. | 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 | liczba całkowita | Liczba częściowych obrazów do wygenerowania w trybie przesyłania strumieniowego z zakresu od 0 (wartość domyślna) do 3. | Nie. | 0 |
| jakość | wyliczenie | Jakość wygenerowanego obrazu. Jeden z low, , medium, , highlub auto. Wartość domyślna: auto.Możliwe wartości: low, , medium, highauto |
Nie. | |
| rozmiar | 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 |
Tak |
OpenAI.ImageGenToolCallItemParam
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| wynik | ciąg | Wygenerowany obraz zakodowany w formacie base64. | Tak | |
| typ | wyliczenie | Możliwe wartości: image_generation_call |
Tak |
OpenAI.ImageGenToolCallItemResource
Żądanie generowania obrazu wykonane przez model.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| wynik | ciąg | Wygenerowany obraz zakodowany w formacie base64. | Tak | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completed, generatingfailed |
Tak | |
| typ | wyliczenie | Możliwe wartości: image_generation_call |
Tak |
OpenAI.Includable
Określ dodatkowe dane wyjściowe do uwzględnienia w odpowiedzi modelu. Obecnie obsługiwane wartości to:
-
code_interpreter_call.outputs: zawiera dane wyjściowe wykonywania kodu języka Python w elementach wywołania 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łączanie logprobs z komunikatami 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).
| Majątek | Wartość |
|---|---|
| Opis | Określ dodatkowe dane wyjściowe do uwzględnienia w odpowiedzi modelu. Obecnie obsługiwane wartości to: - code_interpreter_call.outputs: zawiera dane wyjściowe wykonywania kodu w języku Pythonw elementy wywołania narzędzia interpretera kodu. - computer_call_output.output.image_url: dołącz adresy URL obrazów z wyników procesu komputerowego.- file_search_call.results: uwzględnij wyniki wyszukiwaniawywołanie narzędzia wyszukiwania plików. - message.input_image.image_url: dołącz adresy URL obrazów z komunikatu wejściowego.- message.output_text.logprobs: dołączanie logprobs z komunikatami asystenta.- reasoning.encrypted_content: zawiera zaszyfrowaną wersję rozumowaniatokeny w danych wyjściowych elementu rozumowania. Dzięki temu elementy rozumowania mogą być używane w programie konwersacje wieloetapowe przy bezstanowym korzystaniu z interfejsu API Odpowiedzi (na przykład gdy store parametr jest ustawiony na false lub gdy organizacja jestzapisane w programie nieprzechowywania żadnych danych). |
| Typ | ciąg |
| Wartości | code_interpreter_call.outputscomputer_call_output.output.image_urlfile_search_call.resultsmessage.input_image.image_urlmessage.output_text.logprobsreasoning.encrypted_contentweb_search_call.resultsweb_search_call.action.sourcesmemory_search_call.results |
OpenAI.ItemContent
Dyskryminujący element OpenAI.ItemContent
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
input_audio |
OpenAI.ItemContentInputAudio |
output_audio |
OpenAI.ItemContentOutputAudio |
refusal |
OpenAI.ItemContentRefusal |
input_text |
OpenAI.ItemContentInputText |
input_image |
OpenAI.ItemContentInputImage |
input_file |
OpenAI.ItemContentInputFile |
output_text |
OpenAI.ItemContentOutputText |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ItemContentType | Zawartość danych wejściowych i wyjściowych wielomodalnych. | Tak |
OpenAI.ItemContentInputAudio
Dane audio jako wejście do modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane | ciąg | Dane audio zakodowane w formacie Base64. | Tak | |
| format | wyliczenie | Format danych audio. Obecnie obsługiwane formaty to mp3 iwav.Możliwe wartości: mp3, wav |
Tak | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_audio.Możliwe wartości: input_audio |
Tak |
OpenAI.ItemContentInputFile
Plik wejściowy do modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| file_data | ciąg | Zawartość pliku, który ma zostać wysłany do modelu. | Nie. | |
| identyfikator_pliku | ciąg | Identyfikator 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 |
Tak |
OpenAI.ItemContentInputImage
Dane wejściowe obrazu do modelu. Dowiedz się więcej o danych wejściowych obrazu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| detail | wyliczenie | Poziom szczegółowości obrazu, który ma zostać wysłany do modelu.
highJeden z , lowlub auto. Wartość domyślna to auto.Możliwe wartości: low, , highauto |
Nie. | |
| identyfikator_pliku | ciąg | Identyfikator pliku, który ma zostać wysłany do modelu. | Nie. | |
| image_url | ciąg | Adres URL obrazu, który ma zostać wysłany do modelu. W pełni kwalifikowany adres URL lub obraz zakodowany w formacie base64 w adresie URL danych. | Nie. | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_image.Możliwe wartości: input_image |
Tak |
OpenAI.ItemContentInputText
Wprowadzanie tekstu do modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| SMS | ciąg | Wprowadzanie tekstu do modelu. | Tak | |
| typ | wyliczenie | Typ elementu wejściowego. Zawsze input_text.Możliwe wartości: input_text |
Tak |
OpenAI.ItemContentOutputAudio
Sygnał wyjściowy audio z modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane | ciąg | Dane audio zakodowane w formacie Base64 z modelu. | Tak | |
| transkrypcja | ciąg | Transkrypcja danych audio z modelu. | Tak | |
| typ | wyliczenie | Typ dźwięku wyjściowego. Zawsze output_audio.Możliwe wartości: output_audio |
Tak |
OpenAI.ItemContentOutputText
Dane wyjściowe tekstowe z modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Adnotacje | macierz | Adnotacje tekstu wyjściowego. | Tak | |
| logprobs | macierz | Nie. | ||
| SMS | ciąg | Dane wyjściowe tekstu z modelu. | Tak | |
| typ | wyliczenie | Typ tekstu wyjściowego. Zawsze output_text.Możliwe wartości: output_text |
Tak |
OpenAI.ItemContentRefusal
Odmowa ze strony modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| refusal | ciąg | Wyjaśnienie odmowy z modelu. | Tak | |
| typ | wyliczenie | Rodzaj odmowy. Zawsze refusal.Możliwe wartości: refusal |
Tak |
OpenAI.ItemContentType
Zawartość danych wejściowych i wyjściowych wielomodalnych.
| Majątek | Wartość |
|---|---|
| Opis | Zawartość danych wejściowych i wyjściowych wielomodalnych. |
| Typ | ciąg |
| Wartości | input_textinput_audioinput_imageinput_fileoutput_textoutput_audiorefusal |
OpenAI.ItemParam
Element zawartości używany do generowania odpowiedzi.
Dyskryminator dla OpenAI.ItemParam
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
message |
OpenAI.ResponsesMessageItemParam |
function_call_output |
OpenAI.FunctionToolCallOutputItemParam |
file_search_call |
OpenAI.FileSearchToolCallItemParam |
computer_call |
OpenAI.ComputerToolCallItemParam |
computer_call_output |
OpenAI.ComputerToolCallOutputItemParam |
web_search_call |
OpenAI.WebSearchToolCallItemParam |
function_call |
OpenAI.FunctionToolCallItemParam |
reasoning |
OpenAI.ReasoningItemParam |
item_reference |
OpenAI.ItemReferenceItemParam |
image_generation_call |
OpenAI.ImageGenToolCallItemParam |
code_interpreter_call |
OpenAI.CodeInterpreterToolCallItemParam |
local_shell_call |
OpenAI.LocalShellToolCallItemParam |
local_shell_call_output |
OpenAI.LocalShellToolCallOutputItemParam |
mcp_list_tools |
OpenAI.MCPListToolsItemParam |
mcp_approval_request |
OpenAI.MCPApprovalRequestItemParam |
mcp_approval_response |
OpenAI.MCPApprovalResponseItemParam |
mcp_call |
OpenAI.MCPCallItemParam |
memory_search_call |
MemorySearchToolCallItemParam |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ItemType | Tak |
OpenAI.ItemReferenceItemParam
Wewnętrzny identyfikator elementu do celów odniesienia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Identyfikator pochodzący z usługi wcześniej wygenerowanego elementu odpowiedzi, do którego się odnosi. | Tak | |
| typ | wyliczenie | Możliwe wartości: item_reference |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| utworzone_przez | obiekt | Nie. | ||
| └* agent | Identyfikator agenta | Agent, który utworzył element. | Nie. | |
| └response_id | ciąg | Odpowiedź, na której jest tworzony element. | Nie. | |
| identyfikator | ciąg | Tak | ||
| typ | OpenAI.ItemType | Tak |
OpenAI.ItemType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | messagefile_search_callfunction_callfunction_call_outputcomputer_callcomputer_call_outputweb_search_callreasoningitem_referenceimage_generation_callcode_interpreter_calllocal_shell_calllocal_shell_call_outputmcp_list_toolsmcp_approval_requestmcp_approval_responsemcp_callstructured_outputsworkflow_actionmemory_search_calloauth_consent_request |
OpenAI.ListFineTuningJobCheckpointsResponse
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane | macierz | Tak | ||
| first_id | ciąg | Nie. | ||
| zawiera_więcej | typ logiczny (boolowski) | Tak | ||
| last_id | ciąg | Nie. | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Tak |
OpenAI.ListFineTuningJobEventsResponse
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane | macierz | Tak | ||
| zawiera_więcej | typ logiczny (boolowski) | Tak | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Tak |
OpenAI.ListPaginatedFineTuningJobsResponse
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dane | macierz | Tak | ||
| zawiera_więcej | typ logiczny (boolowski) | Tak | ||
| obiekt | wyliczenie | Możliwe wartości: list |
Tak |
OpenAI.LocalShellExecAction
Wykonaj polecenie powłoki na serwerze.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| polecenie | macierz | Polecenie do uruchomienia. | Tak | |
| środowisko | obiekt | Zmienne środowiskowe do ustawienia dla polecenia . | Tak | |
| limit_czasu_ms | liczba całkowita | Opcjonalny limit czasu w milisekundach dla polecenia. | Nie. | |
| typ | wyliczenie | Typ akcji powłoki lokalnej. Zawsze exec.Możliwe wartości: exec |
Tak | |
| użytkownik | ciąg | Opcjonalny użytkownik, aby uruchomić polecenie jako. | Nie. | |
| working_directory | ciąg | Opcjonalny katalog roboczy do uruchomienia polecenia w programie . | Nie. |
OpenAI.LocalShellTool
Narzędzie, które umożliwia modelowi wykonywanie poleceń powłoki w środowisku lokalnym.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ lokalnego narzędzia powłoki. Zawsze local_shell.Możliwe wartości: local_shell |
Tak |
OpenAI.LocalShellToolCallItemParam
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Tak | |
| call_id | ciąg | Unikatowy identyfikator wywołania lokalnego narzędzia powłoki wygenerowanego przez model. | Tak | |
| typ | wyliczenie | Możliwe wartości: local_shell_call |
Tak |
OpenAI.LocalShellToolCallItemResource
Wywołanie narzędzia w celu uruchomienia polecenia w lokalnej powłoce.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | OpenAI.LocalShellExecAction | Wykonaj polecenie powłoki na serwerze. | Tak | |
| call_id | ciąg | Unikatowy identyfikator wywołania lokalnego narzędzia powłoki wygenerowanego przez model. | Tak | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete |
Tak | |
| typ | wyliczenie | Możliwe wartości: local_shell_call |
Tak |
OpenAI.LocalShellToolCallOutputItemParam
Dane wyjściowe lokalnego wywołania narzędzia powłoki.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| We/Wy | ciąg | Ciąg JSON danych wyjściowych wywołania lokalnego narzędzia powłoki. | Tak | |
| typ | wyliczenie | Możliwe wartości: local_shell_call_output |
Tak |
OpenAI.LocalShellToolCallOutputItemResource
Dane wyjściowe lokalnego wywołania narzędzia powłoki.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| We/Wy | ciąg | Ciąg JSON danych wyjściowych wywołania lokalnego narzędzia powłoki. | Tak | |
| stan | wyliczenie | Możliwe wartości: in_progress, , completedincomplete |
Tak | |
| typ | wyliczenie | Możliwe wartości: local_shell_call_output |
Tak |
OpenAI.Location
Dyskryminator dla OpenAI.Location
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
approximate |
OpenAI.ApproximateLocation |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.LocationType | Tak |
OpenAI.TypLokalizacji
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | approximate |
OpenAI.LogProb
Prawdopodobieństwo dziennika tokenu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| bytes | macierz | Tak | ||
| logprob | Liczba | Tak | ||
| kod przedpłaty | ciąg | Tak | ||
| top_logprobs | macierz | Tak |
OpenAI.MCPApprovalRequestItemParam
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Tak | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Tak | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Tak | |
| typ | wyliczenie | Możliwe wartości: mcp_approval_request |
Tak |
OpenAI.MCPApprovalRequestItemResource
Wniosek o zatwierdzenie przez człowieka wywołania narzędzia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów dla narzędzia. | Tak | |
| nazwa | ciąg | Nazwa narzędzia do uruchomienia. | Tak | |
| etykieta_serwera | ciąg | Etykieta serwera MCP wysyłającego żądanie. | Tak | |
| typ | wyliczenie | Możliwe wartości: mcp_approval_request |
Tak |
OpenAI.MCPApprovalResponseItemParam
Odpowiedź na żądanie zatwierdzenia MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| approval_request_id | ciąg | Identyfikator odpowiedzi na żądanie zatwierdzenia. | Tak | |
| approve | typ logiczny (boolowski) | Czy żądanie zostało zatwierdzone. | Tak | |
| powód | ciąg | Opcjonalna przyczyna decyzji. | Nie. | |
| typ | wyliczenie | Możliwe wartości: mcp_approval_response |
Tak |
OpenAI.MCPApprovalResponseItemResource
Odpowiedź na żądanie zatwierdzenia MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| approval_request_id | ciąg | Identyfikator odpowiedzi na żądanie zatwierdzenia. | Tak | |
| approve | typ logiczny (boolowski) | Czy żądanie zostało zatwierdzone. | Tak | |
| powód | ciąg | Opcjonalna przyczyna decyzji. | Nie. | |
| typ | wyliczenie | Możliwe wartości: mcp_approval_response |
Tak |
OpenAI.MCPCallItemParam
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Tak | |
| błąd | ciąg | Błąd wywołania narzędzia, jeśli istnieje. | Nie. | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Tak | |
| We/Wy | ciąg | Dane wyjściowe z wywołania narzędzia. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Tak | |
| typ | wyliczenie | Możliwe wartości: mcp_call |
Tak |
OpenAI.MCPCallItemResource
Wywołanie narzędzia na serwerze MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Ciąg JSON argumentów przekazanych do narzędzia. | Tak | |
| błąd | ciąg | Błąd wywołania narzędzia, jeśli istnieje. | Nie. | |
| nazwa | ciąg | Nazwa uruchomionego narzędzia. | Tak | |
| We/Wy | ciąg | Dane wyjściowe z wywołania narzędzia. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP z uruchomionym narzędziem. | Tak | |
| typ | wyliczenie | Możliwe wartości: mcp_call |
Tak |
OpenAI.MCPListToolsItemParam
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | ciąg | Komunikat o błędzie, jeśli serwer nie może wyświetlić listy narzędzi. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Tak | |
| narzędzia | macierz | Narzędzia dostępne na serwerze. | Tak | |
| typ | wyliczenie | Możliwe wartości: mcp_list_tools |
Tak |
OpenAI.MCPListToolsItemResource
Lista narzędzi dostępnych na serwerze MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | ciąg | Komunikat o błędzie, jeśli serwer nie może wyświetlić listy narzędzi. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP. | Tak | |
| narzędzia | macierz | Narzędzia dostępne na serwerze. | Tak | |
| typ | wyliczenie | Możliwe wartości: mcp_list_tools |
Tak |
OpenAI.MCPListToolsTool
Narzędzie dostępne na serwerze MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Adnotacje | Dodatkowe adnotacje dotyczące narzędzia. | Nie. | ||
| opis | ciąg | Opis narzędzia. | Nie. | |
| input_schema | Schemat JSON opisujący dane wejściowe narzędzia. | Tak | ||
| nazwa | ciąg | Nazwa narzędzia. | Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| dozwolone_narzędzia | obiekt | Nie. | ||
| └─ nazwy_narzędzi | macierz | Lista dozwolonych nazw narzędzi. | Nie. | |
| headers | obiekt | Opcjonalne nagłówki HTTP do wysyłania do serwera MCP. Używanie do uwierzytelniania lub innych celów. |
Nie. | |
| project_connection_id | ciąg | Identyfikator połączenia w projekcie 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) | Określ, które narzędzia serwera MCP wymagają zatwierdzenia. | Nie. | |
| etykieta_serwera | ciąg | Etykieta dla tego serwera MCP używana do identyfikowania go w wywołaniach narzędzi. | Tak | |
| adres_serwera | ciąg | Adres URL serwera MCP. | Tak | |
| typ | wyliczenie | Typ narzędzia MCP. Zawsze mcp.Możliwe wartości: mcp |
Tak |
OpenAI.Metadata
Zestaw 16 par klucz-wartość, 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.Prompt
Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| identyfikator | ciąg | Unikatowy identyfikator szablonu monitu do użycia. | Tak | |
| zmienne | obiekt | Opcjonalna mapa wartości, które mają być zastępowane zmiennymi w monit. Wartości podstawienia mogą być ciągami lub innymi Typy danych wejściowych odpowiedzi, takie jak obrazy lub pliki. |
Nie. | |
| wersja | ciąg | Opcjonalna wersja szablonu monitu. | Nie. |
OpenAI.RankingOptions
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| klasyfikator | wyliczenie | Klasyfikator używany do wyszukiwania plików. Możliwe wartości: auto, default-2024-11-15 |
Nie. | |
| próg punktowy | Liczba | 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. |
OpenAI.Reasoning
Tylko modele serii o
Opcje konfiguracji dla modeli rozumowania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nakład pracy | obiekt | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| generate_summary | wyliczenie |
Przestarzałe: użyj summary zamiast. Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu.
autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. | |
| podsumowanie | wyliczenie | Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu. autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. |
OpenAI.ReasoningEffort
Ogranicza nakład pracy na rozumowanie modeli rozumowania.
Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie.
Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi.
Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1.
Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego.
Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania.
| Majątek | Wartość |
|---|---|
| Opis | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
| Typ | ciąg |
| Wartości | noneminimallowmediumhigh |
OpenAI.ReasoningItemParam
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 dla kolejnych tur konwersacji, jeśli ręcznie zarządzasz stanem konwersacji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| encrypted_content | ciąg | Zaszyfrowana zawartość elementu rozumowania — wypełniana, gdy odpowiedź jest wygenerowany za pomocą reasoning.encrypted_content polecenia w parametrze include . |
Nie. | |
| podsumowanie | macierz | Analiza zawartości tekstu. | Tak | |
| typ | wyliczenie | Możliwe wartości: reasoning |
Tak |
OpenAI.ReasoningItemResource
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 dla kolejnych tur konwersacji, jeśli ręcznie zarządzasz stanem konwersacji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| encrypted_content | ciąg | Zaszyfrowana zawartość elementu rozumowania — wypełniana, gdy odpowiedź jest wygenerowany za pomocą reasoning.encrypted_content polecenia w parametrze include . |
Nie. | |
| podsumowanie | macierz | Analiza zawartości tekstu. | Tak | |
| typ | wyliczenie | Możliwe wartości: reasoning |
Tak |
OpenAI.ReasoningItemSummaryPart
Klasyfikator OpenAI.ReasoningItemSummaryPart
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
summary_text |
OpenAI.ReasoningItemSummaryTextPart |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ReasoningItemSummaryPartType | Tak |
OpenAI.ReasoningItemSummaryPartType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | summary_text |
OpenAI.ReasoningItemSummaryTextPart
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| SMS | ciąg | Tak | ||
| typ | wyliczenie | Możliwe wartości: summary_text |
Tak |
OpenAI.Response
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| agent | obiekt | Nie. | ||
| └─ nazwa | ciąg | Nazwa agenta. | Nie. | |
| └typ | wyliczenie | Możliwe wartości: agent_id |
Nie. | |
| └* wersja | ciąg | Identyfikator wersji agenta. | Nie. | |
| tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| konwersacja | obiekt | Tak | ||
| └─ ID | ciąg | Nie. | ||
| utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Tak | |
| błąd | obiekt | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Tak | |
| └─ kod | OpenAI.ResponseErrorCode | Kod błędu odpowiedzi. | Nie. | |
| └─ Komunikat | ciąg | Czytelny dla człowieka opis błędu. | Nie. | |
| identyfikator | ciąg | Unikatowy identyfikator tej odpowiedzi. | Tak | |
| incomplete_details | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Tak | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| instructions | ciąg lub tablica | Tak | ||
| max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. |
Tak | |
| 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 |
Tak | |
| We/Wy | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Tak | |
| output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| wywołania_narzędzia_równoległe | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Tak | Prawda |
| previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| monit | obiekt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator szablonu monitu do użycia. | Nie. | |
| Zmienne └* | OpenAI.ResponsePromptVariables | Opcjonalna mapa wartości, które mają być zastępowane zmiennymi w monit. Wartości podstawienia mogą być ciągami lub innymi Typy danych wejściowych odpowiedzi, takie jak obrazy lub pliki. |
Nie. | |
| └* wersja | ciąg | Opcjonalna wersja szablonu monitu. | Nie. | |
| reasoning | obiekt |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └─ wysiłek | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| └─ generuj_podsumowanie | wyliczenie |
Przestarzałe: użyj summary zamiast. Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu.
autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. | |
| └─ Podsumowanie | wyliczenie | Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu. autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. | |
| poziom usługi | obiekt | Określa typ przetwarzania używany do obsługi żądania. * Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowane w ustawieniach programu Project. Jeśli nie skonfigurowano inaczej, projekt będzie używać wartości domyślnej. * Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardu ceny i wydajność wybranego modelu. * W przypadku ustawienia na wartość "flex" lub "priorytet", a następnie żądanie zostanie przetworzone z odpowiednią usługą kondygnacja. Skontaktuj się ze sprzedażą , aby dowiedzieć się więcej o przetwarzaniu priorytetu. * Jeśli nie ustawiono, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać wartość service_tierwartość oparta na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może się różnić 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. | |
| 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 | Liczba | 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. |
Tak | |
| SMS | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| tool_choice | obiekt | 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 wiadomości a wykonywaniem połączeniawięcej narzędzi required oznacza, że model musi wywoływać co najmniej jedno narzędzie. |
Nie. | |
| └typ | OpenAI.ToolChoiceObjectType | Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach. |
Nie. | |
| narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| top_p | Liczba | 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. |
Tak | |
| truncation | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Tak |
OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent
Emitowane, gdy fragment kodu jest przesyłany strumieniowo przez interpreter kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| delta | ciąg | Fragment kodu przesyłany strumieniowo przez interpreter kodu. | Tak | |
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w odpowiedzi, dla której jest przesyłany strumieniowo kod. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call_code.delta.Możliwe wartości: response.code_interpreter_call_code.delta |
Tak |
OpenAI.ResponseCodeInterpreterCallCodeDoneEvent
Emitowane, gdy fragment kodu jest finalizowany przez interpreter kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Ostateczny wynik fragmentu kodu generowany przez interpretatora kodu. | Tak | |
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w odpowiedzi, dla której kod jest sfinalizowany. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call_code.done.Możliwe wartości: response.code_interpreter_call_code.done |
Tak |
OpenAI.ResponseCodeInterpreterCallCompletedEvent
Emitowane po zakończeniu wywołania interpretera kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w odpowiedzi, dla której wykonano wywołanie interpretera kodu. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call.completed.Możliwe wartości: response.code_interpreter_call.completed |
Tak |
OpenAI.ResponseCodeInterpreterCallInProgressEvent
Emitowane, gdy trwa wywołanie interpretera kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w odpowiedzi, dla której trwa wywołanie interpretera kodu. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call.in_progress.Możliwe wartości: response.code_interpreter_call.in_progress |
Tak |
OpenAI.ResponseCodeInterpreterCallInterpretingEvent
Emitowane, gdy interpreter kodu aktywnie interpretuje fragment kodu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wywołania narzędzia interpretera kodu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w odpowiedzi, dla której interpreter kodu interpretuje kod. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.code_interpreter_call.interpreting.Możliwe wartości: response.code_interpreter_call.interpreting |
Tak |
OpenAI.ResponseCompletedEvent
Emitowane po zakończeniu odpowiedzi modelu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| odpowiedź | obiekt | Tak | ||
| └* agent | Identyfikator agenta | Agent używany na potrzeby tej odpowiedzi | Nie. | |
| └* tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| Konwersacja └* | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Nie. | |
| └─ błąd | OpenAI.ResponseError | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Nie. | |
| └niekompletne_szczegóły | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Nie. | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| └─ instrukcje | ciąg lub tablica | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| └max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| └max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| Metadane └* | obiekt | Zestaw 16 par klucz-wartość, 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 |
Nie. | |
| └─ Dane wyjściowe | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Nie. | |
| └output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| └parallel_tool_calls | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| └previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| Stan └* | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
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 | Liczba | 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. | |
| └* tekst | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| └─ Narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| └ top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| └─top_p | Liczba | 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. | |
| └* skrócenie | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.completed.Możliwe wartości: response.completed |
Tak |
OpenAI.ResponseContentPartAddedEvent
Emitowane po dodaniu nowej części zawartości.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks dodanej części zawartości. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego została dodana część zawartości. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego została dodana część zawartości. | Tak | |
| część | obiekt | Tak | ||
| └typ | OpenAI.ItemContentType | Zawartość danych wejściowych i wyjściowych wielomodalnych. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.content_part.added.Możliwe wartości: response.content_part.added |
Tak |
OpenAI.ResponseContentPartDoneEvent
Emitowane po zakończeniu części zawartości.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks części zawartości, która jest ukończona. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego została dodana część zawartości. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego została dodana część zawartości. | Tak | |
| część | obiekt | Tak | ||
| └typ | OpenAI.ItemContentType | Zawartość danych wejściowych i wyjściowych wielomodalnych. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.content_part.done.Możliwe wartości: response.content_part.done |
Tak |
OpenAI.ResponseCreatedEvent
Zdarzenie emitowane podczas tworzenia odpowiedzi.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| odpowiedź | obiekt | Tak | ||
| └* agent | Identyfikator agenta | Agent używany na potrzeby tej odpowiedzi | Nie. | |
| └* tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| Konwersacja └* | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Nie. | |
| └─ błąd | OpenAI.ResponseError | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Nie. | |
| └niekompletne_szczegóły | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Nie. | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| └─ instrukcje | ciąg lub tablica | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| └max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| └max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| Metadane └* | obiekt | Zestaw 16 par klucz-wartość, 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 |
Nie. | |
| └─ Dane wyjściowe | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Nie. | |
| └output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| └parallel_tool_calls | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| └previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| Stan └* | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
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 | Liczba | 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. | |
| └* tekst | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| └─ Narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| └ top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| └─top_p | Liczba | 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. | |
| └* skrócenie | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.created.Możliwe wartości: response.created |
Tak |
OpenAI.ResponseError
Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | OpenAI.ResponseErrorCode | Kod błędu odpowiedzi. | Tak | |
| komunikat | ciąg | Czytelny dla człowieka opis błędu. | Tak |
OpenAI.ResponseErrorCode
Kod błędu odpowiedzi.
| Majątek | Wartość |
|---|---|
| Opis | Kod błędu odpowiedzi. |
| Typ | 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| kod | ciąg | Kod błędu. | Tak | |
| komunikat | ciąg | Komunikat o błędzie. | Tak | |
| param | ciąg | Parametr błędu. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze error.Możliwe wartości: error |
Tak |
OpenAI.ResponseFailedEvent
Zdarzenie emitowane w przypadku niepowodzenia odpowiedzi.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| odpowiedź | obiekt | Tak | ||
| └* agent | Identyfikator agenta | Agent używany na potrzeby tej odpowiedzi | Nie. | |
| └* tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| Konwersacja └* | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Nie. | |
| └─ błąd | OpenAI.ResponseError | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Nie. | |
| └niekompletne_szczegóły | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Nie. | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| └─ instrukcje | ciąg lub tablica | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| └max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| └max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| Metadane └* | obiekt | Zestaw 16 par klucz-wartość, 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 |
Nie. | |
| └─ Dane wyjściowe | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Nie. | |
| └output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| └parallel_tool_calls | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| └previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| Stan └* | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
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 | Liczba | 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. | |
| └* tekst | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| └─ Narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| └ top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| └─top_p | Liczba | 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. | |
| └* skrócenie | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.failed.Możliwe wartości: response.failed |
Tak |
OpenAI.ResponseFileSearchCallCompletedEvent
Emitowane po zakończeniu wywołania wyszukiwania plików (znaleziono wyniki).
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.file_search_call.completed.Możliwe wartości: response.file_search_call.completed |
Tak |
OpenAI.ResponseFileSearchCallInProgressEvent
Emitowane po zainicjowaniu wywołania wyszukiwania plików.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.file_search_call.in_progress.Możliwe wartości: response.file_search_call.in_progress |
Tak |
OpenAI.ResponseFileSearchCallSearchingEvent
Emitowane, gdy wyszukiwanie plików jest obecnie przeszukiwane.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego zainicjowano wywołanie wyszukiwania plików. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego przeszukiwanego przez wywołanie wyszukiwania plików. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.file_search_call.searching.Możliwe wartości: response.file_search_call.searching |
Tak |
OpenAI.ResponseFormat
Dyskryminator dla OpenAI.ResponseFormat
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
json_object |
OpenAI.ResponseFormatJsonObject |
json_schema |
OpenAI.ResponseFormatJsonSchema |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: text, , json_objectjson_schema |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_object.Możliwe wartości: json_object |
Tak |
OpenAI.ResponseFormatJsonSchema
Schemat formatu odpowiedzi, opisany jako obiekt schematu JSON. Dowiedz się, jak tworzyć schematy JSON tutaj. Format odpowiedzi schematu JSON. Służy do generowania ustrukturyzowanych odpowiedzi JSON. Dowiedz się więcej o danych wyjściowych ze strukturą.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| json_schema | obiekt | Opcje konfiguracji danych wyjściowych ze strukturą, w tym schemat JSON. | Tak | |
| 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. |
Nie. | |
| Schemat └* | obiekt | Nie. | ||
| └* ścisłe | typ logiczny (boolowski) | Czy włączyć ścisłe przestrzeganie schematu podczas generowania danych wyjściowych. W przypadku ustawienia wartości true model będzie zawsze przestrzegał dokładnego zdefiniowanego schematu W polu schema. Tylko podzbiór schematu JSON jest obsługiwany, gdyParametr strict ma wartość true. Aby dowiedzieć się więcej, przeczytaj ustrukturyzowane dane wyjścioweprzewodnik. |
Nie. | Nieprawda |
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_schema.Możliwe wartości: json_schema |
Tak |
OpenAI.ResponseFormatText
Domyślny format odpowiedzi. Służy do generowania odpowiedzi tekstowych.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze text.Możliwe wartości: text |
Tak |
OpenAI.ResponseFunctionCallArgumentsDeltaEvent
Emitowane, gdy występuje różnica w argumentach wywołania funkcji częściowej.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| delta | ciąg | Dodano argument delta w wywołaniu funkcji. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego dodano różnicę argumentów wywołania funkcji. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego do którego zostanie dodana różnica w argumentach wywołania funkcji. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.function_call_arguments.delta.Możliwe wartości: response.function_call_arguments.delta |
Tak |
OpenAI.ResponseFunctionCallArgumentsDoneEvent
Emitowane, gdy argumenty wywołania funkcji są finalizowane.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | ciąg | Argumenty wywołania funkcji. | Tak | |
| item_id | ciąg | Identyfikator elementu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego. | Tak | |
| typ | wyliczenie | Możliwe wartości: response.function_call_arguments.done |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.image_generation_call.completed". Możliwe wartości: response.image_generation_call.completed |
Tak |
OpenAI.ResponseImageGenCallGeneratingEvent
Emitowane, gdy wywołanie narzędzia do generowania obrazów aktywnie generuje obraz (stan pośredni).
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.image_generation_call.generating". Możliwe wartości: response.image_generation_call.generating |
Tak |
OpenAI.ResponseImageGenCallInProgressEvent
Emitowane jest, gdy trwa wywołanie narzędzia do generowania obrazów.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.image_generation_call.in_progress". Możliwe wartości: response.image_generation_call.in_progress |
Tak |
OpenAI.ResponseImageGenCallPartialImageEvent
Emitowany sygnał, gdy częściowy obraz staje się dostępny podczas przesyłania strumieniowego generowanych obrazów.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu generowania obrazu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| partial_image_b64 | ciąg | Dane częściowe obrazu zakodowane w formacie Base64, odpowiednie do renderowania jako obrazu. | Tak | |
| partial_image_index | liczba całkowita | Indeks zaczynający się od 0 dla obrazu częściowego (w systemie backend indeks zaczyna się od 1, ale dla użytkownika jest to indeks od 0). | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze „response.image_generation_call.partial_image”. Możliwe wartości: response.image_generation_call.partial_image |
Tak |
OpenAI.ResponseInProgressEvent
Emitowane, gdy odpowiedź jest w toku.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| odpowiedź | obiekt | Tak | ||
| └* agent | Identyfikator agenta | Agent używany na potrzeby tej odpowiedzi | Nie. | |
| └* tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| Konwersacja └* | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Nie. | |
| └─ błąd | OpenAI.ResponseError | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Nie. | |
| └niekompletne_szczegóły | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Nie. | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| └─ instrukcje | ciąg lub tablica | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| └max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| └max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| Metadane └* | obiekt | Zestaw 16 par klucz-wartość, 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 |
Nie. | |
| └─ Dane wyjściowe | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Nie. | |
| └output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| └parallel_tool_calls | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| └previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| Stan └* | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
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 | Liczba | 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. | |
| └* tekst | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| └─ Narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| └ top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| └─top_p | Liczba | 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. | |
| └* skrócenie | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.in_progress.Możliwe wartości: response.in_progress |
Tak |
OpenAI.ResponseIncompleteEvent
Zdarzenie emitowane, gdy odpowiedź jest zakończona jako niekompletna.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| odpowiedź | obiekt | Tak | ||
| └* agent | Identyfikator agenta | Agent używany na potrzeby tej odpowiedzi | Nie. | |
| └* tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| Konwersacja └* | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Nie. | |
| └─ błąd | OpenAI.ResponseError | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Nie. | |
| └niekompletne_szczegóły | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Nie. | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| └─ instrukcje | ciąg lub tablica | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| └max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| └max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| Metadane └* | obiekt | Zestaw 16 par klucz-wartość, 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 |
Nie. | |
| └─ Dane wyjściowe | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Nie. | |
| └output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| └parallel_tool_calls | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| └previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| Stan └* | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
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 | Liczba | 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. | |
| └* tekst | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| └─ Narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| └ top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| └─top_p | Liczba | 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. | |
| └* skrócenie | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.incomplete.Możliwe wartości: response.incomplete |
Tak |
OpenAI.ResponseMCPCallArgumentsDeltaEvent
Emituje się, gdy następuje różnica (częściowa aktualizacja) w argumentach wywołania narzędzia MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| delta | Częściowa aktualizacja argumentów wywołania narzędzia MCP. | Tak | ||
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.arguments_delta". Możliwe wartości: response.mcp_call.arguments_delta |
Tak |
OpenAI.ResponseMCPCallArgumentsDoneEvent
Emitowane, gdy argumenty wywołania narzędzia MCP są finalizowane.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Argumenty | Sfinalizowane argumenty wywołania narzędzia MCP. | Tak | ||
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.arguments_done". Możliwe wartości: response.mcp_call.arguments_done |
Tak |
OpenAI.ResponseMCPCallCompletedEvent
Emitowane po pomyślnym zakończeniu wywołania narzędzia MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.completed". Możliwe wartości: response.mcp_call.completed |
Tak |
OpenAI.ResponseMCPCallFailedEvent
Emitowane, gdy wywołanie narzędzia MCP nie powiodło się.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.failed". Możliwe wartości: response.mcp_call.failed |
Tak |
OpenAI.ResponseMCPCallInProgressEvent
Emitowane, gdy trwa wywołanie narzędzia MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator przetwarzanego elementu wywołania narzędzia MCP. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_call.in_progress". Możliwe wartości: response.mcp_call.in_progress |
Tak |
OpenAI.ResponseMCPListToolsCompletedEvent
Emitowane po pomyślnym pobraniu listy dostępnych narzędzi MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdarzenia. Zawsze „response.mcp_list_tools.completed”. Możliwe wartości: response.mcp_list_tools.completed |
Tak |
OpenAI.ResponseMCPListToolsFailedEvent
Emitowane, gdy próba wyświetlenia listy dostępnych narzędzi MCP nie powiodła się.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_list_tools.failed". Możliwe wartości: response.mcp_list_tools.failed |
Tak |
OpenAI.ResponseMCPListToolsInProgressEvent
Emitowane, gdy system jest w trakcie pobierania listy dostępnych narzędzi MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.mcp_list_tools.in_progress". Możliwe wartości: response.mcp_list_tools.in_progress |
Tak |
OpenAI.ResponseOutputItemAddedEvent
Emitowane po dodaniu nowego elementu wyjściowego.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| element | obiekt | Element zawartości używany do generowania odpowiedzi. | Tak | |
| └created_by | Utworzone przez | Informacje o twórcy elementu | Nie. | |
| └─ ID | ciąg | Nie. | ||
| └typ | OpenAI.ItemType | Nie. | ||
| output_index | liczba całkowita | Indeks dodanego elementu wyjściowego. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_item.added.Możliwe wartości: response.output_item.added |
Tak |
OpenAI.ResponseOutputItemDoneEvent
Emitowane, gdy element wyjściowy jest oznaczony jako zakończony.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| element | obiekt | Element zawartości używany do generowania odpowiedzi. | Tak | |
| └created_by | Utworzone przez | Informacje o twórcy elementu | Nie. | |
| └─ ID | ciąg | Nie. | ||
| └typ | OpenAI.ItemType | Nie. | ||
| output_index | liczba całkowita | Indeks elementu wyjściowego, który został oznaczony jako wykonany. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_item.done.Możliwe wartości: response.output_item.done |
Tak |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| odpowiedź | obiekt | Tak | ||
| └* agent | Identyfikator agenta | Agent używany na potrzeby tej odpowiedzi | Nie. | |
| └* tło | typ logiczny (boolowski) | Czy uruchomić odpowiedź modelu w tle. Dowiedz się więcej o odpowiedziach w tle. |
Nie. | Nieprawda |
| Konwersacja └* | obiekt | Nie. | ||
| └─ ID | ciąg | Nie. | ||
| └─ utworzono_o | liczba całkowita | Sygnatura czasowa systemu Unix (w sekundach) czasu utworzenia tej odpowiedzi. | Nie. | |
| └─ błąd | OpenAI.ResponseError | Obiekt błędu zwracany, gdy model nie może wygenerować odpowiedzi. | Nie. | |
| └─ ID | ciąg | Unikatowy identyfikator tej odpowiedzi. | Nie. | |
| └niekompletne_szczegóły | obiekt | Szczegółowe informacje o tym, dlaczego odpowiedź jest niekompletna. | Nie. | |
| └* przyczyna | wyliczenie | Powód, dla którego odpowiedź jest niekompletna. Możliwe wartości: max_output_tokens, content_filter |
Nie. | |
| └─ instrukcje | ciąg lub tablica | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. Podczas używania z previous_response_id, instrukcje z poprzedniegoodpowiedź nie zostanie przeniesiona do następnej odpowiedzi. To sprawia, że jest to proste w celu wymiany komunikatów systemowych (lub od deweloperów) w nowych odpowiedziach. |
Nie. | |
| └max_output_tokens | liczba całkowita | Górna granica liczby tokenów, które można wygenerować dla odpowiedzi, w tym widoczne tokeny wyjściowe i tokeny rozumowania. | Nie. | |
| └max_tool_calls | liczba całkowita | Maksymalna liczba wywołań do wbudowanych narzędzi, które można przetworzyć w odpowiedzi. Ta maksymalna liczba dotyczy wszystkich wbudowanych wywołań narzędzi, a nie poszczególnych narzędzi. Wszelkie dalsze próby wywołania narzędzia przez model zostaną zignorowane. | Nie. | |
| Metadane └* | obiekt | Zestaw 16 par klucz-wartość, 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 |
Nie. | |
| └─ Dane wyjściowe | macierz | Tablica elementów zawartości wygenerowanych przez model. - Długość i kolejność elementów w tablicy output jest zależnana odpowiedzi modelu. — Zamiast uzyskiwać dostęp do pierwszego elementu w tablicy output izakł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. |
Nie. | |
| └output_text | ciąg | Właściwość wygody tylko dla zestawu SDK, która zawiera zagregowane dane wyjściowe tekstu ze wszystkich output_text elementów w tablicy output , jeśli istnieją.Obsługiwane w zestawach SDK python i JavaScript. |
Nie. | |
| └parallel_tool_calls | typ logiczny (boolowski) | Czy zezwolić modelowi na równoległe uruchamianie wywołań narzędzi. | Nie. | Prawda |
| └previous_response_id | ciąg | Unikatowy identyfikator poprzedniej odpowiedzi na model. Użyj tego do tworzenie konwersacji o wielu wymianach. Dowiedz się więcej o zarządzanie stanem konwersacji. |
Nie. | |
| Zachęta └* | OpenAI.Prompt | Odwołanie do szablonu monitu i jego zmiennych. Dowiedz się więcej. |
Nie. | |
| └* rozumowanie | OpenAI.Reasoning |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └service_tier | OpenAI.ServiceTier | Uwaga: service_tier nie ma zastosowania do usługi Azure OpenAI. | Nie. | |
| Stan └* | wyliczenie | Stan generowania odpowiedzi.
completedJeden z , , failedin_progress, cancelled, queued lub incomplete.Możliwe wartości: completed, , failedin_progress, cancelled, , queuedincomplete |
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 | Liczba | 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. | |
| └* tekst | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może być zwykły tekstowe lub ustrukturyzowane dane JSON. Zobacz Wprowadzanie tekstu i dane wyjściowe i dane wyjściowe ze strukturą |
Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| └wybór_narzędzia | OpenAI.ToolChoiceOptions lub OpenAI.ToolChoiceObject | Jak model powinien wybrać narzędzie (lub narzędzia), które ma być używane podczas generowania odpowiedź. Zobacz parametr , tools aby zobaczyć, jak określić narzędziamodel może wywoływać. |
Nie. | |
| └─ Narzędzia | macierz | 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 .Dwie kategorie narzędzi, które można modelowi podać, to: * 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. * Wywołania funkcji (narzędzia niestandardowe): funkcje zdefiniowane przez Użytkownika umożliwienie modelowi wywołania własnego kodu. Dowiedz się więcej o wywoływanie funkcji. |
Nie. | |
| └ top_logprobs | liczba całkowita | Liczba całkowita z zakresu od 0 do 20 określająca liczbę najbardziej prawdopodobnych tokenów do zwrócenia na każdej pozycji, z których każdy ma skojarzone logarytmiczne prawdopodobieństwo. | Nie. | |
| └─top_p | Liczba | 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. | |
| └* skrócenie | wyliczenie | Strategia obcinania, która ma być użyta dla odpowiedzi modelu. - auto: Jeśli kontekst tej odpowiedzi i poprzednich przekroczy określony limitrozmiar okna kontekstu modelu, model zostanie obcięty odpowiedź, aby dopasować okno kontekstu, upuszczając elementy wejściowe. w środku rozmowy - disabled (ustawienie domyślne): jeśli odpowiedź modelu przekroczy okno konteksturozmiar modelu, żądanie zakończy się niepowodzeniem z błędem 400. 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 | Dowiedz się więcej o najlepszych rozwiązaniach dotyczących bezpieczeństwa. | Nie. | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.queued". Możliwe wartości: response.queued |
Tak |
OpenAI.ResponseReasoningDeltaEvent
Emitowane w przypadku zmiany (częściowej aktualizacji) treści rozumowania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks zawartości części rozumowania w elemencie wyjściowym. | Tak | |
| delta | Częściowa aktualizacja zawartości rozumowania. | Tak | ||
| item_id | ciąg | Unikatowy identyfikator elementu, dla którego jest aktualizowane rozumowanie. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.reasoning.delta". Możliwe wartości: response.reasoning.delta |
Tak |
OpenAI.ResponseReasoningDoneEvent
Emitowane, gdy zawartość rozumowania jest finalizowana dla elementu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks zawartości części rozumowania w elemencie wyjściowym. | Tak | |
| item_id | ciąg | Unikatowy identyfikator elementu, dla którego rozumowanie jest finalizowane. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| SMS | ciąg | Sfinalizowany tekst rozumowania. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.reasoning.done". Możliwe wartości: response.reasoning.done |
Tak |
OpenAI.ResponseReasoningSummaryDeltaEvent
Emitowane w przypadku zmiany (częściowej aktualizacji) w zawartości podsumowania wnioskowania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| delta | Częściowa aktualizacja zawartości podsumowania przyczyn. | Tak | ||
| item_id | ciąg | Unikatowy identyfikator elementu, dla którego jest aktualizowane podsumowanie rozumowania. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| summary_index | liczba całkowita | Indeks części podsumowania w elemencie wyjściowym. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.reasoning_summary.delta". Możliwe wartości: response.reasoning_summary.delta |
Tak |
OpenAI.ResponseReasoningSummaryDoneEvent
Emitowane, gdy zawartość podsumowania rozumowania jest finalizowana dla elementu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu, dla którego podsumowanie rozumowania jest finalizowane. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego w tablicy wyjściowej odpowiedzi. | Tak | |
| summary_index | liczba całkowita | Indeks części podsumowania w elemencie wyjściowym. | Tak | |
| SMS | ciąg | Sfinalizowany tekst podsumowania rozumowania. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze "response.reasoning_summary.done". Możliwe wartości: response.reasoning_summary.done |
Tak |
OpenAI.ResponseReasoningSummaryPartAddedEvent
Emitowane po dodaniu nowej części podsumowania rozumowania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu, z którym ta część podsumowania jest skojarzona. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego jest skojarzony z tą częścią podsumowania. | Tak | |
| część | obiekt | Tak | ||
| └typ | OpenAI.ReasoningItemSummaryPartType | Nie. | ||
| summary_index | liczba całkowita | Indeks części podsumowania w podsumowaniu rozumowania. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_part.added.Możliwe wartości: response.reasoning_summary_part.added |
Tak |
OpenAI.ResponseReasoningSummaryPartDoneEvent
Emitowane po ukończeniu części podsumowującej wnioskowanie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu, z którym ta część podsumowania jest skojarzona. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego jest skojarzony z tą częścią podsumowania. | Tak | |
| część | obiekt | Tak | ||
| └typ | OpenAI.ReasoningItemSummaryPartType | Nie. | ||
| summary_index | liczba całkowita | Indeks części podsumowania w podsumowaniu rozumowania. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_part.done.Możliwe wartości: response.reasoning_summary_part.done |
Tak |
OpenAI.ResponseReasoningSummaryTextDeltaEvent
Emitowane po dodaniu zmiany do tekstu podsumowującego rozumowanie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| delta | ciąg | Delta tekstu dodana do podsumowania. | Tak | |
| item_id | ciąg | Identyfikator elementu, z który jest skojarzona ta delta tekstu podsumowania. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, z którym powiązana jest zmiana tekstu podsumowania. | Tak | |
| summary_index | liczba całkowita | Indeks części podsumowania w podsumowaniu rozumowania. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_text.delta.Możliwe wartości: response.reasoning_summary_text.delta |
Tak |
OpenAI.ResponseReasoningSummaryTextDoneEvent
Emitowany po zakończeniu tekstu podsumowania rozumowania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Identyfikator elementu, z którym jest powiązany ten tekst podsumowania. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, z którym związany jest ten tekst podsumowania. | Tak | |
| summary_index | liczba całkowita | Indeks części podsumowania w podsumowaniu rozumowania. | Tak | |
| SMS | ciąg | Pełny tekst ukończonego podsumowania rozumowania. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.reasoning_summary_text.done.Możliwe wartości: response.reasoning_summary_text.done |
Tak |
OpenAI.ResponseRefusalDeltaEvent
Emitowane w przypadku częściowego tekstu odmowy.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks części zawartości, do którego jest dodawany tekst odmowy. | Tak | |
| delta | ciąg | Tekst odmowy, który został dodany. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego jest dodawany tekst odmowy. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego jest dodawany tekst odmowy. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.refusal.delta.Możliwe wartości: response.refusal.delta |
Tak |
OpenAI.ResponseRefusalDoneEvent
Emitowane, gdy tekst odmowy jest sfinalizowany.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks części treści, w której tekst odmowy jest sfinalizowany. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, dla którego tekst odmowy jest finalizowany. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, w którym tekst odmowy został sfinalizowany. | Tak | |
| refusal | ciąg | Tekst odmowy, który jest sfinalizowany. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.refusal.done.Możliwe wartości: response.refusal.done |
Tak |
OpenAI.ResponseStreamEvent
Dyskryminator dla OpenAI.ResponseStreamEvent
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| sequence_number | liczba całkowita | Numer sekwencji dla tego zdarzenia. | Tak | |
| typ | OpenAI.ResponseStreamEventType | Tak |
OpenAI.ResponseStreamEventType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | response.audio.deltaresponse.audio.doneresponse.audio_transcript.deltaresponse.audio_transcript.doneresponse.code_interpreter_call_code.deltaresponse.code_interpreter_call_code.doneresponse.code_interpreter_call.completedresponse.code_interpreter_call.in_progressresponse.code_interpreter_call.interpretingresponse.completedresponse.content_part.addedresponse.content_part.doneresponse.createderrorresponse.file_search_call.completedresponse.file_search_call.in_progressresponse.file_search_call.searchingresponse.function_call_arguments.deltaresponse.function_call_arguments.doneresponse.in_progressresponse.failedresponse.incompleteresponse.output_item.addedresponse.output_item.doneresponse.refusal.deltaresponse.refusal.doneresponse.output_text.annotation.addedresponse.output_text.deltaresponse.output_text.doneresponse.reasoning_summary_part.addedresponse.reasoning_summary_part.doneresponse.reasoning_summary_text.deltaresponse.reasoning_summary_text.doneresponse.web_search_call.completedresponse.web_search_call.in_progressresponse.web_search_call.searchingresponse.image_generation_call.completedresponse.image_generation_call.generatingresponse.image_generation_call.in_progressresponse.image_generation_call.partial_imageresponse.mcp_call.arguments_deltaresponse.mcp_call.arguments_doneresponse.mcp_call.completedresponse.mcp_call.failedresponse.mcp_call.in_progressresponse.mcp_list_tools.completedresponse.mcp_list_tools.failedresponse.mcp_list_tools.in_progressresponse.queuedresponse.reasoning.deltaresponse.reasoning.doneresponse.reasoning_summary.deltaresponse.reasoning_summary.done |
OpenAI.ResponseTextDeltaEvent
Emitowane w przypadku dodatkowej zmiany tekstu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks części zawartości, do której dodano zmianę tekstową. | Tak | |
| delta | ciąg | Dodano zmianę tekstu. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, do którego dodano różnicę tekstu. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego dodano różnicę tekstu. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_text.delta.Możliwe wartości: response.output_text.delta |
Tak |
OpenAI.ResponseTextDoneEvent
Emitowane po sfinalizowaniu zawartości tekstowej.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| content_index | liczba całkowita | Indeks części zawartości, w której treść tekstowa jest sfinalizowana. | Tak | |
| item_id | ciąg | Identyfikator elementu wyjściowego, którego zawartość tekstowa jest finalizowana. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, którego treść tekstowa jest sfinalizowana. | Tak | |
| SMS | ciąg | Zawartość tekstowa, która jest sfinalizowana. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.output_text.done.Możliwe wartości: response.output_text.done |
Tak |
KonfiguracjaFormatuTekstuOdpowiedzi.OpenAI
Dyskryminowanie pliku OpenAI.ResponseTextFormatConfiguration
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
text |
OpenAI.ResponseTextFormatConfigurationText |
json_object |
OpenAI.ResponseTextFormatConfigurationJsonObject |
json_schema |
OpenAI.ResponseTextFormatConfigurationJsonSchema |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ResponseTextFormatConfigurationType | Obiekt określający format, który musi zostać wygenerowany przez model. Konfigurowanie { "type": "json_schema" } włącza dane wyjściowe ze strukturą,zapewnia, że model będzie zgodny z podanym schematem JSON. Dowiedz się więcej w 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ą. |
Tak |
OpenAI.ResponseTextFormatConfigurationJsonObject
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: json_object |
Tak |
OpenAI.ResponseTextFormatConfigurationJsonSchema (konfiguracja formatu tekstu odpowiedzi OpenAI według schematu JSON)
Format odpowiedzi schematu JSON. Służy do generowania ustrukturyzowanych odpowiedzi JSON. Dowiedz się więcej o danych wyjściowych ze strukturą.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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. |
Tak | |
| schemat | obiekt | Tak | ||
| surowy | typ logiczny (boolowski) | Czy włączyć ścisłe przestrzeganie schematu podczas generowania danych wyjściowych. W przypadku ustawienia wartości true model będzie zawsze przestrzegał dokładnego zdefiniowanego schematu W polu schema. Tylko podzbiór schematu JSON jest obsługiwany, gdyParametr strict ma wartość true. Aby dowiedzieć się więcej, przeczytaj ustrukturyzowane dane wyjścioweprzewodnik. |
Nie. | Nieprawda |
| typ | wyliczenie | Typ zdefiniowanego formatu odpowiedzi. Zawsze json_schema.Możliwe wartości: json_schema |
Tak |
Konfiguracja formatu tekstu odpowiedzi OpenAI
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: text |
Tak |
OpenAI.TypKonfiguracjiFormatowaniaTekstu odpowiedzi
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 w witrynie
Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.
Niezalecane w przypadku modeli gpt-4o i nowszych:
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ą.
| Majątek | Wartość |
|---|---|
| Opis | 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 w witrynie
Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.
Niezalecane w przypadku modeli gpt-4o i nowszych:
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ą. | | Typ | ciąg | | Wartości | textjson_schemajson_object |
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| input_tokens | liczba całkowita | Liczba tokenów wejściowych. | Tak | |
| input_tokens_details | obiekt | Szczegółowy podział tokenów wejściowych. | Tak | |
| └cached_tokens | liczba całkowita | Liczba tokenów pobranych z pamięci podręcznej. Więcej informacji na temat buforowania monitów. |
Nie. | |
| output_tokens | liczba całkowita | Liczba tokenów wyjściowych. | Tak | |
| output_tokens_details | obiekt | Szczegółowy podział tokenów wyjściowych. | Tak | |
| └─ tokeny_rozumowania | liczba całkowita | Liczba tokenów rozumowania. | Nie. | |
| total_tokens | liczba całkowita | Całkowita liczba użytych tokenów. | Tak |
OpenAI.ResponseWebSearchCallCompletedEvent
Uwaga: web_search nie jest jeszcze dostępna za pośrednictwem usługi Azure OpenAI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wyjściowego skojarzonego z wywołaniem wyszukiwania w Internecie. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego jest skojarzone wywołanie wyszukiwania w Internecie. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.web_search_call.completed.Możliwe wartości: response.web_search_call.completed |
Tak |
OpenAI.ResponseWebSearchCallInProgressEvent
Uwaga: web_search nie jest jeszcze dostępna za pośrednictwem usługi Azure OpenAI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wyjściowego skojarzonego z wywołaniem wyszukiwania w Internecie. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego jest skojarzone wywołanie wyszukiwania w Internecie. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.web_search_call.in_progress.Możliwe wartości: response.web_search_call.in_progress |
Tak |
OpenAI.ResponseWebSearchCallSearchingEvent
Uwaga: web_search nie jest jeszcze dostępna za pośrednictwem usługi Azure OpenAI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| item_id | ciąg | Unikatowy identyfikator elementu wyjściowego skojarzonego z wywołaniem wyszukiwania w Internecie. | Tak | |
| output_index | liczba całkowita | Indeks elementu wyjściowego, do którego jest skojarzone wywołanie wyszukiwania w Internecie. | Tak | |
| typ | wyliczenie | Typ zdarzenia. Zawsze response.web_search_call.searching.Możliwe wartości: response.web_search_call.searching |
Tak |
OpenAI.ResponsesAssistantMessageItemParam
Element parametru komunikatu z rolą assistant .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg lub tablica | Tak | ||
| rola | wyliczenie | Rola komunikatu, czyli zawsze assistant.Możliwe wartości: assistant |
Tak |
OpenAI.ResponsesAssistantMessageItemResource
Element zasobu komunikatu z rolą assistant .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | macierz | Zawartość skojarzona z wiadomością. | Tak | |
| rola | wyliczenie | Rola komunikatu, czyli zawsze assistant.Możliwe wartości: assistant |
Tak |
OpenAI.ResponsesDeveloperMessageItemParam
Element parametru komunikatu z rolą developer .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg lub tablica | Tak | ||
| rola | wyliczenie | Rola komunikatu, czyli zawsze developer.Możliwe wartości: developer |
Tak |
OpenAI.ResponsesDeveloperMessageItemResource
Element zasobu komunikatu z rolą developer .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | macierz | Zawartość skojarzona z wiadomością. | Tak | |
| rola | wyliczenie | Rola komunikatu, czyli zawsze developer.Możliwe wartości: developer |
Tak |
OpenAI.ResponsesMessageItemParam
Element komunikatu odpowiedzi reprezentujący rolę i zawartość, jak podano jako parametry żądania klienta.
Klasyfikator dla OpenAI.ResponsesMessageItemParam
Ten składnik używa właściwości role do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
user |
OpenAI.ResponsesUserMessageItemParam |
system |
OpenAI.ResponsesSystemMessageItemParam |
developer |
OpenAI.ResponsesDeveloperMessageItemParam |
assistant |
OpenAI.ResponsesAssistantMessageItemParam |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rola | obiekt | Kolekcja prawidłowych ról dla elementów komunikatów odpowiedzi. | Tak | |
| typ | wyliczenie | Typ elementu odpowiedzi, który jest zawsze "komunikatem". Możliwe wartości: message |
Tak |
OpenAI.ResponsesMessageItemResource
Element zasobu komunikatu odpowiedzi reprezentujący rolę i zawartość podaną w odpowiedziach usługi.
Dyskryminujące dla openAI.ResponsesMessageItemResource
Ten składnik używa właściwości role do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
user |
OpenAI.ResponsesUserMessageItemResource |
system |
OpenAI.ResponsesSystemMessageItemResource |
developer |
OpenAI.ResponsesDeveloperMessageItemResource |
assistant |
OpenAI.ResponsesAssistantMessageItemResource |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rola | obiekt | Kolekcja prawidłowych ról dla elementów komunikatów odpowiedzi. | Tak | |
| 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 |
Tak | |
| typ | wyliczenie | Typ elementu odpowiedzi, który jest zawsze "komunikatem". Możliwe wartości: message |
Tak |
OpenAI.ResponsesMessageRole
Kolekcja prawidłowych ról dla elementów komunikatów odpowiedzi.
| Majątek | Wartość |
|---|---|
| Opis | Kolekcja prawidłowych ról dla elementów komunikatów odpowiedzi. |
| Typ | ciąg |
| Wartości | systemdeveloperuserassistant |
OpenAI.ResponsesSystemMessageItemParam
Element parametru komunikatu z rolą system .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg lub tablica | Tak | ||
| rola | wyliczenie | Rola komunikatu, czyli zawsze system.Możliwe wartości: system |
Tak |
OpenAI.ResponsesSystemMessageItemResource
Element zasobu komunikatu z rolą system .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | macierz | Zawartość skojarzona z wiadomością. | Tak | |
| rola | wyliczenie | Rola komunikatu, czyli zawsze system.Możliwe wartości: system |
Tak |
OpenAI.ResponsesUserMessageItemParam
Element parametru komunikatu z rolą user .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | ciąg lub tablica | Tak | ||
| rola | wyliczenie | Rola komunikatu, czyli zawsze user.Możliwe wartości: user |
Tak |
OpenAI.ResponsesUserMessageItemResource
Element zasobu komunikatu z rolą user .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| zawartość | macierz | Zawartość skojarzona z wiadomością. | Tak | |
| rola | wyliczenie | Rola komunikatu, czyli zawsze user.Możliwe wartości: user |
Tak |
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 projektu. Jeśli nie skonfigurowano inaczej, projekt 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. Skontaktuj się ze sprzedażą , aby dowiedzieć się więcej o przetwarzaniu priorytetu.
- Jeśli nie zostanie 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 .
| Majątek | Wartość |
|---|---|
| Opis | Określa typ przetwarzania używany do obsługi żądania. * Jeśli ustawiono wartość "auto", żądanie zostanie przetworzone przy użyciu warstwy usługi skonfigurowane w ustawieniach programu Project. Jeśli nie skonfigurowano inaczej, projekt będzie używać wartości domyślnej. * Jeśli ustawiono wartość "default", żądanie zostanie przetworzone przy użyciu standardu ceny i wydajność wybranego modelu. * W przypadku ustawienia na wartość "flex" lub "priorytet", a następnie żądanie zostanie przetworzone z odpowiednią usługą kondygnacja. Skontaktuj się ze sprzedażą , aby dowiedzieć się więcej o przetwarzaniu priorytetu. * Jeśli nie ustawiono, domyślne zachowanie to "auto". Po ustawieniu parametru service_tier treść odpowiedzi będzie zawierać wartość service_tierwartość oparta na trybie przetwarzania używanym do obsługi żądania. Ta wartość odpowiedzi może się różnić od wartości ustawionej w parametrze . |
| Typ | ciąg |
| Wartości | autodefaultflexscalepriority |
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 w witrynie
Domyślny format to { "type": "text" } bez żadnych dodatkowych opcji.
Niezalecane w przypadku modeli gpt-4o i nowszych:*
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ą.
Dyskryminowanie dla elementu OpenAI.TextResponseFormatConfiguration
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg | Tak |
OpenAI.Tool
Dyskryminator dla OpenAI.Tool
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
function |
OpenAI.FunctionTool |
file_search |
OpenAI.FileSearchTool |
computer_use_preview |
OpenAI.ComputerUsePreviewTool |
web_search_preview |
OpenAI.WebSearchPreviewTool |
code_interpreter |
OpenAI.CodeInterpreterTool |
image_generation |
OpenAI.ImageGenTool |
local_shell |
OpenAI.LocalShellTool |
mcp |
OpenAI.MCPTool |
bing_grounding |
BingGroundingAgentTool |
fabric_dataagent_preview |
MicrosoftFabricAgentTool |
sharepoint_grounding_preview |
SharepointAgentTool |
azure_ai_search |
AzureAISearchAgentTool |
openapi |
OpenApiAgentTool |
bing_custom_search_preview |
BingCustomSearchAgentTool |
browser_automation_preview |
BrowserAutomationAgentTool |
azure_function |
AzureFunctionAgentTool |
capture_structured_outputs |
CaptureStructuredOutputsTool |
a2a_preview |
A2ATool |
memory_search |
MemorySearchTool |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ToolType | Narzędzie, które może służyć do generowania odpowiedzi. | Tak |
OpenAI.ToolChoiceObject
Dyskryminator dla OpenAI.ToolChoiceObject
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
file_search |
OpenAI.ToolChoiceObjectFileSearch |
computer_use_preview |
OpenAI.ToolChoiceObjectComputer |
web_search_preview |
OpenAI.ToolChoiceObjectWebSearch |
image_generation |
OpenAI.ToolChoiceObjectImageGen |
code_interpreter |
OpenAI.ToolChoiceObjectCodeInterpreter |
function |
OpenAI.ToolChoiceObjectFunction |
mcp |
OpenAI.ToolChoiceObjectMCP |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.ToolChoiceObjectType | Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach. |
Tak |
OpenAI.ToolChoiceObjectCodeInterpreter
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: code_interpreter |
Tak |
OpenAI.ToolChoiceObjectComputer
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: computer_use_preview |
Tak |
OpenAI.ToolChoiceObjectFileSearch
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: file_search |
Tak |
OpenAI.ToolChoiceObjectFunction
Użyj tej opcji, aby wymusić wywołanie określonej funkcji przez model.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa funkcji do wywołania. | Tak | |
| typ | wyliczenie | W przypadku wywoływania funkcji typ to zawsze function.Możliwe wartości: function |
Tak |
OpenAI.ToolChoiceObjectImageGen
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: image_generation |
Tak |
OpenAI.ToolChoiceObjectMCP
Użyj tej opcji, aby wymusić wywołanie określonego narzędzia na zdalnym serwerze MCP.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nazwa | ciąg | Nazwa narzędzia do wywołania na serwerze. | Nie. | |
| etykieta_serwera | ciąg | Etykieta serwera MCP do użycia. | Tak | |
| typ | wyliczenie | W przypadku narzędzi MCP typ to zawsze mcp.Możliwe wartości: mcp |
Tak |
OpenAI.ToolChoiceObjectType
Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. Dowiedz się więcej o wbudowanych narzędziach.
| Majątek | Wartość |
|---|---|
| Opis | Wskazuje, że model powinien używać wbudowanego narzędzia do generowania odpowiedzi. |
| Dowiedz się więcej o wbudowanych narzędziach. | |
| Typ | ciąg |
| Wartości | file_searchfunctioncomputer_use_previewweb_search_previewimage_generationcode_interpretermcp |
OpenAI.ToolChoiceObjectWebSearch
Uwaga: web_search nie jest jeszcze dostępna za pośrednictwem usługi Azure OpenAI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: web_search_preview |
Tak |
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.
| Majątek | Wartość |
|---|---|
| Opis | 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 wiadomości a wykonywaniem połączeniawięcej narzędzi required oznacza, że model musi wywoływać co najmniej jedno narzędzie. |
| Typ | ciąg |
| Wartości | noneautorequired |
OpenAI.ToolType
Narzędzie, które może służyć do generowania odpowiedzi.
| Majątek | Wartość |
|---|---|
| Opis | Narzędzie, które może służyć do generowania odpowiedzi. |
| Typ | ciąg |
| Wartości | file_searchfunctioncomputer_use_previewweb_search_previewmcpcode_interpreterimage_generationlocal_shellbing_groundingbrowser_automation_previewfabric_dataagent_previewsharepoint_grounding_previewazure_ai_searchopenapibing_custom_search_previewcapture_structured_outputsa2a_previewazure_functionmemory_search |
OpenAI.TopLogProb
Najwyższe prawdopodobieństwo dziennika tokenu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| bytes | macierz | Tak | ||
| logprob | Liczba | Tak | ||
| kod przedpłaty | ciąg | Tak |
OpenAI.UpdateConversationRequest
Aktualizowanie konwersacji
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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.VectorStoreFileAttributes
Zestaw 16 par klucz-wartość, 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.WebSearchAction
Dyskryminowanie openAI.WebSearchAction
Ten składnik używa właściwości type do rozróżniania różnych typów:
| Wartość typu | Schema |
|---|---|
find |
OpenAI.WebSearchActionFind |
open_page |
OpenAI.WebSearchActionOpenPage |
search |
OpenAI.WebSearchActionSearch |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | OpenAI.WebSearchActionType | Tak |
OpenAI.WebSearchActionFind
Typ akcji "find": wyszukuje wzorzec na załadowanej stronie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| wzorzec | ciąg | Wzorzec lub tekst do wyszukania na stronie. | Tak | |
| typ | wyliczenie | Typ akcji. Możliwe wartości: find |
Tak | |
| Adres URL | ciąg | Adres URL strony wyszukał wzorzec. | Tak |
OpenAI.WebSearchActionOpenPage
Typ akcji "open_page" — otwiera określony adres URL z wyników wyszukiwania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ akcji. Możliwe wartości: open_page |
Tak | |
| Adres URL | ciąg | Adres URL otwarty przez model. | Tak |
OpenAI.WebSearchActionSearch
Typ akcji "search" — wykonuje zapytanie wyszukiwania w Internecie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| kwerenda | ciąg | Zapytanie wyszukiwania. | Tak | |
| Źródeł | macierz | Źródła wykorzystane w wyszukiwaniu. | Nie. | |
| typ | wyliczenie | Typ akcji. Możliwe wartości: search |
Tak |
OpenAI.WebSearchActionSearchSources
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Możliwe wartości: url |
Tak | |
| Adres URL | ciąg | Tak |
OpenAI.WebSearchActionType
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | searchopen_pagefind |
OpenAI.WebSearchPreviewTool
Uwaga: web_search nie jest jeszcze dostępna za pośrednictwem usługi Azure OpenAI.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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.
medium jest wartością domyślną.Możliwe wartości: low, , mediumhigh |
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 |
Tak | |
| lokalizacja_użytkownika | obiekt | Nie. | ||
| └typ | OpenAI.LocationType | Nie. |
OpenAI.WebSearchToolCallItemParam
Wyniki wywołania narzędzia wyszukiwania w sieci. Więcej informacji można znaleźć w przewodniku wyszukiwania w Internecie .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | obiekt | Tak | ||
| └typ | OpenAI.WebSearchActionType | Nie. | ||
| typ | wyliczenie | Możliwe wartości: web_search_call |
Tak |
OpenAI.WebSearchToolCallItemResource
Wyniki wywołania narzędzia wyszukiwania w sieci. Więcej informacji można znaleźć w przewodniku wyszukiwania w Internecie .
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| akcja | obiekt | Tak | ||
| └typ | OpenAI.WebSearchActionType | Nie. | ||
| stan | wyliczenie | Stan działania wyszukiwarki internetowej. Możliwe wartości: in_progress, , searching, completedfailed |
Tak | |
| typ | wyliczenie | Możliwe wartości: web_search_call |
Tak |
OpenAI.integer
Typ: liczba całkowita
Format: int64
OpenAI.numeric
Typ: liczba
Format: podwójne
OpenApiAgentTool
Informacje o definicji danych wejściowych narzędzia OpenAPI używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| openapi | obiekt | Informacje o definicji danych wejściowych dla funkcji openapi. | Tak | |
| └* uwierzytelnianie | OpenApiAuthDetails | Szczegóły uwierzytelniania interfejsu API | Nie. | |
| └default_params | macierz | 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 └* | macierz | Lista definicji funkcji używanych przez narzędzie OpenApi | Nie. | |
| └─ nazwa | ciąg | Nazwa funkcji do wywołania. | Nie. | |
| └* specyfikacja | Kształt funkcji openapi opisany jako obiekt schematu JSON. | Nie. | ||
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'openapi'. Możliwe wartości: openapi |
Tak |
OpenApiAnonymousAuthDetails
Szczegóły zabezpieczeń uwierzytelniania anonimowego openApi
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | wyliczenie | Typ obiektu, który jest zawsze "anonimowy". Możliwe wartości: anonymous |
Tak |
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:
| Wartość typu | Schema |
|---|---|
anonymous |
OpenApiAnonymousAuthDetails |
project_connection |
OpenApiProjectConnectionAuthDetails |
managed_identity |
OpenApiManagedAuthDetails |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to: — Anonimowe (bez wymaganego uwierzytelniania) — Połączenie projektu (wymaga project_connection_id do punktu końcowego, zgodnie z konfiguracją w narzędziu Foundry) - Managed_Identity (wymaga odbiorców uwierzytelniania opartego na tożsamościach) |
Tak |
OpenApiAuthType
Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to:
- Anonimowy (uwierzytelnianie nie jest wymagane)
- Połączenie projektu (wymaga project_connection_id do punktu końcowego, zgodnie z konfiguracją w narzędziu Foundry)
- Managed_Identity (wymaga odbiorców do uwierzytelniania opartego na tożsamości)
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | anonymousproject_connectionmanaged_identity |
OpenApiFunctionDefinition
Informacje o definicji danych wejściowych dla funkcji openapi.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| auth | obiekt | szczegóły uwierzytelniania dla elementu OpenApiFunctionDefinition | Tak | |
| └typ | OpenApiAuthType | Typ uwierzytelniania musi być anonimowy/project_connection/managed_identity | Nie. | |
| default_params | macierz | 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 | macierz | Lista definicji funkcji używanych przez narzędzie OpenApi | Nie. | |
| nazwa | ciąg | Nazwa funkcji do wywołania. | Tak | |
| specyfikacja | Kształt funkcji openapi opisany jako obiekt schematu JSON. | Tak |
OpenApiManagedAuthDetails
Szczegóły zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| security_scheme | obiekt | Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity | Tak | |
| └odbiorców | ciąg | Zakres uwierzytelniania dla typu uwierzytelniania managed_identity | Nie. | |
| typ | wyliczenie | Typ obiektu, który jest zawsze "managed_identity". Możliwe wartości: managed_identity |
Tak |
OpenApiManagedSecurityScheme
Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| audience | ciąg | Zakres uwierzytelniania dla typu uwierzytelniania managed_identity | Tak |
OpenApiProjectConnectionAuthDetails
Szczegóły zabezpieczeń dotyczące uwierzytelniania połączenia projektu OpenApi
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| security_scheme | obiekt | Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity | Tak | |
| └project_connection_id | ciąg | Identyfikator połączenia projektu dla typu uwierzytelniania połączenia projektu | Nie. | |
| typ | wyliczenie | Typ obiektu, którym zawsze jest 'project_connection'. Możliwe wartości: project_connection |
Tak |
OpenApiProjectConnectionSecurityScheme
Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| project_connection_id | ciąg | Identyfikator połączenia projektu dla typu uwierzytelniania połączenia projektu | Tak |
PagedConnection
Stronicowana kolekcja elementów połączenia
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy połączenia na tej stronie | Tak |
PagedDatasetVersion
Stronicowana kolekcja elementów DatasetVersion
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy DatasetVersion na tej stronie | Tak |
PagedDeployment
Stronicowana kolekcja elementów wdrożenia
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy wdrożenia na tej stronie | Tak |
PagedEvaluationRule
Stronicowana kolekcja elementów EvaluationRule
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy EvaluationRule na tej stronie | Tak |
PagedEvaluationTaxonomy
Stronicowana kolekcja elementów EvaluationTaxonomy
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy EvaluationTaxonomy na tej stronie | Tak |
PagedEvaluatorVersion
Stronicowana kolekcja elementów EvaluatorVersion
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy EvaluatorVersion na tej stronie | Tak |
PagedIndex
Stronicowana kolekcja elementów indeksu
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy indeksu na tej stronie | Tak |
PagedInsight
Stronicowana kolekcja elementów szczegółowych informacji
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy szczegółowych informacji na tej stronie | Tak |
PagedRedTeam
Stronicowana kolekcja elementów RedTeam
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy RedTeam na tej stronie | Tak |
PagedSchedule
Stronicowana kolekcja elementów harmonogramu
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy harmonogramu na tej stronie | Tak |
PagedScheduleRun
Stronicowana kolekcja elementów ScheduleRun
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| nextLink | ciąg | Link do następnej strony elementów | Nie. | |
| wartość | macierz | Elementy ScheduleRun na tej stronie | Tak |
PendingUploadRequest
Reprezentuje prośbę o oczekujące przesłanie.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| connectionName (nazwa_połączenia) | 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 | BlobReference jest jedynym obsługiwanym typem. Możliwe wartości: BlobReference |
Tak |
PendingUploadResponse
Reprezentuje odpowiedź na oczekujące żądanie przesłania
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| BlobReference | obiekt | Szczegóły odwołania do obiektu blob. | Tak | |
| └* 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 |
Nie. | |
| Poświadczenie └* | SasCredential | Informacje o poświadczeniach w celu uzyskania dostępu do konta magazynu. | Nie. | |
| └* storageAccountArmId | ciąg | Identyfikator usługi ARM konta magazynu do użycia. | Nie. | |
| pendingUploadId | ciąg | Identyfikator tego żądania przesłania. | Tak | |
| pendingUploadType | wyliczenie | BlobReference jest jedynym obsługiwanym typem Możliwe wartości: BlobReference |
Tak | |
| 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| instructions | ciąg | Komunikat systemu (lub dewelopera) wstawiony do kontekstu modelu. | Nie. | |
| rodzaj | wyliczenie | Możliwe wartości: prompt |
Tak | |
| model | ciąg | Wdrożenie modelu do użycia dla tego agenta. | Tak | |
| reasoning | obiekt |
Tylko modele serii o Opcje konfiguracji dla modeli rozumowania. |
Nie. | |
| └─ wysiłek | OpenAI.ReasoningEffort | Ogranicza nakład pracy na rozumowanie modeli rozumowania. Obecnie obsługiwane wartości nie są żadne, minimalne, niskie, średnie i wysokie. Zmniejszenie nakładu pracy w zakresie rozumowania może spowodować szybsze reagowanie i mniej tokenów używanych podczas rozumowania w odpowiedzi. Wartość domyślna gpt-5.1 nie jest równa żadnej, która nie wykonuje rozumowania. Obsługiwane wartości rozumowania dla biblioteki gpt-5.1 nie są żadne, niskie, średnie i wysokie. Wywołania narzędzi są obsługiwane dla wszystkich wartości rozumowania w gpt-5.1. Wszystkie modele przed gpt-5.1 domyślnie średni wysiłek rozumowania i nie obsługują żadnego. Domyślnie model gpt-5-pro ma wartość (i obsługuje tylko) duży wysiłek rozumowania. |
Nie. | |
| └─ generuj_podsumowanie | wyliczenie |
Przestarzałe: użyj summary zamiast. Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu.
autoJeden z , conciselub detailed.Możliwe wartości: auto, , concisedetailed |
Nie. | |
| └─ Podsumowanie | wyliczenie | Podsumowanie rozumowania wykonywanego przez model. Może to być przydatne do debugowania i zrozumienia procesu rozumowania modelu. autoJeden z , conciselub detailed.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 | Liczba | 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 | obiekt | Opcje konfiguracji generowania odpowiedzi tekstowej przez model. Może to być zwykły tekst lub dane JSON ze strukturą. | Nie. | |
| Format └─ | OpenAI.ResponseTextFormatConfiguration | Nie. | ||
| narzędzia | macierz | 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 | Liczba | 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 |
PromptBasedEvaluatorDefinition
Ewaluator oparty na podpowiedziach
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| prompt_text | ciąg | Tekst monitu używany do oceny | Tak | |
| typ | wyliczenie | Możliwe wartości: prompt |
Tak |
ProtocolVersionRecord
Mapowanie rekordu dla pojedynczego protokołu i jego wersji.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| protokół | obiekt | Tak | ||
| wersja | ciąg | Ciąg wersji protokołu, np. 'v0.1.1'. | Tak |
RaiConfig
Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI).
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rai_policy_name | ciąg | Nazwa zasady RAI, która ma zostać zastosowana. | Tak |
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:
| Wartość typu | Schema |
|---|---|
Hourly |
HourlyRecurrenceSchedule |
Daily |
DailyRecurrenceSchedule |
Weekly |
WeeklyRecurrenceSchedule |
Monthly |
MonthlyRecurrenceSchedule |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Typ cyklu. | Tak |
RecurrenceTrigger
Wyzwalacz oparty na cyklu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| endTime | ciąg | Godzina zakończenia harmonogramu cyklu w formacie ISO 8601. | Nie. | |
| interwał | liczba całkowita | Interwał harmonogramu cyklu. | Tak | |
| grafik | obiekt | Model harmonogramu cykli. | Tak | |
| └typ | Typ cyklu | Typ cyklu dla harmonogramu cyklu. | Nie. | |
| startTime | ciąg | Godzina rozpoczęcia harmonogramu cyklu w formacie ISO 8601. | Nie. | |
| strefa czasowa | ciąg | Strefa czasowa dla harmonogramu cyklu. | Nie. | UTC |
| typ | wyliczenie | Typ wyzwalacza. Możliwe wartości: Recurrence |
Tak |
Typ cyklu
Typ cyklu.
| Majątek | Wartość |
|---|---|
| Opis | Typ cyklu. |
| Typ | ciąg |
| Wartości | HourlyDailyWeeklyMonthly |
RedTeam
Szczegóły czerwonej drużyny.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| applicationScenario | ciąg | Scenariusz aplikacji dla operacji red team, w celu wygenerowania ataków specyficznych dla scenariusza. | Nie. | |
| attackStrategies | macierz | Lista strategii ataku lub zagnieżdżone listy strategii ataku. | Nie. | |
| displayName | ciąg | Nazwa biegu czerwonej drużyny. | Nie. | |
| identyfikator | ciąg | Identyfikator biegu drużyny czerwonej. | Tak | |
| liczbawywracania | liczba całkowita | Liczba rund symulacji. | Nie. | |
| properties | obiekt | Właściwości czerwonej drużyny. 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 | macierz | Lista kategorii ryzyka, dla których mają być generowane cele ataku. | Nie. | |
| symulacjaOnly | typ logiczny (boolowski) | Tylko symulacja lub Symulacja + ocena. Wartość domyślna false, jeśli true skanowanie generuje wynik konwersacji, a nie wynik oceny. | Nie. | Nieprawda |
| stan | ciąg | Status czerwonej drużyny. Jest on ustawiany przez usługę i jest tylko do odczytu. | Nie. | |
| tags | obiekt | Tagi czerwonej drużyny. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| miejsce docelowe | obiekt | Klasa abstrakcyjna dla konfiguracji docelowej. | Tak | |
| └typ | ciąg | Typ konfiguracji modelu. | Nie. |
RedTeamItemGenerationParams
Reprezentuje parametry generowania elementów zespołu czerwonego.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| attack_strategies | macierz | Kolekcja strategii ataków, które mają być używane. | Tak | |
| num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Tak | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze red_team.Możliwe wartości: red_team |
Tak |
Kategoria ryzyka
Kategoria ryzyka dla celu ataku.
| Majątek | Wartość |
|---|---|
| Opis | Kategoria ryzyka dla celu ataku. |
| Typ | ciąg |
| Wartości | HateUnfairnessViolenceSexualSelfHarmProtectedMaterialCodeVulnerabilityUngroundedAttributesProhibitedActionsSensitiveDataLeakageTaskAdherence |
Sygnatury dostępu współdzielonego
Definicja poświadczeń sygnatury dostępu współdzielonego (SAS)
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| SAS | ciąg | token SAS | Nie. | |
| typ | wyliczenie | Typ poświadczeń Możliwe wartości: SAS |
Tak |
SampleType
Rodzaj próbki użytej w analizie.
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | EvaluationResultSample |
Poświadczenia SasCredential
Definicja poświadczeń sygnatury dostępu współdzielonego
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| sasUri | ciąg | Identyfikator URI sygnatury dostępu współdzielonego | Tak | |
| typ | wyliczenie | Rodzaj poświadczenia Możliwe wartości: SAS |
Tak |
Schedule
Model harmonogramu.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis harmonogramu. | Nie. | |
| displayName | ciąg | Nazwa harmonogramu. | Nie. | |
| włączony | typ logiczny (boolowski) | Włączony stan harmonogramu. | Tak | |
| identyfikator | ciąg | Identyfikator harmonogramu. | Tak | |
| 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) | obiekt | Zaplanuj stan apryfikacji. | Nie. | |
| daneSystemowe | obiekt | Metadane systemowe zasobu. | Tak | |
| tags | obiekt | Tagi harmonogramu. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne. | Nie. | |
| zadanie | obiekt | Zaplanuj model zadań. | Tak | |
| Konfiguracja └* | obiekt | Konfiguracja dla zadania. | Nie. | |
| └typ | ScheduleTaskType | Typ zadania. | Nie. | |
| wyzwalacz | obiekt | Model podstawowy dla wyzwalacza harmonogramu. | Tak | |
| └typ | Typ wyzwalacza | Typ wyzwalacza. | Nie. |
ScheduleProvisioningStatus
Zaplanuj stan apryfikacji.
| Majątek | Wartość |
|---|---|
| Opis | Zaplanuj stan apryfikacji. |
| Typ | ciąg |
| Wartości | CreatingUpdatingDeletingSucceededFailed |
ScheduleRun
Zaplanuj model uruchamiania.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| błąd | ciąg | Informacje o błędzie dla uruchomienia harmonogramu. | Nie. | |
| identyfikator | ciąg | Identyfikator przebiegu harmonogramu. | Tak | |
| properties | obiekt | Właściwości harmonogramu są uruchamiane. | Tak | |
| identyfikator harmonogramu | ciąg | Identyfikator harmonogramu. | Tak | |
| sukces | typ logiczny (boolowski) | Wyzwalanie stanu powodzenia uruchomienia harmonogramu. | Tak | |
| triggerTime | ciąg | Czas wyzwolenia uruchomienia 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:
| Wartość typu | Schema |
|---|---|
Evaluation |
EvaluationScheduleTask |
Insight |
InsightScheduleTask |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| konfiguracja | obiekt | Konfiguracja dla zadania. | Nie. | |
| typ | obiekt | Typ zadania. | Tak |
ScheduleTaskType
Typ zadania.
| Majątek | Wartość |
|---|---|
| Opis | Typ zadania. |
| Typ | ciąg |
| Wartości | EvaluationInsight |
SeedPromptsRedTeamItemGenerationParams
Reprezentuje parametry generowania czerwonego elementu zespołu z monitami dotyczącymi inicjatora.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| attack_strategies | macierz | Kolekcja strategii ataków, które mają być używane. | Tak | |
| num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Tak | |
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Nie. | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze red_team.Możliwe wartości: red_team_seed_prompts |
Tak |
SharepointAgentTool
Informacje o definicji danych wejściowych narzędzia sharepoint używane do konfigurowania agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| sharepoint_grounding_preview | obiekt | Parametry narzędzia do uziemiania programu sharepoint. | Tak | |
| └project_connections | macierz | Połączenia projektu dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Nie. | |
| typ | wyliczenie | Typ obiektu, który jest zawsze "sharepoint_grounding". Możliwe wartości: sharepoint_grounding_preview |
Tak |
SharepointGroundingToolParameters
Parametry narzędzia do uziemiania programu sharepoint.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| project_connections | macierz | Połączenia projektu dołączone do tego narzędzia. Może istnieć maksymalnie 1 połączenie zasób dołączony do narzędzia. |
Nie. |
SKU
Informacje o jednostce SKU
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| dyspozycyjność | liczba całkowita | Pojemność jednostki SKU | Tak | |
| family | ciąg | Rodzina SKU | Tak | |
| nazwa | ciąg | Nazwa jednostki SKU | Tak | |
| rozmiar | ciąg | Rozmiar jednostki SKU | Tak | |
| warstwa | ciąg | Warstwa jednostki SKU | Tak |
StructuredInputDefinition
Ustrukturyzowane dane wejściowe, które mogą uczestniczyć w monitujących podstawieniach szablonów i wiązaniu argumentów narzędzia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| 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 | typ logiczny (boolowski) | Określa, czy właściwość wejściowa jest wymagana, gdy agent jest wywoływany. | Nie. | Nieprawda |
| schemat | Schemat JSON dla danych wejściowych ze strukturą (opcjonalnie). | Nie. |
StructuredOutputDefinition
Ustrukturyzowane dane wyjściowe, które mogą być generowane przez agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis danych wyjściowych, które mają zostać wyemitowane. Używany przez model do określania, kiedy należy wyemitować dane wyjściowe. | Tak | |
| nazwa | ciąg | Nazwa ustrukturyzowanych danych wyjściowych. | Tak | |
| schemat | Schemat JSON dla ustrukturyzowanych danych wyjściowych. | Tak | ||
| surowy | typ logiczny (boolowski) | Określa, czy wymuszać ścisłą walidację. Wartość domyślna true. |
Tak |
StructuredOutputsItemResource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| We/Wy | Dane wyjściowe ze strukturą przechwycone podczas odpowiedzi. | Tak | ||
| typ | wyliczenie | Możliwe wartości: structured_outputs |
Tak |
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:
| Wartość typu | Schema |
|---|---|
azure_ai_model |
AzureAIModelTarget |
azure_ai_agent |
AzureAIAgentTarget |
azure_ai_assistant |
AzureAIAssistantTarget |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg | Typ obiektu docelowego. | Tak |
TargetCompletions
Reprezentuje źródło danych dla docelowej konfiguracji oceny ukończenia.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| wiadomości wejściowe | obiekt | Nie. | ||
| └item_reference | ciąg | Nie. | ||
| └typ | wyliczenie | Możliwe wartości: item_reference |
Nie. | |
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Nie. | |
| miejsce docelowe | obiekt | Klasa bazowa dla obiektów docelowych z obsługą dyskryminatora. | Tak | |
| └typ | ciąg | Typ obiektu docelowego. | Nie. | |
| typ | wyliczenie | Typ źródła danych, zawsze TargetCompletions.Możliwe wartości: azure_ai_target_completions |
Tak |
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:
| Wartość typu | Schema |
|---|---|
AzureOpenAIModel |
AzureOpenAIModelConfiguration |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg | Typ konfiguracji modelu. | Tak |
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:
| Wartość typu | Schema |
|---|---|
azure_ai_model |
AzureAIModelTargetUpdate |
azure_ai_assistant |
AzureAIAssistantTargetUpdate |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | ciąg | Typ obiektu docelowego. | Tak |
TaksonomiaCategory
Definicja kategorii taksonomii.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis kategorii taksonomii. | Nie. | |
| identyfikator | ciąg | Niepowtarzalny identyfikator kategorii taksonomii. | Tak | |
| nazwa | ciąg | Nazwa kategorii taksonomii. | Tak | |
| properties | obiekt | Dodatkowe właściwości dla kategorii taksonomii. | Nie. | |
| riskCategory | obiekt | Kategoria ryzyka dla celu ataku. | Tak | |
| Podkategorie | macierz | Lista podkategorii taksonomii. | Tak |
TaksonomyRedTeamItemGenerationParams
Reprezentuje parametry generowania czerwonego elementu zespołu z monitami dotyczącymi inicjatora.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| attack_strategies | macierz | Kolekcja strategii ataków, które mają być używane. | Tak | |
| num_turns | liczba całkowita | Liczba zakrętów dozwolona w grze. | Tak | |
| przesłać źródło | obiekt | Tak | ||
| └─ zawartość | macierz | Zawartość pliku jsonl. | Nie. | |
| └─ ID | ciąg | Identyfikator pliku. | Nie. | |
| └typ | wyliczenie | Typ źródła jsonl. Zawsze file_id.Możliwe wartości: file_id |
Nie. | |
| typ | wyliczenie | Typ parametrów generowania elementów, zawsze red_team.Możliwe wartości: red_team_taxonomy |
Tak |
TaksonomiaSubCategory
Definicja podkategorii taksonomii.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Opis podkategorii taksonomii. | Nie. | |
| włączony | typ logiczny (boolowski) | Wykaz pozycji taksonomii w ramach tej podkategorii. | Tak | |
| identyfikator | ciąg | Niepowtarzalny identyfikator podkategorii taksonomii. | Tak | |
| nazwa | ciąg | Nazwa podkategorii taksonomii. | Tak | |
| properties | obiekt | Dodatkowe właściwości dla podkategorii taksonomii. | Nie. |
ToolDescription
Opis narzędzia, które może być używane przez agenta.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Krótki opis przeznaczenia narzędzia. | Nie. | |
| nazwa | ciąg | Nazwa narzędzia. | Nie. |
ToolProjectConnection
Zasób połączenia z projektem.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| project_connection_id | ciąg | Połączenie projektu w elemencie ToolProjectConnectionList dołączonym do tego narzędzia. | Tak |
TracesEvalRunDataSource
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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| lookback_hours | liczba całkowita | Okno wyszukiwania (w godzinach) stosowane podczas pobierania śladów z usługi Application Insights. | Nie. | 168 |
| trace_ids | macierz | Kolekcja identyfikatorów śledzenia agenta, które powinny być oceniane. | Tak | |
| typ | wyliczenie | Typ źródła danych, zawsze azure_ai_traces.Możliwe wartości: azure_ai_traces |
Tak |
TreatmentEffectType
Rodzaj efektu zabiegu.
| Majątek | Wartość |
|---|---|
| Typ | ciąg |
| Wartości | TooFewSamplesInconclusiveChangedImprovedDegraded |
Wyzwalacz
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:
| Wartość typu | Schema |
|---|---|
Cron |
CronTrigger (Wyzwalacz Crona) |
Recurrence |
Wyzwalacz cyklu |
OneTime |
OneTimeTrigger |
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| typ | obiekt | Typ wyzwalacza. | Tak |
Typ wyzwalacza
Typ wyzwalacza.
| Majątek | Wartość |
|---|---|
| Opis | Typ wyzwalacza. |
| Typ | ciąg |
| Wartości | CronRecurrenceOneTime |
UpdateAgentFromManifestRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| manifest_id | ciąg | Identyfikator manifestu do zaimportowania wersji agenta. | Tak | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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. | Tak |
UpdateAgentRequest
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| definicja | obiekt | Tak | ||
| Rodzaj └* | AgentKind | Nie. | ||
| └rai_config | RaiConfig | Konfiguracja filtrowania treści i funkcji bezpieczeństwa Responsible AI (RAI). | Nie. | |
| opis | ciąg | Czytelny dla człowieka opis agenta. | Nie. | |
| metadane | obiekt | Zestaw 16 par klucz-wartość, 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| metadane | OpenAI.Metadata | Zestaw 16 par klucz-wartość, 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 | Opis | Wymagane | Default |
|---|---|---|---|---|
| rodzaj | wyliczenie | Rodzaj elementu pamięci. Możliwe wartości: user_profile |
Tak |
WeeklyRecurrenceSchedule
Tygodniowy harmonogram nawrotów.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| Dni tygodnia | macierz | Dni tygodnia dla harmonogramu cyklu. | Tak | |
| typ | wyliczenie | Typ nawrotu tygodniowego. Możliwe wartości: Weekly |
Tak |
WorkflowActionOutputItemResource
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| action_id | ciąg | Unikatowy identyfikator akcji. | Tak | |
| rodzaj | ciąg | Rodzaj akcji CSDL (np. "SetVariable", "InvokeAzureAgent"). | Tak | |
| 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. | |
| stan | wyliczenie | Stan akcji (np. "in_progress", "completed", "failed", "cancelled". Możliwe wartości: completed, , failed, in_progresscancelled |
Tak | |
| typ | wyliczenie | Możliwe wartości: workflow_action |
Tak |
WorkflowAgentDefinition
Definicja agenta przepływu pracy.
| Name | Typ | Opis | Wymagane | Default |
|---|---|---|---|---|
| rodzaj | wyliczenie | Możliwe wartości: workflow |
Tak | |
| przepływ pracy | ciąg | Definicja CSDL YAML przepływu pracy. | Nie. |
liczba całkowita
Typ: liczba całkowita
Format: int64