OpenAI 라이브러리

개요

개요

OpenAI라이브러리는 사용자가 OpenAI 서버와 연동하여 TextCompletion, ChatCompletion 등의 작업을 수행할 수 있습니다.

OpenAI라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.

해당 라이브러리 및 각 라이브러리 카드 속성은 OpenAI 정책에 따라 변경될 수 있으며 v3.1의 경우 출시 시점인 2023년 6월 기준으로 생성되었습니다.

공통 속성

공통 속성

MORE OPTION

카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

On Error

콤보박스

N

-

N

오류 발생 시 수행할 동작을 지정합니다.

- 미지정: 오류를 출력하고 작업을 종료합니다.

- Ignore: 해당 오류를 무시합니다.

- Retry: 해당 액티비티를 1회 재시도합니다.

- Goto: 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다.

- Event: 프로젝트에 등록된 이벤트를 호출합니다.

DESCRIPTION

카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

Description

문자

N

-

N

해당 액티비티 카드에 대한 설명을 추가합니다.

Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다.

MaxTokens는 호출시 설정 가능한 token 범위를 사전에 1차 체크하는 역할을 합니다.

Header,Prompt등을 포함한 전체 Tokens은 솔루션이 판단해주며 전체 Tokens은 호출의 결과로 알 수 있습니다.

TextCompletion

TextCompletion

개요

OpenAI Text Completion API를 호출합니다.

사용 절차

  1. [Output] RESULT에 응답결과 전체를 저장할 변수를 지정합니다.

  2. [Output] TextRESULT에 응답결과 중 choices내 첫번째 text 결과를 가져옵니다.

  3. API Token에 API Token을 입력합니다.

API Token은 Open AI Sign Up 이후 아래 URL에서 확인합니다.

https://platform.openai.com/account/api-keys

카드 속성

공통여부

속성

유형

필수여부

단위

자동입력여부

설명

N

[Output] RESULT

변수

Y

-

Y

응답결과 전체를 저장할 변수를 지정합니다.

N

[Output] TextRESULT

변수

Y

-

Y

응답결과 중 choices내 첫번째 text 결과를 저장할 변수를 지정합니다.

N

API Token

변수

Y

-

N

API Token을 입력합니다.

- Normal: 입력한 API Token이 일반 텍스트로 저장됩니다.

- Credential: 입력한 API Token이 암호화됩니다. (공유 리소스에서 검색됩니다.)

- Secure: 입력한 API Token이 암호화되고, 저장됩니다.

N

Model

콤보박스

Y

-

Y

사용할 Model을 선택합니다.

- text-ada-001

- text-babbage-001

- text-curie-001

- text-davinci-002

- text-davinci-003

N

MaxTokens

숫자

N

-

Y

MaxTokens를 입력합니다.

N

Prompt

문자열 or 문자 배열

N

-

Y

Prompt를 입력합니다.

N

Suffix

문자열

N

-

N

Suffix(삽입된 텍스트가 완료된 뒤에 오는 접미사)를 입력합니다.

Model이 text-davinci-002, text-davinci-003인 경우에만 보입니다.

N

Temperature

숫자

N

-

Y

Temperature(무작위성)를 입력합니다.

N

TopP

숫자

N

-

Y

TopP(상위 확률 질량에 토큰을 고려하는 정도)를 입력합니다.

N

N

숫자

N

-

Y

N(각 Prompt에 대해 생성할 완료 수)를 입력합니다.

N

LogProbs

숫자

N

-

N

LogProbs(가장 가능성이 높은 토큰과 선택한 토큰에 대한 로그 확률을 포함)를 입력합니다.

N

Echo

토글

N

-

N

Echo(완료와 함께 Prompt 되풀이 여부)를 선택합니다.

N

Stop

문자열 or 문자 배열

N

-

N

Stop(토큰 생성 중지를 하는 토큰 목록)을 입력합니다.

N

PresencePenalty

숫자

N

-

Y

PresencePenalty(새 주제에 대해 이야기할 가능성을 높임)를 입력합니다.

N

FrequencyPenalty

숫자

N

-

Y

FrequencyPenalty(동일한 줄을 그대로 반복할 가능성을 줄임)를 입력합니다.

N

BestOf

