Runs - Update Run

Usługa:

AI Foundry

Wersja interfejsu API:

v1

Modyfikuje istniejący przebieg wątku.

POST {endpoint}/threads/{threadId}/runs/{runId}?api-version=v1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Punkt końcowy projektu w postaci: https://.services.ai.azure.com/api/projects/
runId	path	True	string	Identyfikator przebiegu.
threadId	path	True	string	Identyfikator wątku.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
metadata		Zestaw maksymalnie 16 par klucz/wartość, które mogą być dołączone do obiektu, używane do przechowywania dodatkowych informacji o tym obiekcie w formacie ustrukturyzowanym. Klucze mogą mieć długość maksymalnie 64 znaków, a wartości mogą mieć maksymalnie 512 znaków.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ThreadRun	Informacje o zmodyfikowanym przebiegu.
Other Status Codes	AgentV1Error	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
https://ai.azure.com/.default

Definicje

Nazwa	Opis
AgentErrorDetail	Opisuje informacje o błędach zwracane przez interfejs API agentów.
AgentV1Error	Ładunek błędu zwrócony przez interfejs API agentów.
AISearchIndexResource	Zasób AI Search Index.
AzureAISearchQueryType	Dostępne typy zapytań dla narzędzia Azure AI Search.
AzureAISearchToolDefinition	Informacje o definicji danych wejściowych narzędzia wyszukiwania sztucznej inteligencji platformy Azure używane do konfigurowania agenta.
AzureAISearchToolResource	Zestaw zasobów indeksu używanych przez narzędzie azure_ai_search.
AzureFunctionBinding	Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI.
AzureFunctionDefinition	Definicja funkcji platformy Azure.
AzureFunctionStorageQueue	Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI.
AzureFunctionToolDefinition	Informacje o definicji danych wejściowych narzędzia funkcji platformy Azure używane do konfigurowania agenta.
BingGroundingSearchConfiguration	Wyszukaj konfigurację dla Bing Grounding
BingGroundingSearchToolParameters	Parametry narzędzia wyszukiwania uziemienia Bing.
BingGroundingToolDefinition	Informacje o definicji danych wejściowych narzędzia wyszukiwania uziemieniowego bing używane do konfigurowania agenta.
CodeInterpreterToolDefinition	Informacje o definicji danych wejściowych narzędzia interpretera kodu używane do konfigurowania agenta.
CodeInterpreterToolResource	Zestaw zasobów używanych przez narzędzie code_interpreter.
ConnectedAgentDetails	Informacje dotyczące łączenia jednego agenta z drugim jako narzędzia
ConnectedAgentToolDefinition	Informacje o definicji danych wejściowych dla narzędzia połączonego agenta, które definiuje agenta podrzędnego specyficznego dla domeny
FileSearchRankingOptions	Opcje klasyfikacji wyszukiwania plików.
FileSearchToolDefinition	Informacje o definicji wejściowej narzędzia wyszukiwania plików używane do konfigurowania agenta.
FileSearchToolDefinitionDetails	Opcje zastępują narzędzie wyszukiwania plików.
FileSearchToolResource	Zestaw zasobów używanych przez narzędzie file_search.
FunctionDefinition	Informacje o definicji danych wejściowych funkcji.
FunctionToolDefinition	Informacje o definicji danych wejściowych narzędzia funkcji używane do konfigurowania agenta.
IncompleteDetailsReason	Powód, dla którego przebieg jest niekompletny. Będzie to wskazywać, który limit tokenów został osiągnięty w trakcie przebiegu.
IncompleteRunDetails	Szczegółowe informacje o tym, dlaczego przebieg jest niekompletny. Jeśli przebieg nie jest niekompletny, zostanie null.
OpenApiAnonymousAuthDetails	Szczegóły zabezpieczeń uwierzytelniania anonimowego openApi
OpenApiAuthType	Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to: Anonimowy (uwierzytelnianie nie jest wymagane) Połączenie (wymaga connection_id do punktu końcowego, zgodnie z konfiguracją w AI Foundry) Managed_Identity (wymaga odbiorców do uwierzytelniania opartego na tożsamości)
OpenApiConnectionAuthDetails	Szczegóły zabezpieczeń uwierzytelniania połączeń openApi
OpenApiConnectionSecurityScheme	Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
OpenApiFunctionDefinition	Informacje o definicji danych wejściowych dla funkcji openapi.
OpenApiManagedAuthDetails	Szczegóły zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
OpenApiManagedSecurityScheme	Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity
OpenApiToolDefinition	Informacje o definicji danych wejściowych narzędzia OpenAPI używane do konfigurowania agenta.
RequiredFunctionToolCall	Reprezentacja żądanego wywołania narzędzia funkcji wymaganego przez model w celu kontynuowania oceny przebiegu.
RequiredFunctionToolCallDetails	Szczegółowe informacje dotyczące wywołania funkcji, podane przez wymaganą akcję wywołującą narzędzie funkcji, które zawiera nazwę i argumenty funkcji.
RunCompletionUsage	Statystyki użycia związane z uruchomieniem. Ta wartość będzie null, jeśli przebieg nie znajduje się w stanie terminalu (tj. in_progress, queueditp.).
RunError	Szczegóły błędu napotkane przez uruchomienie wątku agenta.
RunStatus	Możliwe wartości stanu przebiegu wątku agenta.
SubmitToolOutputsAction	Szczegóły wymaganych wywołań narzędzi, które muszą zostać przesłane do uruchomienia wątku agenta, aby kontynuować.
SubmitToolOutputsDetails	Szczegóły opisujące narzędzia, które powinny być wywoływane w celu przesyłania danych wyjściowych narzędzia.
ThreadRun	Dane reprezentujące pojedynczy przebieg oceny wątku agenta.
ToolResources	Zestaw zasobów używanych przez narzędzia agenta. Zasoby są specyficzne dla typu narzędzia. Na przykład code_interpreter narzędzie wymaga listy identyfikatorów plików, a file_search narzędzie wymaga listy identyfikatorów magazynów wektorów.
TruncationObject	Określa sposób obcinania wątku przed uruchomieniem. Służy do kontrolowania początkowego okna kontekstu przebiegu.
TruncationStrategy	Możliwe strategie obcinania dla wątku.
VectorStoreConfiguration	Konfiguracja magazynu wektorowego to lista źródeł danych używanych w przypadku użycia wielu plików do wyszukiwania plików przedsiębiorstwa.
VectorStoreConfigurations	Struktura zawierająca listę konfiguracji magazynu wektorowego, tj. listę identyfikatorów zasobów platformy Azure.
VectorStoreDataSource	Struktura zawierająca ścieżkę identyfikatora URI zasobu platformy Azure i typ zasobu pliku używanego jako źródło danych dla wyszukiwania plików przedsiębiorstwa.
VectorStoreDataSourceAssetType	Typ zasobu magazynu wektorowego. Typ zasobu może być uri_asset, w tym przypadku powinien zawierać identyfikator URI zasobu, w przypadku id_asset powinien zawierać identyfikator danych.

