Primeros pasos con Agentforce DX

Objetivos de aprendizaje

En este proyecto, alcanzará los siguientes objetivos:

• Explicar cómo le ayuda Agentforce DX a crear agentes.
  
• Configurar su entorno de desarrollo de Agentforce DX.
  
• Clonar un repositorio que contiene un agente de muestra en un proyecto DX.
  

Nota

¿Su idioma de aprendizaje es español? Comience el reto en un Trailhead Playground en español y utilice las traducciones proporcionadas entre paréntesis para navegar. Copie y pegue solo los valores en inglés, ya que las validaciones del reto se basan en los datos en inglés. Si no aprueba el reto en su organización en español, le recomendamos que (1) cambie la configuración regional a Estados Unidos, (2) cambie el idioma a inglés, siga las instrucciones descritas aquí y, a continuación, (3) vuelva a hacer clic en el botón Check Challenge (Comprobar el reto).

Consulte la insignia Trailhead en su idioma para obtener más información sobre cómo aprovechar la experiencia de Trailhead en otros idiomas.

Coral Cloud Resorts y Agentforce DX

¡Enhorabuena! El equipo de desarrollo de Coral Cloud Resorts le acaba de contratar y está deseando empezar a programar. Su nuevo gerente le explica que el equipo trabaja arduamente para crear agentes. Ya han empezado con la creación de un agente que se llama Local Info Agent (Agente de información local) que proporciona a los clientes actualizaciones sobre las previsiones meteorológicas e información sobre eventos locales, y ahora usted va a continuar con el proyecto. Sin embargo, usted nunca antes ha desarrollado un agente en Salesforce, por lo que necesita formación para aprender los aspectos básicos. ¡Continúe leyendo!

Dado que usted es un desarrollador moderno, está acostumbrado a utilizar las últimas herramientas de desarrollo, como almacenar el código fuente del agente en un sistema de control de versiones (por ejemplo, GitHub) e incorporar el desarrollo y las pruebas del agente en trabajos de integración continua (CI). Parece un trabajo para Agentforce DX.

¿Qué es Agentforce DX?

Hasta ahora, es posible que haya creado agentes con la IU de Agentforce Builder, que es la manera . de crear agentes con clics y sin código. Para incorporar IA en una canalización moderna de DevOps, debe dejar de usar solo el navegador y pasar al mundo de Agentforce Developer Experience (DX) que permite programar de forma profesional. Este cambio le permite tratar la lógica de sus agentes como código fuente, versionarlo en un repositorio e implementarlo junto con los componentes Lightning y de Apex.

Si usted es desarrollador de Salesforce, es probable que ya conozca Salesforce DX, un conjunto de herramientas para desarrollar, probar y enviar aplicaciones en Salesforce Platform. Entre estas herramientas se incluyen Agentforce Vibes, extensiones de Visual Studio Code (VS Code), Salesforce CLI y mucho más. Agentforce DX amplía estas herramientas para poder trabajar también con agentes.

Los agentes se componen de metadatos, como cualquier otra personalización de Salesforce. Agentforce DX ofrece herramientas que permiten para crear, modificar, previsualizar y probar agentes con código fuera de la IU de Agentforce Builder. Además, permite trasladar los metadatos de los agentes entre el proyecto de DX y las organizaciones borrador, sandboxes y organizaciones de producción con las que trabaja. Gracias a estas funciones, puede incorporar agentes en su proceso moderno de desarrollo de software.

Regístrese para obtener una organización de Developer Edition con Agentforce

Para completar este proyecto, necesita una organización de Developer Edition especial que contenga datos de Agentforce y nuestros datos de muestra. Obtenga la versión gratuita de Developer Edition y conéctela a Trailhead para completar los retos de este proyecto. Tenga en cuenta que Developer Edition está diseñada para trabajar con los retos de esta insignia y es posible que no funcione con otras. Compruebe siempre que está usando el Trailhead Playground o la organización de Developer Edition que le recomendamos.

1. Regístrese para obtener una organización de Developer Edition con Agentforce gratuita.
   
2. Rellene el formulario.
   
   • En Email (Correo electrónico), introduzca una dirección de correo activa.
     
   • En Username, introduzca una dirección de correo electrónico exclusiva (por ejemplo, yourname@test.com [su nombre@prueba.com]). No tiene por qué ser una cuenta real.
     
3. Una vez completado el formulario, haga clic en Sign me up (Registrarse). Aparece un mensaje de confirmación.
   
4. Cuando reciba el correo electrónico de activación (es posible que tarde unos minutos), ábralo y haga clic en Verificar cuenta.
   
