마이그레이션 구현

단계별 에이전트 마이그레이션

나중에 더욱 쉽게 안정화하고 문제를 해결할 수 있도록 마이그레이션에 단계별로 접근합니다.

1. 에이전트를 그대로 마이그레이션하십시오.

   모든 하위 에이전트, 지침 및 작업의 기준선 마이그레이션으로 시작합니다. 새 빌더에서 레거시 에이전트 디자인을 확인하고 종단간 작동하는지 확인합니다.

2. 모든 회귀를 식별하고 수정합니다.

   회귀를 식별하려면 에이전트의 에이전트 스크립트 구문을 확인하고 빌더에서 오류를 확인합니다. 그런 다음 이전에 실행한 것과 동일한 수동 및 배치 테스트를 실행하여 에이전트의 마이그레이션 전 기준선을 설정합니다.

   • 레거시 빌더의 에이전트에서 작업했지만 새 빌더에서 작동하지 않는 항목은 회귀입니다.
   • 그 밖의 모든 기능은 개선 사항 또는 개선 사항입니다.

   문제를 격리하고 해결할 수 있도록 다른 사항을 변경하기 전에 회귀를 수정합니다. 기준선 마이그레이션 후 문제가 발생하면 마이그레이션의 결과가 아니라 변경한 결과임을 알 수 있습니다.

   

   팁 Agentforce 사용하여 에이전트를 업그레이드하면 확인 오류와 같은 문제의 가능성이 줄어듭니다. 그러나 근거를 변경하면 에이전트 성과에 영향을 미칠 수 있습니다. 레거시 및 신규 빌더 간 데이터 모델 및 기본 추론 엔진의 차이점으로 인해 에이전트를 종단 간에 테스트하는 것이 중요합니다.
3. 에이전트 스크립트를 사용하여 에이전트를 강화하고 개선합니다.

   새 빌더에서 기준 에이전트가 안정되면 에이전트의 신뢰도 및 성과를 향상하기 위해 변경을 시작할 수 있습니다. 이제 에이전트 스크립트가 제공하는 기능을 활용하여 레거시 빌더에서 작동하지 않은 사항을 수정하고 전략적으로 결정성을 도입하여 예측 가능성과 일관성을 추가할 수 있습니다.

4. 에이전트 확장하기.

   에이전트 마이그레이션 중에 에이전트 위시리스트의 시리언 노래를 듣고 새 하위 에이전트, 사용 사례 또는 통합으로 에이전트의 기능을 확장할지 생각할 수 있습니다. 너무 빨리 확장할 필요가 없습니다. 새 기능을 도입하기 전에 에이전트 마이그레이션에 집중하십시오. 특히 에이전트가 새 빌더에서 안정되기 전에 너무 많은 작업을 한 번에 수행하면 에이전트의 아키텍처가 흐리게 되고 문제를 추적, 분리, 문제 해결하기가 더 어려울 수 있습니다.

소규모 배치로 변경하고 각 배치 후 테스트

회귀를 수정하거나 에이전트 스크립트를 사용하여 에이전트를 강화하든 한 번에 많은 사항을 변경하지 마십시오. 따라서 특히 타사 AI 코딩 도구를 사용하는 경우 변경 사항이 발생할 수 있는 문제(예: 컴파일 오류)를 격리하고 테스트하기가 더 어려울 수 있습니다. 변경 사항에 반복적으로 접근하여 개선 사항을 측정하고 결과를 문서화하고 회귀를 최소화합니다.

• 먼저 구조 및 아키텍처를 변경한 다음, 맞춤형으로 완성합니다.
• 각 변경 후에 테스트하고 기준선에 대한 메트릭을 추적합니다.
• 에이전트를 커밋하고 작은 수정이 아닌 중요한 변경 후 새 버전을 만듭니다. 새 빌더에서 에이전트 버전 관리 및 편집 수명 주기에 대해 자세히 알아봅니다.

테스트 팁

테스트는 기준선을 설정하고 결과 및 개선 사항을 객관적으로 측정하고 회귀를 최소화하는 데 중요합니다. 마이그레이션 시 에이전트의 사유 및 지침이 변경되어 에이전트의 동작에 영향을 미칠 수 있습니다. 사용하는 마이그레이션 도구 또는 도구에 상관없이 에이전트가 예상대로 수행하는지 확인하기 위해 신중하게 테스트, 조정, 다시 테스트할 계획입니다.

• 에이전트 마이그레이션의 각 스테이지 시작 시점 및 각 변경 사항 배치 후에 다시 테스트합니다. 다음을 포함하여 조기에 자주 테스트할 계획:
  • 마이그레이션하기 전에 초기 기준선을 설정하고 문제를 식별합니다.
  • 초기 마이그레이션 후 새 빌더에서 기준선을 설정하고 회귀를 식별합니다.
  • 모든 주요 변경 또는 작은 변경 사항의 배치 후
• Agentforce 빌더에서 수동 테스트 및 Agentforce 테스트 센터 배치 테스트를 포함하는 테스트 계획을 만듭니다. 같은 계획을 실행하여 기준선을 추적합니다. 최소한 적절한 테스트 계획은 다음을 포함합니다.
  • 사례 생성, 약속 예약, 주문 추적 또는 Knowledge 질문에 답변 작업이 포함된 FAQ와 같은 핵심 에이전트 기능
  • 인증된 사용자, 인증되지 않은 사용자, 불만족하거나 불만족한 사용자, 많은 작은 대화에 참여하는 사용자 등 실제 사용자 동작을 기반으로 하는 페르소나입니다.
  • 다중 전환 대화, 다중 하위 에이전트 사용 사례, 가장자리 사례 등 간단하고 복잡한 시나리오의 범위입니다.