AgentErrorDetail

Objekt

Opisuje informacje o błędach zwracane przez interfejs API agentów.

Nazwa	Typ	Opis
code	string	Kod błędu nadający się do odczytu maszynowego.
message	string	Opis błędu czytelny dla człowieka.
param	string	Nazwa parametru, który spowodował błąd, jeśli dotyczy.
type	string	Identyfikator typu błędu (np. invalid_request_error).

AgentV1Error

Objekt

Ładunek błędu zwrócony przez interfejs API agentów.

Nazwa	Typ	Opis
error	AgentErrorDetail	Reprezentuje błąd.

AISearchIndexResource

Objekt

Zasób AI Search Index.

Nazwa	Typ	Opis
filter	string	Filtruj ciąg dla zasobu wyszukiwania.
index_asset_id	string	Identyfikator zasobu indeksu dla zasobu wyszukiwania.
index_connection_id	string	Identyfikator połączenia indeksu w pliku IndexResource dołączony do tego agenta.
index_name	string	Nazwa indeksu w indeksieResource dołączonym do tego agenta.
query_type	AzureAISearchQueryType	Typ zapytania w AIIndexResource dołączony do tego agenta.
top_k	integer (int32)	Liczba dokumentów do pobrania z wyszukiwania i prezentowania do modelu.

