설정, 인증, 스키마 구성 등을 포함해 액션을 사용하여 GPT를 외부 API에 연결하는 방법입니다.

개요

이 문서에서는 외부 API에 연결하는 방법, GPT가 수행할 수 있는 작업을 정의하는 방법, 인증, 스키마, 워크스페이스 제한을 관리하는 방법을 포함하여 GPT에서 작업을 구성하는 방법을 설명합니다.

작업을 구성하려면 인증 정보와 OpenAPI 스키마를 포함해 연결하려는 서비스의 API 세부 정보가 필요합니다. GPT는 앱 또는 작업 중 하나를 사용할 수 있지만 둘을 동시에 사용할 수는 없습니다.

각 작업은 GPT가 API로 인증하는 방식과 API가 수행할 수 있는 작업을 정의하는 스키마라는 두 가지 주요 구성 요소로 정의됩니다.

제한 사항

워크스페이스에서 허용된 작업 도메인이 하나도 없으면, 허용 목록 검사를 통과할 수 있는 작업 도메인이 없으므로 GPT 맞춤 작업을 실행할 수 없습니다. 그렇다고 해서 모든 GPT의 공개 범위나 액세스가 차단된다는 의미는 아닙니다.

Pro 모드에서는 작업을 사용할 수 없습니다. 맞춤 작업이 있는 GPT를 만들거나 편집할 때 모델 선택기에는 작업을 지원하는 비-Pro 모델만 표시됩니다.

작업 만들기

GPT 편집기에서 작업 섹션으로 이동한 다음 새 작업 만들기를 선택하세요.

그런 다음 GPT가 외부 API에 연결하고 이를 사용하는 방식을 구성합니다.

작업을 구성한 후에는 미리 보기에서 테스트하여 예상대로 작동하는지 확인하세요.

인증

인증은 GPT가 외부 API에 연결하는 방식을 제어합니다.

사용 가능한 옵션:

없음: 인증이 필요하지 않음
API 키: 비밀 키를 사용해 요청 승인
OAuth: 계정 기반 액세스에 사용자 로그인을 사용

API 키

서버 간 액세스에는 API 키 인증을 사용하세요. 다음과 같이 구성할 수 있습니다:

Basic
Bearer
사용자 지정 헤더

OAuth

작업에 사용자 계정이 필요한 경우 OAuth를 사용하세요. OAuth에는 다음이 필요합니다:

클라이언트 ID 및 클라이언트 보안 비밀
승인 URL 및 토큰 URL
범위 및 토큰 교환 방식

편집기는 OAuth 흐름을 완료하기 위한 콜백 URL을 제공합니다.

스키마

스키마는 API가 수행할 수 있는 작업을 정의합니다. ChatGPT에 다음을 알려줍니다:

호출할 서버
사용 가능한 엔드포인트
허용하는 매개변수
각 작업이 식별되는 방식(operation IDs)

스키마는 JSON 또는 YAML 형식의 OpenAPI 사양으로 제공해야 합니다.

스키마 추가

스키마는 세 가지 방법으로 추가할 수 있습니다:

편집기에 직접 붙여넣기
URL에서 가져오기
기본 제공 예시에서 시작:
- 날씨(JSON)
- 펫 스토어(YAML)
- 빈 템플릿

스키마가 유효하면 편집기에 감지된 작업이 표시됩니다. 유효하지 않으면 유효성 검사 오류가 표시됩니다.

워크스페이스 제한(Enterprise 및 Edu)

다음 메시지가 표시되는 경우:

“워크스페이스 설정에서 허용된 도메인이 없습니다.”

이는 워크스페이스 설정에 의해 작업이 제한되어 있음을 의미합니다.

관리자는 모든 도메인을 허용하거나 승인된 도메인으로 작업을 제한할 수 있습니다.
허용된 도메인이 없으면 작업을 사용할 수 없습니다.

작업 및 도메인 제한에 대한 워크스페이스 수준 제어는 Enterprise 및 Edu 워크스페이스에서 GPT 액세스 관리를 참조하세요.

개인정보 보호 및 사용자 제어

각 작업에는 개인정보 보호 정책 URL을 포함할 수 있습니다.
작업이 있는 공개 GPT(링크 또는 GPT 스토어)는 유효한 개인정보 보호 정책 URL을 포함해야 합니다.
사용자는 작업이 실행되기 전에 승인을 요청받을 수 있습니다.
OAuth 작업의 경우 사용자는 연결된 계정을 검토하고 관리할 수 있습니다.

추가 도움말

작업 작성 또는 디버깅에 도움이 필요하면 공식 ActionsGPT를 사용하세요.

GPT에서 액션 구성하기

개요