Propagación y observabilidad del paquete de configuración
Cuando la pasarela resuelve un paquete de configuración mediante reglas, propaga el paquete a los servicios descendentes a través de los cabezales de equipaje OpenTelemetry (Otel). Esto permite gestionar la configuración de principio a fin en toda la arquitectura de la puerta de enlace y del agente.
Cómo se propagan los paquetes de configuración
La pasarela establece el ARN y la versión del paquete resueltos en el equipaje de Otel mediante las siguientes claves:
| Llave de equipaje | Description (Descripción) |
|---|---|
|
|
El ARN del paquete de configuración resuelto. |
|
|
La versión del paquete de configuración resuelto. |
El flujo de propagación funciona de la siguiente manera:
-
La puerta de enlace evalúa las reglas y resuelve un paquete de configuración.
-
La pasarela establece el ARN y la versión del paquete en las cabeceras de equipaje de Otel en la solicitud saliente.
-
El agente recibe la solicitud junto con las cabeceras de equipaje. Usted controla el tiempo de ejecución. Si es necesario, su código de agente puede leer el ARN y la versión del paquete de configuración del equipaje del Otel.
-
Si el agente invoca una pasarela con objetivos MCP, la pasarela lee el paquete del equipaje del Otel y anula la descripción de la herramienta en las respuestas.
tools/listPara obtener más información, consulte Comportamiento de los objetivos del MCP.
Comportamiento de los objetivos del MCP
La puerta de enlace aplica anulaciones de paquetes de configuración en los destinos MCP solo para la ruta. tools/list Las search_tool rutas invoke_tool y no admiten la anulación de paquetes de configuración.
Por ejemplo, si un paquete de configuración anula la descripción de la herramienta de un objetivo, la descripción actualizada aparece en tools/list las respuestas, pero no en search_tool las respuestas.
Para aplicar estas anulaciones, la pasarela llama GetConfigurationBundleVersion para leer el contenido del paquete. Añada este permiso a la función de ejecución de la puerta de enlace:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "bedrock-agentcore:GetConfigurationBundleVersion", "Resource": "arn:aws:bedrock-agentcore:us-west-2:123456789012:configuration-bundle/*" } ] }
nota
Este permiso solo es necesario en la función de ejecución de la puerta de enlace para tools/list las operaciones de MCP. El motor de ejecución del agente transfiere el paquete sin acceder a él y no necesita este permiso.
Restricciones
-
El paquete de configuración debe estar en la misma cuenta que la puerta de enlace. Cross-account no se admite el acceso a paquetes.
-
Las pasarelas con destinos HTTP no leen los paquetes de configuración del equipaje de Otel. Solo resuelven los paquetes mediante sus propias reglas. Si pasa un paquete de equipaje de Otel a una puerta de enlace con destinos HTTP, la puerta de enlace lo ignora.
-
Las pasarelas con destinos MCP leen los paquetes de configuración del equipaje de Otel y solo anulan la ruta.
tools/list
Observabilidad para la resolución de reglas
Cuando la puerta de enlace resuelve las reglas de una solicitud, emite atributos de intervalo en el intervalo del servidor de puerta de enlace. Puede usar estos atributos para observar qué versión del paquete de configuración y qué decisiones de enrutamiento se aplicaron.
El paquete de configuración anula los atributos
| Atributo Span | Description (Descripción) |
|---|---|
|
|
El ARN del paquete de configuración resuelto. |
|
|
La versión del paquete de configuración resuelto. |
Atributos de enrutamiento objetivo
| Atributo Span | Description (Descripción) |
|---|---|
|
|
El nombre del objetivo resuelto. |
Utilice estos atributos para comprobar que las reglas se resuelven según lo esperado y para solucionar problemas de comportamiento de enrutamiento.
