Motia: 코드에서 인텔리전스를 빠르게 구축하기 위한 개발 프레임워크

728 0

일반 소개

모티아는 소프트웨어 엔지니어를 위한 오픈 소스 AI 에이전트 프레임워크로, GitHub에서 호스팅되며 모티아개발팀이 개발했습니다. 이를 통해 개발자는 익숙한 프로그래밍 언어(예: Python, TypeScript, Ruby)로 지능형 에이전트를 신속하게 작성, 테스트 및 배포할 수 있습니다. 모티아는 '코드 우선'과 '이벤트 중심'을 핵심으로 하므로 개발자는 새로운 구문이나 복잡한 구성을 배울 필요 없이 프로덕션에 바로 사용할 수 있는 자동화 시스템을 구축할 수 있습니다. 또한 브라우저 기반 시각화 도구인 모티아 워크벤치를 제공하여 에이전트의 작동 상황을 실시간으로 확인할 수 있습니다. 2025년 3월 현재 최신 버전은 다음과 같습니다. v0.1.0-beta.8는 커뮤니티의 긍정적인 피드백을 바탕으로 복잡한 작업을 효율적으로 개발해야 하는 팀에 적합합니다.

기능 목록

코드 우선 개발: 파이썬, 타입스크립트, 루비 및 기타 언어로 직접 에이전트 로직을 작성하세요.
다국어 지원: 동일한 에이전트에서 서로 다른 언어를 혼합할 수 있습니다(예: 데이터 처리를 위한 Python과 유형 검사를 위한 TypeScript).
이벤트 중심 아키텍처: 실시간 응답 시나리오에 적합한 이벤트를 통해 작업을 트리거합니다.
실시간 시각화: 모티아 워크벤치는 에이전트 실행 흐름과 로그를 표시합니다.
모듈식 단계: 에이전트는 입출력 유효성 검사를 지원하는 재사용 가능한 단계로 구성되어 있습니다.
원클릭 배포: 서버 관리 경험이 없어도 명령 한 번으로 에이전트를 배포할 수 있습니다.
API 및 웹훅: 외부 호출을 위한 HTTP 엔드포인트를 자동으로 생성합니다.
내장된 디버깅 도구: 실시간 로그와 실행 그래프를 통해 문제를 해결하는 데 도움이 됩니다.
유연한 AI 통합: 모든 대규모 모델 또는 벡터 데이터베이스를 제한 없이 지원합니다.

도움말 사용

모티아의 사용은 설치, 개발, 배포의 세 가지 주요 단계로 나뉩니다. 다음은 사용자가 빠르게 시작할 수 있도록 도와주는 자세한 가이드입니다.

설치 프로세스

환경 준비하기
Node.js(권장 버전 16 이상) 및 pnpm이 필요합니다. 설치되어 있는지 확인합니다:

node -v
pnpm -v

아직 설치되어 있지 않다면 공식 Node.js 웹사이트를 방문하여 다운로드 및 설치한 다음 실행하세요:

npm install -g pnpm

프로젝트 만들기
모티아 CLI로 프로젝트를 초기화합니다:

npx motia create -n my-first-agent

이렇게 하면 my-first-agent 폴더에 샘플 단계와 종속성이 있습니다.

카탈로그를 입력하고 시작
실행 중입니다:

cd my-first-agent
pnpm run dev

실행 후 브라우저가 열립니다. http://localhost:3000모티아 워크벤치를 보고 싶다면 기본적으로 볼 수 있습니다. default 프로세스.

주요 기능 사용 방법

모티아의 핵심은 에이전트 로직 작성과 실시간 디버깅입니다. 작동 방식은 다음과 같습니다.

프록시 로직 작성

정의 단계
존재 steps 에 폴더를 만듭니다. reply.js::

export default async function handler({ input }) {
return { reply: `你好，${input.name}！有什么我可以帮你的吗？` };
}

생성 프로세스
존재 flows 에 폴더를 만듭니다. support.js::

export default {
name: "support",
steps: ["reply"],
triggers: { api: true }
};

테스트 API
서비스를 다시 시작(pnpm run dev)를 클릭한 다음 컬로 테스트합니다:

curl -X POST http://localhost:3000/support -H "Content-Type: application/json" -d '{"name": "李明"}'

