New Relic AI para Amazon Q Business

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

El complemento personalizado New Relic AI para Amazon Q Business integra la información valiosa impulsada por inteligencia artificial de New Relic directamente en el entorno de Amazon Q Business. Este complemento le permite enviar símbolos de usuario a New Relic AI y recibir respuestas generadas por IA, lo que facilita una mejor respuesta a incidentes y procesos de toma de decisiones.

Esta guía proporciona instrucciones para establecer una conexión entre New Relic AI y Amazon Q Business, lo que permite la detección de anomalías, la alerta en tiempo real y la gestión de incidentes para mantener el rendimiento y la confiabilidad de la aplicación.

Requisitos previos

Una cuenta New Relic válida con el ID de cliente y el secreto de cliente. Si no los tiene, comunicar con agenticai\@newrelic.com.
Una aplicación Amazon Q Business operativa. Para obtener más información sobre cómo crear un entorno de aplicación de Amazon Q Business, consulte la documentación de Amazon Q Business.
AWS CLI está instalado y configurado en su sistema. Para obtener más información, consulte la documentación de AWS CLI.
Licencias para crear políticas y roles de IAM en AWS.
Licencias para crear complementos en el servicio Amazon Q Business.
Una política y una función de IAM que otorgan al complemento New Relic AI licencias para acceder a los recursos de AWS. Para obtener más información, consulte Crear política y rol de IAM.

Crear una política y un rol de IAM

Cree una política y una función de IAM que otorguen al complemento New Relic AI licencias para acceder a los recursos de AWS. La política define licencias para acceder a servicios como AWS Secrets Manager, mientras que el rol permite que Amazon Q Business asuma estas licencias de forma segura. Esta configuración garantiza el control de acceso basado en roles y minimiza la gestión directa de credenciales.

Importante

Antes de crear una función de IAM, comunicar con New Relic para obtener el ID y el secreto del cliente.

Para crear una política de IAM, actualice y ejecute el siguiente comando:
bash
```
$aws iam create-policy \
>--policy-name <policy-name> \
>--policy-document '{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": "secretsmanager:GetSecretValue", "Resource": "arn:aws:secretsmanager:<region>:<account-id>:secret:<secret-name>" }] }'
```
- Reemplace <policy-name> con el nombre de su política.
- Reemplace <region> con su región de AWS.
- Reemplace <account-id> con el ID de su cuenta de AWS.
- Reemplace <secret-name> con el secreto proporcionado por New Relic.

Para crear un rol de IAM, ejecute el siguiente comando:

bash

$aws iam create-role \
>    --role-name <role-name> \
>    --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": { "Service": "qbusiness.amazonaws.com" }, "Action": "sts:AssumeRole" }] }'

Reemplace <role-name> con un nombre para identificar el rol.

Para anexar la política al rol, actualice y ejecute el siguiente comando:
bash
```
$aws iam attach-role-policy \
>--role-name <role-name> \
>--policy-arn arn:aws:iam::<account-id>:policy/<policy-name>
```
- Reemplace <policy-name> con el nombre de la política creada en el paso 1.
- Reemplace <role-name> con el nombre del rol creado en el paso 2.
- Reemplace <account-id> con el ID de su cuenta de AWS.

Crear complemento NRAI

Puede crear el complemento NRAI manualmente o mediante la AWS CLI.

