자유 형식 절차

개요

자유 형식 절차는 하나의 작업을 평이한 자연어로 설명합니다. 에이전트는 지침을 해석하고 상황에 맞게 표현과 순서를 조정합니다. 자유 형식 절차는 도구(통화 종료와 같은 시스템 도구 포함)를 호출하고, 지식 베이스 문서를 조회하며, 다른 절차로 연결할 수 있습니다.

자유 형식 절차를 사용해야 할 때

에이전트가 상황에 맞게 표현과 순서를 조정할 수 있고, 자연어로 빠르게 작성하고 싶을 때 자유 형식 절차를 사용하세요. 구조화된 절차, 워크플로, 시스템 프롬프트와의 비교는 절차를 사용해야 할 때를 참고하세요.

절차의 구성 요소

다음은 편집기의 환불 절차 예시입니다.

절차는 트리거와 콘텐츠라는 두 가지 주요 부분으로 구성됩니다. 두 부분 모두 다른 리소스에 대한 인라인 참조를 포함할 수 있으며, 위 스크린샷에서는 렌치 아이콘이 있는 태그로 표시됩니다. 각 절차에는 대시보드에 표시되는 이름도 있습니다.

이름

대시보드에서 절차를 식별하는 짧은 라벨입니다. 이름은 LLM에 전송되지 않으므로 에이전트 동작에 영향을 주지 않습니다.

트리거

에이전트가 이 절차를 사용해야 하는 시점에 대한 설명입니다. 예: 사용자가 주문 환불을 요청할 때.

하위 절차를 만들 때만 트리거를 비워 두세요.

콘텐츠

마크다운으로 작성된 절차의 본문입니다. 콘텐츠는 에이전트가 수행해야 할 작업을 설명합니다. 질문하기, 주문 조회하기, 도구 호출하기 또는 통화 종료하기 등이 이에 해당합니다. 따라야 할 번호 순서의 단계일 수도 있고, 상황에 대한 일반적인 지침일 수도 있습니다. 각 단계나 가이드라인은 한 문장(사용자에게 주문 ID를 요청하세요) 또는 무엇을 해야 하고 왜 해야 하는지 설명하는 짧은 단락으로 작성할 수 있습니다.

순차적인 작업에는 번호 단계를 사용하고, 한 단계 내의 요구 사항이나 하위 항목에는 글머리 기호를 사용하세요.

인라인 참조

절차에서는 여러 종류의 리소스를 인라인으로 참조할 수 있습니다.

• 도구(예: 주문 조회, 카드 청구, 통화 종료, 상담원에게 연결)
• 지식 베이스 문서
• 다른 절차

단계에서 에이전트가 도구, 지식 베이스 문서 또는 다른 절차를 사용해야 할 때마다 인라인 참조를 사용하세요. 참조는 리소스를 절차에 자동으로 연결하므로 에이전트가 사용할 수 있습니다. _여기서 계산기 도구 사용_과 같은 일반 텍스트 언급도 작동하지만, 리소스가 이미 에이전트에 연결되어 있어야 합니다.

트리거나 콘텐츠에 /를 입력하고 슬래시 메뉴에서 리소스를 선택하여 참조를 삽입하세요. 참조는 편집기에서 클릭 가능한 태그로 표시됩니다. 태그를 클릭하면 기본 리소스를 열고 구성을 확인할 수 있습니다.

API를 통해 자유 형식 콘텐츠를 작성할 때는 다음 구문으로 참조를 삽입하세요.

[tool id="tool_abc123"]
[kb id="kb_abc123"]
[procedure id="agtprc_abc123"]
[system_tool id="end_call"]
{{customer_id}}

인라인 절차 참조는 동일한 에이전트의 절차를 사용해야 합니다. 에이전트 범위 및 복제 동작은 제한 사항을 참고하세요.