AzureAISearchQueryType

Wyliczanie

Dostępne typy zapytań dla narzędzia Azure AI Search.

Wartość	Opis
semantic	Typ zapytania semantic
simple	Typ zapytania simple
vector	Typ zapytania vector
vector_semantic_hybrid	Typ zapytania vector_semantic_hybrid
vector_simple_hybrid	Typ zapytania vector_simple_hybrid

AzureAISearchToolDefinition

Objekt

Informacje o definicji danych wejściowych narzędzia wyszukiwania sztucznej inteligencji platformy Azure używane do konfigurowania agenta.

Nazwa	Typ	Opis
type	string: azure_ai_search	Typ obiektu.

AzureAISearchToolResource

Objekt

Zestaw zasobów indeksu używanych przez narzędzie azure_ai_search.

Nazwa	Typ	Opis
indexes	AISearchIndexResource[]	Indeksy dołączone do tego agenta. Może istnieć maksymalnie 1 zasób indeksu dołączony do agenta.

AzureFunctionBinding

Objekt

Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI.

Nazwa	Typ	Opis
storage_queue	AzureFunctionStorageQueue	Kolejka magazynu.
type	enum: storage_queue	Typ powiązania, który jest zawsze "storage_queue".

AzureFunctionDefinition

Objekt

Definicja funkcji platformy Azure.

Nazwa	Typ	Opis
function	FunctionDefinition	Definicja funkcji platformy Azure i jej parametrów.
input_binding	AzureFunctionBinding	Kolejka magazynu wejściowego. Wyzwalacz magazynu kolejek uruchamia funkcję w miarę dodawania do niej komunikatów.
output_binding	AzureFunctionBinding	Kolejka magazynu wyjściowego. Funkcja zapisuje dane wyjściowe w tej kolejce po przetworzeniu elementów wejściowych.

AzureFunctionStorageQueue

Objekt

Struktura przechowywania nazwy kolejki magazynu i identyfikatora URI.

Nazwa	Typ	Opis
queue_name	string	Nazwa kolejki usługi Azure Function Storage.
queue_service_endpoint	string	Identyfikator URI usługi Azure Storage Queue Service umożliwiający manipulowanie kolejką.

AzureFunctionToolDefinition

Objekt

Informacje o definicji danych wejściowych narzędzia funkcji platformy Azure używane do konfigurowania agenta.

Nazwa	Typ	Opis
azure_function	AzureFunctionDefinition	Definicja funkcji, którą narzędzie funkcji powinno wywołać.
type	string: azure_function	Typ obiektu.

BingGroundingSearchConfiguration

Objekt

Wyszukaj konfigurację dla Bing Grounding

Nazwa	Typ	Opis
connection_id	string	Identyfikator połączenia do uziemienia za pomocą wyszukiwania Bing
count	integer (int64)	Liczba wyników wyszukiwania do zwrócenia w odpowiedzi interfejsu API Bing
freshness	string	Filtruj wyniki wyszukiwania według określonego zakresu czasu. Dopuszczalne wartości: https://learn.microsoft.com/bing/search-apis/bing-web-search/reference/query-parameters
market	string	Rynek, z którego pochodzą wyniki.
set_lang	string	Język, który ma być używany dla ciągów interfejsu użytkownika podczas wywoływania interfejsu API Bing.

BingGroundingSearchToolParameters

Objekt

