탐색으로 건너뛰기

프로시저

관련 상황에서 에이전트가 불러오는 작업별 지침

개요

프로시저에는 하나의 특정 작업을 위한 지침이 담겨 있습니다. 각 프로시저에는 적용 시점을 설명하는 트리거와 수행할 작업을 설명하는 콘텐츠가 있습니다. 대화가 트리거와 일치하면 에이전트가 프로시저를 불러옵니다.

에이전트가 서로 다른 여러 작업을 처리해야 할 때 프로시저를 사용하세요. 예를 들어 고객 지원 에이전트에서는 각 프로시저가 환불, 신원 확인, 계정 복구, 연결 문제 해결처럼 하나의 요청 유형을 처리할 수 있습니다.

에이전트 대시보드의 프로시저 탭

프로시저 유형

프로시저에는 두 가지 유형이 있습니다.

  • 자유 형식 프로시저 는 에이전트가 해석하고 상황에 맞게 조정하는 자연어 지침으로 작성합니다.
  • 구조화된 프로시저 는 에이전트가 매번 동일한 방식으로 실행하는, 유형이 지정된 단계의 순서 목록입니다.

동일한 에이전트에서 두 유형을 모두 사용할 수 있습니다. 에이전트는 유형과 관계없이 트리거를 기준으로 관련 프로시저를 선택합니다.

프로시저는 서로를 호출할 수 있습니다. 자유 형식 프로시저는 인라인 참조를 통해 다른 프로시저를 호출하고, 구조화된 프로시저는 하위 프로시저 단계를 통해 다른 구조화된 프로시저를 호출합니다. 일반적으로 열린 형태의 처리는 자유 형식 프로시저에서 유지하고, 매번 동일한 방식으로 실행해야 하는 부분은 구조화된 프로시저로 넘깁니다.

에이전트에는 프로시저, 워크플로, 또는 둘 다 있을 수 있습니다. 둘 다 있는 경우 모든 프로시저는 워크플로의 모든 지점에서 사용할 수 있으며, 특정 워크플로 노드로 프로시저를 제한할 수 없습니다. 대부분의 에이전트는 둘 중 한 가지 방식을 중심으로 구축되지만, 두 방식을 함께 사용할 수 있습니다.

프로시저 사용 시점

모든 에이전트에는 시스템 프롬프트가 있습니다. 프로시저와 워크플로는 그 위에 구조를 추가하는 두 가지 방법이며, 에이전트는 둘 다 사용할 수 있습니다. 대화가 얼마나 다양하게 전개될 수 있는지에 따라 시작점을 선택하세요.

요구 사항사용 방법이유
간단한 개념 검증 에이전트시스템 프롬프트만 사용설정과 반복 작업이 가장 빠르지만, 에이전트의 범위가 넓어질수록 단일 프롬프트는 다루기 어려워집니다.
에이전트가 표현과 순서를 조정할 수 있는 작업자유 형식 프로시저전체 대화가 하나의 LLM 컨텍스트에 유지되므로, 에이전트가 표현과 순서를 조정하고 예상치 못한 흐름도 따라갈 수 있습니다. 컨텍스트 윈도우를 더 많이 사용합니다.
매번 동일한 방식으로 단계를 실행해야 하는 작업구조화된 프로시저설정한 순서대로 매번 같은 방식으로 각 단계가 실행되며, 짧은 단계 목록으로 작성할 수 있습니다.
복잡한 분기와 예외 상황을 완전히 제어해야 하는 경우워크플로직접 설계하고 연결한 하위 에이전트 그래프로 실행되며, 분기와 각 단계에서 사용하는 모델을 완전히 제어할 수 있습니다.

자유 형식 프로시저가 기본 선택지입니다. 가장 빠르게 작성할 수 있고 문서처럼 읽혀 비기술 팀도 관리할 수 있으며, 대화가 정해진 흐름에서 벗어나도 에이전트가 대응할 수 있습니다. 인증, 에스컬레이션, 금융 거래처럼 단계를 건너뛰거나 순서가 바뀌는 데 따른 비용이 큰 경우에는 구조화된 프로시저를 사용하세요. 두 프로시저 유형 모두 제공하지 않는 라우팅 로직이나 단계별 모델 제어가 필요하면 워크플로를 사용하세요.

프로시저 관리

프로시저 작성에는 대시보드를 사용하는 것이 좋습니다. 프로시저를 프로그래밍 방식으로 관리하거나 배포 도구에 통합하려면 CLI 또는 API를 사용하세요.

대시보드에서 에이전트를 연 다음 프로시저를 선택하세요. + 를 사용해 자유 형식 또는 구조화된 프로시저를 만드세요. 같은 메뉴에서 프로시저를 폴더로 그룹화할 수 있습니다. 작성 방법은 자유 형식 프로시저 및 구조화된 프로시저를 참조하세요.

제한 사항

  • 프로시저 콘텐츠는 최대 50,000자로 제한됩니다.
  • 에이전트는 가장 최근에 시작된 프로시저 5개를 컨텍스트에 유지합니다. 하나의 대화에서 그보다 많은 프로시저가 시작되면, 가장 오래된 자유 형식 프로시저의 콘텐츠, 인라인 도구, 지식 베이스 문서가 프롬프트에서 제외됩니다. 한 번에 활성화되는 프로시저 수가 적도록 프로시저의 범위를 좁히고 하위 프로시저를 사용하세요.
  • 프로시저를 만든 후에는 유형을 변경할 수 없습니다. 자유 형식과 구조화된 유형 간에 전환하려면 새 프로시저를 만들고 해당 프로시저에 대한 모든 참조를 업데이트하세요.
  • 프로시저는 하나의 에이전트에 속합니다. 에이전트 간에 공유하거나 워크스페이스 수준 리소스로 저장할 수 없습니다.
  • 에이전트를 복제하면 프로시저를 공유하는 대신 복사합니다. 복사본에는 새 프로시저 ID가 부여되므로 복제된 에이전트의 참조는 새 ID를 사용해야 합니다.
  • 프로시저를 특정 워크플로 노드로 제한할 수 없습니다. 에이전트에 둘 다 있으면 모든 프로시저를 모든 노드에서 사용할 수 있습니다.
  • 구조화된 프로시저는 지식 베이스 문서를 참조할 수 없습니다.