1. EdgeBridge Agent 디바이스 정보

SmartThings 앱에 추가된 EdgeBridge Agent 디바이스는 두 개의 컴포넌트를 가집니다.

main 컴포넌트 (라벨: EdgeBridge)

AEB 서버 자체의 상태를 보여주는 컴포넌트입니다.

캐퍼빌리티표시 내용
serverAddressAEB 서버의 IP:Port (mDNS로 자동 탐색)
edgebridge연결 상태 / 연결 방식 / 기기 종류 / 서버 시작 시각 / 관찰 시각(30분) / 브릿지 버전
batteryAEB 폰의 배터리 잔량 (TV는 100% 고정)
refresh강제 ping 트리거 (수동 갱신)
healthCheckSmartThings 표준 헬스 상태

agent 컴포넌트 (라벨: AI Agent)

LLM 에이전트를 자동화에서 호출하기 위한 컴포넌트입니다. 자세한 사용법은 다음 섹션을 참고하세요.

samplecircle50208.llmBot — providerModel / prompt / aiResponse / aiStatus

2. 플러그인 화면에서 LLM 명령하기

EdgeBridge Agent 디바이스의 플러그인(SmartThings 앱 detailView)에서도 즉석에서 LLM에 한 번 명령을 보낼 수 있습니다. 자동화 없이 빠르게 한 번 물어보거나 결과만 확인할 때 편리합니다.

플러그인 detailView 구성 (agent 컴포넌트)

컨트롤동작
Provider / ModelList 컨트롤. 사용할 모델을 고르면 setProviderModel 명령이 호출되어 providerModel attribute가 갱신됩니다.
PromptTextField 컨트롤. 자연어로 질문/명령을 입력하고 Send를 누르면 sendMessage가 호출됩니다. (선택한 Provider/Model이 그대로 사용됨)
AI StatusState 컨트롤. idle / sending / success / error 4단계로 자동 갱신됩니다.
AI ResponseState 컨트롤. LLM이 반환한 최종 텍스트가 그대로 표시됩니다. 길어지면 줄바꿈 후 스크롤됩니다.

사용 흐름

3. 자동화에서 LLM 명령

SmartThings 자동화(루틴/규칙)에서 EdgeBridge Agent의 agent 컴포넌트에 명령을 보내면, AEB가 LLM과 통신해 응답을 attribute로 돌려줍니다.

명령 (Command)

속성 (Attributes)

providerModel enum

gemini-2.5-flash · gemini-2.5-pro · gemini-2.5-flash-lite · claude-opus-4-7 · claude-sonnet-4-6 · claude-haiku-4-5-20251001 · openai-gpt-4o · openai-gpt-4o-mini · openai-gpt-4.1 · openai-gpt-4.1-mini · openai-gpt-4.1-nano

사용 흐름

예시 시나리오
"오후 11시" 시간 트리거 → sendMessage("오늘 외출 모드로 안 잡혀있는 켜진 조명 정리해줘") → aiStatus가 success가 되면 다음 자동화에서 알림 보내기 → aiResponse 본문을 푸시 메시지에 포함.