Parametry narzędzia wyszukiwania uziemienia Bing.

Nazwa	Typ	Opis
search_configurations	BingGroundingSearchConfiguration[]	Konfiguracje wyszukiwania dołączone do tego narzędzia. Do narzędzia może być dołączony maksymalnie 1 zasób konfiguracji wyszukiwania.

BingGroundingToolDefinition

Objekt

Informacje o definicji danych wejściowych narzędzia wyszukiwania uziemieniowego bing używane do konfigurowania agenta.

Nazwa	Typ	Opis
bing_grounding	BingGroundingSearchToolParameters	Parametry narzędzia wyszukiwania uziemienia Bing.
type	string: bing_grounding	Typ obiektu.

CodeInterpreterToolDefinition

Objekt

Informacje o definicji danych wejściowych narzędzia interpretera kodu używane do konfigurowania agenta.

Nazwa	Typ	Opis
type	string: code_interpreter	Typ obiektu.

CodeInterpreterToolResource

Objekt

Zestaw zasobów używanych przez narzędzie code_interpreter.

Nazwa	Typ	Opis
data_sources	VectorStoreDataSource[]	Źródła danych do użycia. Ta opcja wzajemnie wyklucza się z właściwością fileIds.
file_ids	string[]	Lista identyfikatorów plików udostępnionych narzędziu code_interpreter . Może istnieć maksymalnie 20 plików skojarzonych z narzędziem.

ConnectedAgentDetails

Objekt

Informacje dotyczące łączenia jednego agenta z drugim jako narzędzia

Nazwa	Typ	Opis
description	string	Opis tego, co robi agent, używany przez model do wybierania, kiedy i jak wywołać agenta.
id	string	Identyfikator agenta podrzędnego.
name	string	Imię i nazwisko agenta, który ma zostać wezwany.

ConnectedAgentToolDefinition

Objekt

Informacje o definicji danych wejściowych dla narzędzia połączonego agenta, które definiuje agenta podrzędnego specyficznego dla domeny

Nazwa	Typ	Opis
connected_agent	ConnectedAgentDetails	Agent podrzędny do nawiązania połączenia
type	string: connected_agent	Typ obiektu.

FileSearchRankingOptions

Objekt

Opcje klasyfikacji wyszukiwania plików.

Nazwa	Typ	Opis
ranker	string	Rangator wyszukiwania plików.
score_threshold	number (float)	Próg wyszukiwania klasyfikatora.

FileSearchToolDefinition

Objekt

Informacje o definicji wejściowej narzędzia wyszukiwania plików używane do konfigurowania agenta.

Nazwa	Typ	Opis
file_search	FileSearchToolDefinitionDetails	Opcje zastępują narzędzie wyszukiwania plików.
type	string: file_search	Typ obiektu.

FileSearchToolDefinitionDetails

Objekt

Opcje zastępują narzędzie wyszukiwania plików.

Nazwa	Typ	Opis
max_num_results	integer (int32) minimum: 1 maximum: 50	Maksymalna liczba wyników, które narzędzie wyszukiwania plików powinno wyświetlić. Wartość domyślna to 20 dla modeli gpt-4* i 5 dla gpt-3,5-turbo. Ta liczba powinna należeć do zakresu od 1 do 50 włącznie. Należy pamiętać, że narzędzie wyszukiwania plików może zwracać mniej niż max_num_results wyniki. Aby uzyskać więcej informacji, zobacz dokumentację narzędzia wyszukiwania plików.
ranking_options	FileSearchRankingOptions	Opcje klasyfikacji wyszukiwania plików.

FileSearchToolResource

Objekt

Zestaw zasobów używanych przez narzędzie file_search.

Nazwa	Typ	Opis
vector_store_ids	string[]	Identyfikator magazynu wektorów dołączony do tego agenta. Może istnieć maksymalnie 1 magazyn wektorów dołączony do agenta.
vector_stores	VectorStoreConfigurations[]	Lista obiektów konfiguracji magazynu wektorów z platformy Azure. Ta lista jest ograniczona do jednego elementu. Jedynym elementem tej listy jest lista identyfikatorów zasobów platformy Azure używanych przez narzędzie wyszukiwania.

