Внедрение миграции

Миграция агента поэтапно

Подходите к миграции поэтапно, чтобы потом было легче стабилизировать и устранить неполадки.

1. Миграция агента без изменений.

   Начните с базовой миграции всех субагентов, инструкций и действий. Встаньте на устаревший дизайн агента в новом конструкторе и проверьте его работоспособность.

2. Определите и исправьте все регрессии.

   Чтобы определить регрессии, проверьте синтаксис сценария агента и проверьте наличие ошибок в конструкторе. Потом выполните те же ручные и пакетные тесты, что и ранее, чтобы установить предмиграционный базис агента.

   • Все, что работало в агенте в устаревшем конструкторе и не работало в новом конструкторе, является регрессией.
   • Все остальное - улучшение или усовершенствование.

   Исправьте все регрессии перед внесением других изменений, чтобы изолировать и устранить неполадки. Если что-то нарушено после базовой миграции, вы знаете, что это результат миграции, а не внесенное изменение.

   

   Совет Использование Agentforce для обновления агента уменьшает вероятность ошибок проверки. Однако, любое изменение аргументации может повлиять на производительность агента. Важно протестировать агента от начала до конца из-за различий в модели данных и базовом механизме рассуждения между устаревшими и новыми конструкторами.
3. Закалите и улучшите агента посредством сценария агента.

   После того как базовый агент стабилен в новом конструкторе, можно начать вносить изменения для повышения надежности и производительности агента. На этом этапе можно воспользоваться возможностями, которые может предложить сценарий агента для исправления вещей, которые никогда не работали в устаревшем конструкторе, и стратегически внедрить детерминизм для добавления предсказуемости и последовательности.

4. Расширьте агента.

   На определенном этапе миграции агента вы можете услышать песню сирены списка желаний агента и подумать о расширении возможностей агента до новых подагентов, способов использования или интеграций. Не спешите расширяться. Сосредоточьтесь на миграции агентов, прежде чем вводить новые функции. Выполнение слишком большого количества действий одновременно, особенно до того, как ваш агент станет стабильным в новом конструкторе, может испортить архитектуру агента и затруднить отслеживание, изоляцию и устранение неполадок.

Внесение изменений в небольшие пакеты и тестирование после каждого пакета

Вне зависимости, исправляете ли вы регрессии или закаляете агента посредством сценария агента, избегайте внесения большого количества изменений за один раз. Это может затруднить изоляцию и тестирование проблем, которые могут возникнуть в результате изменений (например, ошибка компиляции), особенно при использовании сторонних инструментов кодирования на основе искусственного интеллекта. Используйте повторяющийся подход к изменениям для измерения улучшений, документирования результатов и минимизации регрессий.

• Сперва внесите структурные и архитектурные изменения, а потом подготовьтесь.
• Тестируйте после каждого изменения и отслеживайте показатели по сравнению с базовыми.
• Обязательство агента и создание новых версий после значительных изменений, а не незначительных исправлений. Подробнее о жизненном цикле версии и редактирования агента в новом конструкторе.

Советы по тестированию

Тестирование имеет решающее значение для установления базиса, объективной оценки результатов и улучшений и сведения к минимуму регрессий. При миграции происходят изменения в аргументации и инструкциях агента, которые могут повлиять на поведение агента. Независимо от используемого инструмента или инструментов миграции, рекомендуем тщательно протестировать, настроить и протестировать повторно, чтобы обеспечить корректную производительность агента.

• Тестируйте в начале каждого этапа миграции агента, а потом после каждого пакета изменений. Планируйте тестирование на раннем этапе и часто, в том числе:
  • Прежде чем мигрировать, установите начальный базис и определите проблемы.
  • После первичной миграции установите базис в новом конструкторе и определите регрессии.
  • После каждого серьезного изменения или пакета небольших изменений
• Создайте план тестирования, включающий ручное тестирование в Agentforce Builder и пакетное тестирование в центре тестирования Agentforce. Выполните тот же план для отслеживания по сравнению с базовым уровнем. Как минимум, хороший план тестирования охватывает:
  • Основные функции агента, например, создание обращений, резервирование встреч, отслеживание заказов или вопросы и ответы с действием «Ответ на вопросы с помощью Knowledge».
  • Персоны, основанные на реальном поведении пользователя, например, проверенные пользователи, непроверенные пользователи, нетерпеливые или несчастные пользователи, пользователи, которые ведут много светских разговоров.
  • Диапазон простых и более сложных сценариев, включительно с многооборотными диалогами, сценариями использования с несколькими субагентами и краевыми сценариями.