5. Complete el registro estableciendo una contraseña y una pregunta de seguridad.
   
   • Sugerencia: Guarde su nombre de usuario, contraseña y URL de inicio de sesión en un lugar seguro, como un gestor de contraseñas, para acceder fácilmente. Necesitará esta información más tarde para autorizar a Salesforce CLI a usar su organización de Developer Edition.
     
6. Ya ha iniciado sesión en su Developer Edition.
   

Ahora, conecte su organización de Developer Edition a Trailhead.

1. Asegúrese de haber iniciado sesión en su cuenta de Trailhead.
   
2. En la sección Verify Step (Verificar paso) al final de esta página, haga clic en la organización práctica que aparece y haga clic en Connect Org (Conectar organización).
   
3. En la pantalla de inicio de sesión, introduzca su nombre de usuario y contraseña para la organización de Developer Edition que acaba de configurar.
   
4. En la pantalla Allow Access? (¿Permitir acceso?), haga clic en Allow (Permitir).
   
5. En la pantalla Want to connect this org for hands-on challenges? (¿Desea conectar esta organización para retos prácticos?), haga clic en Yes! Save it (Sí, guardar). Se le redirigirá a la página de retos y ya podrá utilizar su organización de Developer Edition para conseguir esta insignia.
   

Activar Agentforce en su organización de Developer Edition

Para desarrollar agentes con Agentforce DX, active Agentforce en su organización de Developer Edition.

1. Inicie sesión en su organización de Developer Edition y haga clic en el icono de engranaje de configuración situado en la esquina superior derecha.
   
2. Haga clic en Setup (Configuración) en el menú desplegable.
   
3. Escriba Einstein Setup (Configuración de Einstein) en el cuadro Quick Find (Búsqueda rápida) y haga clic en Einstein Setup (Configuración de Einstein).
   
4. Asegúrese de que la opción Turn on Einstein (Activar Einstein) esté activada.
   
   
5. Escriba Einstein Bots en el cuadro Quick Find (Búsqueda rápida) y haga clic en Einstein Bots.
   
6. Configure Einstein Bots a On (Activado).
   
   
7. Escriba Salesforce Go en el cuadro Quick Find (Búsqueda rápida) y, a continuación, seleccione Salesforce Go.
   
8. En el cuadro de texto Search features... (Buscan funciones...), introduzca Agentforce y seleccione Agentforce (Default) (Agentforce [predeterminado]).
   
9. Haga clic en Get Started (Empezar).
   
10. Haga clic en Turn On (Activar).
    
    
11. Haga clic en Confirm (Confirmar).
    

Configurar su entorno de desarrollo

A continuación, configure su entorno de desarrollo local. El equipo de desarrollo de Coral Cloud Resorts utiliza comando de VS Code y de CLI para crear agentes. VS Code es un entorno de desarrollo integrado (IDE) que se compone de un editor de código, herramientas de automatización de creación, un depurador y una finalización de código inteligente.

Si usted es desarrollador de Salesforce y emplea nuestras herramientas que permiten código, es probable que tenga instalado VS Code (con las extensiones de Salesforce) y Salesforce CLI en su equipo. Puede utilizar la misma configuración, pero asegúrese de actualizar todas las extensiones de VS Code a la última versión. También debe instalar Node.js en su ordenador.

Siga estos pasos para configurar su entorno.

1. Instale VS Code en su ordenador; para ello, vaya a code.visualstudio.com y haga clic en Download (Descargar).
   
2. Instale Salesforce Extension Pack desde VS Code Marketplace. Dos de las extensiones que se instalan automáticamente son Agentforce DX y Agentforce Vibes.
   
3. Instalar Salesforce CLI.
   
4. Instale Node.js.
   Instale Node.js de forma global en su ordenador ahora para poder ejecutar la secuencia de comandos de configuración más adelante en esta unidad.
   

Clonar el repositorio de muestra

Como ya hemos mencionado, su equipo de desarrollo ha empezado a trabajar en el agente Local Info Agent (Agente de información local) y ha registrado el código fuente en un repositorio de GitHub. El código fuente se organiza con un proyecto estándar de Salesforce DX, que proporciona una estructura de proyecto para los metadatos de su organización (código y configuración), datos de muestra y todas las pruebas de su equipo. Los agentes son como cualquier otro componente de una organización de Salesforce, ya que están compuestos de metadatos, de forma que emplea proyectos de DX para almacenarlos y trabajar con agentes.

Asegúrese de haber instalado Git en su ordenador para poder clonar el repositorio en VS Code. Si lo prefiere, puede descargar el repositorio de muestra como archivo ZIP y extraerlo todo localmente.

Siga estos pasos para utilizar Git a fin de clonar el repositorio de muestra para poder empezar a programar el agente.