FunctionDefinition

Objekt

Informacje o definicji danych wejściowych funkcji.

Nazwa	Typ	Opis
description	string	Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję.
name	string	Nazwa funkcji do wywołania.
parameters		Parametry akceptowane przez funkcje, opisane jako obiekt schematu JSON.

FunctionToolDefinition

Objekt

Informacje o definicji danych wejściowych narzędzia funkcji używane do konfigurowania agenta.

Nazwa	Typ	Opis
function	FunctionDefinition	Definicja funkcji, którą narzędzie funkcji powinno wywołać.
type	string: function	Typ obiektu.

IncompleteDetailsReason

Wyliczanie

Powód, dla którego przebieg jest niekompletny. Będzie to wskazywać, który limit tokenów został osiągnięty w trakcie przebiegu.

Wartość	Opis
max_completion_tokens	Przekroczono maksymalną liczbę tokenów ukończenia
max_prompt_tokens	Przekroczono maksymalną liczbę tokenów monitów

IncompleteRunDetails

Objekt

Szczegółowe informacje o tym, dlaczego przebieg jest niekompletny. Jeśli przebieg nie jest niekompletny, zostanie null.

Nazwa	Typ	Opis
reason	IncompleteDetailsReason	Powód, dla którego przebieg jest niekompletny. Wskazuje to, który określony limit tokenu został osiągnięty podczas przebiegu.

OpenApiAnonymousAuthDetails

Objekt

Szczegóły zabezpieczeń uwierzytelniania anonimowego openApi

Nazwa	Typ	Opis
type	string: anonymous	Typ uwierzytelniania musi być anonimowy/połączenie/managed_identity

OpenApiAuthType

Wyliczanie

Typ uwierzytelniania dla punktu końcowego OpenAPI. Dozwolone typy to:

• Anonimowy (uwierzytelnianie nie jest wymagane)
• Połączenie (wymaga connection_id do punktu końcowego, zgodnie z konfiguracją w AI Foundry)
• Managed_Identity (wymaga odbiorców do uwierzytelniania opartego na tożsamości)

Wartość	Opis
anonymous
connection
managed_identity

OpenApiConnectionAuthDetails

Objekt

Szczegóły zabezpieczeń uwierzytelniania połączeń openApi

Nazwa	Typ	Opis
security_scheme	OpenApiConnectionSecurityScheme	Szczegóły zabezpieczeń uwierzytelniania połączenia
type	string: connection	Typ uwierzytelniania musi być anonimowy/połączenie/managed_identity

OpenApiConnectionSecurityScheme

Objekt

Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity

Nazwa	Typ	Opis
connection_id	string	Identyfikator połączenia dla typu uwierzytelniania połączenia

OpenApiFunctionDefinition

Objekt

Informacje o definicji danych wejściowych dla funkcji openapi.

Nazwa	Typ	Opis
auth	OpenApiAuthDetails: OpenApiAnonymousAuthDetails OpenApiConnectionAuthDetails OpenApiManagedAuthDetails	Szczegóły uwierzytelniania interfejsu API
default_params	string[]	Lista parametrów specyfikacji interfejsu OpenAPI, które będą używać domyślnych ustawień udostępnionych przez użytkownika
description	string	Opis działania funkcji używanej przez model do wyboru, kiedy i jak wywołać funkcję.
functions	FunctionDefinition[]	Lista definicji funkcji używanych przez narzędzie OpenApi
name	string	Nazwa funkcji do wywołania.
spec		Kształt funkcji openapi opisany jako obiekt schematu JSON.

OpenApiManagedAuthDetails

Objekt

Szczegóły zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity

