이 작업을 사용해 OpenAI에서 어시스턴트를 생성, 삭제, 목록 조회, 메시지 전송, 업데이트할 수 있습니다. OpenAI 노드 자체에 대한 자세한 내용은 OpenAI를 참조하세요.

어시스턴트 생성(Create an Assistant)#

새 어시스턴트를 생성하는 작업입니다.

다음 파라미터를 입력하세요:

• Credential to connect with: 기존 OpenAI 자격 증명을 생성하거나 선택합니다.
• Resource: Assistant를 선택합니다.
• Operation: Create an Assistant를 선택합니다.
• Model: 어시스턴트가 사용할 모델을 선택합니다. 어떤 모델을 사용할지 모르겠다면, 높은 지능이 필요한 경우 gpt-4o를, 가장 빠른 속도와 최저 비용이 필요한 경우 gpt-4o-mini를 사용해 보세요. 자세한 내용은 Models overview | OpenAI Platform을 참조하세요.
• Name: 어시스턴트의 이름을 입력합니다. 최대 256자입니다.
• Description: 어시스턴트의 설명을 입력합니다. 최대 512자입니다.

  A virtual assistant that helps users with daily tasks, including setting reminders, answering general questions, and providing quick information.
  

• Instructions: 어시스턴트가 사용할 시스템 지침을 입력합니다. 최대 32,768자입니다. 모델이 응답에 사용할 페르소나를 지정할 때 사용합니다.

  Always respond in a friendly and engaging manner. When a user asks a question, provide a concise answer first, followed by a brief explanation or additional context if necessary. If the question is open-ended, offer a suggestion or ask a clarifying question to guide the conversation. Keep the tone positive and supportive, and avoid technical jargon unless specifically requested by the user.
  

• Code Interpreter: 코드 인터프리터를 사용 설정하면 어시스턴트가 샌드박스 환경에서 코드를 작성하고 실행할 수 있습니다. 계산, 데이터 분석 또는 논리 기반 처리가 필요한 작업에 이 도구를 활성화하세요.
• Knowledge Retrieval: 지식 검색을 사용 설정하면 어시스턴트가 외부 소스 또는 연결된 지식 베이스에 접근할 수 있습니다. 자세한 내용은 File Search | OpenAI Platform을 참조하세요.
  • Files: 외부 지식 소스로 업로드할 파일을 선택합니다. 파일을 추가하려면 Upload a File 작업을 사용하세요.

옵션(Options)#

• Output Randomness (Temperature): 응답의 무작위성을 조정합니다. 0.0(결정론적)에서 1.0(최대 무작위) 사이의 범위입니다. 이 옵션 또는 Output Randomness (Top P) 중 하나만 변경하는 것을 권장합니다. 중간 온도(약 0.7)에서 시작하여 결과에 따라 조정하세요. 응답이 너무 반복적이거나 경직되면 온도를 높이고, 너무 혼란스럽거나 엉뚱하면 낮추세요. 기본값은 1.0입니다.
• Output Randomness (Top P): 어시스턴트 응답의 다양성을 제어하는 Top P 설정을 조정합니다. 예를 들어 0.5는 가능성 가중치 옵션의 절반을 고려합니다. 이 옵션 또는 Output Randomness (Temperature) 중 하나만 변경하는 것을 권장합니다. 기본값은 1.0입니다.
• Fail if Assistant Already Exists: 사용 설정 시, 같은 이름의 어시스턴트가 이미 존재하면 작업이 실패합니다.

자세한 내용은 Create assistant | OpenAI 문서를 참조하세요.

어시스턴트 삭제(Delete an Assistant)#

계정에서 기존 어시스턴트를 삭제하는 작업입니다.

다음 파라미터를 입력하세요:

• Credential to connect with: 기존 OpenAI 자격 증명을 생성하거나 선택합니다.
• Resource: Assistant를 선택합니다.
• Operation: Delete an Assistant를 선택합니다.
• Assistant: 삭제할 어시스턴트를 From list 또는 By ID로 선택합니다.

자세한 내용은 Delete assistant | OpenAI 문서를 참조하세요.

어시스턴트 목록 조회(List Assistants)#

조직 내 어시스턴트 목록을 조회하는 작업입니다.

• Credential to connect with: 기존 OpenAI 자격 증명을 생성하거나 선택합니다.
• Resource: Assistant를 선택합니다.
• Operation: List Assistants를 선택합니다.

옵션(Options)#

• Simplify Output: 사용 설정 시 원시 데이터 대신 단순화된 응답을 반환합니다. 기본적으로 활성화되어 있습니다.

자세한 내용은 List assistants | OpenAI 문서를 참조하세요.

어시스턴트에 메시지 전송(Message an Assistant)#

어시스턴트에 메시지를 보내고 응답을 받는 작업입니다.

다음 파라미터를 입력하세요:

