Adición de una herramienta para una acción empresarial
Después de elegir un tipo de herramienta, agregue la herramienta al agente y la configure para las búsquedas y acciones que necesita el agente de ayuda. En esta unidad, aprenderá a agregar una herramienta existente y a configurar su conexión, acciones y entradas mediante un conector de SharePoint que controla una búsqueda de estado y una nueva solicitud como ejemplo de trabajo.
Distinguir una acción del conector de su conexión
Un conector encapsula la API de un servicio y expone las operaciones que admite como acciones. Cada acción realiza un trabajo. El conector SharePoint, por ejemplo, incluye Obtener elementos y Obtener elemento para leer elementos de lista y Crear elemento para agregar uno. Cuando agregas un conector como herramienta, las acciones que pongas a disposición son las que el orquestador puede invocar.
Una conexión es el vínculo autenticado que usa la herramienta para llegar al servicio. La acción define lo que hace la herramienta y la conexión permite que la herramienta llegue al servicio para hacerlo. Cuando una herramienta necesita una conexión, inicie sesión o proporcione credenciales como parte de la configuración.
Mantenga las dos ideas separadas a medida que configure una herramienta. Una conexión que falta o ha expirado impide que se ejecuten acciones que dependan de ella. Un conjunto de acciones mal elegido proporciona al orquestador las opciones incorrectas.
Añadir una herramienta existente desde la pestaña Compilar
En los pasos siguientes se muestra la ruta de acceso común para agregar una herramienta existente. La ruta de acceso es la misma para cada tipo de herramienta hasta que se selecciona una herramienta:
- Inicie sesión en Copilot Studio y abra su agente.
- En la barra de navegación del agente, selecciona la pestaña Construir .
- En el panel de componentes, selecciona el botón de herramientas .
- En el cuadro de diálogo Añadir una herramienta, explore o busque una herramienta. Para filtrar por tipo de herramienta, use la pestaña Destacado, Protocolo de contexto de modelo (MCP),Conectores o Flujos de trabajo .
- Selecciona una herramienta para ver sus detalles, incluyendo una descripción y las acciones que ofrece.
- Selecciona Agregar.
Para el agente de ayuda, cambie a la pestaña Conectores del paso 4 o busque SharePoint y, a continuación, seleccione el conector de SharePoint. El paso 5 es un punto de control útil. Antes de seleccionar Agregar, compare las acciones que enumera la herramienta con la búsqueda y la acción que identificó para el requisito. Si ninguna de las acciones enumeradas se ajusta al requisito, busque otra herramienta antes de agregarla.
Obtenga más información en Incorporación de una herramienta a un agente.
Gestiona una herramienta que tu organización bloquea
Las directivas de gobernanza de la organización, como las directivas de datos, pueden restringir qué herramientas y conectores están disponibles. Este comportamiento se encuentra actualmente en versión preliminar. Aparece una herramienta bloqueada deshabilitada en el cuadro de diálogo Agregar una herramienta y no se puede seleccionar. Para averiguar por qué, mantenga el puntero sobre el icono de cruz junto a la herramienta. El mensaje identifica la restricción de directiva que se aplica.
No puedes cambiar una restricción de directiva desde tu agente. Póngase en contacto con el administrador para preguntar si se puede permitir la herramienta o si existe una alternativa aprobada.
Los entornos no permiten todos los mismos conectores. Si el conector de SharePoint no está disponible, practique con un conector que permita su organización y que ofrezca un par de acciones similares: uno que lee un registro y otro que crea un registro. Las decisiones de configuración en el resto de esta unidad se aplican de la misma manera.
Configurar la herramienta después de agregarla
Después de agregar una herramienta, complete su configuración antes de que el agente se base en ella:
- Autenticar: Algunas herramientas requieren que inicies sesión o proporciones credenciales antes de poder utilizarlas. Siga las indicaciones de autenticación.
- Seleccionar acciones: en el caso de los conectores que proporcionan varias acciones, seleccione qué acciones específicas estarán disponibles para el agente.
- Revise la descripción: compruebe que la descripción refleja con precisión lo que hace la herramienta. El entorno de ejecución de orquestación usa la descripción para determinar cuándo invocar la herramienta.
Elija acciones deliberadamente. El agente de ayuda necesita una acción de lectura del conector de SharePoint para la búsqueda de estado y Crear elemento para las nuevas solicitudes. Si el número de solicitud es el identificador de SharePoint del elemento, Get item lo recupera por id. Si el número de solicitud se almacena en otra columna, Get items necesita un filtro que identifique ese registro. Haga que solo esté disponible la acción de lectura que coincida con la lista y Crear elemento . Esto limita las operaciones que el agente puede realizar en la lista. Una acción que se omite es una que el agente no puede invocar.
Configuración de entradas para la herramienta
En la pestaña Compilar , las herramientas del agente aparecen en el panel componentes, debajo del botón Herramientas . Seleccione una herramienta para abrir el cuadro de diálogo Detalles de la herramienta , donde trabajará en los paneles siguientes:
- Detalles: actualice el nombre y la descripción para mejorar cómo decide el agente cuándo usar la herramienta. También puede actualizar las credenciales de autenticación si expiran.
- Entradas: Configure los valores que se pasan a la herramienta cuando se invoque. Para conectores con múltiples acciones, añade o elimina acciones específicas.
- Salidas: vea las salidas que devuelve la herramienta en el planificador.
Después de realizar cambios, seleccione Guardar.
En el panel Entradas , ordene cada valor de entrada en uno de los dos grupos. Algunos valores permanecen iguales en cada llamada. Para el agente de ayuda, el sitio de SharePoint y la lista que realiza un seguimiento de las solicitudes son los mismos para cada empleado. Otros valores proceden de la propia solicitud, como el identificador del elemento para Obtener elemento, un filtro para Obtener elementos o los detalles de una nueva solicitud. Para cada acción, decida a qué grupo pertenece cada entrada y compruebe que la configuración coincide con esa decisión. Una búsqueda en una lista incorrecta o una acción de creación que espera que el empleado indique el sitio es un problema de configuración que las pruebas ponen de manifiesto más adelante.
El panel Salidas muestra lo que devuelve la herramienta. Saber qué devuelve cada acción para que pueda comprobar los resultados más adelante. Para la consulta de estado, el valor que te interesa es el estado del elemento, que comparas con el elemento de la lista cuando pruebas la herramienta.
Si quita una herramienta más adelante, seleccione la X junto a la herramienta y, a continuación, seleccione Quitar. Al quitar una herramienta, solo se elimina su asociación con el agente. El conector subyacente, el servidor MCP o la configuración de API permanecen en su lugar.
Obtenga más información en Administración y eliminación de herramientas en un agente.
Confirmación del acceso que usa la conexión
La conexión determina qué cuenta alcanza el servicio y los permisos de esa cuenta limitan lo que la herramienta puede leer o cambiar. Antes de que otros empleados confíen en la herramienta, confirme cuya conexión ejecuta cada acción en lugar de asumir que usa la cuenta del creador o del empleado. Pruebe el acceso como usuario previsto. Para el agente de soporte, verifique que una consulta de estado no pueda revelar la solicitud de otro empleado simplemente porque alguien conozca su número. Una instrucción para solicitar un número de solicitud no aplica el control de acceso.
Si la herramienta notifica un error de conexión, compruebe que las credenciales están actualizadas y que el servicio está disponible. Puede actualizar las credenciales expiradas en el panel Detalles del cuadro de diálogo Detalles de la herramienta .
Reflexiona: Elige una acción que necesite un agente que estás planificando o creando. ¿Cuál de sus entradas debe permanecer igual en cada llamada y cuál debe provenir de lo que el usuario pregunta?
Más adelante en este módulo, explorará cómo refinar el nombre y la descripción de la herramienta para que el agente lo llame para las solicitudes correctas y cómo probar la herramienta en versión preliminar para confirmar que se ejecuta con las entradas y el resultado correctos.