모델·체인·MCP
언어 모델 노드 (AI 서브노드)
모델 노드는 AI Agent·LLM 체인의 모델 슬롯에 점선으로 연결하는 서브노드입니다.
| 노드 | 프로바이더 | 자격증명 |
|---|---|---|
| Ollama Chat Model | Ollama (로컬/클라우드) | ollamaApi (baseUrl + 필요 시 apiKey) |
| Ollama Model | Ollama (completion) | ollamaApi |
| OpenAI Chat Model | OpenAI · Azure OpenAI · OpenAI 호환 API | openAiApi |
| Anthropic Chat Model | Anthropic Claude | anthropicApi |
| Google Gemini Chat Model | Google Gemini | Gemini API 키 |
- 모델 선택 — 모델 ID 는 직접 입력하거나, 자격증명이 연결된 경우 프로바이더에서 목록을 불러오는 동적 모델 피커로 고를 수 있습니다.
- Ollama 클라우드 — 자격증명에 apiKey 를 넣으면 인증 헤더로 전달됩니다(로컬 Ollama 는 apiKey 불요).
- reasoning 모델(OpenAI o1/o3/gpt-5 계열) — 전용 파라미터 규약(max_completion_tokens, reasoning_effort)이 자동 적용됩니다.
- Anthropic extended thinking — thinking budget 설정 시 제약(temperature 등)이 자동 보정됩니다.
- 자격증명 등록은 자격증명 참고. 프로바이더별 파라미터는 각 노드 페이지에 문서화돼 있습니다.
LLM 체인 (Basic LLM Chain)
LLM Chain 은 도구 없이 프롬프트 → 모델 → 응답의 단순 체인입니다. 모델 슬롯에 모델 노드를 연결하고 프롬프트(직접 입력 또는 이전 노드 데이터)를 지정합니다.
구조화 체인 3종
모델 출력에 JSON 스키마를 강제해 구조화된 결과를 얻는 체인입니다.
| 노드 | 용도 |
|---|---|
| Text Classifier | 입력 텍스트를 정의한 카테고리로 분류 |
| Sentiment Analysis | 감정 분석 |
| Information Extractor | 텍스트에서 지정 속성 추출 |
MCP 게이트웨이
AI Agent 의 MCP Client Tool 은 MCP(Model Context Protocol) 서버의 도구들을 에이전트 도구로 노출합니다. SSemWorks 는 MCP 게이트웨이(works-mcp)를 통해 여러 MCP 서버·일반 REST API 를 하나의 엔드포인트로 통합합니다.
다이어그램 설명
- 에이전트의 MCP 노드는 게이트웨이 주소 하나만 바라봅니다 — 실제 MCP 서버가 늘어나도 워크플로우는 그대로입니다.
- 게이트웨이는 등록된 서버들의 도구 목록을 병합해 내려주고, 호출을 소유 서버로 라우팅합니다(이름 충돌 시 서버명 접두사).
- 일반 REST API 도 도구로 등록할 수 있습니다(관리 스튜디오에서 메서드/경로/파라미터를 정의하면 MCP 도구로 번역).
- APP 키 스코핑 — 관리 스튜디오에서 APP(API 키)을 발급하고 사용할 도구(서비스)를 맵핑하면, 그 APP 키를 가진 에이전트는 부여된 도구만 보고 호출할 수 있습니다.
노드 설정
MCP Client Tool 노드에서:
- 엔드포인트 — MCP 게이트웨이의
/mcp주소 - 인증 토큰(authToken) — 관리 스튜디오에서 발급한 APP 키(Bearer 로 전송)
서버/도구를 게이트웨이에 새로 등록하면 약 1분 안에 에이전트에 반영됩니다(도구 목록 캐시).