에이전트 API로 맞춤형 AI 에이전트 구축
학습 목표
- 에이전트 API를 시작하는 방법을 설명합니다.
- 에이전트 API를 사용하여 AI 에이전트 세션을 시작하고, 세션 라이프사이클을 관리합니다.
에이전트 API 시작하기
여러분은 지금 개발자이며, Salesforce AI 에이전트가 고객의 질문에 빠르고 유용한 답변을 제공하도록 웹사이트에 Agentforce를 통합해야 한다고 생각해 보세요.
이 작업이 워크플로를 간소화하고 사용자 상호 작용을 향상시킬 것이라는 점은 알고 있지만, 어디서부터 시작해야 할까요? 바로 에이전트 API입니다.
에이전트 API를 사용하여 Agentforce를 실행하는 과정을 대략적인 단계별로 살펴보겠습니다.
1단계: Agentforce 활성화 및 에이전트 활성화
먼저 Salesforce org에서 Agentforce를 활성화해야 합니다. 이 단계는 매우 중요하며, 이를 수행하지 않으면 이후의 모든 구성이 작동하지 않습니다. Agentforce를 활성화한 후에는 하나 이상의 에이전트를 활성화해야 합니다.
에이전트 API는 ‘Agentforce (Default)(Agentforce(기본값))’ 유형의 에이전트를 지원하지 않습니다.
2단계: 외부 클라이언트 앱 생성 및 OAuth 설정 활성화
다음으로 Salesforce에서 외부 클라이언트 앱을 생성해야 합니다. 이 앱은 안전한 API 호출에 필수적인 클라이언트 자격 증명 플로를 처리합니다. API의 OAuth 설정을 활성화합니다.
3단계: 소비자 키 및 소비자 암호 획득
앱 설정이 완료되면 소비자 키와 소비자 암호를 획득해야 합니다. 이 자격 증명은 API 호출을 인증하는 데 필수적입니다. 외부 클라이언트 앱에서 이를 확인할 수 있습니다.
4단계: 토큰 생성
에이전트 API에 대한 모든 호출에는 토큰이 필요합니다. 이 토큰은 API 호출을 인증하는 데 사용됩니다. 소비자 키, 소비자 암호, 도메인 이름을 사용하여 토큰을 생성할 수 있습니다.
실습: 첫 번째 API 호출 만들기
이제 에이전트 API 호출을 직접 해 볼 차례입니다.
호출을 하기 전에 조직에서 일부 정보를 수집해야 합니다. 자세한 내용은 에이전트 API 개발자 가이드의 API 호출을 참고하세요.
명령줄 인터페이스를 사용하여 다음 curl 명령을 실행하면 에이전트 API로 새로운 에이전트 세션을 생성할 수 있습니다.
curl --location -X POST https://api.salesforce.com/einstein/ai-agent/v1/agents/{AGENT_ID}/sessions \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--data '{
"externalSessionKey": "{RANDOM_UUID}",
"instanceConfig": {
"endpoint": "https://{MY_DOMAIN_URL}"
},
"streamingCapabilities": {
"chunkTypes": ["Text"]
},
"bypassUser": true
}'호출에 성공하면 세션 ID와 추가 정보가 포함된 응답을 받게 됩니다. 예시 응답은 다음과 같습니다.
{
"sessionId": "80ab2e16-392e-4c12-b80a-f028a58400b5",
"_links": {
"self": null,
"messages": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/sessions/80ab2e16-392e-4c12-b80a-f028a58400b5/messages"
},
"messagesStream": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/sessions/80ab2e16-392e-4c12-b80a-f028a58400b5/messages/stream"
},
"session": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/agents/0XxHr000000ysOSKAY/sessions"
},
"end": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/sessions/80ab2e16-392e-4c12-b80a-f028a58400b5"
}
},
"messages": [
{
"type": "Inform",
"id": "d27b7308-f1ab-47bd-949c-0225d5e21a8e",
"feedbackId": "",
"planId": "",
"isContentSafe": true,
"message": "Hi, I'm an AI service assistant. How can I help you?",
"result": [],
"citedReferences": []
}
]
}이제 AI 에이전트에 메시지를 보낼 수 있습니다.
에이전트 API는 동기식 메시지 처리와 스트리밍 메시지 처리를 모두 지원합니다. 동기식 메시지는 한 번의 호출로 완전한 응답을 얻어야 하는 사용 사례에 가장 적합하며, 스트리밍 메시지는 채팅 대화와 같은 실시간 상호 작용에 더 적합합니다.
작업이 끝나면 세션을 종료하세요.
고려할 사항
-
데이터 사용량: 에이전트 API 사용은 생성형 AI 사용 및 청구에서 설명하는 대로 크레딧 소비량에 영향을 미칩니다.
-
API 제한 시간: 에이전트 API에는 120초의 제한 시간이 있습니다. 호출 제한 시간이 초과되면 HTTP 500 응답을 받게 됩니다.
요약
지금까지 에이전트 API 시작하기 가이드와 샘플 코드를 사용하여 웹사이트에 Agentforce를 통합하고 고객 경험을 개선해 보세요.