Вы находитесь здесь:
Создание элемента агента
Используйте агента Agentforce для динамической обработки задач в потоке. Выберите существующего агента или создайте агента с настраиваемыми инструкциями и действиями.
Требуемые версии
Полномочия
Чтобы использовать существующих агентов в потоках, необходимо полномочие пользователя «Просмотр настройки». Для создания агентов из Flow Builder необходимо полномочие пользователя «Настройка приложения», Einstein Copilot Builder, Einstein Agent Platform Builder или самообслуживания Copilot Builder. Пользователи с профилем системного администратора могут создавать и использовать агентов.
При отсутствии полномочий на создание агентов кнопка «Создать агента» не отображается на панели выбора агента. Выбрать можно только существующих агентов.
Использование
Добавьте элемент создания агента в поток. В поле «Агент» найдите и выберите активного агента или нажмите «Создать агента», чтобы создать нового.
Выбор существующего агента
Чтобы использовать существующего агента, найдите агента по имени в поле «Агент». В списке отображаются только активные агенты. После выбора агента настройте вводные и выходные данные агента на панели свойств.
Создание нового агента
Чтобы создать агента, нажмите кнопку «Создать агента». В окне создания агента настройте основные сведения об агенте.
| Поле | Описание |
|---|---|
| Метка | Имя агента. |
| API-имя | Имя элемента должно быть уникальным только в рамках текущего потока. Два элемента могут иметь одинаковое API- имя при условии, что они используются в разных потоках.Имя API может содержать буквы, цифры и символы подчеркивания без пробелов. Оно должно начинаться с буквы и не может заканчиваться символом подчеркивания. Также оно не может содержать два последовательных подчеркивания. |
| Описание | Описание действий агента. |
| Доступ пользователя | Запись пользователя, от имени которого выполняется агент. Выберите текущего пользователя или попросите систему создать пользователя. |
| Команды | Инструкции, описывающие действия агента и направляющие его рассуждения. |
| Действия | Действия, которые может использовать агент. Выберите существующие действия в библиотеке активов или создайте настраиваемые действия. |
Добавление действий к агенту
Агенту необходимо как минимум одно действие для выполнения задач. Добавьте действия перед нажатием кнопки «Создать и активировать» или в Agentforce Builder после активации агента.
Чтобы выбрать текущие действия, щелкните «Выбрать действия». Найдите и выберите одно или несколько действий из библиотеки активов, потом нажмите «Добавить в агенты». Доступные действия включают действия Knowledge, потоки, настроенные как вызываемые действия и стандартные действия.
Чтобы создать действие, нажмите кнопку «Создать действие». В окне создания действия настройте действие.
| Поле | Описание |
|---|---|
| Метка инструмента агента | Имя действия. |
| API-имя | Имя элемента должно быть уникальным только в рамках текущего потока. Два элемента могут иметь одинаковое API- имя при условии, что они используются в разных потоках.Имя API может содержать буквы, цифры и символы подчеркивания без пробелов. Оно должно начинаться с буквы и не может заканчиваться символом подчеркивания. Также оно не может содержать два последовательных подчеркивания. |
| Описание | Имя действия. Агент использует эту информацию для определения способа и времени использования этого действия. |
| Тип действия ссылки | Тип действия (например, Flow или Apex). |
| Категория действия ссылки | Подтип ссылочного типа действия. Не у всех действий есть категория действия ссылки. |
| Ссылочное действие | Имя действия для ссылки. |
Для каждого ввода добавьте описание действий ввода. Агент использует описание для определения способа использования ввода при вызове действия. Выберите «Требовать ввод для выполнения действия», чтобы сделать ввод обязательным.
Для каждого вывода добавьте описание возвратов вывода и способа использования результата в потоке. Выберите «Фильтровать из контекста агента», чтобы исключить вывод из аргументации агента. Выберите «Показать в разговоре», чтобы добавить этот вывод в ответ агента.
Чтобы создать и активировать агента, нажмите кнопку «Создать и активировать».
Настройка элемента
После выбора или создания агента настройте элемент создания агента на панели свойств.
| Поле | Описание |
|---|---|
| Метка | Метка действия на холсте и в менеджере инструментария. |
| API-имя | Имя элемента должно быть уникальным только в рамках текущего потока. Два элемента могут иметь одинаковое API- имя при условии, что они используются в разных потоках.Имя API может содержать буквы, цифры и символы подчеркивания без пробелов. Оно должно начинаться с буквы и не может заканчиваться символом подчеркивания. Также оно не может содержать два последовательных подчеркивания. |
| Описание | Описание элемента. |
Задать значения ввода
Настройте вводные данные элемента создания агента на панели свойств.
| Поле | Описание |
|---|---|
| Запрос агента | Вопрос или запрос для отправки агенту для данного выполнения потока. Агент применяет инструкции к данному конкретному запросу для создания вывода. |
| Код сеанса | Дополнительно. Используйте код сеанса, возвращенный элементом создания агента, выполняемым ранее в потоке. Агент сохраняет полный контекст рассуждений и память из этого разговора. Если вы не предоставите код сеанса, агент начнет новый разговор, но вы всегда можете указать результаты из предыдущих элементов создания агента в качестве вводных данных. |
Настройка структурированного вывода
Чтобы настроить агента на возврат структурированных данных, которые может использовать поток, определите структурированные поля вывода. Каждое поле представляет часть сведений, извлекаемых или создаваемых агентом.
Если вы настраиваете структурированный вывод, агент возвращает только структурированные данные в поле структурированного ответа агента. Поле ответа агента возвращает null. Если структурированный вывод не настроен, агент возвращает только неструктурированный текст в поле ответа агента.
Чтобы настроить структурированный вывод, нажмите «Настроить». Настройте поля для каждого структурированного поля вывода:
| поле | Описание |
|---|---|
| Имя поля | Обязательно. Уникальное буквенно-цифровое имя структурированного поля вывода. Имя не может содержать специальных символов или пробелов. |
| Описание | Краткое описание, используемое с именем поля для повышения точности модели большого языка (LLM). |
| Тип данных | Обязательно. Тип данных поля. Допустимые значения: Строка, число, логическое значение. |
| Обязательно | Указывает, что LLM должен создать ответ для этого поля вывода. Требование строк вывода может привести к неточным или вредным ответам LLM. |
Сохранить значения вывода
| Поле | Описание |
|---|---|
| Ответ агента | Неструктурированный ответ от агента. Возвращает ноль, если настроен структурированный вывод. |
| Код сеанса | Код сеанса разговора, в котором находится ответ агента. |
| Структурированный ответ агента | Структурированный вывод из агента. Возвращает ноль, если не настроен структурированный вывод. |
Структурированное использование вывода
Прежде чем настраивать структурированный вывод, введите метку и API-имя для элемента создания агента, а потом сохраните поток.
При настройке структурированного вывода определите как минимум 1 структурированное поле вывода перед сохранением.
Для каждого заданного структурированного поля вывода создаются два поля: один с заданным именем и связанным логическим полем _set. Например, если вы определили структурированное поле вывода под именем summary, создается также логическое поле под именем summary_set.
| Поле | Описание |
|---|---|
| True | Поле было добавлено в структурированный ответ агента, но не содержало заданного значения. |
| False | Поле не было добавлено в структурированный ответ агента. |
Когда определенный структурированный вывод возвращает null, используйте связанное поле _set позже в потоке, чтобы определить, почему поле является null.
Примечания к использованию
- Протестируйте поток перед активацией, чтобы обеспечить корректное функционирование элемента создания агента.
- Агенты, созданные в Flow Builder, могут быть найдены и изменены в Agentforce Builder в любое время.
- Начиная с версии API 67.0, действия агента на основе искусственного интеллекта больше недоступны в элементе действия. Используйте элемент создания агента для работы с агентами. При открытии потока с элементом «Действие», ссылающимся на действие «Агент на основе искусственного интеллекта», он автоматически отображается как элемент «Создать агента». Исходная конфигурация сохранена.
