봇 구성
AISCouncil의 모든 봇은 제공업체, 모델, 동작 및 외모를 제어하는 구성 객체로 정의됩니다. 이 페이지는 전체 구성 스키마를 문서화하고 각 필드를 설명합니다.
설정 패널
설정 패널은 화면 오른쪽에서 슬라이드아웃됩니다. 데스크톱에서는 기본적으로 표시되고 모바일에서는 설정 아이콘을 통해 접근할 수 있습니다. 패널에는 다음이 포함됩니다:
- 상단의 제공업체 및 모델 선택기
- 시스템 프롬프트 텍스트 영역
- 생성 매개변수 (온도, 최대 토큰 등)
- 고급 설정 (확장 가능한 섹션)
- 페르소나 설정 (아이콘, 설명, 색상)
- 봇별 API 키 필드
편집하면 변경 사항이 자동으로 저장됩니다.
핵심 필드
제공업체
모델을 호스팅하는 LLM 제공업체입니다. 드롭다운에서 선택:
| 제공업체 | API 키 소스 | 참고 |
|---|---|---|
| Anthropic | console.anthropic.com | Claude 모델 -- 고급 추론 |
| OpenAI | platform.openai.com | GPT-4o, o3, DALL-E |
| xAI | console.x.ai | Grok 모델 |
| Google Gemini | aistudio.google.com | 무료 Flash 티어 이용 가능 |
| OpenRouter | openrouter.ai | 300개 이상의 모델, 무료 티어 |
| Groq | console.groq.com | 초고속 LPU 추론 |
| DeepSeek | platform.deepseek.com | R1 및 V3 추론 모델 |
| Mistral | console.mistral.ai | Large, Small, Codestral |
| Ollama | N/A (로컬) | 로컬 실행, API 키 불필요 |
| Custom | 사용자 정의 | 모든 OpenAI 호환 엔드포인트 |
제공업체를 변경하면 해당 제공업체에서 사용 가능한 모델을 표시하도록 모델 드롭다운이 업데이트됩니다.
모델
선택한 제공업체의 특정 모델입니다. 드롭다운은 커뮤니티 모델 레지스트리에서 채워지며 다음을 표시합니다:
- 모델 이름 및 ID
- 가격 계층 (무료 또는 유료)
- 컨텍스트 윈도우 크기
- 기능 (vision, 추론, 도구)
모델을 선택하면 드롭다운 아래에 가격 (백만 토큰당 입력/출력), 컨텍스트 윈도우 크기, 최대 출력 토큰 및 기능 태그를 보여주는 정보 카드가 나타납니다. 이것은 작업에 적합한 모델을 선택하는 데 도움이 됩니다.
시스템 프롬프트
모든 대화 시작 시 모델에 전송되는 지침입니다. 봇의 동작, 성격 및 제약 조건을 정의합니다. 자세한 지침과 템플릿은 시스템 프롬프트를 참조하세요.
시스템 프롬프트 필드에는 5개의 내장 프리셋이 있는 템플릿 드롭다운이 포함되어 있습니다. 템플릿을 선택하고 필요에 맞게 사용자 정의하세요.
온도
응답의 무작위성/창의성을 제어합니다.
| 값 | 동작 |
|---|---|
| 0 | 결정론적 -- 항상 가장 가능성 있는 토큰 선택 |
| 0.3 | 보수적 -- 집중적이고 일관된 응답 |
| 0.7 | 균형 잡힘 (기본값) -- 창의성과 일관성의 좋은 조화 |
| 1.0 | 창의적 -- 더 다양한 응답 |
| 1.5-2.0 | 매우 창의적 -- 예측 불가능, 실험적 |
최대 토큰
단일 응답에서 모델이 생성할 수 있는 최대 토큰 수입니다. 범위: 128 ~ 16,384 (또는 지원하는 모델의 경우 더 높음). 기본값: 4,096.
최대 토큰을 너무 낮게 설정하면 응답이 문장 중간에 잘릴 수 있습니다. 너무 높게 설정하면 유료 모델의 비용이 증가할 수 있습니다. 대부분의 사용 사례에 4,096이 좋은 기본값입니다.
고급 필드
설정 패널에서 고급 섹션을 확장하여 이 매개변수에 액세스합니다.
추론 / 사고 노력
확장 사고를 지원하는 모델(Claude, GPT o 시리즈, DeepSeek R1, Gemini 사고 모델)의 경우 응답 전에 모델이 추론에 소비하는 계산량을 제어합니다.
| 값 | 설명 |
|---|---|
| 끔 | 확장 사고 없음 (표준 응답) |
| 낮음 | 최소 추론, 가장 빠른 응답 |
| 보통 | 보통 추론 깊이 |
| 높음 | 깊은 추론, 더 철저함 |
| 최고 | 최대 추론 노력 |
| 사용자 정의 | 사용자 정의 예산 토큰 수 설정 |
모든 모델이 추론/사고 모드를 지원하지는 않습니다. 필드는 선택한 모델 또는 제공업체가 지원하는 경우에만 나타납니다. 추론을 지원하는 것으로 알려진 모델에는 Anthropic Claude (확장 사고), OpenAI o1/o3 시리즈, DeepSeek R1, xAI Grok 및 Google Gemini 사고 모델이 포함됩니다.
Top P (핵 샘플링)
토큰 선택을 위한 누적 확률 임계값을 제어합니다. 기본값: 1.0 (필터링 없음).
1.0-- 모든 토큰 고려 (기본값)0.9-- 확률 질량의 상위 90%를 구성하는 토큰 고려0.1-- 매우 제한적, 거의 결정론적
일반적으로 온도 또는 Top P 중 하나만 조정하는 것이 권장됩니다. 둘 다 변경하면 예측할 수 없는 결과가 발생할 수 있습니다.
빈도 페널티
이미 나타난 토큰이 반복될 가능성을 줄입니다. 범위: 0 ~ 2. 기본값: 0.
0-- 페널티 없음 (기본값)0.5-- 가벼운 반복 감소1.0-2.0-- 강한 반복 감소
존재 페널티
한 번이라도 나타난 토큰에 페널티를 부과하여 모델이 새로운 주제에 대해 이야기하도록 장려합니다. 범위: 0 ~ 2. 기본값: 0.
0-- 페널티 없음 (기본값)0.5-- 가벼운 주제 다양성 장려1.0-2.0-- 새로운 주제로 강력한 유도
시드
재현 가능한 출력을 위한 정수 값입니다. 동일한 시드, 프롬프트 및 매개변수가 사용되면 모델은 동일한 응답을 반환하려고 시도합니다. 모든 제공업체가 이 기능을 지원하지는 않습니다.
정지 시퀀스
쉼표로 구분된 사용자 정의 정지 토큰 목록입니다. 모델이 이 시퀀스 중 하나를 생성하면 더 이상 출력을 생성하지 않습니다. 구조화된 출력 또는 역할극 시나리오에 유용합니다.
예시: END,---,</answer>는 모델이 END, --- 또는 </answer>를 생성할 때 중지합니다.
응답 형식
출력 형식을 제어합니다:
| 값 | 설명 |
|---|---|
text | 표준 텍스트 출력 (기본값) |
json | JSON 출력 강제 (모델이 구조화된 출력을 지원해야 함) |
JSON 모드는 시스템 프롬프트에서 모델에게 JSON을 생성하도록 지시해야 합니다. 프롬프트에서 언급하지 않고 응답 형식을 JSON으로 설정하면 오류나 잘못된 출력이 발생할 수 있습니다.
도구 호출
지원하는 모델에 대한 함수/도구 호출을 구성합니다. 이것은 외부 도구 또는 구조화된 작업을 호출할 수 있는 봇을 구축하기 위한 고급 기능입니다.
봇별 API 키
각 봇은 전역 키와 다른 API 키를 사용할 수 있습니다:
- 설정 패널에서 API 키 필드 찾기 (제공업체 선택기 아래)
- 이 봇에 특정한 키 입력
- 이 키는 이 봇에만 전역 키를 재정의함
봇별 키는 로컬로 저장되며 공유 봇 URL에 절대 포함되지 않습니다.
구성 단축 키
내부적으로 봇 구성은 효율적인 URL 압축을 위해 단축 키를 사용합니다. 이것은 통합을 구축하거나 공유 URL을 디버깅하는 경우 유용합니다:
| 단축 키 | 전체 이름 | 유형 | 기본값 |
|---|---|---|---|
n | Name | string | "New Bot" |
p | Provider | string | "anthropic" |
m | Model | string | -- |
s | System Prompt | string | "" |
t | Temperature | number | 0.7 |
x | Max Tokens | number | 4096 |
tp | Top P | number | 1.0 |
fp | Frequency Penalty | number | 0 |
pp | Presence Penalty | number | 0 |
se | Seed | number | -- |
re | Reasoning Effort | string | -- |
st | Stop Sequences | string | -- |
rf | Response Format | string | "text" |
tc | Tool Choice | string | -- |
tl | Tool List | array | -- |
pi | Persona Icon | string | -- |
pd | Persona Description | string | -- |
pc | Persona Color | string | -- |
Council 구성 (c 키)
봇이 council (2개 이상 멤버)인 경우 c 키에 다음이 포함됩니다:
| 단축 키 | 전체 이름 | 유형 | 기본값 |
|---|---|---|---|
cs | Council Style | string | "council" |
ms | Members | array | -- |
ch | Chairman | number | 0 |
vm | Voting Mode | string | "weighted" |
sr | Skip Review | boolean | false |
mx | Max Tokens (per member) | number | 1024 |
dr | Deliberation Rounds | number | 2 |
채팅 설정
이 봇별 설정은 채팅 경험을 제어합니다:
| 설정 | 단축 키 | 설명 | 기본값 |
|---|---|---|---|
| Context Limit | cl | API로 전송되는 최대 메시지 (0 = 무제한) | 무제한 |
| Streaming | sm | 실시간 토큰 스트리밍 | 활성화 |
| Auto-Title | at | 대화 제목 자동 생성 | 비활성화 |
| Markdown | mr | 응답에서 마크다운 렌더링 | 활성화 |
| Show Token Count | stc | 메시지당 토큰 사용량 표시 | 비활성화 |
원시 구성 편집
설정 패널은 모든 필드에 대한 시각적 편집기를 제공합니다. 일반적인 사용에서 원시 JSON을 편집할 필요가 없습니다. 그러나 내부 형식은 통합, 사용자 정의 제공업체 또는 프로그래밍 방식으로 봇 구성을 생성하는 도구를 구축하는 개발자를 위해 여기에 문서화되어 있습니다.
원시 구성 예시:
{
"n": "Code Assistant",
"p": "anthropic",
"m": "claude-sonnet-4-20250514",
"s": "You are an expert software engineer. Provide clear, well-documented code with explanations.",
"t": 0.3,
"x": 8192,
"pi": "💻",
"pd": "Software engineering assistant",
"pc": "#4a90d9"
}