개요
이 문서에서는 외부 API에 연결하는 방법, GPT가 할 수 있는 일을 정의하는 방법, 인증, 스키마, 워크스페이스 제한을 관리하는 방법을 포함하여 GPT에서 액션을 구성하는 방법을 설명합니다.
액션을 구성하려면 연결하려는 서비스의 API 세부정보(인증 정보 및 OpenAPI 스키마 포함)가 필요합니다. GPT는 앱 또는 액션 중 하나만 사용할 수 있으며, 두 가지를 동시에 사용할 수는 없습니다.
각 액션은 두 가지 주요 구성요소로 정의됩니다. GPT가 API에 인증하는 방식과 API가 무엇을 할 수 있는지 정의하는 스키마입니다.
제한 사항
워크스페이스에서 허용된 액션 도메인이 0개라면, 어떤 액션 도메인도 허용 목록(allowlist) 검사를 통과할 수 없으므로 GPT 사용자 지정 액션을 실행할 수 없습니다. 그렇다고 해서 반드시 모든 GPT의 공개 범위나 접근이 차단된다는 뜻은 아닙니다.
Pro 모드에서는 액션을 사용할 수 없으며, 사용자 지정 액션이 있는 GPT를 만들면 그 안에서 선택 가능한 모델은 Instant 및 Thinking 모델만 제공됩니다.
액션 만들기
GPT 편집기에서 Actions 섹션으로 이동한 다음 Create new action을 선택합니다.
그런 다음 GPT가 외부 API에 연결하고 이를 사용하는 방법을 구성합니다.
액션을 구성한 뒤에는 Preview에서 테스트하여 예상대로 동작하는지 확인하세요.
인증
인증은 GPT가 외부 API에 연결하는 방식을 제어합니다.
사용 가능한 옵션:
None: 인증이 필요하지 않음
API key: 비밀 키를 사용해 요청을 승인함
OAuth: 사용자의 로그인으로 계정 기반 접근을 사용함
API key
서버 간 접근(server-to-server access)에는 API key 인증을 사용하세요. 다음과 같이 구성할 수 있습니다:
Basic
Bearer
Custom header
OAuth
액션에 사용자 계정이 필요할 때는 OAuth를 사용하세요. OAuth에는 다음이 필요합니다:
Client ID 및 Client Secret
Authorization URL 및 Token URL
Scope 및 토큰 교환 방식
편집기는 OAuth 흐름을 완료하기 위한 콜백 URL을 제공합니다.
스키마
스키마는 API가 무엇을 할 수 있는지 정의합니다. 스키마는 ChatGPT에 다음을 알려줍니다:
어느 서버를 호출할지
어떤 엔드포인트를 사용할 수 있는지
어떤 파라미터를 받는지
각 액션을 어떻게 식별하는지(오퍼레이션 ID)
스키마는 JSON 또는 YAML 형식의 OpenAPI 사양으로 제공해야 합니다.
스키마 추가
스키마는 다음 세 가지 방법으로 추가할 수 있습니다:
편집기에 직접 붙여넣기
URL에서 가져오기
기본 제공 예시에서 시작하기:
날씨(JSON)
펫 스토어(YAML)
빈 템플릿
스키마가 유효하면 편집기에 감지된 액션이 표시됩니다. 유효하지 않으면 검증 오류가 표시됩니다.
워크스페이스 제한(Enterprise 및 Edu)
다음 메시지가 표시된다면:
“워크스페이스 설정에서 어떤 도메인도 허용되지 않습니다.”
이는 워크스페이스 설정에 의해 액션이 제한된다는 의미입니다.
관리자는 모든 도메인을 허용하거나 승인된 도메인으로만 액션을 제한할 수 있습니다.
허용된 도메인이 없다면 액션을 사용할 수 없습니다.
액션 및 도메인 제한에 대한 워크스페이스 수준 제어는 다음을 참고하세요: Enterprise 및 Edu 워크스페이스에서 GPT 접근 관리하기.
개인정보 및 사용자 제어
각 액션에는 개인정보 보호 정책 URL을 포함할 수 있습니다.
액션이 포함된 공개 GPT(링크 또는 GPT 스토어)는 유효한 개인정보 보호 정책 URL을 반드시 포함해야 합니다.
사용자는 액션이 실행되기 전에 승인을 요청받을 수 있습니다.
OAuth 액션의 경우 사용자는 연결된 계정을 검토하고 관리할 수 있습니다.
추가 도움말
액션 작성 또는 디버깅에 도움이 필요하면 공식 ActionsGPT를 사용하세요.