자유 형식 절차

자연어로 작성된 작업별 지침

개요

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

자유 형식 프로시저를 사용하는 경우

에이전트가 상황에 맞게 표현과 순서를 조정할 수 있고, 평이한 언어로 빠르게 작성하고 싶다면 자유 형식 프로시저를 사용하세요. 구조화된 프로시저, 워크플로, 시스템 프롬프트와의 비교는 프로시저를 사용하는 경우를 참조하세요.

프로시저 구성 요소

다음은 편집기의 환불 프로시저입니다.

환불 프로시저
예시

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

이름

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

트리거

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

하위 프로시저를 만들 때만 트리거를 비워 두세요.

콘텐츠

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

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

인라인 참조

프로시저는 다양한 종류의 리소스를 인라인으로 참조할 수 있습니다.

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

단계에서 에이전트가 도구, 지식 베이스 문서 또는 다른 프로시저를 사용해야 할 때마다 인라인 참조를 사용하세요. 참조하면 리소스가 프로시저에 자동으로 연결되어 에이전트가 사용할 수 있습니다. 일반 텍스트 언급(예: 여기서 계산기 도구 사용)도 작동하지만, 리소스가 이미 에이전트에 연결된 경우에만 가능합니다.

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

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

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

인라인 프로시저 참조는 동일한 에이전트의 프로시저를 사용해야 합니다. 에이전트 범위와 복제 동작은 제한 사항을 참조하세요.

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

프로시저 편집기의 슬래시 메뉴

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

유효하지 않은 참조를 나열하는
오류 대화상자

하위 프로시저

하위 프로시저는 트리거가 비어 있습니다. 이를 참조하는 다른 프로시저에서만 에이전트가 실행할 수 있습니다.

하위 프로시저를 사용하면 하나의 에이전트 내에서 단계를 공유하고 한 번에 사용할 수 있는 프로시저 수를 줄일 수 있습니다. 진입 프로시저에 트리거를 지정하고 콘텐츠에서 관련 하위 프로시저를 참조하며, 하위 프로시저의 트리거는 비워 두세요.

에스컬레이션 하위 프로시저에는 대화를 상담원에게 넘기는 단계를 포함할 수 있습니다. 환불 및 취소 프로시저에서 이를 참조하고 트리거는 비워 두세요. 에이전트는 두 프로시저의 단계로 에스컬레이션할 수 있지만, 해당 프로시저 외부에서는 하위 프로시저를 사용할 수 없습니다.

문서에서 가져오기

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

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

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

SOP 업로드 대화상자

자유 형식 프로시저 관리

대시보드에서 에이전트를 연 다음 프로시저를 선택하세요. + 를 사용해 자유 형식 프로시저를 만드세요. 트리거를 추가하고 콘텐츠 편집기에 지침을 작성한 다음 에이전트 변경 사항을 게시하세요.

모범 사례

에이전트는 트리거에서 올바른 프로시저를 선택하고 콘텐츠를 따라야 합니다. 프로시저 수가 늘어날수록 더 성능이 뛰어난 모델이 이를 더 안정적으로 수행합니다. 옵션은 모델을 참조하세요.

프로시저를 잘 작성하려면 두 부분을 잘 작성해야 합니다. 적절한 때 프로시저를 실행하는 트리거와 에이전트가 따를 수 있는 콘텐츠입니다.

트리거 작성

겹치거나 모호한 트리거는 잘못된 프로시저를 실행하게 합니다. _사용자가 구독 취소를 요청할 때_가 _사용자 계정 관련 질문이 있을 때_보다 좋습니다.

에이전트가 해야 할 일이 아니라 사용자가 요청하는 내용을 설명하세요. 에이전트 작업으로 표현된 트리거는 신뢰도가 낮습니다.

사용자가 다르게 표현하면 좁은 트리거는 실제 요청을 놓칠 수 있습니다. 사용자가 말할 수 있는 표현 변형을 포함하세요. _사용자가 주문을 환불, 반품하거나 환불받기를 요청할 때_는 _사용자가 환불을 요청할 때_보다 더 안정적으로 실행됩니다.

콘텐츠 작성

단계를 에이전트에 대한 지침으로 작성하세요. _고객의 마지막 주문을 조회하세요_가 _고객의 마지막 주문을 조회해야 합니다_보다 좋습니다. 직접적인 지침은 제안보다 따르기 쉽습니다.

추론은 프로시저에 나열되지 않은 예외 상황에도 적용됩니다. _환불을 처리하려면 주문 ID가 필요하기 때문에_와 같은 짧은 설명은 에이전트가 단계에서 예상하지 못한 상황을 처리하는 데 도움이 됩니다. 한 줄 설명으로 같은 효과를 낼 수 있다면 모두 대문자로 쓴 MUST나 엄격한 스크립트는 피하세요.

프로시저가 관련 없는 결과로 분기되기 시작하면 더 작은 프로시저로 나누고 에이전트가 그 사이에서 라우팅하도록 하세요.

프로시저 조합

여러 프로시저에서 동일한 단계(고객 신원 확인, 주문 조회, 상담원에게 에스컬레이션)가 반복되면 전용 프로시저로 추출하고 필요한 각 프로시저에서 슬래시 메뉴를 통해 이를 참조하세요. 공통 단계를 한곳에서 관리하면 이를 사용하는 모든 프로시저의 일관성을 유지할 수 있습니다.

신원 확인이나 에스컬레이션처럼 다른 프로시저가 요청할 때만 에이전트가 실행해야 하는 작업에는 하위 프로시저를 사용하세요. 트리거가 없으므로 대화 시작 시 진입 프로시저와 경쟁하지 않습니다. 트리거 선택지가 적을수록 라우팅에 집중할 수 있습니다.

어조, 정체성, 거부 정책, 가드레일은 시스템 프롬프트에 속합니다. 작업별 단계는 프로시저에 넣으세요.

프로시저는 에이전트 구성의 일부이므로 새 에이전트 버전을 게시할 때 함께 스냅샷으로 저장됩니다. 이전 프로시저 세트로 되돌리려면 이전 에이전트 버전을 복원하세요. 에이전트 버전 관리를 참조하세요.

팀에 이미 SOP가 있다면 가져오기 도구를 사용해 초안으로 변환한 후 다듬으세요.