1. Abra VS Code y haga clic en View | Command Palette (Ver | Paleta de comandos). Luego, seleccione Git: Clone (Git: Clonar).
   
2. Escriba https://github.com/forcedotcom/afdx-pro-code-testdrive como URL del repositorio.
   
3. Vaya al directorio en el que desea colocar el código fuente y, a continuación, haga clic en Select as Repository Destination (Seleccionar como repositorio de destino).
   
4. Haga clic en Abrir.
   

Un proyecto de Salesforce DX denominado afdx-pro-code-testdrive que se muestra en VS Code. Puede revisar el código existente si lo desea; en esta insignia se hablará de algunos artefactos relacionados con el agente más adelante.

Autorizar la organización de Developer Edition

Utilice el nombre de usuario y la contraseña de su organización de Developer Edition para autorizar a nivel local la organización de forma que VS Code y los comandos de la CLI funcionen con ella.

1. En VS Code, haga clic en View | Command Palette (Ver | Paleta de comandos). Luego, seleccione SFDX: Authorize an Org (Autorizar una organización).
   
2. Haga clic en Production (Producción).
   
3. Escriba agentforce para el alias de la organización.
   
4. En la ventana del navegador que se abre, inicie sesión en su organización de Developer Edition con sus credenciales.
   
5. Haga clic en Allow (Permitir), lo que permite que Salesforce CLI pueda acceder a su organización.
   Busque un mensaje en el que se lea Authentication Successful (La autenticación se ha completado).
   
6. Cierre la ventana del navegador.
   

Ahora, su organización de Developer Edition tiene autorización y se ha definido como organización predeterminada.

Ejecutar una secuencia de comandos para crear e implementar artefactos de la organización

El repositorio de muestra que ha clonado contiene los archivos de origen para los artefactos que implementan el nuevo agente Local Info Agent (Agente de información local), como clases de Apex, una plantilla de solicitud y un flujo. En este módulo no mostraremos la descripción de estos artefactos. Sin embargo, es necesario contar con ellos en su organización de Developer Edition para continuar con esta insignia de Trailhead, por lo que proporcionamos una secuencia de comandos en el repositorio que acaba de clonar.

Cuando ejecute la secuencia de comandos, se implementarán los archivos de origen, se asignarán los permisos y se creará un usuario agente. Los agentes de Agentforce se ejecutan como un usuario especializado con el perfil Einstein Agent User (Usuario agente de Einstein); este usuario es la identidad en ejecución de su agente.

1. Desde el terminal integrado de VS Code, ejecute la secuencia de comandos de configuración.
   ./setup(en macOS o Linux)
   setup.cmd (en Windows)
   
2. La secuencia de comandos muestra los pasos que se están ejecutando y aparece una marca de verificación en verde cuando el paso se completa correctamente.
   Importante: Guarde el nombre de usuario exclusivo que crea la secuencia de comandos, ya que lo necesitará en la siguiente unidad.
   
   

Ver los comandos del agente

Explore los comandos del agente antes de empezar a usarlos. La mayoría de los comandos de CLI tienen equivalentes de la paleta de comandos de VS Code, que también utilizará. Resulta útil visualizar todos los comandos de CLI para hacerse una idea general de lo que Agentforce DX puede hacer.

1. Desde el terminal integrado de VS Code, ejecute el comando sf search de la CLI para ver todos los comandos disponibles de agent (agente). Un resumen del comando que se muestra en la parte inferior a medida que navega por la lista.
   
   Para obtener información técnica sobre el complemento de Salesforce CLI que contiene los comandos de agent (agente), ejecute este comando.
   sf plugins inspect agent
2. Ejecute un comando con el indicador --help (ayuda) para ver información detallada sobre el mismo, como sus indicadores y ejemplos de cómo usarlo. Utilice -h para obtener información concisa.
   sf agent validate authoring-bundle --help

Esta insignia de Trailhead solo se centra en los comandos de CLI agent validate authoring-bundle y agent publish authoring-bundle o en sus equivalentes de VS Code.

Ahora que ya ha aprendido sobre Agentforce DX y ha configurado su entorno de desarrollo, vamos a lo divertido: programar un agente.

Recursos

• Salesforce Developers: Build Agents with Agentforce DX
• Salesforce Developers: Salesforce CLI Command Reference, agent Commands
• Salesforce Developers: Extensión Agentforce Vibes
• Salesforce Developers: How Salesforce Developer Experience (DX) Tooling Changes the Way You Work
• Salesforce Developers: Extensiones de Salesforce para Visual Studio Code
• Salesforce Developers: Salesforce CLI Setup Guide, Quick Start
• Ayuda de Salesforce: Diseñar e implementar agentes
• Trailhead: Conocer la nueva versión de Agentforce Builder