• verifiedCustomerId 또는 isVerified 변수를 기반으로 하는 필터링을 포함하여 고객 확인을 구현한 경우 확인되지 않은 최종 사용자 및 확인된 최종 사용자로서 에이전트의 동작을 명시적으로 테스트합니다. 새 빌더에서 에이전트를 실시간 테스트 모드로 미리 봅니다. 확인된 사용자와 확인되지 않은 사용자를 시뮬레이션하려면 변수 탭에서 고객 확인 결과 또는 확인된 고객 ID를 저장하는 데 사용하는 모든 변수의 값을 재정의합니다.
• 에이전트 대화에서 갑작스러운 변경 사항을 명시적으로 테스트합니다. 사용자는 요청에서 작은 대화로 전환하고, 현재 요청이 완료되기 전에 새 요청을 만들거나 대화 주제를 변경할 수 있습니다. 에이전트는 적응할 수 있지만, 찾지 않는 경우 주제 전환과 관련된 문제는 놓칠 수 있습니다. 효과적으로 테스트하려면 미리 보기 대화에서 제목을 3~4번 변경하여 신뢰할 수 있는 에이전트 동작을 확인합니다.
• 수동 테스트 및 배치 테스트 모두에서 레거시 빌더와 새 빌더 간에 테스트 기능이 다릅니다. 각각에 사용할 수 있는 테스트 도구를 알아보십시오. 메트릭을 최대한 정확하게 비교할 수 있도록 레거시 및 새 도구 전반에서 동일한 기능, 페르소나, 시나리오를 테스트할 계획입니다.

타사 AI 도구를 사용하여 작업하기 위한 팁

에이전트는 메타데이터이며 에이전트 스크립트는 이동성이 높으므로 에이전트를 마이그레이션하고 향상하기 위해 하위 코드, 프로 코드, 타사 도구를 유연하게 사용할 수 있습니다. 가장 적합한 도구의 조합을 사용하되 타사 도구를 사용할 때 다음 팁에 유의하십시오.

• 타사 AI 코딩 도구는 Agentforce 기술이 로드된 경우에도 Agent Script 구문을 올바르게 만들 수 없습니다. 오피셜 Agent Script 문서를 다운로드하여 코딩 에이전트와 공유합니다. AI 생성 변경 사항을 수락하기 전에 항상 수동으로 검토하고 필요한 경우 유효한 에이전트 스크립트 구문에 변경 사항을 리팩터링하십시오. 의심할 경우 Agentforce 개발자 가이드의 에이전트 스크립트 문서를 참조하고 AI를 사용하여 두 번째 의견을 작성하십시오.
• 명확한 제약 및 목표를 정의하여 Claude, Cursor 및 기타 AI 도구를 최대한 활용합니다. 성공 기준에 대한 명확성은 이러한 도구가 실행 가능한 결과를 제공하는 데 도움이 됩니다. 예를 들어, "내 에이전트 개선"과 같은 일반적인 요청은 자체적으로 효과적인 결과를 얻을 가능성이 없습니다. 더 구체적인 요청을 하면 더 나은 결과를 얻을 가능성이 높습니다(예: "에이전트가 반품을 처리하기 전에 항상 주문 자격을 확인해야 함"). 또한 이 마이그레이션 가이드를 컨텍스트로 공유하면 AI 도구가 요구 사항을 이해하고 효과적인 접근 방식을 제안하는 데 도움이 됩니다.
• AI 도구를 사용하여 작업하는 방법은 두 가지 이상이므로 한 번에 전체 에이전트를 최적화할 필요가 없습니다. 원하는 결과를 얻지 못하거나 에이전트의 디자인 및 동작에 대한 광범위한 변경 사항을 이해하기 어려운 경우 AI 도구를 독립 계약자보다 전략적 파트너 및 공동작업자처럼 취급하십시오. 이를 반복적으로 사용하여 특정한 개별적인 문제를 진단하고, 접근 방식을 확인하고, 솔루션을 구현할 수 있습니다. 다음은 효과적인 크기의 워크플로의 몇 가지 예입니다.
  • 사전 로드된 기술이 있는 AI 코딩 도구를 사용하여 변경할 경우 계획 모드에서 변경 사항을 검토합니다. 설계 결정을 심사 및 검증하고 향후 최적의 경로를 결정하기 위해 특정 변경 사항을 적용한 이유를 설명해달라고 요청하십시오. 그런 다음, 에이전트 모드에서 변경 사항을 실행합니다.
  • 명령을 수동으로 검토하고 권장 변경 사항을 기록합니다. 질문 모드에서 변경 사항에 대한 AI 관점을 요청합니다. AI가 동의하는지, 다르게 수행할 작업 및 이유는 무엇입니까? 이 프로세스를 사용하여 유지할 변경 사항을 결정합니다. 그런 다음, 에이전트 모드에서 변경 사항을 작은 배치로 실행합니다.

팀에서 작업하기 위한 팁

현재 빌더에서 동일한 에이전트에 대해 동시에 공동 작업하지 않는 것이 좋습니다. 그러나 에이전트 마이그레이션에 대해 효과적으로 협력할 수 있는 방법이 있습니다.

• 모든 변경 사항에 대한 AI 검토 외에도 에이전트 변경 사항을 커밋하기 전에 품질 검사로 동료 검토를 고려하십시오.
• 간단한 독립형 문제 및 수정으로 다중 플레이어 공동 작업을 제한합니다.
• 각 빌더는 에이전트의 자체 사본에서 작업해야 합니다. 그런 다음, 복사본을 직접 표시하고 병합합니다. 이 가이드의 다른 여러 단계와 마찬가지로 AI를 사용하여 이 작업을 수행할 수 있습니다.