사전 요구 사항#
Apidog에서 AI 기능을 구성하기 전에 다음 사항을 확인하십시오.조직 또는 팀 관리자(또는 그 이상) 역할이 있는 Apidog 계정
Apidog 클라이언트 버전 2.7.18 이상
지원되는 AI 모델 제공업체(OpenAI, Anthropic, Google AI Studio, Google Vertex 또는 사용자 지정 제공업체)의 API 키
조직 또는 팀 관리자(또는 그 이상의 역할)만 AI 기능을 구성할 수 있습니다.
모델 제공업체 구성#
AI features가 활성화되면 모델 제공업체를 구성하는 옵션이 표시됩니다. 구성을 시작하려면 + Add Provider를 클릭하십시오.현재 Apidog는 다음 모델 제공업체를 지원합니다.| 제공업체 |
|---|
| OpenAI |
| Anthropic |
| Google AI Studio |
| Google Vertex |
| Azure OpenAI |
| Custom API Configuration |
이러한 제공업체가 요구 사항을 충족하지 않는 경우 Custom API Configuration을 사용하여 다른 제공업체 모델에 연결할 수도 있습니다.구성 설정#
모델 제공업체를 추가할 때 다음 설정을 사용자 지정할 수 있습니다.| 설정 | 설명 |
|---|
| API Key | 선택한 모델 제공업체에서 제공한 API Key를 입력하십시오. 키가 유효한지 확인하려면 Test 기능을 사용하십시오. |
| API Base URL | Apidog에서 AI 기능을 사용할 때 요청이 전송되는 실제 URL입니다. 기본 제공업체의 경우 기본 URL이 미리 입력되어 있으며, 필요에 따라 편집할 수 있습니다. |
| Model List | AI 제공업체에서 제공하는 모델 목록입니다. 활성화된 모델만 AI 기능에 사용할 수 있습니다. 필요한 경우 모델을 수동으로 추가하십시오. |
| API Format | (Custom API Configuration 전용) 요청 및 응답 형식을 정의합니다. 대부분의 모델은 OpenAI 형식을 따릅니다. |
AI 모델로 전송되는 각 요청은 Apidog 서버에서 이 API 기본 URL로 전송됩니다.
Apidog의 AI 기능에는 사전 설정된 프롬프트와 호출 흐름이 포함되어 있습니다. 최상의 결과를 얻으려면 고급의 강력한 모델(더 긴 컨텍스트, 함수 호출 등을 지원하는 모델, 예: GPT-4.1-mini)을 선택해야 합니다.
기본 모델 설정#
사용자가 AI 기능을 사용할 때 모델을 지정하지 않으면 Apidog는 여기에서 설정된 기본 모델을 사용합니다. 현재 활성화된 모든 모델이 포함된 드롭다운이 표시되며, 기본적으로 사용할 모델을 선택하면 됩니다.기본 모델은 기본적으로 "Auto Select"로 설정되어 있으며, 활성화된 제공업체 및 모델의 순서에 따라 사용 가능한 모델을 자동으로 선택합니다.특정 모델을 기본값으로 설정했지만 해당 모델이 비활성화되거나 제거되면 Apidog는 자동으로 "Auto Select"로 다시 전환합니다.기능 및 프롬프트#
여기에서 모든 Apidog AI 기능을 관리하고 해당 프롬프트를 사용자 지정할 수 있습니다. 기능이 활성화되면 프로젝트의 관련 섹션에 표시됩니다. Apidog는 각 기능에 대한 기본 프롬프트를 제공하며, 필요에 더 잘 맞도록 조정할 수 있습니다.사용자 지정 프롬프트 편집은 아직 지원되지 않습니다. 향후 업데이트를 기다려 주십시오!
조직에서 팀으로 AI 구성 상속#
조직 관리를 사용하는 경우 조직 관리자 또는 소유자는 조직 수준에서 AI 기능을 설정할 수 있습니다. 이러한 설정은 조직 아래의 모든 팀에 적용될 수 있어, 프로젝트 전반에서 일관성을 유지하고 관리를 단순화하는 데 도움이 됩니다.조직 관리 페이지의 Settings 아래에서 팀 수준과 동일한 AI Features 구성 인터페이스를 찾을 수 있습니다.조직 수준에서 AI 기능이 설정되면 조직 내 모든 팀이 구성된 모델 제공업체, 기본 모델 및 기능을 상속할 수 있습니다.상속 규칙#
| 설정 | 동작 |
|---|
| Feature Toggles | 조직 수준에서 활성화된 경우 팀에서 켜거나 끌 수 있습니다. 조직 수준에서 비활성화된 경우 팀에서 활성화할 수 없습니다. |
| Model Providers | 팀은 조직에서 상속하거나 독립적으로 설정할 수 있습니다. |
| Default Model | 팀은 조직의 기본 모델을 사용하거나 자체적으로 구성할 수 있습니다. |
1.
AI 기능 스위치, 모델 제공업체 설정, 기본 모델 선택 및 기능과 같은 모든 토글은 조직의 구성을 따릅니다. 이를 통해 모든 팀에서 중앙 집중식 제어와 일관성이 보장됩니다.
2.
필요에 따라 모델 제공업체는 조직에서 상속하거나 각 팀에서 독립적으로 설정할 수 있습니다.
3.
팀은 조직 수준에서 정의된 기본 모델을 사용하도록 선택하거나 자체적으로 구성할 수도 있습니다.
