Conéctese a su agente

Registra el flujo de trabajo de la API como una herramienta en tu agente de Monster Selector y actualiza el esquema de entrada del agente.

Con el flujo de trabajo publicado, está disponible en el Agent Builder como una herramienta conectable.

Paso 2: abre el agente Selector de Monster

En Studio Web, navega a tu solución MonsterSelector y ábrela en el Agent Builder.

Tómate un momento para orientarte en su estado actual antes de realizar cambios:

• Entrada: questDescription (cadena) y monsters (matriz de candidatos aprobados por la persona que llama)
• Salida: monsterIndex (string): el slug del monstruo elegido
• Solicitud del sistema: indica al agente que elija la mejor coincidencia de la lista proporcionada

En este lab, se elimina la entrada monsters y el requisito de rellenar previamente los candidatos. El agente los obtiene por sí mismo utilizando la herramienta que acabas de crear.

---

Paso 3: conectar el flujo de trabajo de la API como herramienta

Añadir la herramienta

Asegúrate de estar en la vista Lienzo : utiliza el botón Lienzo/Formulario en la parte superior de Agent Builder. El botón + en Herramientas solo es visible en la vista de Lienzo.

1. En el lienzo del agente, selecciona + en Herramientas.
2. En el panel Caja de herramientas , selecciona Flujo de trabajo de API.
3. En el panel Recursos disponibles , selecciona el flujo de trabajo que creaste en el paso 1.

Nota:

¿Los recursos disponibles están vacíos? El flujo de trabajo debe publicarse antes de que aparezca aquí. Vuelve al paso 1 y completa el subpaso Publicar en tu fuente , luego vuelve e inténtalo de nuevo.

Configurar la descripción de la herramienta

Asigna un nombre y una descripción a la herramienta. La descripción es lo que el agente lee en runtime para decidir cuándo y cómo llamar a la herramienta; escríbelo como una instrucción para el agente, no como una etiqueta para humanos:

• Nombre: Monster Query
• Descripción: Searches the D&D 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with name, type, CR, size, alignment, and description. Call this tool when you need to find monster candidates for a quest.

Nota:

La descripción impulsa la selección de herramientas. El agente lee esta descripción, no el nombre de la herramienta, para decidir cuándo y cómo llamar a la herramienta. Una descripción vaga produce un uso vago de la herramienta. Sea específico sobre lo que devuelve la herramienta y cuándo utilizarla.

---

Paso 4: actualizar el contrato del agente

Con la herramienta conectada, actualiza la definición del agente para reflejar el nuevo contrato: el agente ya no necesita una lista de monstruos rellenada previamente, y ahora devuelve datos estructurados de monstruos, incluido su propio razonamiento.

Los tres cambios en este paso funcionan juntos: eliminar monsters pone fin a la dependencia del agente de la persona que llama para los datos; el esquema de salida declara lo que el agente se compromete a devolver; la solicitud actualizada le dice al agente cómo utilizar su nueva capacidad. Ninguno de los tres funciona sin los demás.

Para editar la definición del agente, selecciona el nodo del agente en el lienzo para abrir el panel de definición a la derecha.

Eliminar monstruos de la entrada

En la definición del agente, elimina la propiedad monsters del esquema de entrada. La entrada actualizada solo debe tener questDescription.

Para eliminar la propiedad monsters :

1. Dentro del agente, abre Data Manager seleccionando el icono Abrir Data Manager en la barra de navegación izquierda (parece un portapapeles).
2. El panel Gestor de datos tiene tres agrupaciones: Entradas, Salidas y Variables; monsters debe estar en la lista Entradas .
3. monsters para revelar los iconos de edición y eliminación a la derecha de la etiqueta: un icono de lápiz (editar) y un icono de papelera (eliminar).
4. Selecciona el icono Eliminar para eliminar monsters.

Ahora solo deberías tener una entrada: questDescription:

Campo	Tipo	Obligatorio	Descripción
questDescription	String	Sí	Descripción de la misión

Añadir el esquema de salida

Añade un esquema de salida con los cinco campos de la tabla de diseño en Qué estás creando.

Dentro del mismo panel de Data Manager :

1. Señala el encabezado Salidas para revelar el icono Añadir propiedad (+).
2. Selecciona Añadir propiedad para añadir cada uno de los siguientes campos:

Campo	Tipo
monsterIndex	String
monsterName	String
monsterType	String
monsterCr	String
monsterReasoning	String

Nota:

monsterReasoning es generado por el agente, no desde la API. El agente escribe este campo: es la explicación del agente de por qué el monstruo seleccionado se ajusta a la búsqueda. A diferencia de los otros cuatro campos (que provienen de los resultados de la herramienta), monsterReasoning refleja el propio juicio del agente.

Actualizar la solicitud del sistema

Para abrir el panel Propiedades , selecciona el agente en el lienzo o selecciona el icono de llave inglesa en la esquina superior derecha. Sustituye el mensaje del sistema por:

You are a quest classifier for an adventurer's guild. Given a quest description, your job is to find the most thematically appropriate monster from the D&D 5e SRD and to return information about that monster.

When given a quest description:
1. Analyze the quest to determine what kind of creature fits the context - consider creature type, challenge rating, environment, and theme.
2. Call the Monster Query tool with a search term that targets that creature type.
3. Review the returned candidates and select the best fit for the quest.
4. Return the selected monster's key fields and a monsterReasoning that explains why this monster fits the quest.

Always call the Monster Query tool before selecting a monster. Do not guess monster details from memory.

Importante:

Los agentes de codificación no son deterministas. Tu solicitud producirá resultados diferentes a los del ejemplo anterior; que se espera. Lo que importa es que el agente llame a la herramienta, razone sobre los candidatos y devuelva los cinco campos de salida necesarios.

---

Con la herramienta conectada y el contrato del agente actualizado, estás listo para probar el proceso completo en la siguiente sección.