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.

# Creación y configuración de agentes manualmente
<a name="agents-create"></a>

# Requisitos previos para crear agentes de Amazon Bedrock
<a name="agents-prereq"></a>

Asegúrese de que su rol de IAM tenga los [permisos necesarios](security_iam_id-based-policy-examples-agent.md#iam-agents-ex-all) para realizar acciones relacionadas con los agentes de Amazon Bedrock.

Antes de crear un agente, revise los siguientes requisitos previos y determine cuáles debe cumplir:

1. Debe configurar al menos una de las siguientes opciones para el agente:
   + [Grupo de acciones](agents-action-create.md): define las acciones que el agente puede ayudar a realizar a los usuarios finales. Cada grupo de acciones incluye los parámetros que el agente debe obtener del usuario final. También puede definir las API a las que se puede llamar, cómo gestionar la acción y cómo devolver la respuesta. Para ver la cuota de grupos de acciones en un agente, consulte la cuota de **Action groups per Agent** en los [Amazon Bedrock endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/bedrock.html) en la Referencia general de AWS. Puede omitir este requisito previo si su agente no va a tener grupos de acciones.
   + [Bases de conocimientos](knowledge-base.md): proporcionan un repositorio de información que el agente puede consultar para responder a las consultas de los clientes y mejorar las respuestas generadas. Asociar al menos una base de conocimientos puede ayudar a mejorar las respuestas a las consultas de los clientes mediante el uso de orígenes de datos privados. Para ver la cuota de bases de conocimientos asociadas a un agente, consulte la cuota de **Associated knowledge bases per Agent** en los [Amazon Bedrock endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/bedrock.html) en la Referencia general de AWS. Puede omitir este requisito previo si no piensa asociar bases de conocimientos al agente.

1. (Opcional) [Cree un [rol de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) de AWS Identity and Access Management (IAM) personalizado para el agente con los permisos adecuados](agents-permissions.md). Puede omitir este requisito previo si tiene previsto usar la Consola de administración de AWS para crear automáticamente un rol de servicio.

1. (Opcional) Cree una [barrera de protección](guardrails.md) para implementar garantías para el agente y evitar comportamientos no deseados en las respuestas del modelo y en los mensajes de los usuarios. A continuación, podrá asociarla al agente.

1. (Opcional) Adquiera [Rendimiento aprovisionado](prov-throughput.md) para aumentar la cantidad y la tasa de tokens que el agente puede procesar en un período de tiempo determinado. A continuación, podrá asociarlo a un alias del agente al [crear una versión del agente y asociarle un alias](agents-deploy.md).

Para crear un agente con Amazon Bedrock, debe configurar los siguientes componentes:
+ La configuración del agente, que define el objetivo del agente y el modelo fundacional (FM) que utiliza para generar peticiones y respuestas.
+ Al menos uno de los siguientes:
  + Grupos de acciones que definen las acciones que debe ejecutar el agente.
  + Una base de conocimientos de orígenes de datos para aumentar las capacidades generativas del agente al permitir las búsquedas y las consultas.

Como mínimo, puede crear un agente que solo tenga un nombre. Para **preparar** un agente para que el usuario pueda [probarlo](agents-test.md) o [implementarlo](agents-deploy.md), se deben configurar como mínimo los siguientes componentes:


****  

| Configuración | Descripción | 
| --- | --- | 
| Rol de recurso del agente | Es el ARN del [rol de servicio que dispone de permisos para llamar a las operaciones de la API en el agente](agents-permissions.md). | 
| Modelo fundacional (FM) | Es un FM para que el agente lo invoque para realizar la orquestación. | 
| Instrucciones | Lenguaje natural que describe lo que debe hacer el agente y cómo debe interactuar con los usuarios. | 

También debe configurar al menos un grupo de acciones o una base de conocimientos para el agente. Si prepara un agente sin grupos de acciones ni bases de conocimientos, este devolverá las respuestas basándose únicamente en el FM y en las instrucciones y [plantillas de peticiones básicas](advanced-prompts.md).

Para obtener más información sobre cómo crear un agente, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:

------
#### [ Console ]

**Creación de un agente**

1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

1. En el panel de navegación de la izquierda, seleccione **Agentes**.

1. En la sección **Agentes**, elija **Crear agente**.

1. (Opcional) Cambie el **nombre** generado automáticamente para el agente y proporcione una **descripción** opcional para el agente.

1. Seleccione **Crear**. Se crea el agente y se le redirigirá al **Creador de agentes** del agente recién creado, donde podrá configurarlo.

1. Puede continuar con el siguiente procedimiento para configurar el agente o volver al creador de agentes más adelante.

**Configuración del agente**

1. Si aún no se encuentra en el creador de agentes, haga lo siguiente:

   1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

   1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**.

   1. Elija **Editar en el Creador de agentes**.

1. En la sección **Detalles del agente**, puede definir las siguientes configuraciones:

   1. Edite el **Nombre del agente** o la **Descripción del agente**.

   1. En **Rol de recurso del agente**, seleccione una de las siguientes opciones:
      + **Crear y utilizar un nuevo rol de servicio**: deje que Amazon Bedrock cree el rol de servicio y configure los permisos necesarios en su nombre.
      + **Utilizar un rol de servicio existente**: use un [rol personalizado](agents-permissions.md) que haya configurado previamente.

   1. En **Seleccionar modelo**, seleccione un FM para que su agente lo invoque durante la orquestación.

      De forma predeterminada, se muestran los modelos optimizados para los agentes. Para ver todos los modelos admitidos por los agentes de Amazon Bedrock, desactive **Optimizado para agentes de Bedrock**.  
![\[Puede crear agentes con cualquier modelo fundacional. Actualmente, algunos de los modelos que se ofrecen están optimizados con peticiones o analizadores ajustados para integrarse con la arquitectura de los agentes. Con el tiempo, tenemos previsto proporcionar una optimización para todos los modelos ofrecidos.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/agents/agents-optimized-model-selection.png)

   1. En **Instrucciones para el agente**, introduzca detalles para decirle al agente lo que debe hacer y cómo debe interactuar con los usuarios. Las instrucciones sustituyen al marcador de posición \$1instructions\$1 de la [plantilla de petición de orquestación](prompt-placeholders.md#placeholders-orchestration). A continuación se muestra un ejemplo de instrucciones:

      ```
      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.
      ```

   1. Si expande **Configuración adicional**, puede modificar las siguientes configuraciones:
      + **Intérprete de código**: (opcional) elija si desea permitir que el agente se encargue de las tareas que implican escribir, ejecutar, probar y solucionar problemas de código. Para obtener más información, consulte [Generación, ejecución y prueba del código con la interpretación del código](agents-code-interpretation.md).
      + **Entrada de usuario**: (opcional) elija si desea permitir que el agente solicite más información al usuario si no tiene suficiente información. Para obtener más información, consulte [Configuración del agente para solicitar información al usuario](agents-user-input.md).
      + **Selección de clave de KMS**: (opcional) De forma predeterminada, AWS cifra los recursos de los agentes con una Clave administrada de AWS. Para cifrar su agente con su propia clave administrada por el cliente, seleccione **Personalizar configuración de cifrado (avanzada)** en la sección de Selección de claves de KMS. Para crear una clave nueva, seleccione **Crear una clave de AWS KMS** y vuelva a actualizar esta ventana. Para usar una clave existente, seleccione una clave en **Elija una clave de AWS KMS**.
      + **Tiempo de espera de la sesión inactiva**: de forma predeterminada, si un usuario no ha respondido durante 30 minutos en una sesión con un agente de Amazon Bedrock, el agente ya no conservará el historial de conversaciones. El historial de conversaciones se utiliza tanto para reanudar una interacción como para aumentar las respuestas en función del contexto de la conversación. Para cambiar este período de tiempo predeterminado, introduzca un número en el campo **Tiempo de espera de la sesión** y elija una unidad de tiempo.

   1. En la sección **Permisos de IAM**, en **Rol de recurso del agente**, elija un [rol de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role). Para permitir que Amazon Bedrock cree el rol de servicio en su nombre, seleccione **Crear y utilizar un nuevo rol de servicio**. Para utilizar un [rol personalizado](agents-permissions.md) que haya creado antes, elija **Utilizar un rol de servicio existente**.
**nota**  
El rol de servicio que crea Amazon Bedrock para usted no admite permisos para las características que están en versión preliminar. Para utilizar estas características, [debe asociar los permisos correctos al rol de servicio](agents-permissions.md).

   1. (Opcional) De forma predeterminada, AWS cifra los recursos de los agentes con una Clave administrada de AWS. Para cifrar su agente con su propia clave administrada por el cliente, seleccione **Personalizar configuración de cifrado (avanzada)** en la sección **Selección de claves de KMS**. Para crear una clave nueva, seleccione **Crear una clave de AWS KMS** y vuelva a actualizar esta ventana. Para usar una clave existente, seleccione una clave en **Elija una clave de AWS KMS**.

   1. (Opcional) Para asociar etiquetas a este agente, en la sección **Etiquetas: opcional**, seleccione **Agregar nueva etiqueta** y proporcione un par clave-valor.

   1. Seleccione **Siguiente** cuando haya terminado de establecer la configuración del agente.

1. En la sección **Grupos de acciones**, puede elegir **Agregar** para añadir grupos de acciones a su agente. Para obtener más información sobre la configuración de grupos de acciones, consulte [Uso de grupos de acciones para definir las acciones que debe realizar el agente](agents-action-create.md). Para saber cómo agregar grupos de acciones a su agente, consulte [Agregación de un grupo de acciones al agente en Amazon Bedrock](agents-action-add.md).

1. En la sección **Bases de conocimiento**, puede elegir **Agregar** para asociar grupos de conocimiento a su agente. Para obtener más información sobre cómo configurar las bases de conocimientos, consulte [Recuperación de datos y generación de respuestas de IA con Bases de conocimiento de Amazon Bedrock](knowledge-base.md). Para obtener información sobre cómo asociar las bases de conocimiento a su agente, consulte [Aumento de la generación de respuestas para el agente con una base de conocimientos](agents-kb-add.md).

1. En la sección **Detalles de la barrera de protección**, puede elegir **Editar** para asociar una barrera de protección a su agente para bloquear y filtrar el contenido dañino. Seleccione una barrera de protección que desee utilizar en el menú desplegable de la sección **Selección de barrera de protección** y, a continuación, elija la versión que desee utilizar en la sección **Versión de barrera de protección**. Puede seleccionar **Ver** para ver la configuración de la barrera de protección. Para obtener más información, consulte [Detección y filtrado del contenido dañino mediante Barreras de protección para Amazon Bedrock](guardrails.md).

1. En la sección **Estrategia de orquestación**, puede elegir **Editar** para personalizar la orquestación del agente. Para obtener más información sobre la estrategia de orquestación que puede utilizar para su agente, consulte [Personalización de la estrategia de orquestación de agentes](orch-strategy.md).

1. En la sección **Colaboración entre múltiples agentes**, puede elegir **Editar** para crear un equipo de colaboración entre múltiples agentes. Para obtener más información sobre colaboración entre múltiples agentes, consulte [Uso de la colaboración entre múltiples agentes con Agentes para Amazon Bedrock](agents-multi-agent-collaboration.md).

1. Cuando termine de configurar su agente, seleccione una de las siguientes opciones:
   + Para permanecer en el **Creador de agentes**, seleccione **Guardar**. A continuación, puede **preparar** el agente para probarlo con las configuraciones actualizadas en la ventana de pruebas. Para saber cómo puede probar el agente, consulte [Prueba y solución de problemas de comportamiento del agente](agents-test.md).
   + Para volver a la página **Detalles del agente**, seleccione **Guardar y salir**.

------
#### [ API ]

Para crear un agente, envíe una solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html) (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

[Ver ejemplos de código](bedrock-agent_example_bedrock-agent_CreateAgent_section.md)

Para preparar el agente y probarlo o implementarlo de forma que usted pueda [probarlo](agents-test.md) o [implementarlo](agents-deploy.md), debe incluir como mínimo los siguientes campos (si lo prefiere, puede omitir estas configuraciones y configurarlas más adelante enviando una solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html)):


****  

| Campo | Caso de uso | 
| --- | --- | 
| agentResourceRoleArn | Para especificar un ARN del rol de servicio que dispone de permisos para llamar a las operaciones de la API en el agente. | 
| foundationModel | Para especificar un modelo fundacional (FM) con el que el agente pueda orquestar. | 
| instruction | Para proporcionar instrucciones que le indiquen al agente lo que debe hacer. Se utiliza en el marcador de posición \$1instructions\$1 de la plantilla de petición de orquestación. | 

Los siguientes campos son opcionales:


****  

| Campo | Caso de uso | 
| --- | --- | 
| description | Describe lo que hace el agente. | 
| idleSessionTTLInSeconds | Duración tras la cual el agente finaliza la sesión y elimina la información almacenada. | 
| customerEncryptionKeyArn | ARN de una clave de KMS para cifrar los recursos del agente. | 
| etiquetas | Para asociar [etiquetas](tagging.md) a su agente. | 
| promptOverrideConfiguration | Para [personalizar las peticiones](advanced-prompts.md) que se envían al FM en cada paso de la orquestación. | 
| guardrailConfiguration | Para añadir una [barrera de protección](guardrails.md) al agente. Especifique el ID o el ARN de la barrera de protección y la versión que se deben utilizar. | 
| clientToken | Para garantizar que la solicitud de la API se complete solo una vez. Para obtener más información, consulte [Ensuring idempotency](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). | 
| cachingState | Habilitar el almacenamiento en caché de peticiones de entrada en el agente. Para obtener más información, consulte [Almacenamiento en caché de peticiones para una inferencia de modelos más rápida](prompt-caching.md). | 
| reasoning\$1config | Permitir el razonamiento del modelo para que el modelo explique cómo llegó a sus conclusiones. Úselo dentro de un campo additionalModelRequestFields. Debe especificar el número de budget\$1tokens que se utilizan para el razonamiento del modelo, que son un subconjunto de los tokens de salida. Para obtener más información, consulte [Mejora de las respuestas de los modelos con el razonamiento de modelos](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-reasoning.html). | 

La respuesta devuelve un objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) que contiene detalles sobre el agente que se acaba de crear. Si no se puede crear el agente, la respuesta del objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) devolverá una lista de `failureReasons` junto con una lista de `recommendedActions` para que pueda solucionar los problemas.

```
    def create_agent(self, agent_name, foundation_model, role_arn, instruction):
        """
        Creates an agent that orchestrates interactions between foundation models,
        data sources, software applications, user conversations, and APIs to carry
        out tasks to help customers.

        :param agent_name: A name for the agent.
        :param foundation_model: The foundation model to be used for orchestration by the agent.
        :param role_arn: The ARN of the IAM role with permissions needed by the agent.
        :param instruction: Instructions that tell the agent what it should do and how it should
                            interact with users.
        :return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
        """
        try:
            response = self.client.create_agent(
                agentName=agent_name,
                foundationModel=foundation_model,
                agentResourceRoleArn=role_arn,
                instruction=instruction,
            )
        except ClientError as e:
            logger.error(f"Error: Couldn't create agent. Here's why: {e}")
            raise
        else:
            return response["agent"]
```

Para obtener más información, consulte [Introducción a Agentes de Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).

------