• Если вы внедрили проверку клиента, включительно с фильтрацией на основе переменных verifiedCustomerId или isVerified, явно протестируйте поведение агента как непроверенного конечного пользователя и как проверенного конечного пользователя. В новом конструкторе предварительно просмотрите агента в режиме оперативного тестирования. Для имитации проверенных и непроверенных пользователей во вкладке «Переменные» переопределите значения любых переменных, используемых для хранения результатов проверки клиента или проверенных кодов клиентов.
• Явно протестируйте на наличие резких изменений в разговоре агента. Пользователи могут переходить от запросов к разговорам, создавать новые запросы до завершения текущего запроса или иным образом изменять тему разговора. Хотя агенты адаптируемы, проблемы с переключением тем можно легко пропустить, если их не искать. Чтобы эффективно протестировать, измените тему три или четыре раза в разговоре предварительного просмотра для проверки надежного поведения агента.
• Возможности тестирования отличаются в устаревшем конструкторе и новом конструкторе, как для тестирования вручную, так и для пакетного тестирования. Ознакомьтесь с инструментами тестирования, доступными для каждого из них. Запланируйте тестирование одних и тех же функций, персон и сценариев в устаревших и новых инструментах, чтобы как можно точнее сравнить показатели.

Советы по работе со сторонними инструментами искусственного интеллекта

Агенты — это метаданные, а сценарий агента является высокопортативным, поэтому у вас есть возможность использовать низкокодовые, прокодированные и сторонние инструменты для миграции и расширения агента. Используйте комбинацию инструментов, которые больше подходят вам, но помните о следующих советах по работе со сторонними инструментами.

• Сторонние инструменты кодирования на основе искусственного интеллекта не всегда правильно понимают синтаксис Agent Script, даже при загруженных навыках Agentforce. Загрузите официальную документацию Agent Script и предоставьте к ней общий доступ агенту кодирования. Всегда просматривайте вручную изменения, созданные на основе искусственного интеллекта, прежде чем принимать их и при необходимости преобразовывайте изменения в действительный синтаксис сценария агента. При возникновении сомнений см. документацию Agent Script в Руководстве разработчика Agentforce и используйте искусственный интеллект для получения другого мнения.
• Получите максимум от Клода, курсора и других инструментов искусственного интеллекта, определив четкие ограничения и цели. Ясность критериев успеха помогает этим инструментам предоставлять действенные результаты. Например, запросы общего характера «улучшить моего агента» вряд ли приведут к эффективным результатам самостоятельно. Вы с большей вероятностью получите лучший результат, если отправите более конкретный запрос (например, «убедитесь, что агент всегда проверяет право на заказ, прежде чем пытаться обработать возврат»). Общий доступ к этому руководству по миграции в контексте может помочь инструментам искусственного интеллекта понять ваши требования и предложить эффективные подходы.
• Существует несколько способов работы с инструментами искусственного интеллекта, и не нужно оптимизировать всего агента одновременно. Если вы не получаете нужных результатов или вам трудно понять общие изменения в дизайне и поведении агента, относитесь к инструментам искусственного интеллекта больше как к стратегическим партнерам и соавторам, чем к независимым подрядчикам. Их можно использовать итерационно для диагностики конкретных, отдельных проблем, проверки подходов и внедрения решений. Ниже указаны примеры эффективных бизнес-правил размером с укус.
  • При использовании средства кодирования на основе искусственного интеллекта с предварительно загруженными навыками для внесения изменений просмотрите изменение в режиме плана. Попросите его объяснить, почему он внес конкретные изменения для оспаривания и проверки проектных решений и определения лучшего пути вперед. Потом выполните изменение в режиме агента.
  • Просмотрите инструкцию вручную и запишите рекомендованные изменения. В режиме вопроса попросите ИИ о перспективах изменений: согласен ли ИИ, что он сделает по-другому и почему? Используйте этот процесс, чтобы решить, какие изменения сохранить. Потом выполните изменения в режиме агента небольшими пакетами.

Советы по работе в рабочих группах

В данный момент не рекомендуется одновременно работать с одним и тем же агентом в конструкторе. Но существуют способы эффективной совместной работы над миграцией агентов.

• В дополнение к проверке изменений на основе искусственного интеллекта, рекомендуем использовать коллегиальную проверку в качестве проверки качества перед подтверждением изменений агента.
• Ограничьте многопользовательское сотрудничество простыми, самостоятельными проблемами и решениями.
• Каждый конструктор должен работать в собственной копии агента. Потом вручную дифференцируйте и объедините копии. Как и многие другие шаги в этом руководстве, вы можете использовать искусственный интеллект, чтобы помочь в этом.