- Botpress 코드 실행 카드를 사용하면 봇 워크플로 내에서 사용자 지정 JavaScript를 실행하여 표준 기본 제공 작업을 넘어서는 동적 API 호출, 데이터 처리 및 개인화된 로직을 구현할 수 있습니다.
- 주요 사용 사례로는 동적 API 요청, LLM 출력 후처리, 속도 제한, 권한 확인, 다단계 API 호출 연쇄 등이 있으며, 이를 통해 AI 에이전트는 복잡한 워크플로우를 정확하게 처리할 수 있습니다.
- 모범 사례에는 환경 변수에서 API 키를 보호하고, 오류와 시간 초과를 원활하게 처리하며, 강력하고 안전한 봇 운영을 위한 조건부 로직을 구축하여 원활하고 확장 가능한 API 통합을 보장하는 것이 포함됩니다.
AI 에이전트는 액세스할 수 있는 데이터만큼만 강력합니다. 대규모 언어 모델LLMs은 학습 데이터에서 응답을 생성하지만 API와 통합되지 않는 한 실시간 주가를 검색하거나 결제를 처리하거나 CRM 세부 정보에 액세스할 수 없습니다.
API를 통해 AI 상담원은 실시간 데이터에 액세스하고, 로직을 실행하고, 작업을 트리거할 수 있습니다. 이를 완벽하게 활용하려면 상담원에게 사용자 지정 코드가 필요합니다.
Botpress Studio의 '코드 실행' 카드를 사용하면 봇의 워크플로 내에서 JavaScript를 작성하고 실행하여 API 호출, 데이터 처리 및 봇 동작 사용자 지정을 원활하게 처리할 수 있습니다.
실행 코드 카드란 무엇인가요?
Botpress 코드 실행 카드는 개발자가 봇의 흐름 내에서 사용자 지정 JavaScript를 실행할 수 있도록 지원합니다. 이 카드는 다음과 같은 기능을 지원합니다:
- 사용자 지정 논리 구현: 복잡한 계산을 실행하거나 표준 작업에서 다루지 않는 방식으로 데이터를 변환할 수 있습니다.
- 동적 상호 작용: 사용자 데이터 또는 실시간 계산을 기반으로 응답을 조정합니다.
- 데이터 통합: 타사 서비스와 원활하게 연결하여 데이터를 가져오거나 전송할 수 있습니다.
- 상태 관리: 봇의 상태에 액세스하고 수정하여 컨텍스트를 유지하고 상호작용을 개인화할 수 있습니다.
- 오류 처리: 사용자 지정 오류 관리를 구현하여 안정적인 운영을 보장하세요.
코드 실행 카드는 AI가 생성한 코드 제안 기능을 제공합니다. API 데이터 가져오기와 같은 프롬프트를 입력하면 시스템이 즉시 JavaScript를 생성합니다. 그런 다음 필요에 따라 검토, 편집, 수정하여 개발 속도를 높일 수 있습니다.
AI 에이전트에 외부 API가 필요한 이유는 무엇인가요?
AI 에이전트는 액세스하는 데이터와 서비스만큼만 유용합니다. 입력을 처리하고 응답을 생성할 수는 있지만 외부 API 없이는 실시간 지식, 트랜잭션 기능 및 심층 통합이 부족합니다.
실시간 데이터 통합, 워크플로 자동화, 보안 강화 등 어떤 작업을 수행하든 API는 봇의 지능과 반응성, 통합성을 높여줍니다.
실행 코드 카드를 사용하는 5가지 방법
Botpress Studio의 코드 실행 카드는 AI 에이전트 작업을 간소화합니다. 워크플로에 추가하는 방법은 간단합니다. 이 빠른 튜토리얼을 따라하세요:
추가된 후상담원 워크플로에서 이를 활용하는 주요 방법은 다음과 같습니다.
1. 동적 API 호출
정적 API 호출을 사용하는 대신 실행 카드를 사용하면 사용자 의도, 봇 컨텍스트 또는 이전 대화에 따라 요청을 동적으로 수정할 수 있습니다.
예시: 사용자 기본 설정에 따라 사용자 지정 데이터 가져오기.
프롬프트: 여행 챗봇은 사용자의 목적지, 여행 날짜 및 예산에 따라 호텔 가격을 검색해야 합니다.
.webp)
참고: 코드 실행 카드는 자연어에서 코드를 생성할 수 있습니다. 하지만 항상 변수 생성된 코드를 프로덕션 환경에 배포하기 전에 항상 변수를 확인해야 합니다.
2. LLM 응답에 대한 사후 처리
Botpress 기본 제공 AI 작업을 제공하지만 출력 형식 지정, 특정 단어 필터링, 데이터 구조화 등 사용자에게 표시하기 전에 응답을 미세 조정해야 하는 경우가 있습니다.
예시: 구조화되지 않은 LLM 응답을 정의된 테이블/포맷으로 재작성하기.
프롬프트: AI가 API에서 레스토랑 추천을 가져오는데, 표시하기 전에 깔끔한 테이블로 서식을 지정해 주세요.
.webp)
3. 속도 제한 및 조건부 실행
디지털 지갑을 포함한 일부 API에는 사용량 제한이 있습니다. 코드 실행 카드를 사용하면 사용률 제한을 적용하고, 폴백을 설정하고, API 가용성에 따라 조건부 로직을 추가하여 사용자 상호 작용을 제어할 수 있습니다.
예시: 호출하기 전에 API 사용량 확인
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. 권한 처리
봇이 특정 기능에 대한 액세스 권한을 부여하기 전에 사용자를 확인해야 하는 경우, 이 카드를 사용하면 Botpress기본 옵션을 넘어서는 사용자 지정 인증 흐름을 사용할 수 있습니다.
예시: AI 응답을 제공하기 전에 사용자 구독 상태 확인하기
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. 다단계 API 체인
봇이 최종 응답을 보내기 전에 여러 API의 데이터를 결합해야 하는 경우가 있습니다. 이 카드는 데이터를 동적으로 가져오고, 변환하고, 전달하여 복잡한 다단계 워크플로우를 지원합니다.
예시: 날씨 + 레스토랑 예약을 가져와 떠나기 가장 좋은 시간 추천하기
프롬프트: workflow.userApiKey를 사용하여 workflow.city에 대한 날씨 및 교통 데이터를 가져옵니다. 조건에 따라 최적의 이동 시간을 반환합니다. 실패 처리하기.
.webp)
AI 에이전트를 위한 원활한 API 통합
AI 에이전트는 실시간 데이터를 활용하고 워크플로우를 자동화하며 외부 서비스와 연결할 수 있을 때 가장 효과적입니다.
Botpress Hub 사전 구축된 API 통합, 자동화 도구 및 즉시 사용 가능한 커넥터를 통해 이를 원활하게 지원하므로 구성이 아닌 구축에 집중할 수 있습니다.
지금 바로 봇의 워크플로우에 강력한 API를통합하세요 - 무료입니다.
자주 묻는 질문
1. 코드 실행 카드를 효과적으로 사용하려면 JavaScript를 알아야 하나요?
꼭 그렇지는 않습니다. 기본 사항을 알아두면 도움이 되지만, 이 카드에는 AI가 생성한 코드 제안이 포함되어 있습니다. 원하는 내용을 설명하기만 하면 몇 가지 시작 코드를 작성하여 수정할 수 있습니다.
2. 일반적인 API 통합을 위한 템플릿이나 상용구 코드 스니펫이 있나요?
예, Botpress 날씨 API 호출, CRM 또는 결제 서비스 호출과 같은 인기 있는 사용 사례에 대한 예시와 커뮤니티 공유 스니펫을 제공합니다.
3. 사전 API 통합 경험이 없어도 코드 실행 카드를 사용할 수 있나요?
물론입니다. API를 처음 사용하는 경우 카드에 내장된 AI가 안내 메시지를 표시하고 시각적 워크플로 빌더를 통해 전체 프로세스를 더욱 직관적으로 진행할 수 있습니다.
4. 카드가 장기 실행 API 요청 또는 시간 초과를 어떻게 처리하나요?
await을 사용하는 비동기 JavaScript를 지원하지만, 원활한 작동을 위해 시도/잡기 및 폴백 로직을 사용하여 시간 초과 처리를 수동으로 빌드하는 것이 좋습니다.
5. 카드를 사용하여 인증 및 권한 부여를 구현하는 모범 사례는 무엇인가요?
중요한 키를 환경 변수에 안전하게 저장하고, API 인증에 토큰이나 헤더를 사용하고, 코드에 조건부 로직을 추가하여 사용자 역할이나 액세스 수준을 확인한 후 계속 진행하세요.
.webp)
