M365Con 2027 – conferencia online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Concepto

En el protocolo A2A, una tarjeta de agente (agent card) es un documento legible por máquinas que se publica en una URL conocida y describe el nombre del agente, sus capacidades, habilidades, endpoint, requisitos de autenticación y formatos de entrada y salida, para que otros agentes puedan descubrirlo.

✦ CONCEPTOAgent cardM365.FM
Title graphic: Agent card (Concepto)

También se tratan

Los episodios sobre Agent card tratan también Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming y AI Center of Excellence.

Descripción

Una tarjeta de agente es un documento legible por máquina que se utiliza en el protocolo Agent2Agent (A2A) para describir un agente. Se publica en una URL conocida y contiene metadatos como el nombre del agente, su descripción, versión, capacidades, habilidades, endpoint, requisitos de autenticación y los formatos de entrada y salida que admite. Su propósito principal es el descubrimiento: un cliente u otro agente puede leer la tarjeta para saber qué ofrece un agente antes de enviarle cualquier solicitud.

El protocolo A2A aborda la interoperabilidad entre agentes con un lenguaje estandarizado, lo que elimina la necesidad de código personalizado en cada interacción entre agentes. La tarjeta de agente es la parte de este enfoque que permite a un agente anunciar su identidad y sus capacidades. En lugar de asumir de forma fija las características de un agente remoto, un agente que realiza la llamada lee la tarjeta publicada y determina cómo llegar al agente y qué tipos de datos puede intercambiar.

La página de Microsoft Learn sobre el alojamiento de A2A en Microsoft Agent Framework muestra cómo se ve esto en la práctica. En el ejemplo de alojamiento con ASP.NET Core, la tarjeta se sirve en una ruta conocida que termina en agent-card.json. El método de mapeo que expone la tarjeta proviene del paquete del SDK de A2A y no de los paquetes de alojamiento de Agent Framework. La tarjeta de ejemplo define un nombre, una descripción y una versión, los modos predeterminados de entrada y salida, y una interfaz compatible que incluye una URL, un enlace de protocolo y una versión del protocolo. La página recomienda que la tarjeta esté completamente rellenada para uso en producción, de modo que los clientes reciban información completa sobre el agente al que van a llamar.

La documentación describe una limitación práctica relacionada con el alojamiento. Un único host puede publicar solo una tarjeta de agente en la ruta conocida, lo que significa que solo un agente es detectable allí. Otros agentes alojados junto a él siguen siendo accesibles a través de sus propias URL, pero los clientes deben conocer previamente esos endpoints, ya que la ubicación compartida no los enumera. Al planificar una implementación con varios agentes, esto afecta a cómo se diseña el descubrimiento y a cómo se comparte la información de los endpoints con los consumidores. La página de documentación no cubre las habilidades, los detalles de autenticación ni las firmas de la tarjeta, por lo que esos aspectos se describen aquí solo a nivel de la definición general.

El episodio "Agent-to-Agent (A2A) Communication - Simply Explained" aborda el concepto como parte de un debate más amplio sobre la interoperabilidad. Presenta la tarjeta de agente como el mecanismo mediante el cual los agentes anuncian su identidad y sus capacidades, lo que facilita el descubrimiento y la interacción. El mismo episodio relaciona esto con la comunicación estructurada, en la que los agentes intercambian distintos tipos de datos, lo que favorece la colaboración y el seguimiento del estado de las tareas. También subraya que la privacidad y la seguridad son aspectos centrales de la comunicación entre agentes, y que quienes trabajan con estos sistemas deben conocer los riesgos asociados al manejo de datos. Dado que una tarjeta de agente publica información sobre un agente y sobre cómo llegar a él, decidir qué incluir y cómo se controla el acceso forma parte de esa consideración de seguridad más amplia.

En resumen, la tarjeta de agente funciona como la descripción pública de un agente A2A. Los clientes la leen antes de enviar cualquier tarea, se sirve desde una ubicación predecible y debe estar completa y ser precisa en producción. La restricción de una sola tarjeta por ruta conocida en el ejemplo de alojamiento con ASP.NET Core es un punto de diseño que hay que tener en cuenta siempre que se exponga más de un agente desde el mismo host.

Resumen generado con IA a partir de los episodios de M365.FM y los datos de esta página. Puedes mejorarlo con el botón de edición de abajo.

TipoConcepto
TipoFormat

Preguntas frecuentes

Las preguntas marcadas con IA se escribieron con IA a partir de los datos de esta página.

¿Qué es una tarjeta de agente en el protocolo A2A? (IA)

Es un documento legible por máquina, publicado en una URL conocida, que describe el nombre de un agente, sus capacidades, habilidades, endpoint, requisitos de autenticación y formatos de entrada y salida para que otros agentes puedan descubrirlo.

¿Dónde se sirve la tarjeta de agente en el ejemplo de Microsoft Agent Framework? (IA)

En el ejemplo de alojamiento con ASP.NET Core se sirve en una ruta conocida que termina en agent-card.json, usando un método de mapeo del paquete del SDK de A2A y no de los paquetes de alojamiento de Agent Framework.

¿Puede un host publicar varias tarjetas de agente? (IA)

Según la página de Microsoft Learn, un único host puede publicar solo una tarjeta de agente en la ruta conocida, por lo que solo un agente es detectable allí; los demás agentes siguen accesibles mediante sus propias URL, que los clientes deben conocer previamente.

Glosario

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Expertos y empresas para este tema

Nadie ha indicado aún este tema. Añádelo a tu perfil.

Mantenido por Mirko Peters (Microsoft MVP) · Última actualización: