Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
RAIL(Remote Agent Invocation Layer)은 기존 애플리케이션을 LLM과 연결하여 AI가 직접 메서드를 호출할 수 있게 만드는 범용 브리지 프로토콜입니다. 단 한 줄의 코드로 C#, C++, Python 등 다양한 언어의 앱을 에이전트 환경으로 전환할 수 있는 아키텍처를 제공합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 HN Claude Code Search의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기어떤 애플리케이션이든 AI 제어가 가능하게 만드는 단 한 줄의 코드
RAIL은 모든 애플리케이션(C#, C++, Python, Node.js)을 모든 LLM(GPT, Claude, Gemini)에 연결하는 **범용 브리지 (universal bridge)**입니다. 애플리케이션을 새로 작성할 필요 없이, 단 한 줄의 코드만 추가하면 AI가 귀하의 메서드를 직접 호출할 수 있습니다.
| 프로젝트 | 목적 | 언어 |
|---|---|---|
| RailOrchestrator | 메인 AI 애플리케이션 (UI + LLM 라우팅) | C# / WPF |
| ... |
두뇌 (The Brain) - 사용자가 상호작용하는 메인 애플리케이션입니다.
주요 파일:
Services/Host/HostService.cs - Named Pipe 서버Services/LLMService.cs - LLM API 통합Services/ReAct/ReActOrchestrator.cs - 에이전트 루프브리지 (The Bridge) - 언어 간 통신을 가능하게 하는 네이티브 DLL입니다.
RAIL_Ignite() - 호스트에 연결대상: Python, C++, Node.js, Rust, Go
** .NET SDK** - C# 애플리케이션을 위한 클라이언트 라이브러리입니다.
RailEngine.Ignite(this)RailBridge.dll 로드사용법:
// App.xaml.cs 에서
RailEngine.Ignite(this);
툴킷 (The Toolkit) - 어셈블리 스캐닝 (assembly scanning) 및 매니페스트 생성.
포함 내용:
RuntimeRegistry - .NET / Native 바이너리 감지AssemblyScanner - DLL에서 메서드 추출CompositeManifest - 멀티 모듈 매니페스트 (manifest) 형식DependencyAnalyzer - 프로젝트 의존성 분석SolutionScanner - 전체 .sln 솔루션 스캔사용처: RailStudio, RailOrchestrator
C++ SDK - C++ 애플리케이션의 연결을 지원합니다.
LoadLibrary를 통한 RailBridge.dll 로드빌드 (Build):
build_x64.bat # 64비트
build_x86.bat # 32비트 (레거시 앱)
사용법 (Usage):
Rail::ignite("MyApp", manifestJson, onCommand);
Python SDK - Python 스크립트의 연결을 지원합니다.
ctypes를 사용하여 RailBridge.dll 로드사용법 (Usage):
from rail import RailEngine
engine = RailEngine()
...
Node.js SDK - TypeScript/JavaScript 애플리케이션의 연결을 지원합니다.
ffi-napi 사용사용법 (Usage):
import { RailEngine } from 'rail-sdk';
engine.ignite([new MyService()]);
시각적 도구 (Visual Tool) - 애플리케이션을 스캔하고 분석합니다.
rail.manifest.json 자동 생성사용 사례: Rail 통합을 위한 레거시 앱 준비
SDK 통합을 보여주는 예제 애플리케이션입니다.
| 예제 | 설명 |
|---|---|
AgentTest | 고객 데이터베이스가 포함된 간단한 WPF 앱 |
WorkflowDemo | 워크플로 자동화 예제 |
매니페스트 (Manifest) 여기에서 이 예제 애플리케이션을 위해 이미 생성된 모든 "rail.manifest.json"이 포함된 Manifest 폴더를 찾을 수 있습니다.
애플리케이션을 AI 제어 가능 (AI-controllable) 상태로 전환할 때, 정확히 필요한 사항은 다음과 같습니다:
| 언어 | 추가할 항목 | 자동 포함 항목 | 비고 |
|---|---|---|---|
| C# (.NET) | RailSDK.Universal.dll | RailBridge.dll (자동 복사됨) | 참조 하나로 모든 기능 포함 |
| ... |
RailSDK.Universal을 추가하면, 네이티브 브릿지 (native bridge)가 출력 디렉터리로 자동 복사됩니다:
📁 bin/Debug/net8.0/
├── YourApp.exe
├── RailSDK.Universal.dll ← 이 참조를 추가합니다
...
추가 방법:
<PackageReference Include="RailSDK.Universal" Version="2.0.0" />
C++은 코드베이스에 따라 **두 가지 통합 모드 (integration modes)**를 제공합니다:
새로운 애플리케이션 또는 C++17을 지원하는 코드베이스의 경우:
// RTTR 매크로를 사용하여 클래스를 등록합니다
RTTR_REGISTRATION {
rttr::registration::class_<OrderManager>("OrderManager")
...
필요한 파일:
📁 YourApp/
├── YourApp.exe
├── rail_sdk.dll ← C++ 래퍼 (RTTR 포함)
...
C++17 또는 RTTR을 사용할 수 없는 레거시 애플리케이션 (예: 게임, 오래된 코드베이스)의 경우:
#define RAIL_NO_RTTR // RTTR 비활성화
// 자체 명령 라우터 (command router)를 정의합니다
...
필요한 파일:
📁 YourApp/
├── YourApp.exe
├── rail_sdk.dll ← C++ 래퍼 (RTTR 미포함)
...
실제 사례: Notepad++와 Doom은 코드베이스가 RTTR을 지원할 수 없었기 때문에 옵션 B (커스텀 디스패처)를 사용하여 통합되었습니다.
📁 YourProject/
├── main.py (또는 index.ts)
├── RailBridge.dll ← 수동으로 복사
...
ctypes/ffi 호출을 대신 처리해 주는 래퍼 (wrapper) 패키지를 설치하세요.
┌─────────────────────────────────────────────────────────────┐
│ RailOrchestrator │
│ (메인 AI 애플리케이션) │
...
RailOrchestrator
└── uses → RailSDK (RailFactory.Core) for manifest parsing
...
// 서비스를 생성합니다.
public class CustomerService
{
...
// 콜백 함수를 정의합니다.
const char* OnCommand(const char* json) {
auto cmd = ParseJson(json);
...
class DataProcessor:
def analyze_data(self, file_path: str) -> dict:
return {"rows": 1000, "status": "processed"}
...
앱을 연결한 후, 자연어로 질문합니다:
"[email protected] 이메일을 가진 John Smith라는 고객을 생성해줘"
→ AI가 CustomerService.CreateCustomer("John Smith", "[email protected]") 호출
...
Ignite()를 호출합니다.