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

Assistant 생성#

이 작업을 사용하여 새 assistant를 생성합니다.

다음 매개변수를 입력하세요:

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

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

• Instructions: assistant가 사용할 시스템 지침을 입력합니다. 최대 길이는 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: 켜서 assistant의 코드 인터프리터를 활성화하면, 샌드박스 환경에서 코드를 작성하고 실행할 수 있습니다. 계산, 데이터 분석 또는 로직 기반 처리가 필요한 작업에 이 도구를 활성화하세요.
• Knowledge Retrieval: 켜서 assistant의 지식 검색 기능을 활성화하면, 외부 소스나 연결된 지식 베이스에 접근할 수 있습니다. 자세한 내용은 File Search | OpenAI Platform을 참고하세요.
  • Files: 외부 지식 소스로 업로드할 파일을 선택합니다. 파일을 더 추가하려면 Upload a File 작업을 사용하세요.

옵션#

• Output Randomness (Temperature): 응답의 무작위성을 조정합니다. 범위는 0.0(결정론적)에서 1.0(최대 무작위성) 사이입니다. 이 옵션이나 Output Randomness (Top P) 중 하나만 변경하는 것을 권장하며, 둘 다 변경하지 않는 것이 좋습니다. 중간 정도의 temperature(약 0.7)로 시작하여 관찰되는 결과에 따라 조정하세요. 응답이 너무 반복적이거나 경직되어 있다면 temperature를 높이세요. 너무 산만하거나 주제를 벗어난다면 낮추세요. 기본값은 1.0입니다.
• Output Randomness (Top P): Top P 설정을 조정하여 assistant 응답의 다양성을 제어합니다. 예를 들어 0.5는 가능성 가중치가 적용된 모든 옵션 중 절반을 고려한다는 의미입니다. 이 옵션이나 Output Randomness (Temperature) 중 하나만 변경하는 것을 권장하며, 둘 다 변경하지 않는 것이 좋습니다. 기본값은 1.0입니다.
• Fail if Assistant Already Exists: 활성화하면 동일한 이름의 assistant가 이미 존재할 경우 작업이 실패합니다.

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

Assistant 삭제#

이 작업을 사용하여 계정에서 기존 assistant를 삭제합니다.

다음 매개변수를 입력하세요:

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

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

Assistant 목록 조회#

이 작업을 사용하여 조직 내 assistant 목록을 조회합니다.

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

옵션#

• Simplify Output: 켜면 원본 데이터 대신 간소화된 버전의 응답을 반환합니다. 이 옵션은 기본적으로 활성화되어 있습니다.

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

Assistant에 메시지 전송#

이 작업을 사용하여 assistant에 메시지를 전송하고 응답을 받습니다.

다음 매개변수를 입력하세요:

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

옵션#

• Base URL: assistant가 API 요청을 보낼 때 사용할 기본 URL을 입력합니다. 이 옵션은 OpenAI와 호환되는 API를 제공하는 다른 LLM 제공업체의 엔드포인트를 사용하도록 assistant를 지정할 때 유용합니다.
• Max Retries: 작업이 실패할 경우 assistant가 재시도할 횟수를 지정합니다.
• Timeout: assistant가 응답을 기다리다 타임아웃될 때까지의 최대 시간을 밀리초 단위로 설정합니다. 이 옵션을 사용하여 작업 중 장시간 대기하는 것을 방지하세요.
• Preserve Original Tools: 끄면 assistant와 연결된 원래 도구가 제거됩니다. 이 특정 작업에서 일시적으로 도구를 제거하고 싶을 때 사용하세요.

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

Assistant 업데이트#

이 작업을 사용하여 기존 assistant의 세부 정보를 업데이트합니다.

다음 매개변수를 입력하세요:

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

옵션#

• Code Interpreter: 켜서 assistant의 코드 인터프리터를 활성화하면, 샌드박스 환경에서 코드를 작성하고 실행할 수 있습니다. 계산, 데이터 분석 또는 로직 기반 처리가 필요한 작업에 이 도구를 활성화하세요.
• Description: assistant의 설명을 입력합니다. 최대 길이는 512자입니다.

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

• Instructions: assistant가 사용할 시스템 지침을 입력합니다. 최대 길이는 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: 켜서 assistant의 지식 검색 기능을 활성화하면, 외부 소스나 연결된 지식 베이스에 접근할 수 있습니다. 자세한 내용은 File Search | OpenAI Platform을 참고하세요.
• Files: 외부 지식 소스로 업로드할 파일을 선택합니다. 파일을 더 추가하려면 Upload a File 작업을 사용하세요. 이 옵션은 File Search 도구가 아닌 Code Interpreter 도구만 업데이트한다는 점에 유의하세요.
• Model: assistant가 사용할 모델을 선택합니다. 어떤 모델을 사용해야 할지 잘 모르겠다면, 높은 지능이 필요한 경우 gpt-4o를, 가장 빠른 속도와 가장 낮은 비용이 필요한 경우 gpt-4o-mini를 사용해 보세요. 자세한 내용은 Models overview | OpenAI Platform을 참고하세요.
• Name: assistant의 이름을 입력합니다. 최대 길이는 256자입니다.
• Remove All Custom Tools (Functions): 켜서 assistant에서 모든 커스텀 도구(함수)를 제거합니다.
• Output Randomness (Temperature): 응답의 무작위성을 조정합니다. 범위는 0.0(결정론적)에서 1.0(최대 무작위성) 사이입니다. 이 옵션이나 Output Randomness (Top P) 중 하나만 변경하는 것을 권장하며, 둘 다 변경하지 않는 것이 좋습니다. 중간 정도의 temperature(약 0.7)로 시작하여 관찰되는 결과에 따라 조정하세요. 응답이 너무 반복적이거나 경직되어 있다면 temperature를 높이세요. 너무 산만하거나 주제를 벗어난다면 낮추세요. 기본값은 1.0입니다.
• Output Randomness (Top P): Top P 설정을 조정하여 assistant 응답의 다양성을 제어합니다. 예를 들어 0.5는 가능성 가중치가 적용된 모든 옵션 중 절반을 고려한다는 의미입니다. 이 옵션이나 Output Randomness (Temperature) 중 하나만 변경하는 것을 권장하며, 둘 다 변경하지 않는 것이 좋습니다. 기본값은 1.0입니다.

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

일반적인 문제#

일반적인 오류나 문제 및 권장 해결 단계는 Common Issues를 참고하세요.