에이전트 업그레이드 오류 문제 해결

레거시 빌더와 Agentforce 빌더 간에 데이터 라이브러리 ID의 필수 형식이 다르므로 잘못된 데이터 라이브러리 오류가 발생할 수 있습니다.

knowledge.rag_feature_config_id가 유효하지 않다는 오류가 표시되면 Agentforce 빌더의 탐색기에서 에이전트의 업그레이드된 버전에 수동으로 데이터 라이브러리를 추가합니다.

에이전트 스크립트에서 소스 필드는 에이전트 작업의 API 이름입니다. 에이전트 작업에 포함된 경우 대상 필드와 함께 에이전트에게 실행할 작업 및 호출할 참조 작업(Apex 클래스, 플로 또는 프롬프트 템플릿과 같은 기본 기능)을 알려줍니다. 메타데이터 불일치 또는 레거시 빌더가 Agentforce 빌더가 필요하지 않은 에이전트 작업 소스에 ID 접미사를 추가했기 때문에 잘못된 소스 오류가 발생할 수 있습니다.

Agentforce 에이전트 작업의 소스를 찾을 수 없다는 오류 메시지가 표시되면 스크립트 보기에서 다음을 수행합니다.

• 소스에서 영숫자 ID 접미사를 삭제합니다. 예를 들어, My_Action_1792ce20299b41c이 My_Action이 됩니다.
• 사용자 정의 에이전트 작업의 경우 작업이 관리 패키지에 속하지 않는 한 작업에서 소스 필드를 완전히 삭제할 수도 있습니다. 사용자 정의 에이전트 작업은 일반적으로 대상 필드만 사용할 수 있습니다. 관리 패키지의 작업에 소스 필드의 네임스페이스가 필요할 수 있습니다.

자산 라이브러리에서 작업을 사용할 수 있는 경우 에이전트에서 작업을 제거한 다음, 다시 추가할 수 있습니다. 또는 에이전트에 고유한 사용자 정의 작업인 경우 작업을 제거하고 동일한 참조 작업을 기반으로 다시 만들 수 있습니다.

컨텍스트 변수(연결된 변수라고도 함)는 Agentforce 빌더 및 Agent Script에서 변수의 소스로 식별되는 개체 필드에 매핑됩니다. 예를 들어, RoutableId 변수의 소스는 Messaging 세션 개체의 ID 필드입니다. 컨텍스트 변수가 포함된 에이전트를 업그레이드할 경우 에이전트 스크립트에서 소스 필드가 누락될 수 있습니다.

업그레이드된 에이전트를 저장하거나 커밋할 때 변수에 대한 소스 필드가 유효하지 않거나 누락된 오류 메시지가 표시되면 스크립트 보기에서 소스를 수동으로 추가합니다. 변수를 사용하지 않는 경우에는 안전하게 삭제할 수 있습니다. 다음 표에 일반적인 컨텍스트 변수 및 소스가 나열되어 있습니다.