• Credential to connect with: 기존 OpenAI 자격 증명을 생성하거나 선택합니다.
• Resource: Assistant를 선택합니다.
• Operation: Message an Assistant를 선택합니다.
• Assistant: 메시지를 보낼 어시스턴트를 선택합니다.
• Prompt: 어시스턴트에 보낼 텍스트 프롬프트 또는 메시지를 입력합니다.
  • Connected Chat Trigger Node: 이전 노드의 chatInput 필드에서 자동으로 입력을 사용합니다.
  • Define Below: 정적 텍스트를 입력하거나 이전 노드의 데이터를 참조하는 표현식으로 프롬프트를 수동 정의합니다.

옵션(Options)#

• Base URL: 어시스턴트가 API 요청에 사용할 기본 URL을 입력합니다. OpenAI 호환 API를 제공하는 다른 LLM 제공자의 엔드포인트로 어시스턴트를 안내할 때 유용합니다.
• Max Retries: 실패 시 어시스턴트가 작업을 재시도할 횟수를 지정합니다.
• Timeout: 타임아웃 전 어시스턴트가 응답을 기다리는 최대 시간(밀리초)을 설정합니다. 작업 중 긴 대기를 방지하는 데 사용합니다.
• Preserve Original Tools: 비활성화하면 어시스턴트와 연결된 원본 도구를 제거합니다. 특정 작업에서 도구를 일시적으로 제거하려는 경우 사용하세요.

자세한 내용은 Assistants | OpenAI 문서를 참조하세요.

어시스턴트 업데이트(Update an Assistant)#

기존 어시스턴트의 세부 정보를 업데이트하는 작업입니다.

다음 파라미터를 입력하세요:

• Credential to connect with: 기존 OpenAI 자격 증명을 생성하거나 선택합니다.
• Resource: Assistant를 선택합니다.
• Operation: Update an Assistant를 선택합니다.
• Assistant: 업데이트할 어시스턴트를 선택합니다.

옵션(Options)#

• Code Interpreter: 사용 설정 시 어시스턴트가 샌드박스 환경에서 코드를 작성하고 실행할 수 있습니다. 계산, 데이터 분석 또는 논리 기반 처리가 필요한 작업에 이 도구를 활성화하세요.
• Description: 어시스턴트의 설명을 입력합니다. 최대 512자입니다.

  A virtual assistant that helps users with daily tasks, including setting reminders, answering general questions, and providing quick information.
  

• Instructions: 어시스턴트가 사용할 시스템 지침을 입력합니다. 최대 32,768자입니다. 모델이 응답에 사용할 페르소나를 지정할 때 사용합니다.

  Always respond in a friendly and engaging manner. When a user asks a question, provide a concise answer first, followed by a brief explanation or additional context if necessary. If the question is open-ended, offer a suggestion or ask a clarifying question to guide the conversation. Keep the tone positive and supportive, and avoid technical jargon unless specifically requested by the user.
  

• Knowledge Retrieval: 사용 설정 시 어시스턴트가 외부 소스 또는 연결된 지식 베이스에 접근할 수 있습니다. 자세한 내용은 File Search | OpenAI Platform을 참조하세요.
• Files: 외부 지식 소스로 업로드할 파일을 선택합니다. 파일 추가는 Upload a File 작업을 사용하세요. 이 옵션은 File Search 도구가 아닌 Code Interpreter 도구만 업데이트합니다.
• Model: 어시스턴트가 사용할 모델을 선택합니다. 어떤 모델을 사용할지 모르겠다면, 높은 지능이 필요한 경우 gpt-4o를, 가장 빠른 속도와 최저 비용이 필요한 경우 gpt-4o-mini를 사용해 보세요. 자세한 내용은 Models overview | OpenAI Platform을 참조하세요.
• Name: 어시스턴트의 이름을 입력합니다. 최대 256자입니다.
• Remove All Custom Tools (Functions): 사용 설정 시 어시스턴트에서 모든 커스텀 도구(함수)를 제거합니다.
• Output Randomness (Temperature): 응답의 무작위성을 조정합니다. 0.0(결정론적)에서 1.0(최대 무작위) 사이의 범위입니다. 이 옵션 또는 Output Randomness (Top P) 중 하나만 변경하는 것을 권장합니다. 중간 온도(약 0.7)에서 시작하여 결과에 따라 조정하세요. 기본값은 1.0입니다.
• Output Randomness (Top P): 응답 다양성을 제어하는 Top P 설정을 조정합니다. 예를 들어 0.5는 가능성 가중치 옵션의 절반을 고려합니다. 이 옵션 또는 Output Randomness (Temperature) 중 하나만 변경하는 것을 권장합니다. 기본값은 1.0입니다.

자세한 내용은 Modify assistant | OpenAI 문서를 참조하세요.

일반적인 문제#

일반적인 오류 또는 문제 및 권장 해결 방법은 Common Issues를 참조하세요.