Inicie sesión en la consola de administración de AWS y abra la consola de Amazon Q Business.
Navegue hasta la Applications y seleccione su aplicación.
En el panel izquierdo, vaya a Actions > Plugins.
Haga clic en Add plugin y seleccione Custom plugin.
Introduzca los siguientes datos:
1. Nombre del complemento: ingrese un nombre único para su complemento.
2. Esquema API: seleccione las siguientes opciones:
  1. En el API schema, para la opción API schema source , seleccione Define with in-line OpenAPI schema editor.
  2. Seleccione el formato para el esquema como YAML.
  3. Copie la siguiente especificación OpenAPI para el complemento New Relic y péguela en el editor.
    openapi: 3.0.3 info: title: NRAI-Plugin description: A NodeJS-based plugin that integrates with New Relic's AI service to process user prompts and return AI-generated responses and send response as it is to user do not change anything version: 0.1.0 servers: - url: https://copilot-agent-testing.service.newrelic.com description: NewRelic Server paths: /newrelic-amazon-q/: post: security: - OAuth2: - read x-amzn-response-template: "Response <template>${output}</template>" summary: Send user prompts to New Relic AI and receive responses and send response as it is to user do not change anything description: Endpoint to send user prompts to New Relic AI and receive responses and send response as it is to user do not change anything requestBody: content: application/json: schema: $ref: "#/components/schemas/PromptPayload" responses: "200": description: Successful Response content: application/json: schema: $ref: "#/components/schemas/Response" components: schemas: PromptPayload: type: object properties: prompt: type: string example: Your prompt here Response: type: string securitySchemes: OAuth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://login.newrelic.com/login tokenUrl: https://login.newrelic.com/api/v1/tokens scopes: read: Read access to resources
  4. Autenticación: seleccione Authentication required y luego ingrese los siguientes detalles:
    - Nombre secreto: Nombre de su secreto de Secrets Manager.
    - ID de cliente: ID de cliente proporcionado por New Relic.
    - Secreto del cliente New Relic proporcionó el secreto del cliente.
    - URL de devolución de llamada de OAuth La URL a la que se debe redirigir al usuario luego de la autenticación. Si la URL de su sitio web para desplegar es <q-endpoint>, emplee <q-endpoint>/oauth/callback. Esta URL de devolución de llamada debe estar incluida en la lista de permitidos de su aplicación de terceros.
  5. Elija un método para autorizar Amazon Q Business: elija Create and add a new service role o Use an existing service role. Cerciorar de que su rol de servicio tenga las licencias necesarias. La consola generará un nombre de rol de servicio.
  6. Tags: (opcional) Agrega una etiqueta para rastrear tu complemento.
Haga clic en Add plugin.

También puede emplear la AWS CLI para crear el complemento:

bash

$aws qbusiness create-plugin \
>--application-id <application-id> \
>--display-name <plugin-name> \
>--type CUSTOM \
>--auth-configuration '{ "oAuth2ClientCredentialConfiguration": { "secretArn": "arn:aws:secretsmanager:<region>:<account-id>:secret:<secret-name>", "roleArn": "arn:aws:iam::<account-id>:role/<role-name>" } }' \
>--custom-plugin-configuration '{ "description": "<description>", "apiSchemaType": "OPEN_API_V3", "apiSchema": { "s3": { "bucket": "<bucket-name>", "key": "<key-name>" } } }'

Parámetros

Parámetros	Descripción
`<application-id>`	El ID de su aplicación Amazon Q Business.
`<plugin-name>`	El nombre de su complemento personalizado.
`<region>`	La región de AWS donde se encuentran sus recursos.
`<account-id>`	Su ID de cuenta de AWS.
`<secret-name>`	El nombre del secreto en AWS Secrets Manager.
`<role-name>`	El nombre del rol de IAM.
`<description>`	Una descripción para su complemento personalizado.
`<bucket-name>`	El nombre del depósito S3 donde se almacena su esquema de API.
`<key-name>`	El nombre clave del archivo de esquema de API en el depósito S3.

Comunicar con un agente de New Relic en Amazon Q Business

Luego de crear el complemento NRAI, puede comunicar con el agente de New Relic en Amazon Q Business para enviar símbolos de usuario y recibir respuestas generadas por IA.

Para acceder al agente de New Relic:

Inicie sesión en la consola de administración de AWS y abra la consola de Amazon Q Business.
Navegue hasta la Applications y seleccione su aplicación.
Acceda a la URL de desplegar para acceder al asistente de chat.
En la ventana Chat, haga clic en Plugins y seleccione el complemento New Relic AI .
Ingresa tu símbolo en la ventana de chat y haz clic en el ícono Send . Será un símbolo para autorizar a Amazon Q Business a acceder a la cuenta New Relic . Este es un proceso de autorización único.
Haga clic en Authorize.
El agente de New Relic AI procesa tu símbolo y devuelve la respuesta en tiempo real.

Te ofrecemos esta traducción automática para facilitar la lectura.

avance

Requisitos previos

Crear una política y un rol de IAM

Importante

Crear complemento NRAI

Opción 1: Crear el complemento NRAI manualmente

Opción 2: Crear un complemento NRAI mediante AWS CLI

Parámetros

Comunicar con un agente de New Relic en Amazon Q Business

Te ofrecemos esta traducción automática para facilitar la lectura.

New Relic AI para Amazon Q Business

avance

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Crear una política y un rol de IAM

Importante

Crear complemento NRAI

Opción 2: Crear un complemento NRAI mediante AWS CLI

Comunicar con un agente de New Relic en Amazon Q Business

Requisitos previos