datamaker-kr synapse-plugin-helper:config Command Workflow
Codex Adaptation
- Treat the user request or explicitly supplied text as the command arguments.
- Use the available Codex file, search, terminal, and clarification capabilities that match the workflow.
- Do not depend on Claude-only slash command variables or tool names.
Synapse Plugin Configuration
Display the current plugin's configuration including categories, connected agents, and settings.
Workflow
Step 1: Check Plugin Context
# Check if config.yaml or synapse.yaml exists in current directory
if [ -f config.yaml ]; then
echo "CONFIG_FILE=config.yaml"
elif [ -f synapse.yaml ]; then
echo "CONFIG_FILE=synapse.yaml"
else
echo "CONFIG_FILE="
fi
If no config.yaml/synapse.yaml found:
현재 디렉토리에 Synapse 플러그인이 없습니다.
플러그인 디렉토리로 이동하거나 /synapse-plugin:create로 새 플러그인을 생성하세요.
Step 2: Parse Plugin Configuration
Read and parse the config file:
cat "$CONFIG_FILE"
Extract key information:
- Plugin name, code, version
- Category
- Data type
- Tasks
- Actions defined
Step 3: Display Plugin Information
╔══════════════════════════════════════════════════╗
║ SYNAPSE PLUGIN CONFIGURATION ║
╠══════════════════════════════════════════════════╣
║ Name: [plugin-name] ║
║ Code: [plugin-code] ║
║ Version: [version] ║
╠══════════════════════════════════════════════════╣
║ Category: [category] ║
║ Data Type: [data_type] ║
║ Tasks: [task1, task2, ...] ║
║ Package Manager: [pip|uv] ║
╚══════════════════════════════════════════════════╝
Step 4: List Available Categories
Display all available plugin categories:
╔══════════════════════════════════════════════════╗
║ AVAILABLE CATEGORIES ║
╠══════════════════════════════════════════════════╣
║ Category │ Description ║
╠───────────────────┼──────────────────────────────╣
║ neural_net │ ML model training/inference ║
║ export │ Data format conversion ║
║ upload │ External data import ║
║ smart_tool │ AI-assisted annotation ║
║ pre_annotation │ Pre-labeling processing ║
║ post_annotation │ Post-labeling processing ║
║ data_validation │ Data quality checks ║
║ custom │ User-defined ║
╚══════════════════════════════════════════════════╝
현재 설정: [current-category]
Step 5: Show Connected Agents
Check for current Synapse agent:
# Check agent configuration
synapse agent show 2>/dev/null || echo "No agent configured"
Display current agent:
╔══════════════════════════════════════════════════╗
║ CURRENT SYNAPSE AGENT ║
╠══════════════════════════════════════════════════╣
║ ID: [agent-id] ║
║ Name: [agent-name] ║
║ URL: [agent-url] ║
╚══════════════════════════════════════════════════╝
If no agent configured:
╔══════════════════════════════════════════════════╗
║ CURRENT SYNAPSE AGENT ║
╠══════════════════════════════════════════════════╣
║ 설정된 에이전트가 없습니다. ║
║ ║
║ 에이전트 선택 방법: ║
║ synapse agent select ║
╚══════════════════════════════════════════════════╝
Step 6: Show Actions Summary
List all defined actions:
╔══════════════════════════════════════════════════╗
║ DEFINED ACTIONS ║
╠══════════════════════════════════════════════════╣
║ Action │ Method │ Entrypoint ║
╠─────────────┼────────┼───────────────────────────╣
║ train │ job │ plugin.train:TrainAction ║
║ inference │ task │ plugin.infer:run ║
║ serve │ serve │ plugin.serve:ModelServer ║
╚══════════════════════════════════════════════════╝
Optionally include semantic types if present:
╔══════════════════════════════════════════════════╗
║ ACTION TYPES ║
╠══════════════════════════════════════════════════╣
║ Action │ Input Type │ Output Type ║
╠─────────────┼─────────────────┼───────────────────╣
║ train │ yolo_dataset │ model_weights ║
║ inference │ model_weights │ inference_results ║
╚══════════════════════════════════════════════════╝
Step 7: Show Environment Variables
If env section exists in config.yaml:
╔══════════════════════════════════════════════════╗
║ ENVIRONMENT VARIABLES ║
╠══════════════════════════════════════════════════╣
║ Variable │ Value ║
╠───────────────────┼──────────────────────────────╣
║ DEBUG │ false ║
║ BATCH_SIZE │ 32 ║
╚══════════════════════════════════════════════════╝
Category Details
| Category | Use Case | Typical Actions |
|---|---|---|
neural_net |
ML 모델 학습/추론 | train, inference, evaluate |
export |
데이터 포맷 변환 | export, convert |
upload |
외부 데이터 가져오기 | import, sync |
smart_tool |
AI 어노테이션 도구 | segment, detect, annotate |
pre_annotation |
라벨링 전 처리 | preprocess, augment |
post_annotation |
라벨링 후 처리 | validate, postprocess |
data_validation |
데이터 품질 검사 | check, validate, report |
custom |
사용자 정의 | (any) |
Smart Tool Configuration
If category is smart_tool, also display:
╔══════════════════════════════════════════════════╗
║ SMART TOOL SETTINGS ║
╠══════════════════════════════════════════════════╣
║ Annotation Category: [annotation_category] ║
║ Annotation Type: [annotation_type] ║
║ Smart Tool Type: [smart_tool] ║
╚══════════════════════════════════════════════════╝
| Field | Values |
|---|---|
annotation_category |
object_detection, segmentation, classification, keypoint, text |
annotation_type |
bbox, polygon, point, line, mask, label |
smart_tool |
automatic, interactive, semi_automatic |
Error Handling
config.yaml/synapse.yaml not found
config.yaml 또는 synapse.yaml을 찾을 수 없습니다.
현재 위치가 Synapse 플러그인 디렉토리인지 확인하세요.
Invalid YAML syntax
config.yaml 또는 synapse.yaml 파싱 오류.
YAML 문법을 확인하세요: python -c "import yaml; yaml.safe_load(open('config.yaml'))"
Agent connection failed
에이전트 정보를 가져올 수 없습니다.
- synapse-sdk가 설치되어 있는지 확인
- 네트워크 연결 확인
- 인증 상태 확인: synapse login
- 에이전트 선택: synapse agent select