결과를 다음과 같이 반환합니다:

{"reply": "你好，李明！有什么我可以帮你的吗？"}

모티아 워크벤치 사용

프로세스 보기
존재 http://localhost:3000 워크벤치를 열고 support인터페이스에 단계별 연결 다이어그램이 표시됩니다.
실시간 테스트
"테스트" 버튼을 클릭하고 다음을 입력합니다. {"name": "张伟"}를 실행하면 차트가 업데이트되고 로그 창에 실행 세부 정보가 표시됩니다.
디버깅 로그
로그는 실시간으로 새로 고쳐집니다. 오류가 있는 경우 빨간색으로 강조 표시되며 단계를 클릭하면 구체적인 문제를 확인할 수 있습니다.

다국어 개발

Python 단계 추가
존재 steps 폴더 만들기 calc.py::

def handler(input):
return {"result": input["number"] + 10}

업데이트 프로세스
수정 support.js::

export default {
name: "support",
steps: ["reply", "calc"],
triggers: { api: true }
};

하이브리드 언어 테스트
컬로 테스트합니다:

curl -X POST http://localhost:3000/support -H "Content-Type: application/json" -d '{"name": "王芳", "number": 5}'

반환:

{"reply": "你好，王芳！有什么我可以帮你的吗？", "result": 15}

이벤트 중심 작업

이벤트 구성
수정 support.js::

export default {
name: "support",
steps: ["reply"],
triggers: { event: "messageReceived" }
};

트리거 이벤트
CLI를 사용하여 이벤트를 전송합니다:
```
npx motia emit --topic messageReceived --message '{"name": "赵强"}'
```
워크벤치에는 실행 결과가 표시됩니다.

배포 에이전트

패키징 프로젝트
실행 중입니다:
```
pnpm build
```
배포
파일을 서버에 업로드하고 실행합니다:
```
pnpm run start
```
에이전트가 배포되면 API 또는 이벤트를 통해 에이전트를 호출할 수 있습니다.

주요 기능 작동

외부 API와의 통합

OpenAI 추가
존재 steps 설정 analyze.js::

import { OpenAI } from 'openai';
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
export default async function handler({ input }) {
const response = await openai.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: input.text }]
});
return { result: response.choices[0].message.content };
}

업데이트 프로세스 및 테스트
프로세스에 추가 analyze입력 텍스트는 API 테스트를 사용하여 분석됩니다.

시각적 사용자 지정

존재 steps 워크벤치의 단계에 UI 구성을 추가하면 워크벤치는 시각화 경험을 향상시키기 위해 사용자 지정 인터페이스를 표시합니다.

애플리케이션 시나리오

재무 분석 에이전트
시장 데이터 업데이트를 듣고 웹 검색과 AI 분석을 결합하여 투자 추천을 생성하세요. 재무팀의 실시간 의사 결정에 이상적입니다.
GitHub 관리 에이전트
GitHub 이슈와 풀 리퀘스트를 자동으로 분류하고, 태그와 검토자를 할당하고, 팀 협업을 개선하세요.
사서함 자동화
Gmail 받은 편지함을 모니터링하고, 이메일 내용을 분석하고, 이메일에 자동 응답하여 고객 서비스 또는 개인 업무 효율을 높일 수 있습니다.
작업 관리 최적화
트렐로에서 작업 카드를 자동으로 이동하고, 요약을 생성하고, Slack에 알림을 보내 프로젝트 관리를 간소화하세요.
지식 퀴즈 시스템
비용 또는 지출 RAG 이 기술은 웹 콘텐츠를 추출하여 교육 또는 고객 서비스 시나리오에 적합한 Q&A 에이전트를 구축합니다.

QA

모티아는 어떤 문제를 해결하나요?
기존 도구의 한계를 피하는 코드 제어 및 시각화 도구를 제공하여 복잡한 AI 에이전트 구축 프로세스를 간소화합니다.
어떤 AI 모델이 지원되나요?
모티아는 모델에 제한을 두지 않으며 OpenAI, 허깅 페이스 또는 기타 서비스와 함께 사용할 수 있습니다.
기능을 확장하려면 어떻게 해야 하나요?
새로운 단계와 프로세스를 추가하여 모든 언어 및 외부 API 통합을 지원하세요.