Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Publicación de productos de agentes de IA basados en contenedores
Gestión de agentes y herramientas de IA basados en contenedores
Los agentes y herramientas de IA basados en contenedores que se ejecutan en Amazon Bedrock AgentCore Runtime se pueden administrar a través de la página unificada de productos de agentes y herramientas de IA o la página de productos de servidor de la consola de administración de AWS Marketplace. Solo los productos con versiones compatibles con Amazon Bedrock AgentCore Runtime estarán visibles en la página de productos de agentes y herramientas de IA.
Inicio del asistente de publicación
-
Inicie sesión en AWS Marketplace Management Portal
con su cuenta de vendedor de AWS. -
Seleccione Productos y, a continuación, Agentes y herramientas de IA en la barra de navegación.
-
Seleccione el menú de productos Crear agentes y herramientas de IA y, a continuación, Agentes y herramientas de IA basados en contenedores.
-
Seleccione Generar ID y código de producto.
(Opcional) Añada etiquetas para admitir autorización basada en etiquetas.
-
Seleccione Continuar.
Paso 1: especificación de la información del producto
-
En Información del producto, introduzca:
-
Título del producto
-
URL de S3 del logotipo del producto
-
Descripción breve
-
Descripción larga
-
Aspectos destacados (1-3)
-
-
Introduzca los detalles de soporte y añada recursos de aprendizaje opcionales seleccionando Añadir recurso.
-
En el menú Categorías de productos, seleccione entre una y tres categorías. Le recomendamos que elija al menos una de las categorías empresariales de Agentes y herramientas de IA.
-
Introduzca palabras clave para mejorar la visibilidad en las búsquedas.
-
(Opcional) Añada recursos de vídeo e imagen de acuerdo con las pautas.
-
Elija Siguiente.
Paso 2: configuración de los precios de los agentes de IA basados en contenedores
-
Elija un modelo de precios.
AgentCore limitaciones de precios
Si se utiliza la imagen del contenedor AgentCore, no se admiten los modelos de precios por hora ni por uso con contratos a largo plazo. Para obtener más información sobre precios, consulte Contrata los precios de los productos en contenedores con AWS License Manager. Para obtener más información sobre la medición personalizada para precios basados en uso, consulte. Configuración de medición personalizada para productos de contenedores con AWS Marketplace Metering Service
-
Seleccione Siguiente.
-
En Establecer precios.
-
Seleccione Siguiente.
Paso 3: especificación de la política de reembolso
-
Introduzca una política de reembolsos.
-
Seleccione Siguiente.
nota
Si ha elegido el modelo de precios de productos gratuitos, no es necesario que introduzca una política de reembolso.
Paso 4: configuración del EULA
-
Elija Contrato estándar para AWS Marketplace o EULA personalizado.
nota
Si elige un EULA personalizado, introduzca una URL para el acuerdo de licencia de usuario final.
-
Seleccione Siguiente.
Paso 5: Añadir repositorios
-
Agregue un repositorio inicial para su producto de contenedor.
nota
Los nombres de repositorio debe ser únicos en todos los productos de su cuenta de vendedor. Puede tener hasta 50 repositorios por producto.
-
Seleccione Siguiente.
Paso 6: configuración de la disponibilidad de la oferta o la lista de permitidos
-
En Configurar la disponibilidad de la oferta, seleccione la configuración de disponibilidad geográfica.
-
Seleccione Siguiente.
-
En Configuración de la lista de permitidos, indique todas las cuentas de AWS que deberían tener acceso a la lista mientras estén en estado limitado.
-
Seleccione Enviar para crear una nueva solicitud de cambio para las pruebas de visibilidad limitada.
Espere de 10 a 15 minutos hasta que el estado de la solicitud sea Correcto.
Paso 7: carga de imágenes y artefactos de contenedores al repositorio
nota
Descubre Amazon Bedrock AgentCore Runtime para AWS Marketplace cómo integrarlo AgentCore con tu imagen de contenedor.
-
Localice la URL del repositorio de ECR:
-
Abra la página de productos de servidor en el Portal AWS Marketplace de administración.
-
Seleccione su producto de contenedor para ver los detalles.
-
Seleccione la pestaña Repositorios para copiar la URL del repositorio.
-
-
Seleccione Ver comandos de envío para abrir una lista de instrucciones, incluidos los comandos que puede usar para enviar imágenes de contenedores de Docker y gráficos de Helm a ese repositorio. Para obtener información general sobre cómo enviar imágenes de contenedores y otros artefactos a los repositorios, consulte Envío de una imagen en la Guía del usuario de Amazon Elastic Container Registry.
nota
Puede usar las siguientes operaciones de API de Amazon Elastic Container Registry (Amazon ECR) cuando se llama a docker pull o a docker push:
-
DescribeImages - Utilice esta opción para revisar los metadatos sobre las imágenes de un repositorio.
-
GetAuthorizationToken - Úselo para autenticarse antes de cargar los artefactos en el repositorio y, a continuación, utilice los comandos docker pull o docker push.
-
ListImages - Utilízalo para ver una lista de las imágenes que has introducido.
-
-
Utilice los comandos de la lista para enviar cualquier artefacto necesario de su repositorio local al AWS Marketplace repositorio de su producto.
nota
La etiqueta que proporciona en los comandos push se utiliza para diferenciar la versión del artefacto que está cargando en el repositorio. Use una etiqueta que tenga sentido para la versión de la que forman parte los artefactos.
-
Repita el procedimiento para cada imagen o artefacto del contenedor que necesite en su versión.
nota
Su versión puede incluir hasta 50 imágenes o artefactos de contenedores en cada opción de entrega. Consulte el siguiente procedimiento para obtener más información sobre las opciones de entrega.
-
Una vez que haya subido sus artefactos, estará listo para crear la versión de su producto.
nota
Las imágenes de su contenedor se escanean automáticamente para comprobar si cumplen Requisitos de productos basados en contenedores para AWS Marketplace. Para obtener más información, consulte Los contenedores escanean los productos para detectar problemas de seguridad.
Paso 8: adición de una nueva versión de producto con recursos
-
Abra la página de productos Agentes y herramientas de IA en AWS Marketplace Management Portal.
nota
Solo los productos contenedor con versiones compatibles con Amazon Bedrock AgentCore Runtime están visibles en la página de productos de agentes y herramientas de IA. Antes de añadir la primera versión, solo encontrará su producto en la página de productos para servidores del portal de administración de AWS Marketplace. Una vez que haya creado la versión para Amazon Bedrock AgentCore Runtime, encontrará su producto contenedor en la página de productos de AI Agents and Tools.
-
Seleccione su producto de contenedor y haga clic en el menú desplegable Solicitar cambios, seleccione Actualizar versiones y, después, Agregar nueva versión.
-
En Opciones de entrega, introduzca:
-
Version title
-
Notas de la versión
-
-
Seleccione Agregar opción de envío.
-
En Método de entrega, seleccione la imagen del contenedor y rellene:
-
Servicios compatibles: seleccione el entorno en el que los compradores pueden lanzar el software.
-
Para el AgentCore servicio Bedrock, seleccione AI Agent, MCP Server o A2A Server en el campo Tipo.
-
Imagen del contenedor: la URL del repositorio y la etiqueta de versión que especificó anteriormente.
-
Título de la opción de entrega y Descripción de la opción de implementación: introduzca un título y una descripción para esta opción de entrega.
-
Instrucciones de uso: introduzca información detallada para ayudar a los compradores a utilizar el software después de lanzarlo.
-
Variables de entorno: especifique las variables de entorno que los compradores deben proporcionar para configurar el comportamiento del agente en tiempo de ejecución. Estas variables se pueden usar para pasar configuraciones, credenciales o indicadores personalizados al contenedor al inicio. Para cada variable, proporciona el nombre esperado por el contenedor, una descripción y un valor predeterminado opcional. Para variables como las credenciales o las claves de API que son únicas, no proporciones un valor predeterminado. Puede usar la descripción para especificar detalles sobre la variable, así como los posibles valores. Todas las variables proporcionadas con sus valores predeterminados se rellenarán automáticamente cuando los compradores lancen tu producto.
-
Si seleccionó un agente de IA o un tipo de herramienta de servidor A2A, confirme que su agente utiliza el razonamiento LLMs y demuestra capacidades autónomas. Estos requisitos ayudan a garantizar que los agentes que se ofrecen en AWS Marketplace cumplan con un estándar de alta calidad. Si su agente no cumple ambos requisitos, elija un tipo de herramienta diferente.
-
Seleccione Agregar versión.
Espere y actualice la página hasta que el estado de la solicitud muestre Correcto.
Al agregar una nueva versión, se escanean automáticamente las imágenes del contenedor en busca de vulnerabilidades.
Paso 9: revisión de la publicación de productos y publicación de forma pública
-
Abra la página de productos Agente y herramientas de IA en AWS Marketplace Management Portal.
-
Seleccione su producto de contenedor en la lista.
-
Selecciona Ver activado. AWS Marketplace
-
Revise la página de detalles del producto para comprobar su precisión. Asegúrese de que las instrucciones de uso guíen al comprador de forma adecuada a lo largo de los pasos necesarios para iniciar su producto.
-
Envíe una solicitud de actualización de visibilidad al público:
-
En la página Productos de servidor, en la pestaña Producto de servidor actual, seleccione el producto basado en contenedor que desee modificar. En el menú desplegable Solicitar cambios, seleccione Actualizar visibilidad.
-
Detalles de la implementación de contenedores
La implementación de contenedores empaqueta su agente o herramienta de IA como una aplicación de contenedores que los clientes pueden ejecutar en sus propios entornos de AWS. Estas son las ventajas de este enfoque de enrutamiento:
-
Los datos permanecen en el entorno del cliente.
-
Configuraciones de implementación personalizables.
-
Integración compatible con Bedrock AgentCore Runtime y la infraestructura existente del cliente
Cuando anuncie un agente en un contenedor, proporcione instrucciones de implementación claras, los requisitos de recursos y las opciones de configuración para garantizar una implementación correcta para el cliente.
Requisitos técnicos para Bedrock Runtime Containers AgentCore
nota
Consulte Amazon Bedrock AgentCore Runtime para AWS Marketplace para obtener más detalles.
Al crear productos de agentes de IA basados en contenedores para AWS Marketplace, siga estos requisitos:
- Requisitos del servidor MCP
-
-
Transporte: solo HTTP sin estado que se puede transmitir.
-
Administración de sesiones: la plataforma agrega automáticamente un encabezado de
Mcp-Session-Idpara aislar la sesión. -
Host: el contenedor debe escuchar en el
0.0.0.0. -
Puerto: el contenedor debe exponer el puerto
8000para la comunicación del servidor MCP. -
Ruta:
/mcp- Punto final POST para recibir mensajes MCP RPC. InvokeAgentRuntime ya que los servidores MCP transferirán las solicitudes a esta ruta. -
Protocolo: el servidor MCP debe ser compatible con el protocolo MCP, incluidos los mensajes de protocolo 'tools/list' and 'tools/call' (compatibles con un marco común como FastMCP).
-
- Requisitos del agente
-
-
Punto de conexión /ping: obtener el punto de conexión para las comprobaciones de estado
-
Punto de conexión /invocations: punto de conexión POST para las interacciones entre los agentes
-
Docker Container: paquete de despliegue en contenedores ARM64
-
Puerto: el contenedor debe exponer el puerto
8080para la comunicación del agente basada en HTTP -
Credenciales no codificadas
-
Libre de vulnerabilidades y exposiciones comunes () CVEs
-
- Requisitos del servidor A2A
-
-
Puerto: los servidores A2A se ejecutan en el puerto 9000 (frente al 8080 para HTTP y 8000 para el MCP)
-
Host: el contenedor debe escuchar en el
0.0.0.0. -
Ruta: los servidores A2A se montan en
/(en vez de en el caso del HTTP, en/invocationsel del MCP)/mcp -
Tarjetas de agente: el A2A ofrece una función integrada de detección de agentes mediante tarjetas de agente en
/.well-known/agent-card.json -
Protocolo: utiliza JSON-RPC para la comunicación agent-to-agent
-
Autenticación: admite los esquemas de autenticación SigV4 y 2.0 OAuth
-
- Instrucciones de uso
-
Asegúrese de que las instrucciones guíen minuciosamente a los clientes durante el lanzamiento y la configuración del producto. Consulte Creación de una AMI y de instrucciones de uso de productos de contenedor para AWS Marketplace.
Pruebas y validación
Antes de publicar su agente o herramienta compatible con MCP, pruebe la implementación al detalle:
-
Compruebe que las instrucciones de uso proporcionen la información necesaria para iniciar y configurar el producto.
-
Pruebe los flujos de autenticación y el control de errores.
-
Valide el rendimiento en diferentes condiciones de carga.
-
Garantice la compatibilidad con los clientes MCP más populares.
-
Documente cualquier requisito de configuración específico del cliente.
Prácticas recomendadas y recomendaciones
Requisitos de documentación
Cuando incluya un agente o una herramienta compatibles con el Model Context Protocol AWS Marketplace, incluya documentación completa:
-
Descripciones y ejemplos detallados de las capacidades
-
Instrucciones de autenticación y configuración
-
Código de ejemplo para escenarios de integración comunes
-
Guías de resolución de problemas y referencia de errores
-
Consideraciones de rendimiento y prácticas recomendadas
Recursos adicionales
Para obtener más información sobre la implementación del protocolo de contexto para modelos en su agente o herramienta de IA, consulte estos recursos:
