AI 워크플로우 삽입으로 Orquesta SDK 구축

출처: Dev.to

Originally published at orquesta.live/blog/embedding-ai-workflows-orquesta-sdk
AI 기반 워크플로우를 기존 웹 애플리케이션에 원활하게 삽입하는 것이 목표입니다. 이 철학은 Orquesta Embed SDK를 구축할 때 guide가 되었으며, 이는 단일 스크립트 태그 하나로 강력한 AI 기능을 앱에 직접 제공합니다. 해당 솔루션을 만들기 위해 우리는 아키텍처 선택, 인증 흐름, 실시간 업데이트 등에 대한 통찰력을 갖췄습니다.

At the heart of our Embed SDK is a simple yet powerful premise: enable developers to integrate Orquesta’s AI-driven operations without complex setup or infrastructure changes.
Embed SDK의 핵심은 개발자가 복잡한 설정이나 인프라 변경 없이 Orquesta의 AI 기반 작업을 손쉽게 통합할 수 있도록 하는 간단하면서도 강력한 전제에 있습니다.

The architectural design revolved around ease of use and performance.
아키텍처 설계는 사용 편의성과 성능을 중심으로 이루어졌습니다.

The decision to encapsulate functionalities within a single script tag stemmed from a desire to reduce friction. Embedding Orquesta should feel natural, akin to adding an analytics tool or a customer chat widget.
단일 스크립트 태그 안에 기능을 캡슐화한다는 결정은 마찰을 최소화하려는 의도에서 비롯되었습니다. Orquesta를 삽입하는 것은 분석 도구나 고객 채팅 위젯을 추가하는 것과 같은 자연스러운 느낌이어야 합니다.

We designed the SDK to load asynchronously, ensuring it doesn’t block the rendering of your web app.
SDK는 비동기 방식으로 로드되도록 설계되어 웹 앱 렌더링이 차단되지 않도록 했습니다.

A notable architectural choice was to employ microservices for handling different operations such as user authentication, real-time updates, and prompt submissions.
주목할 만한 아키텍처 선택은 사용자 인증, 실시간 업데이트, 프롬프트 제출과 같은 다양한 작업을 처리하기 위해 마이크로서비스를 활용하는 것이었습니다.

This separation of concerns allows us to scale individual components independently based on demand and usage patterns.
관심사 분리 원칙은 수요와 사용 패턴에 따라 개별 구성 요소를 독립적으로 확장할 수 있게 해줍니다.

Security is paramount, particularly when dealing with AI operations that might involve sensitive data or processes.
보안은 특히 민감한 데이터나 프로세스를 포함할 수 있는 AI 작업을 다룰 때 무엇보다 중요합니다.

Our architecture ensures that all interactions between your app and Orquesta are encrypted using AES-256.
우리의 아키텍처는 앱과 Orquesta 간 모든 상호작용이 AES-256으로 암호화된다고 보장합니다.

Moreover, because the Orquesta agent runs locally, no code or data ever leaves your infrastructure, maintaining complete privacy.
또한, Orquesta 에이전트가 로컬에서 실행되기 때문에 코드나 데이터가 jamais 인프라를 벗어나지 않아 완전한 프라이버시를 유지합니다.

One of the critical components of embedding an SDK is seamless authentication.
SDK를 원활하게 삽입하는 데 있어 핵심 구성 요소 중 하나는 바로 인증입니다.

We opted for an OAuth 2.0-based flow to authenticate users.
사용자 인증을 위해 OAuth 2.0 기반 흐름을 선택했습니다.

This allows for secure, token-based access to Orquesta’s features and can easily integrate with existing identity providers, simplifying the experience for end users.
이를 통해 보안 토큰 기반으로 Orquesta의 기능을 안전하게 접근할 수 있으며, 기존 신원 제공자와 쉽게 통합되어 최종 사용자 경험을 단순화합니다.

Our SDK initializes the OAuth process with a simple call, redirecting users to a login page if they aren’t already authenticated.
SDK는 간단한 호출로 OAuth 프로세스를 초기화하고, 이미 인증되지 않은 경우 사용자를 로그인 페이지로 리다이렉트합니다.

