View a markdown version of this page

Comience a usar las instancias con la consola - Base amazónica AgentCore
Paso 1: Crear un proveedor de capacidadPaso 2: Crea un tiempo de ejecución de agente que utilice el proveedor de capacidadPaso 3: Invocar y supervisarPaso 4: LimpiarSiguientes pasos

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.

Comience a usar las instancias con la consola

En este tutorial se explica cómo alojar un agente en el tipo de procesamiento de la instancia mediante la consola AWS de administración. En primer lugar, debe crear un proveedor de capacidad que defina la infraestructura de EC2 y, a continuación, crear un agente en tiempo de ejecución que lo utilice y, por último, invocar y supervisar el agente.

Para conocer los requisitos previos, consulte Introducción a las instancias.

Paso 1: Crear un proveedor de capacidad

  1. Abra la AgentCore consola de Amazon Bedrock y seleccione Runtime.

  2. En la pestaña Proveedores de capacidad, elija Crear proveedor de capacidad.

  3. En Detalles del proveedor de capacidad, introduzca un nombre. Los caracteres válidos son letras, dígitos y guiones bajos; el nombre debe empezar por una letra y puede tener hasta 48 caracteres.

  4. Para el sistema operativo, elija el sistema operativo para sus instancias EC2 (por ejemplo, Linux (x86 de 64 bits)). Esto determina qué software y aplicaciones son compatibles con su entorno.

  5. En el caso de los tipos de instancias permitidos, elija hasta 30 tipos de instancias EC2 que cumplan con sus requisitos de carga de trabajo. Filtre por vCPU, memoria y fabricante de CPU para encontrar el que mejor se adapte a sus necesidades.

  6. En Seguridad, elige la VPC que controle el acceso a la red para tus instancias. Si lo desea, configure las subredes y el modo de red de contenedores en Detalles adicionales.

  7. (Opcional) En Configuración de almacenamiento, seleccione Agregar volumen para adjuntar un volumen de Amazon EBS para el almacenamiento persistente. Configure el tipo, el tamaño, el rendimiento, las IOPS y el cifrado del volumen. Esto guarda la configuración del volumen y AgentCore crea cada volumen en el primer inicio de la sesión.

  8. En Acceso al servicio, elija el perfil de instancia adjunto a la instancia EC2 (que se usa AgentCore para recopilar los registros del sistema; no otorga permisos al código de agente) y el rol de infraestructura (que se usa AgentCore para administrar las instancias EC2 en su nombre). Puede usar los roles existentes o dejar que la consola cree otros nuevos.

  9. Elija Creación de proveedores de capacidad El proveedor de capacidad comienza en un CREATING estado y pasa a ser ACTIVE después de validar su configuración.

nota

Una vez creado un proveedor de capacidad, solo se puede editar su descripción. Para cambiar otras configuraciones, como los tipos de instancia, las redes o el almacenamiento, duplique el proveedor de capacidad y realice las actualizaciones en el flujo duplicado.

Paso 2: Crea un tiempo de ejecución de agente que utilice el proveedor de capacidad

  1. En la página de tiempo de ejecución, elija Crear tiempo de ejecución (o, en la página de detalles del proveedor de capacidad, elija Host agent/tool).

  2. Introduzca un nombre para el agente o la herramienta.

  3. Para el tipo de procesamiento, elija Instancias.

  4. Para el proveedor de capacidad, elija un proveedor de capacidad existente o elija Creación rápida para crear uno con los valores predeterminados preconfigurados en línea.

  5. En Agent/tool Fuente, elige el tipo de fuente y proporciona el artefacto:

    • Fuente de S3: empieza a partir de una plantilla, sube un .zip archivo o elige un objeto existente en un bucket de S3.

    • Contenedor ECR: proporcione un URI de imagen de contenedor de Amazon ECR.

  6. (Opcional) Configure la autenticación entrante, las configuraciones avanzadas (seguridad, variables de entorno) y los permisos (rol de ejecución de IAM y cifrado de KMS).

  7. Elija Crear tiempo de ejecución. AgentCore crea la versión 1 y un DEFAULT punto final que apunta a ella.

nota

No puedes cambiar el tipo de procesamiento después de crear el motor de ejecución.

Paso 3: Invocar y supervisar

  1. En la página de detalles del tiempo de ejecución, elige Probar y proporciona una carga útil, o usa el fragmento de código de invocación View para llamar al agente desde tu propia aplicación.

  2. La primera invocación de una nueva sesión aprovisiona una instancia EC2 en tu cuenta y lanza el agente, por lo que normalmente tarda más que en las invocaciones posteriores. Las invocaciones posteriores a la misma sesión son mucho más rápidas. AgentCore aprovisiona la instancia como una instancia gestionada por Amazon EC2, que de forma predeterminada no aparece en las vistas de la consola de EC2. DescribeInstances Para obtener más información sobre la visibilidad de las instancias administradas, consulte la configuración de visibilidad de los recursos administrados.

  3. Usa las métricas de observabilidad, los registros y el seguimiento de la página de detalles del tiempo de ejecución para supervisar las sesiones, las invocaciones, la tasa de errores y el consumo de recursos.

Paso 4: Limpiar

Para evitar que se te cobren continuamente las instancias de Amazon EC2 y los volúmenes de Amazon EBS aprovisionados en tu cuenta, limpia los recursos que creaste para este tutorial cuando hayas terminado:

  1. Elimine la sesión para AgentCore desaprovisionar la instancia EC2 y sus volúmenes persistentes. Detener el tiempo de ejecución de un solo agente en una sesión no termina la instancia. Para obtener más información sobre las operaciones de la API, consulta Cómo empezar a usar las instancias mediante la AWS CLI o el SDK.

  2. Para desvincular el tiempo de ejecución del proveedor de capacidad, elimina el tiempo de ejecución, sus puntos finales o sus versiones.

  3. Elimine el proveedor de capacidad una vez que ningún tiempo de ejecución haga referencia a él.

Siguientes pasos