ThreadRun interface

패키지:

@azure/ai-agents

에이전트 스레드의 단일 평가 실행을 나타내는 데이터입니다.

속성

assistantId	이 실행이 수행된 스레드와 연결된 에이전트의 ID입니다.
cancelledAt	취소된 시간을 나타내는 Unix 타임스탬프(초)입니다.
completedAt	완료 시점을 나타내는 Unix 타임스탬프(초)입니다.
createdAt	이 개체가 만들어진 시점을 나타내는 Unix 타임스탬프(초)입니다.
expiresAt	이 항목이 만료되는 시점을 나타내는 Unix 타임스탬프(초)입니다.
failedAt	실패한 경우를 나타내는 Unix 타임스탬프(초)입니다.
id	API 엔드포인트에서 참조할 수 있는 식별자입니다.
incompleteDetails	실행이 완료되지 않은 이유에 대한 세부 정보입니다. 실행이 불완전하지 않으면 null.
instructions	이 에이전트 스레드 실행에 사용되는 재정의된 시스템 지침입니다.
lastError	이 에이전트 스레드에서 발생한 마지막 오류(있는 경우)가 실행됩니다.
maxCompletionTokens	실행 과정에서 사용되도록 지정된 완료 토큰의 최대 수입니다.
maxPromptTokens	실행 과정에서 사용되도록 지정된 프롬프트 토큰의 최대 수입니다.
metadata	개체에 연결할 수 있는 최대 16개의 키/값 쌍 집합으로, 해당 개체에 대한 추가 정보를 구조화된 형식으로 저장하는 데 사용됩니다. 키의 길이는 최대 64자이고 값의 길이는 최대 512자일 수 있습니다.
model	사용할 모델의 ID입니다.
object	항상 'thread.run'인 개체 형식입니다.
parallelToolCalls	실행 내에서 도구를 병렬로 실행할 수 있는지 여부를 결정합니다.
requiredAction	에이전트 스레드 실행을 계속하는 데 필요한 작업의 세부 정보입니다.
responseFormat	이 실행에 사용되는 도구 호출의 응답 형식입니다.
startedAt	이 항목이 시작된 시점을 나타내는 Unix 타임스탬프(초)입니다.
status	에이전트 스레드 실행의 상태입니다.
temperature	이 실행에 사용되는 샘플링 온도입니다. 설정하지 않으면 기본값은 1입니다.
threadId	이 실행과 연결된 스레드의 ID입니다.
toolChoice	모델에서 호출되는 도구의 여부와 그 안을 제어합니다.
toolResources	에이전트가 이 실행에 사용할 수 있는 도구를 재정의합니다. 이는 실행별로 동작을 수정하는 데 유용합니다.
tools	이 에이전트 스레드 실행에 사용되는 재정의된 사용 도구입니다.
topP	이 실행에 사용되는 핵 샘플링 값입니다. 설정하지 않으면 기본값은 1입니다.
truncationStrategy	컨텍스트 창이 앞으로 이동함에 따라 메시지를 삭제하는 데 사용하는 전략입니다.
usage	실행과 관련된 사용 통계입니다. 이 값은 실행이 터미널 상태(예: null, in_progress등)에 없는 경우 queued.

속성 세부 정보

assistantId

이 실행이 수행된 스레드와 연결된 에이전트의 ID입니다.

assistantId: string

속성 값

string

cancelledAt

취소된 시간을 나타내는 Unix 타임스탬프(초)입니다.

cancelledAt: null | Date

속성 값

null | Date

completedAt

완료 시점을 나타내는 Unix 타임스탬프(초)입니다.

completedAt: null | Date

속성 값

null | Date

createdAt

이 개체가 만들어진 시점을 나타내는 Unix 타임스탬프(초)입니다.

createdAt: Date

속성 값

Date

expiresAt

이 항목이 만료되는 시점을 나타내는 Unix 타임스탬프(초)입니다.

expiresAt: null | Date

속성 값

null | Date

failedAt