Once authenticated, the app receives a token granting it access to Orquesta’s API.
인증이 완료되면 앱은 Orquesta API에 대한 액세스 권한을 부여받는 토큰을 받게 됩니다.

Beyond just authentication, our SDK supports granular role-based permissions.
인증 외에도 SDK는 세분화된 역할 기반 권한을 지원합니다.

Teams can define roles within the Orquesta dashboard, specifying what actions agents can perform.
팀은 Orquesta 대시보드 내에서 역할을 정의하여 에이전트가 수행할 수 있는 작업을 지정할 수 있습니다.

The SDK respects these permissions, ensuring that only authorized actions are executed within the embedded context.
SDK는 이러한 권한을 준수해嵌入된 컨텍스트 내에서 허용된 작업만 실행하도록 합니다.

To give users the responsiveness they need, we implemented real-time updates using WebSockets.
사용자에게 필요한 반응성을 제공하기 위해 WebSocket을 활용한 실시간 업데이트를 구현했습니다.

This choice allows us to push updates to the web app instantly, providing feedback on AI operations as they occur.
이 선택은 웹 앱에 즉시 업데이트를 전송할 수 있게 해주며, AI 작업이 진행되는 순간 피드백을 제공합니다.

Monitoring the stream of outputs from AI agents becomes a dynamic and engaging experience, directly within the interface of your existing application.
AI 에이전트의 출력 스트림을 모니터링하는 것은 애플리케이션 인터페이스 내에서 동적이고 매력적인 경험으로 변모하게 됩니다.

One of the standout features within the Orquesta ecosystem is the Agent Grid.
Orquesta 생태계에서 돋보이는 기능 중 하나는 Agent Grid입니다.

Embedded via our SDK, this component lets you monitor multiple AI agents simultaneously.
SDK를 통해 삽입된 이 구성 요소는 동시에 여러 AI 에이전트를 모니터링할 수 있게 합니다.

Each agent’s terminal can be viewed live, providing transparency and control over ongoing operations.
각 에이전트의 터미널을 실시간으로 볼 수 있어 진행 중인 작업을 투명하게 관리할 수 있습니다.

By embedding Orquesta, SaaS products can offer AI-powered workflows under their branding.
Orquesta를 삽입함으로써 SaaS 제품은 자체 브랜딩 하에 AI 기반 워크플로우를 제공할 수 있습니다.

The SDK supports customization options, allowing you to tailor the appearance and behavior to fit naturally within your product’s UI.
SDK는 사용자 정의 옵션을 지원해 제품 UI와 자연스럽게 조화되도록 외관과 동작을 맞춤 설정할 수 있게 합니다.

This white-label capability extends the functionality of SaaS offerings, providing AI operation features without the need for significant in-house development.
화이트 라벨 기능은 SaaS 제품의 기능을 확장해 Significant 내부 개발 없이도 AI 운영 기능을 제공합니다.

Building the Orquesta Embed SDK involved balancing simplicity with powerful capabilities.
Orquesta Embed SDK 구축에는 단순함과 강력한 기능을 조화시키는 과정이 필요했습니다.

From architectural decisions to real-time interactivity, each aspect was designed to empower developers to integrate AI operations effortlessly.
아키텍처 선택부터 실시간 인터랙션까지, 모든 측면은 개발자가 AI 작업을 원활하게 통합하도록 설계되었습니다.

For teams and organizations looking to enhance their workflows with AI, the Embed SDK provides a robust, secure, and flexible solution.
AI 워크플로우를 강화하고자 하는 팀과 조직에게 Embed SDK는 견고하고 안전한, 유연한 솔루션을 제공합니다.

As we continue to evolve Orquesta, the commitment remains to provide tools that integrate seamlessly into the developer’s workflow, making the power of AI accessible without compromising on ease of use or security.
Orquesta를 계속進化시켜 나갈수록, 도구가 개발자의 워크플로에 원활하게 통합되고, 사용 편의성과 보안을 손상시키지 않고 AI의 힘을 제공한다는 약속은 변함없이 유지됩니다.