Nazwa	Typ	Opis
security_scheme	OpenApiManagedSecurityScheme	Szczegóły zabezpieczeń uwierzytelniania połączenia
type	string: managed_identity	Typ uwierzytelniania musi być anonimowy/połączenie/managed_identity

OpenApiManagedSecurityScheme

Objekt

Schemat zabezpieczeń uwierzytelniania interfejsu OpenApi managed_identity

Nazwa	Typ	Opis
audience	string	Zakres uwierzytelniania dla typu uwierzytelniania managed_identity

OpenApiToolDefinition

Objekt

Informacje o definicji danych wejściowych narzędzia OpenAPI używane do konfigurowania agenta.

Nazwa	Typ	Opis
openapi	OpenApiFunctionDefinition	Definicja funkcji openapi.
type	string: openapi	Typ obiektu.

RequiredFunctionToolCall

Objekt

Reprezentacja żądanego wywołania narzędzia funkcji wymaganego przez model w celu kontynuowania oceny przebiegu.

Nazwa	Typ	Opis
function	RequiredFunctionToolCallDetails	Szczegółowe informacje o funkcji do wykonania przez narzędzie, które zawiera nazwy i argumenty.
id	string	Identyfikator wywołania narzędzia. Ten identyfikator należy przywoływać podczas przesyłania danych wyjściowych narzędzia.
type	string: function	Typ obiektu dla wymaganego wywołania narzędzia.

RequiredFunctionToolCallDetails

Objekt

Szczegółowe informacje dotyczące wywołania funkcji, podane przez wymaganą akcję wywołującą narzędzie funkcji, które zawiera nazwę i argumenty funkcji.

Nazwa	Typ	Opis
arguments	string	Argumenty do użycia podczas wywoływania nazwanej funkcji, jak podano w modelu. Argumenty są prezentowane jako dokument JSON, który powinien zostać zweryfikowany i przeanalizowany pod kątem oceny.
name	string	Nazwa funkcji.

RunCompletionUsage

Objekt

Statystyki użycia związane z uruchomieniem. Ta wartość będzie null, jeśli przebieg nie znajduje się w stanie terminalu (tj. in_progress, queueditp.).

Nazwa	Typ	Opis
completion_tokens	integer (int64)	Liczba tokenów ukończenia używanych w trakcie przebiegu.
prompt_tokens	integer (int64)	Liczba tokenów monitu używanych w trakcie przebiegu.
total_tokens	integer (int64)	Łączna liczba użytych tokenów (monit i ukończenie).

RunError

Objekt

Szczegóły błędu napotkane przez uruchomienie wątku agenta.

Nazwa	Typ	Opis
code	string	Stan błędu.
message	string	Tekst czytelny dla człowieka skojarzony z błędem.

RunStatus

Wyliczanie

Możliwe wartości stanu przebiegu wątku agenta.

Wartość	Opis
cancelled	Reprezentuje przebieg, który został anulowany.
cancelling	Reprezentuje przebieg, który jest w trakcie anulowania.
completed	Reprezentuje przebieg, który został pomyślnie ukończony.
expired	Reprezentuje przebieg, który wygasł, zanim mógłby się zakończyć.
failed	Reprezentuje przebieg, który zakończył się niepowodzeniem.
in_progress	Reprezentuje przebieg, który jest w toku.
queued	Reprezentuje przebieg, który jest w kolejce do uruchomienia.
requires_action	Reprezentuje przebieg, który wymaga kontynuowania innej operacji, takiej jak przesyłanie danych wyjściowych narzędzia.

SubmitToolOutputsAction

Objekt

Szczegóły wymaganych wywołań narzędzi, które muszą zostać przesłane do uruchomienia wątku agenta, aby kontynuować.

Nazwa	Typ	Opis
submit_tool_outputs	SubmitToolOutputsDetails	Szczegóły opisujące narzędzia, które powinny być wywoływane w celu przesyłania danych wyjściowych narzędzia.
type	string: submit_tool_outputs	Typ obiektu.