트리거의 참조를 사용하면 리소스의 출력에 따라 절차를 실행할 수 있습니다. 예: _get_user가 tier ‘gold’를 반환할 때 _. 콘텐츠의 참조는 해당 단계에서 에이전트에게 리소스를 호출하거나 참조하도록 지시합니다.

절차에서 참조하는 지식 베이스 문서는 항상 auto 사용 모드를 사용합니다. 에이전트에서 RAG가 활성화되어 있으면 에이전트는 전체 문서를 프롬프트에 넣는 대신 관련 구절을 검색합니다. 문서가 에이전트에도 연결되어 있으면 에이전트의 해당 문서 사용 모드가 대신 적용되므로, 전체 텍스트를 프롬프트에 유지하려면 prompt 사용 모드로 에이전트에 연결하세요.

참조된 리소스가 나중에 삭제되거나 계정에서 해당 리소스에 대한 액세스 권한을 잃으면 태그가 손상된 것으로 표시됩니다. 편집기 상단의 오류 배지에는 이러한 참조가 나열됩니다. 리소스가 더 이상 존재하지 않으면 invalid, 존재하지만 계정에 액세스 권한이 없으면 _unavailable_로 표시됩니다. 배지를 열어 영향을 받는 단계를 확인하고 참조를 수정하거나 제거하세요.

하위 절차

하위 절차에는 빈 트리거가 있습니다. 에이전트는 이를 참조하는 다른 절차에서만 실행할 수 있습니다.

하나의 에이전트 내에서 단계를 공유하고 한 번에 사용 가능한 절차 수를 줄이려면 하위 절차를 사용하세요. 진입 절차에는 트리거를 지정하고, 콘텐츠에서 관련 하위 절차를 참조하며, 하위 절차의 트리거는 비워 두세요.

에스컬레이션 하위 절차에는 대화를 상담원에게 넘기는 단계를 넣을 수 있습니다. 환불 및 취소 절차에서 이를 참조하고 트리거는 비워 두세요. 에이전트는 두 절차 중 하나의 단계로 에스컬레이션할 수 있지만, 그 외 상황에서는 하위 절차를 사용할 수 없습니다.

문서에서 가져오기

기존 표준 운영 절차(SOP)에서 시작할 수 있습니다. 절차 목록의 + 메뉴에서 SOP에서 가져오기를 선택한 다음 파일을 업로드하세요.

지원 형식: PDF, DOCX, TXT, MD, HTML, EPUB. 파일 크기는 20MB 이하여야 합니다.

가져오기 도구는 문서를 분석하여 최대 10개의 개별 절차를 식별하고, 각각에 대해 생성된 이름, 트리거 및 콘텐츠가 포함된 초안을 만듭니다. 각 초안을 열어 다듬으세요. 문서에 SOP가 10개를 초과하는 경우 업로드 전에 더 작은 파일로 나누세요.

자유 형식 절차 관리

모범 사례

절차를 잘 작성하려면 두 부분을 잘 작성해야 합니다. 필요할 때 절차를 실행하는 트리거와 에이전트가 따를 수 있는 콘텐츠입니다.

절차 반복 개선

작게 시작하고 다음 변경을 하기 전에 에이전트 테스트를 사용해 각 변경 사항을 확인하는 것을 권장합니다.

테스트나 실제 대화가 실패하면 그 배후의 오류 유형을 찾으세요. 에이전트가 잘못된 말을 했다면 _그렇게 말하지 마세요_를 추가하면 한 대화는 해결됩니다. 과거 대화에서 유사한 실패를 검색하고 모두를 포괄하는 하나의 지침을 작성하세요. 원인은 지식 베이스나 에이전트 구성에 있을 수도 있습니다. Architect는 이 검색을 수행할 수 있습니다. 실패한 대화를 열고 Architect를 선택한 다음 유사한 실패를 찾아 수정안을 제안해 달라고 요청하세요. Architect는 대화를 테스트로 전환할 수도 있습니다.

트리거 작성

콘텐츠 작성

절차 구성