코드 카드를 실행합니다: AI 에이전트에 사용자 지정 API 통합

AI 에이전트는 액세스할 수 있는 데이터만큼만 강력합니다. 대규모 언어 모델LLMs은 학습 데이터에서 응답을 생성하지만 API와 통합되지 않는 한 실시간 주가를 검색하거나 결제를 처리하거나 CRM 세부 정보에 액세스할 수 없습니다.

API를 통해 AI 상담원은 실시간 데이터에 액세스하고, 로직을 실행하고, 작업을 트리거할 수 있습니다. 이를 완벽하게 활용하려면 상담원에게 사용자 지정 코드가 필요합니다.

Botpress Studio의 '코드 실행' 카드를 사용하면 봇의 워크플로 내에서 JavaScript를 작성하고 실행하여 API 호출, 데이터 처리 및 봇 동작 사용자 지정을 원활하게 처리할 수 있습니다.

AI 에이전트 구축

시스템과 원활하게 통합되는 AI 에이전트를 구축하세요.

지금 시작하기

신용카드 필요 없음

실행 코드 카드란 무엇인가요?

Botpress 코드 실행 카드는 개발자가 봇의 흐름 내에서 사용자 지정 JavaScript를 실행할 수 있도록 지원합니다. 이 카드는 다음과 같은 기능을 지원합니다:

사용자 지정 논리 구현: 복잡한 계산을 실행하거나 표준 작업에서 다루지 않는 방식으로 데이터를 변환할 수 있습니다.
동적 상호 작용: 사용자 데이터 또는 실시간 계산을 기반으로 응답을 조정합니다.
데이터 통합: 타사 서비스와 원활하게 연결하여 데이터를 가져오거나 전송할 수 있습니다.
상태 관리: 봇의 상태에 액세스하고 수정하여 컨텍스트를 유지하고 상호작용을 개인화할 수 있습니다.
오류 처리: 사용자 지정 오류 관리를 구현하여 안정적인 운영을 보장하세요.

코드 실행 카드는 AI가 생성한 코드 제안 기능을 제공합니다. API 데이터 가져오기와 같은 프롬프트를 입력하면 시스템이 즉시 JavaScript를 생성합니다. 그런 다음 필요에 따라 검토, 편집, 수정하여 개발 속도를 높일 수 있습니다.

AI 에이전트에 외부 API가 필요한 이유는 무엇인가요?

AI 에이전트는 액세스하는 데이터와 서비스만큼만 유용합니다. 입력을 처리하고 응답을 생성할 수는 있지만 외부 API 없이는 실시간 지식, 트랜잭션 기능 및 심층 통합이 부족합니다.

실시간 데이터 통합, 워크플로 자동화, 보안 강화 등 어떤 작업을 수행하든 API는 봇의 지능과 반응성, 통합성을 높여줍니다.

사용 사례	요구 사항	API 예시
실시간 데이터 검색	API 키, 적절한 요청 형식	OpenWeather, NewsAPI
고급 AI 기능	API 키, 모델 선택, 토큰 한도	OpenAI, DeepL
자동화 및 워크플로 통합	API 설정, 트리거 조건	Zapier, Make.com
개인화 및 사용자 컨텍스트	사용자 인증, API 통합	Salesforce, HubSpot
결제 처리 및 거래	판매자 계정, 보안 API 연결	Stripe, 페이팔
보안 및 인증	OAuth 토큰, 액세스 권한	OAuth, Auth0
데이터 저장 및 검색	데이터베이스 API 액세스, 스토리지 구성	Google Sheets, Notion

‍

확장 가능한 AI 에이전트?

AI 에이전트를 외부 API와 즉시 연결하세요.

지금 체험하기

액세스는 항상 무료입니다.

실행 코드 카드를 사용하는 5가지 방법

Botpress Studio의 코드 실행 카드는 AI 에이전트 작업을 간소화합니다. 이 간단한 튜토리얼을 따라 워크플로에 추가하는 것은 간단합니다:

추가된 후에는에이전트 워크플로에서 이를 활용하는 주요 방법을 소개합니다.

1. 동적 API 호출

정적 API 호출을 사용하는 대신 실행 카드를 사용하면 사용자 의도, 봇 컨텍스트 또는 이전 대화에 따라 요청을 동적으로 수정할 수 있습니다.

예시: 사용자 기본 설정에 따라 사용자 지정 데이터 가져오기.

프롬프트: 여행 챗봇은 사용자의 목적지, 여행 날짜 및 예산에 따라 호텔 가격을 검색해야 합니다.

‍참고: 코드 실행 카드는 자연어에서 코드를 생성할 수 있습니다. 하지만 항상 변수 생성된 코드를 프로덕션 환경에 배포하기 전에 항상 변수를 확인해야 합니다.

2. LLM 응답에 대한 사후 처리

Botpress 기본 제공 AI 작업을 제공하지만 출력 형식 지정, 특정 단어 필터링, 데이터 구조화 등 사용자에게 표시하기 전에 응답을 미세 조정해야 하는 경우가 있습니다.

‍예시: 구조화되지 않은 LLM 응답을 정의된 테이블/포맷으로 재작성하기.

프롬프트: AI가 API에서 레스토랑 추천을 가져오는데, 표시하기 전에 깔끔한 테이블로 서식을 지정해 주세요.

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.

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.