

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
<a name="runtime-instances-get-started-console"></a>

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 ](runtime-instances-how-it-works.md#runtime-instances-capacity-provider) 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. ](runtime-instances-getting-started.md)

## Paso 1: Crear un proveedor de capacidad
<a name="runtime-instances-console-create-cp"></a>

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

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

1. 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.

1. 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.

1. 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.

1. 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. **

1. (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.

1. 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.

1. 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
<a name="runtime-instances-console-create-runtime"></a>

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**).

1. Introduzca un ** nombre ** para el agente o la herramienta.

1. Para el tipo de ** procesamiento**, elija ** Instancias**.

1. 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.

1. 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.

1. (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).

1. 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
<a name="runtime-instances-console-invoke"></a>

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.

1. 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html), 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. ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings)

1. 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
<a name="runtime-instances-console-cleanup"></a>

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](runtime-instances-get-started-cli.md).

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

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

## Siguientes pasos
<a name="runtime-instances-console-next-steps"></a>
+  [Instancias](runtime-instances-how-it-works.md) 
+  [Compare los tipos de procesamiento ](runtime-instances-how-it-works.md#runtime-instances-compute-comparison) 
+  [Modelo de seguridad y permisos para las instancias en tiempo de ejecución ](runtime-instances-security.md) 