숫자

N

-

Y

BestOf(토큰당 로그 확률이 가장 높은 항목 후보 완료 수)를 입력합니다.

N

User

문자열

N

-

N

User를 입력합니다.

Y

MORE OPTIONS

-

-

-

-

OpenAI 라이브러리의 공통 속성입니다.

Y

DESCRIPTION

-

-

-

-

OpenAI 라이브러리의 공통 속성입니다.

상세한 속성 설명은 아래 Open AI url을 참고합니다.

https://platform.openai.com/docs/api-reference/completions/create

활용 예시

OpenAI Text Completion API를 호출합니다.

AddDateTime1

예제 파일

사용된 변수

RESULT = 응답결과 전체를 저장할 변수
TextRESULT = 응답결과 중 choices내 첫번째 text 결과를 저장할 변수
Global.apiToken = API Token

사용된 속성

연관/유사 액티비티

ChatCompletion

ChatCompletion

ChatCompletion

개요

OpenAI Chat Completion API를 호출합니다.

사용 절차

  1. [Output] RESULT에 응답결과 전체를 저장할 변수를 지정합니다.

  2. [Output] TextRESULT에 응답결과 중 choices내 첫번째 text 결과를 가져옵니다.

  3. API Token에 API Token을 입력합니다.

API Token은 Open AI Sign Up 이후 아래 URL에서 확인합니다.

https://platform.openai.com/account/api-keys

카드 속성

공통여부

속성

유형

필수여부

단위

자동입력여부

설명

N

[Output] RESULT

변수

Y

-

Y

응답결과 전체를 저장할 변수를 지정합니다.

N

[Output] TextRESULT

변수

Y

-

Y

응답결과 중 choices내 첫번째 text 결과를 저장할 변수를 지정합니다.

N

API Token

변수

Y

-

N

API Token을 입력합니다.

- Normal: 입력한 API Token이 일반 텍스트로 저장됩니다.

- Credential: 입력한 API Token이 암호화됩니다. (공유 리소스에서 검색됩니다.)

- Secure: 입력한 API Token이 암호화되고, 저장됩니다.

N

Model

콤보박스

Y

-

Y

사용할 Model을 선택합니다.

- gpt-3.5-turbo

- gpt-3.5-turbo-0301

- gpt-4

- gpt-4-0314

- gpt-4-32k

- gpt-4-32k-0314

N

MaxTokens

숫자

N

-

Y

MaxTokens를 입력합니다.

N

Prompt

문자열

Y

-

Y

Prompt를 입력합니다.

N

Instruction

문자열

N

-

N

시스템 역할에 대한 설명,지침을 입력합니다.

N

Temperature

숫자

N

-

Y

Temperature(무작위성)를 입력합니다.

N

TopP

숫자

N

-

Y

TopP(상위 확률 질량에 토큰을 고려하는 정도)를 입력합니다.

N

N

숫자

N

-

Y

N(각 Prompt에 대해 생성할 완료 수)를 입력합니다.

N

Stop

문자열 or 문자 배열

N

-

N

Stop(토큰 생성 중지를 하는 토큰 목록)을 입력합니다.

N

PresencePenalty

숫자

N

-

Y

PresencePenalty(새 주제에 대해 이야기할 가능성을 높임)를 입력합니다.

N

FrequencyPenalty

숫자

N

-

Y

FrequencyPenalty(동일한 줄을 그대로 반복할 가능성을 줄임)를 입력합니다.

N

User

문자열

N

-

N

User를 입력합니다.

Y

MORE OPTIONS

-

-

-

-

OpenAI 라이브러리의 공통 속성입니다.

Y

DESCRIPTION

-

-

-

-

OpenAI 라이브러리의 공통 속성입니다.

상세한 속성 설명은 아래 Open AI url을 참고합니다.

https://platform.openai.com/docs/api-reference/chat/create

활용 예시

OpenAI Text Completion API를 호출합니다.

AddDateTime1

예제 파일

사용된 변수

RESULT = 응답결과 전체를 저장할 변수
TextRESULT = 응답결과 중 choices내 첫번째 text 결과를 저장할 변수
Global.apiToken = API Token

사용된 속성

연관/유사 액티비티

TextCompletion