OpenAI Assistants(Independent Publisher)(미리 보기)
OpenAI Assistants를 사용하면 자체 애플리케이션 내에서 AI 도우미를 빌드할 수 있습니다. 도우미에는 지침이 있으며 모델, 도구 및 지식을 활용하여 사용자 쿼리에 응답할 수 있습니다. Assistants 서비스는 현재 코드 인터프리터, 검색 및 함수 호출이라는 세 가지 유형의 도구를 지원합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 트로이 테일러 |
| URL | https://www.hitachisolutions.com |
| 전자 메일 | ttaylor@hitachisolutions.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 트로이 테일러 |
| 웹 사이트 | https://openai.com/ |
| 개인 정보 보호 정책 | https://openai.com/policies/privacy-policy |
| 카테고리 | AI |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키('전달자 $OPENAI_API_KEY' 형식) | 시큐어스트링 (보안 문자열) | 이 API에 대한 API 키('Bearer $OPENAI_API_KEY' 형식) | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 길잡이 검색 |
도우미에 대한 정보를 검색합니다. |
| 길잡이 삭제 |
도우미를 삭제합니다. |
| 도우미 만들기 |
모델과 지침이 포함된 도우미를 만듭니다. |
| 도우미 파일 가져오기 |
도우미 파일 목록을 검색합니다. |
| 도우미 파일 검색 |
도우미 파일을 검색합니다. |
| 도우미 파일 만들기 |
도우미에 파일을 첨부하여 도우미 파일을 만듭니다. |
| 도우미 파일 삭제 |
도우미 파일을 삭제합니다. |
| 메시지 나열 |
지정된 스레드에 대한 메시지 목록을 검색합니다. |
| 메시지 만들기 |
스레드 내에서 메시지를 만듭니다. |
| 메시지 수정 |
메시지를 수정합니다. |
| 메시지 파일 검색 |
스레드에서 메시지 파일을 검색합니다. |
| 메시지 파일 나열 |
스레드에 대한 메시지 파일 목록을 검색합니다. |
| 모델 나열 |
현재 사용 가능한 모델을 나열하고 소유자 및 가용성과 같은 각 모델에 대한 기본 정보를 제공합니다. |
| 목록 도우미 |
도우미 목록을 검색합니다. |
| 목록 실행 |
스레드에 대한 실행 목록을 검색합니다. |
| 스레드 가져오기 |
스레드를 검색합니다. |
| 스레드 만들기 |
도우미가 상호 작용할 수 있는 스레드를 만듭니다. |
| 스레드 만들기 및 실행 |
스레드를 만들고 한 요청에서 실행합니다. |
| 스레드 삭제 |
스레드를 삭제합니다. |
| 스레드 수정 |
스레드를 수정합니다. |
| 실행 가져오기 |
스레드에서 실행을 검색합니다. |
| 실행 단계 가져오기 |
스레드에 대한 실행 단계를 검색합니다. |
| 실행 단계 나열 |
스레드에 대한 실행 단계 목록을 검색합니다. |
| 실행 만들기 |
스레드에 대한 실행을 만듭니다. |
| 실행 수정 |
스레드에 대한 실행을 수정합니다. |
| 실행 취소 |
진행 중인 스레드에 대한 실행을 취소합니다. |
| 실행할 도구 출력 제출 |
실행 상태가 "requires_action"이고 required_action.type이 submit_tool_outputs 경우 이 작업을 사용하여 모두 완료되면 도구 호출에서 출력을 제출할 수 있습니다. |
길잡이 검색
도우미에 대한 정보를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | True | string |
도우미 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
이름
|
name | string |
이름입니다. |
|
Description
|
description | string |
설명입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
길잡이 삭제
도우미를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | True | string |
도우미 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
삭제됨
|
deleted | boolean |
삭제 여부입니다. |
도우미 만들기
모델과 지침이 포함된 도우미를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
Model
|
model | True | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
|
이름
|
name | string |
이름입니다. |
|
|
Description
|
description | string |
설명입니다. |
|
|
유형
|
type | string |
도구 유형입니다. |
|
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
이름
|
name | string |
이름입니다. |
|
Description
|
description | string |
설명입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
도우미 파일 가져오기
도우미 파일 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | True | string |
도우미 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
만든 위치에서
|
data.created_at | integer |
만들 때입니다. |
|
도우미 ID
|
data.assistant_id | string |
도우미 식별자입니다. |
|
첫 번째 ID
|
first_id | string |
첫 번째 식별자입니다. |
|
마지막 ID
|
last_id | string |
마지막 식별자입니다. |
|
더 많은 것을 가지고 있습니다.
|
has_more | boolean |
더 많은 것이 있는지 여부. |
도우미 파일 검색
도우미 파일을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | True | string |
도우미 식별자입니다. |
|
파일 ID
|
file_id | True | string |
파일 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
도우미 파일 만들기
도우미에 파일을 첨부하여 도우미 파일을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | True | string |
도우미 식별자입니다. |
|
파일 ID
|
file_id | True | string |
파일 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
도우미 파일 삭제
도우미 파일을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | True | string |
도우미 식별자입니다. |
|
파일 ID
|
file_id | True | string |
파일 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
삭제됨
|
deleted | boolean |
삭제 여부입니다. |
메시지 나열
지정된 스레드에 대한 메시지 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
한계
|
limit | integer |
한계. |
|
|
순서
|
order | string |
순서입니다. |
|
|
이후
|
after | string |
이후입니다. |
|
|
전에
|
before | string |
이전. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
만든 위치에서
|
data.created_at | integer |
만들 때입니다. |
|
스레드 ID
|
data.thread_id | string |
스레드 식별자입니다. |
|
역할
|
data.role | string |
역할입니다. |
|
Content
|
data.content | array of object | |
|
유형
|
data.content.type | string |
형식입니다. |
|
가치
|
data.content.text.value | string |
값입니다. |
|
Annotations
|
data.content.text.annotations | array of string |
주석입니다. |
|
파일 ID
|
data.file_ids | array of string |
파일 식별자입니다. |
|
도우미 ID
|
data.assistant_id | string |
도우미 식별자입니다. |
|
실행 ID
|
data.run_id | string |
실행 식별자입니다. |
|
첫 번째 ID
|
first_id | string |
첫 번째 식별자입니다. |
|
마지막 ID
|
last_id | string |
마지막 식별자입니다. |
|
더 많은 것을 가지고 있습니다.
|
has_more | boolean |
더 많은 것이 있는지 여부. |
메시지 만들기
스레드 내에서 메시지를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
역할
|
role | string |
역할입니다. |
|
Content
|
content | array of object | |
|
유형
|
content.type | string |
도구 유형입니다. |
|
가치
|
content.text.value | string |
값입니다. |
|
Annotations
|
content.text.annotations | array of string |
주석입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
실행 ID
|
run_id | string |
실행 식별자입니다. |
메시지 수정
메시지를 수정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
메시지 ID
|
message_id | True | string |
메시지 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
역할
|
role | string |
역할입니다. |
|
Content
|
content | array of object | |
|
유형
|
content.type | string |
도구 유형입니다. |
|
가치
|
content.text.value | string |
값입니다. |
|
Annotations
|
content.text.annotations | array of string |
주석입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
실행 ID
|
run_id | string |
실행 식별자입니다. |
메시지 파일 검색
스레드에서 메시지 파일을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
메시지 ID
|
message_id | True | string |
메시지 식별자입니다. |
|
파일 ID
|
file_id | True | string |
파일 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
메시지 ID
|
message_id | string |
메시지 식별자입니다. |
메시지 파일 나열
스레드에 대한 메시지 파일 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
메시지 ID
|
message_id | True | string |
메시지 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
만든 위치에서
|
data.created_at | integer |
만들 때입니다. |
|
메시지 ID
|
data.message_id | string |
메시지 식별자입니다. |
|
첫 번째 ID
|
first_id | string |
첫 번째 식별자입니다. |
|
마지막 ID
|
last_id | string |
마지막 식별자입니다. |
|
더 많은 것을 가지고 있습니다.
|
has_more | boolean |
더 많은 것이 있는지 여부. |
모델 나열
현재 사용 가능한 모델을 나열하고 소유자 및 가용성과 같은 각 모델에 대한 기본 정보를 제공합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
생성됨
|
data.created | integer |
만들 때. |
|
소유
|
data.owned_by | string |
소유. |
목록 도우미
도우미 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
만든 위치에서
|
data.created_at | integer |
만들 때입니다. |
|
이름
|
data.name | string |
이름입니다. |
|
Description
|
data.description | string |
설명입니다. |
|
Model
|
data.model | string |
모델입니다. |
|
지시
|
data.instructions | string |
지침입니다. |
|
Tools
|
data.tools | array of object | |
|
유형
|
data.tools.type | string |
형식입니다. |
|
파일 ID
|
data.file_ids | array of string |
파일 식별자입니다. |
|
첫 번째 ID
|
first_id | string |
첫 번째 식별자입니다. |
|
마지막 ID
|
last_id | string |
마지막 식별자입니다. |
|
더 많은 것을 가지고 있습니다.
|
has_more | boolean |
더 많은 것이 있는지 여부. |
목록 실행
스레드에 대한 실행 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
한계
|
limit | integer |
한계. |
|
|
순서
|
order | string |
순서입니다. |
|
|
이후
|
after | string |
이후입니다. |
|
|
전에
|
before | string |
이전. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
만든 위치에서
|
data.created_at | integer |
만들 때입니다. |
|
도우미 ID
|
data.assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
data.thread_id | string |
스레드 식별자입니다. |
|
상태
|
data.status | string |
상태입니다. |
|
시작 날짜
|
data.started_at | integer |
시작 시. |
|
만료 시간
|
data.expires_at | string |
만료되는 시점입니다. |
|
취소됨
|
data.cancelled_at | string |
취소 시. |
|
실패 시
|
data.failed_at | string |
실패할 때 |
|
완료 시
|
data.completed_at | integer |
완료 시. |
|
마지막 오류
|
data.last_error | string |
마지막 오류입니다. |
|
Model
|
data.model | string |
모델입니다. |
|
지시
|
data.instructions | string |
지침입니다. |
|
Tools
|
data.tools | array of object | |
|
유형
|
data.tools.type | string |
형식입니다. |
|
파일 ID
|
data.file_ids | array of string |
파일 식별자입니다. |
|
첫 번째 ID
|
first_id | string |
첫 번째 식별자입니다. |
|
마지막 ID
|
last_id | string |
마지막 식별자입니다. |
|
더 많은 것을 가지고 있습니다.
|
has_more | boolean |
더 많은 것이 있는지 여부. |
스레드 가져오기
스레드를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
스레드 만들기
도우미가 상호 작용할 수 있는 스레드를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
아이디
|
id | string |
식별자입니다. |
|
|
Object
|
object | string |
개체입니다. |
|
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
|
역할
|
role | True | string |
역할입니다. |
|
Content
|
content | True | string |
콘텐츠입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
|
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
|
실행 ID
|
run_id | string |
실행 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
스레드 만들기 및 실행
스레드를 만들고 한 요청에서 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
|
역할
|
role | string |
역할입니다. |
|
|
Content
|
content | string |
콘텐츠입니다. |
|
|
Model
|
model | string |
모델입니다. |
|
|
소개
|
instructions | string |
지침입니다. |
|
|
유형
|
type | string |
도구 유형입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
상태
|
status | string |
상태입니다. |
|
시작 날짜
|
started_at | string |
시작 시. |
|
만료 시간
|
expires_at | integer |
만료되는 시점입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
실패 시
|
failed_at | string |
실패할 때 |
|
완료 시
|
completed_at | string |
완료 시. |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
스레드 삭제
스레드를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
삭제됨
|
deleted | boolean |
삭제 여부입니다. |
스레드 수정
스레드를 수정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
실행 가져오기
스레드에서 실행을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
실행 ID
|
run_id | True | string |
실행 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
상태
|
status | string |
상태입니다. |
|
시작 날짜
|
started_at | integer |
시작 시. |
|
만료 시간
|
expires_at | string |
만료되는 시점입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
실패 시
|
failed_at | string |
실패할 때 |
|
완료 시
|
completed_at | integer |
완료 시. |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
실행 단계 가져오기
스레드에 대한 실행 단계를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
실행 ID
|
run_id | True | string |
실행 식별자입니다. |
|
단계 ID
|
step_id | True | string |
단계 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
실행 ID
|
run_id | string |
실행 식별자입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
유형
|
type | string |
형식입니다. |
|
상태
|
status | string |
상태입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
완료 시
|
completed_at | integer |
완료 시. |
|
만료 날짜
|
expired_at | string |
만료된 경우 |
|
실패 시
|
failed_at | string |
실패할 때 |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
유형
|
step_details.type | string |
형식입니다. |
|
메시지 ID
|
step_details.message_creation.message_id | string |
메시지 식별자입니다. |
실행 단계 나열
스레드에 대한 실행 단계 목록을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
실행 ID
|
run_id | True | string |
실행 식별자입니다. |
|
한계
|
limit | integer |
한계. |
|
|
순서
|
order | string |
순서입니다. |
|
|
이후
|
after | string |
이후입니다. |
|
|
전에
|
before | string |
이전. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Object
|
object | string |
개체입니다. |
|
데이터
|
data | array of object | |
|
아이디
|
data.id | string |
식별자입니다. |
|
Object
|
data.object | string |
개체입니다. |
|
만든 위치에서
|
data.created_at | integer |
만들 때입니다. |
|
실행 ID
|
data.run_id | string |
실행 식별자입니다. |
|
도우미 ID
|
data.assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
data.thread_id | string |
스레드 식별자입니다. |
|
유형
|
data.type | string |
도구 유형입니다. |
|
상태
|
data.status | string |
상태입니다. |
|
취소됨
|
data.cancelled_at | string |
취소 시. |
|
완료 시
|
data.completed_at | integer |
완료 시. |
|
만료 날짜
|
data.expired_at | string |
만료된 경우 |
|
실패 시
|
data.failed_at | string |
실패할 때 |
|
마지막 오류
|
data.last_error | string |
마지막 오류입니다. |
|
유형
|
data.step_details.type | string |
형식입니다. |
|
메시지 ID
|
data.step_details.message_creation.message_id | string |
메시지 식별자입니다. |
|
첫 번째 ID
|
first_id | string |
첫 번째 식별자입니다. |
|
마지막 ID
|
last_id | string |
마지막 식별자입니다. |
|
더 많은 것을 가지고 있습니다.
|
has_more | boolean |
더 많은 것이 있는지 여부. |
실행 만들기
스레드에 대한 실행을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
|
Model
|
model | True | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
|
유형
|
type | string |
도구 유형입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
상태
|
status | string |
상태입니다. |
|
시작 날짜
|
started_at | integer |
시작 시. |
|
만료 시간
|
expires_at | string |
만료되는 시점입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
실패 시
|
failed_at | string |
실패할 때 |
|
완료 시
|
completed_at | integer |
완료 시. |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
실행 수정
스레드에 대한 실행을 수정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
실행 ID
|
run_id | True | string |
실행 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
상태
|
status | string |
상태입니다. |
|
시작 날짜
|
started_at | integer |
시작 시. |
|
만료 시간
|
expires_at | string |
만료되는 시점입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
실패 시
|
failed_at | string |
실패할 때 |
|
완료 시
|
completed_at | integer |
완료 시. |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
실행 취소
진행 중인 스레드에 대한 실행을 취소합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
실행 ID
|
run_id | True | string |
실행 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
상태
|
status | string |
상태입니다. |
|
시작 날짜
|
started_at | integer |
시작 시. |
|
만료 시간
|
expires_at | integer |
만료되는 시점입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
실패 시
|
failed_at | string |
실패할 때 |
|
완료 시
|
completed_at | string |
완료 시. |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |
실행할 도구 출력 제출
실행 상태가 "requires_action"이고 required_action.type이 submit_tool_outputs 경우 이 작업을 사용하여 모두 완료되면 도구 호출에서 출력을 제출할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
베타 헤더
|
OpenAI-Beta | True | string |
베타 헤더입니다. API가 베타인 동안 설정해야 합니다. |
|
스레드 ID
|
thread_id | True | string |
스레드 식별자입니다. |
|
실행 ID
|
run_id | True | string |
실행 식별자입니다. |
|
도구 호출 ID
|
tool_call_id | string |
통행료 호출 식별자입니다. |
|
|
출력
|
output | string |
출력입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
식별자입니다. |
|
Object
|
object | string |
개체입니다. |
|
만든 위치에서
|
created_at | integer |
만들 때입니다. |
|
도우미 ID
|
assistant_id | string |
도우미 식별자입니다. |
|
스레드 ID
|
thread_id | string |
스레드 식별자입니다. |
|
상태
|
status | string |
상태입니다. |
|
시작 날짜
|
started_at | integer |
시작 시. |
|
만료 시간
|
expires_at | integer |
만료되는 시점입니다. |
|
취소됨
|
cancelled_at | string |
취소 시. |
|
실패 시
|
failed_at | string |
실패할 때 |
|
완료 시
|
completed_at | string |
완료 시. |
|
마지막 오류
|
last_error | string |
마지막 오류입니다. |
|
Model
|
model | string |
모델입니다. |
|
지시
|
instructions | string |
지침입니다. |
|
Tools
|
tools | array of object | |
|
유형
|
tools.type | string |
도구 유형입니다. |
|
이름
|
tools.function.name | string |
이름입니다. |
|
Description
|
tools.function.description | string |
설명입니다. |
|
유형
|
tools.function.parameters.type | string |
형식입니다. |
|
파일 ID
|
file_ids | array of string |
파일 식별자입니다. |