AIP 챗봇을 함수로 게시하기
챗봇을 함수로 게시하면 AIP Evals, Automate, Code Repositories처럼 Foundry 함수를 실행하는 경로에서 사용할 수 있습니다. 챗봇을 게시할 때마다 함수 버전을 만들거나 저장할 때마다 함수 버전을 만들도록 설정할 수 있습니다.
입력과 출력 계약
| 입력 | 의미와 기본값 |
|---|---|
userInput | 응답할 사용자 입력 문자열입니다. |
sessionRid | 선택적 세션 식별자입니다. 형식은 ri.aip-agents..session.{uuid}입니다. 새 세션은 필드를 완전히 생략하며 빈 문자열을 보내지 않습니다. 기존 RID를 전달하면 대화를 이어갑니다. |
| 애플리케이션 변수 | 모두 선택적 입력으로 제공되어 기본 상태를 덮어쓸 수 있습니다. 객체 집합의 기본값은 해당 유형 전체 객체 집합이고 문자열 기본값은 Studio에 구성된 값입니다. |
출력 markdownResponse는 최종 Markdown 응답입니다. sessionRid는 모든 실행에서 반환되며 다음 호출에 전달하면 세션을 이어갑니다. 애플리케이션 변수도 선택적 출력에 포함되지만 해당 실행에서 갱신된 값만 나옵니다. 갱신하지 않은 변수의 출력이 비어 있다는 사실을 실제 변수 값이 비었다는 뜻으로 해석하지 않습니다.
게시 설정
- 오른쪽 위
Publish옆 설정 아이콘으로Publish settings를 엽니다. Publish function from chatbot을 켭니다.- 온톨로지와 함수 이름, API 이름, 설명을 지정합니다.
- 챗봇 저장 시 마이너 함수 버전을 만들려면
Version configuration의 해당 항목을 선택합니다. Publish chatbot and function을 선택합니다.
게시 알림의 링크로 Ontology Manager의 함수를 열 수 있습니다. 이후에는 Publish settings > Published function에서도 찾습니다. 함수 게시를 끄면 이후 챗봇 게시에서 함수 버전을 등록하지 않습니다. 다시 켠 뒤 함수를 게시하려면 챗봇을 다시 게시합니다.
평가 모음
함수 게시 후 왼쪽 Evaluation에서 Create evaluation suite를 선택합니다. 이름을 정하고 챗봇과 같은 프로젝트를 선택해야 합니다. 생성된 모음 오른쪽 화살표로 AIP Evals를 엽니다.
평가 사례에서 새 대화를 시작하려면 sessionRid를 null로 설정합니다. RID가 있으면 기존 대화를 이어가므로 독립 평가와 다른 결과가 생길 수 있습니다. 객체 집합 입력도 null 또는 실제 값이어야 하며 편집기에서 값이 지정되지 않은 빈 상태로 두지 않습니다. null은 전체 객체 유형을 포함하는 기본값과 연결될 수 있으므로 평가 범위를 확인합니다.