SubmitToolOutputsDetails

Objekt

Szczegóły opisujące narzędzia, które powinny być wywoływane w celu przesyłania danych wyjściowych narzędzia.

Nazwa	Typ	Opis
tool_calls	RequiredToolCall[]: RequiredFunctionToolCall[]	Lista wywołań narzędzi, które należy rozpoznać, aby wątek agenta był uruchamiany, aby kontynuować.

ThreadRun

Objekt

Dane reprezentujące pojedynczy przebieg oceny wątku agenta.

Nazwa	Typ	Opis
assistant_id	string	Identyfikator agenta skojarzonego z wątkiem, względem którego wykonano ten przebieg.
cancelled_at	integer (unixtime)	Sygnatura czasowa systemu Unix w sekundach reprezentująca moment anulowania.
completed_at	integer (unixtime)	Sygnatura czasowa systemu Unix w sekundach reprezentująca czas po zakończeniu.
created_at	integer (unixtime)	Sygnatura czasowa systemu Unix w sekundach reprezentująca czas utworzenia tego obiektu.
expires_at	integer (unixtime)	Sygnatura czasowa systemu Unix w sekundach reprezentująca czas wygaśnięcia tego elementu.
failed_at	integer (unixtime)	Sygnatura czasowa systemu Unix( w sekundach) reprezentująca, kiedy to się nie powiodło.
id	string	Identyfikator, do którego można odwoływać się w punktach końcowych interfejsu API.
incomplete_details	IncompleteRunDetails	Szczegółowe informacje o tym, dlaczego przebieg jest niekompletny. Jeśli przebieg nie jest niekompletny, zostanie null.
instructions	string	Zastąpione instrukcje systemowe używane dla tego wątku agenta.
last_error	RunError	Ostatni błąd, jeśli istnieje, napotkany przez ten wątek agenta, zostanie uruchomiony.
max_completion_tokens	integer (int32)	Maksymalna liczba tokenów ukończenia określonych do użycia w trakcie przebiegu.
max_prompt_tokens	integer (int32)	Maksymalna liczba tokenów monitów określonych do użycia w trakcie przebiegu.
metadata	object	Zestaw maksymalnie 16 par klucz/wartość, które mogą być dołączone do obiektu, używane do przechowywania dodatkowych informacji o tym obiekcie w formacie ustrukturyzowanym. Klucze mogą mieć długość maksymalnie 64 znaków, a wartości mogą mieć maksymalnie 512 znaków.
model	string	Identyfikator modelu do użycia.
object	enum: thread.run	Typ obiektu, który jest zawsze "thread.run".
parallel_tool_calls	boolean	Określa, czy narzędzia mogą być wykonywane równolegle w ramach przebiegu.
required_action	RequiredAction: SubmitToolOutputsAction	Szczegóły akcji wymaganej do uruchomienia wątku agenta.
response_format	AgentsResponseFormatOption	Format odpowiedzi wywołań narzędzia używanych w tym przebiegu.
started_at	integer (unixtime)	Sygnatura czasowa systemu Unix w sekundach reprezentująca moment uruchomienia tego elementu.
status	RunStatus	Stan uruchomienia wątku agenta.
temperature	number (float)	Temperatura próbkowania używana na potrzeby tego przebiegu. Jeśli nie zostanie ustawiona, wartość domyślna to 1.
thread_id	string	Identyfikator wątku skojarzonego z tym przebiegiem.
tool_choice	AgentsToolChoiceOption	Określa, czy i które narzędzie jest wywoływane przez model.
tool_resources	ToolResources	Zastąpić narzędzia, których agent może użyć na potrzeby tego przebiegu. Jest to przydatne w przypadku modyfikowania zachowania dla poszczególnych przebiegów
tools	ToolDefinition[]: AzureAISearchToolDefinition[] AzureFunctionToolDefinition[] BingGroundingToolDefinition[] CodeInterpreterToolDefinition[] ConnectedAgentToolDefinition[] FileSearchToolDefinition[] FunctionToolDefinition[] OpenApiToolDefinition[]	Zastąpione włączone narzędzia używane na potrzeby tego wątku agenta.
top_p	number (float)	Wartość próbkowania jądra użyta na potrzeby tego przebiegu. Jeśli nie zostanie ustawiona, wartość domyślna to 1.
truncation_strategy	TruncationObject	Strategia stosowania do usuwania komunikatów w miarę przesuwania okien kontekstowych do przodu.
usage	RunCompletionUsage	Statystyki użycia związane z uruchomieniem. Ta wartość będzie null, jeśli przebieg nie znajduje się w stanie terminalu (tj. in_progress, queueditp.).