실패한 경우를 나타내는 Unix 타임스탬프(초)입니다.

failedAt: null | Date

속성 값

null | Date

id

API 엔드포인트에서 참조할 수 있는 식별자입니다.

id: string

속성 값

string

incompleteDetails

실행이 완료되지 않은 이유에 대한 세부 정보입니다. 실행이 불완전하지 않으면 null.

incompleteDetails: null | IncompleteRunDetails

속성 값

null | IncompleteRunDetails

instructions

이 에이전트 스레드 실행에 사용되는 재정의된 시스템 지침입니다.

instructions: string

속성 값

string

lastError

이 에이전트 스레드에서 발생한 마지막 오류(있는 경우)가 실행됩니다.

lastError: null | RunError

속성 값

null | RunError

maxCompletionTokens

실행 과정에서 사용되도록 지정된 완료 토큰의 최대 수입니다.

maxCompletionTokens: null | number

속성 값

null | number

maxPromptTokens

실행 과정에서 사용되도록 지정된 프롬프트 토큰의 최대 수입니다.

maxPromptTokens: null | number

속성 값

null | number

metadata

개체에 연결할 수 있는 최대 16개의 키/값 쌍 집합으로, 해당 개체에 대한 추가 정보를 구조화된 형식으로 저장하는 데 사용됩니다. 키의 길이는 최대 64자이고 값의 길이는 최대 512자일 수 있습니다.

metadata: null | Record<string, string>

속성 값

null | Record<string, string>

model

사용할 모델의 ID입니다.

model: string

속성 값

string

object

항상 'thread.run'인 개체 형식입니다.

object: "thread.run"

속성 값

"thread.run"

parallelToolCalls

실행 내에서 도구를 병렬로 실행할 수 있는지 여부를 결정합니다.

parallelToolCalls: boolean

속성 값

boolean

requiredAction

에이전트 스레드 실행을 계속하는 데 필요한 작업의 세부 정보입니다.

requiredAction?: null | RequiredActionUnion

속성 값

null | RequiredActionUnion

responseFormat

이 실행에 사용되는 도구 호출의 응답 형식입니다.

responseFormat: null | AgentsResponseFormatOption

속성 값

null | AgentsResponseFormatOption

startedAt

이 항목이 시작된 시점을 나타내는 Unix 타임스탬프(초)입니다.

startedAt: null | Date

속성 값

null | Date

status

에이전트 스레드 실행의 상태입니다.

status: RunStatus

속성 값

RunStatus

temperature

이 실행에 사용되는 샘플링 온도입니다. 설정하지 않으면 기본값은 1입니다.

temperature?: null | number

속성 값

null | number

threadId

이 실행과 연결된 스레드의 ID입니다.

threadId: string

속성 값

string

toolChoice

모델에서 호출되는 도구의 여부와 그 안을 제어합니다.

toolChoice: null | AgentsToolChoiceOption

속성 값

null | AgentsToolChoiceOption

toolResources

에이전트가 이 실행에 사용할 수 있는 도구를 재정의합니다. 이는 실행별로 동작을 수정하는 데 유용합니다.

toolResources?: null | ToolResources

속성 값

null | ToolResources

tools

이 에이전트 스레드 실행에 사용되는 재정의된 사용 도구입니다.

tools: ToolDefinitionUnion[]

속성 값

ToolDefinitionUnion[]

topP

이 실행에 사용되는 핵 샘플링 값입니다. 설정하지 않으면 기본값은 1입니다.

topP?: null | number

속성 값

null | number

truncationStrategy

컨텍스트 창이 앞으로 이동함에 따라 메시지를 삭제하는 데 사용하는 전략입니다.

truncationStrategy: null | TruncationObject

속성 값

null | TruncationObject

usage

실행과 관련된 사용 통계입니다. 이 값은 실행이 터미널 상태(예: null, in_progress등)에 없는 경우 queued.

usage: null | RunCompletionUsage

속성 값

null | RunCompletionUsage