ToolResources

Objekt

Zestaw zasobów używanych przez narzędzia agenta. Zasoby są specyficzne dla typu narzędzia. Na przykład code_interpreter narzędzie wymaga listy identyfikatorów plików, a file_search narzędzie wymaga listy identyfikatorów magazynów wektorów.

Nazwa	Typ	Opis
azure_ai_search	AzureAISearchToolResource	Zasoby używane przez narzędzie azure_ai_search składające się z identyfikatorów indeksów i nazw.
code_interpreter	CodeInterpreterToolResource	Zasoby używane przez narzędzie code_interpreter składające się z identyfikatorów plików.
file_search	FileSearchToolResource	Zasoby używane przez narzędzie file_search składające się z identyfikatorów magazynów wektorowych.

TruncationObject

Objekt

Określa sposób obcinania wątku przed uruchomieniem. Służy do kontrolowania początkowego okna kontekstu przebiegu.

Nazwa	Typ	Domyślna wartość	Opis
last_messages	integer (int32)		Liczba najnowszych komunikatów z wątku podczas konstruowania kontekstu przebiegu.
type	TruncationStrategy	auto	Strategia obcinania do użycia dla wątku. Wartość domyślna to auto. Jeśli ustawiono wartość last_messages, wątek zostanie obcięty z lastMessages zlicza najnowsze komunikaty w wątku. Po ustawieniu autowartości na wartość komunikaty w środku wątku zostaną porzucone w celu dopasowania do długości kontekstu modelu . max_prompt_tokens

TruncationStrategy

Wyliczanie

Możliwe strategie obcinania dla wątku.

Wartość	Opis
auto	Wartość domyślna. Wiadomości w środku wątku zostaną usunięte, aby dopasować je do długości kontekstu modelu.
last_messages	Wątek zostanie obcięty do lastMessages liczby ostatnich wiadomości.

VectorStoreConfiguration

Objekt

Konfiguracja magazynu wektorowego to lista źródeł danych używanych w przypadku użycia wielu plików do wyszukiwania plików przedsiębiorstwa.

Nazwa	Typ	Opis
data_sources	VectorStoreDataSource[]	Źródła danych

VectorStoreConfigurations

Objekt

Struktura zawierająca listę konfiguracji magazynu wektorowego, tj. listę identyfikatorów zasobów platformy Azure.

Nazwa	Typ	Opis
configuration	VectorStoreConfiguration	Konfiguracje
name	string	Nazwa

VectorStoreDataSource

Objekt

Struktura zawierająca ścieżkę identyfikatora URI zasobu platformy Azure i typ zasobu pliku używanego jako źródło danych dla wyszukiwania plików przedsiębiorstwa.

Nazwa	Typ	Opis
type	VectorStoreDataSourceAssetType	Typ zasobu
uri	string	Identyfikator URI zasobu.

VectorStoreDataSourceAssetType

Wyliczanie

Typ zasobu magazynu wektorowego. Typ zasobu może być uri_asset, w tym przypadku powinien zawierać identyfikator URI zasobu, w przypadku id_asset powinien zawierać identyfikator danych.

Wartość	Opis
id_asset	Identyfikator danych
uri_asset	Azure URI