Integração New Relic AI para Amazon Q Business

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

O New Relic AI plugin personalizado para o Amazon Q Business integra baseados New Relic insights em IA da diretamente no ambiente do Amazon Q Business. Este plugin permite que você envie prompts de usuário para o New Relic AI e receba respostas geradas pela IA, facilitando a melhoria da resposta a incidentes e dos processos de tomada de decisão.

Este guia fornece instruções para estabelecer uma conexão entre New Relic AI e o Amazon Q Business, permitindo detecção de anomalias, alertas em tempo real e gerenciamento de incidentes para manter o desempenho do aplicativo e a confiabilidade.

Pré-requisitos

Uma conta válida da New Relic com o ID do cliente e o segredo do cliente. Caso você não tenha esses dados, entre em contato com agenticai@newrelic.com.
Um aplicativo operacional do Amazon Q Business. Para obter mais informações sobre como criar um ambiente de aplicativo Amazon Q Business, consulte a documentação do Amazon Q Business.
A AWS CLI está instalada e configurada no seu sistema. Para obter mais informações, consulte a documentação da AWS CLI.
Permissões para criar políticas e funções do IAM na AWS.
Permissões para criar plugins no serviço Amazon Q Business.
Uma política e função do IAM que concedem ao plugin New Relic AI permissões para acessar recursos da AWS. Para obter mais informações, consulte Criar política e função do IAM.

Criar política e função do IAM

Crie uma política e uma função do IAM que concedam ao plugin New Relic AI permissões para acessar recursos da AWS. A política define permissões para acessar serviços como o AWS Secrets Manager, enquanto a função permite que o Amazon Q Business Business assuma essas permissões com segurança. Essa configuração garante controle de acesso baseado em função e minimiza o gerenciamento direto de credenciais.

Importante

Antes de criar uma função do IAM, entre em contato com a New Relic para obter o ID do cliente e o segredo do cliente.

Para criar uma política do IAM, atualize e execute o seguinte 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>" }] }'
```
- Substitua <policy-name> pelo nome da sua política.
- Substitua <region> pela sua região da AWS.
- Substitua <account-id> pelo ID da sua conta AWS.
- Substitua <secret-name> pelo segredo fornecido pelo New Relic.

Para criar uma função do IAM, execute o seguinte 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" }] }'

Substitua <role-name> por um nome para identificar a função.

Para anexar a política à função, atualize e execute o seguinte comando:
bash
```
$aws iam attach-role-policy \
>--role-name <role-name> \
>--policy-arn arn:aws:iam::<account-id>:policy/<policy-name>
```
- Substitua <policy-name> pelo nome da política criada na etapa 1.
- Substitua <role-name> pelo nome da função criada na etapa 2.
- Substitua <account-id> pelo ID da sua conta AWS.

Criar plugin NRAI

Você pode criar o plugin NRAI manualmente ou usando a AWS CLI.

Entre no AWS Management Console e abra o console do Amazon Q Business.
Navegue até o Applications e selecione seu aplicativo.
No painel esquerdo, vá para Actions > Plugins.
Clique em Add plugin e selecione Custom plugin.
Insira os seguintes detalhes:
1. Nome do plugin: insira um nome exclusivo para o seu plugin.
2. Esquema de API: Selecione as seguintes opções:
  1. No API schema, para a opção API schema source , selecione Define with in-line OpenAPI schema editor.
  2. Selecione o formato do esquema como YAML.
  3. Copie a especificação OpenAPI abaixo para o plugin New Relic e cole no 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. Autenticação: Selecione Authentication required e insira os seguintes detalhes:
    - Nome do segredo: Nome do seu segredo do Secrets Manager.
    - ID do cliente: ID do cliente fornecida pela New Relic.
    - Segredo do cliente O New Relic forneceu o segredo do cliente.
    - URL de retorno de chamada do OAuth A URL para a qual o usuário precisa ser redirecionado após a autenticação. Se o URL do seu site de implantação for <q-endpoint>, use <q-endpoint>/oauth/callback. Este URL de retorno de chamada deve estar na lista de permissões do seu aplicativo de terceiros.
  5. Escolha um método para autorizar o Amazon Q Business: Escolha Create and add a new service role ou Use an existing service role. Certifique-se de que sua função de serviço tenha as permissões necessárias. O console gerará um nome de função de serviço.
  6. Tags: (opcional) Adicione uma tag para rastrear seu plugin.
Clique em Add plugin.

Você também pode usar a AWS CLI para criar o plugin:

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âmetro

Parâmetro	Descrição
`<application-id>`	O ID do seu aplicativo Amazon Q Business.
`<plugin-name>`	O nome do seu plugin personalizado.
`<region>`	A região da AWS onde seus recursos estão localizados.
`<account-id>`	Seu ID de conta da AWS.
`<secret-name>`	O nome do segredo no AWS Secrets Manager.
`<role-name>`	O nome da função do IAM.
`<description>`	Uma descrição para seu plugin personalizado.
`<bucket-name>`	O nome do bucket S3 onde seu esquema de API está armazenado.
`<key-name>`	O nome da chave do arquivo de esquema da API no bucket do S3.

Comunique-se com o agente da New Relic no Amazon Q Business

Depois de criar o plugin NRAI, você pode se comunicar com o agente New Relic no Amazon Q Business para enviar prompts de usuário e receber respostas geradas por IA.

Para acessar o agente New Relic:

Entre no AWS Management Console e abra o console do Amazon Q Business.
Navegue até o Applications e selecione seu aplicativo.
Acesse a URL do implante para acessar o assistente de chat.
Na janela de bate-papo, clique em Plugins e selecione o plugin New Relic AI .
Digite seu prompt na janela de bate-papo e clique no ícone Send . Você será solicitado a autorizar o Amazon Q Business a acessar a conta New Relic . Este é um processo de autorização único.
Clique em Authorize.
O agente New Relic AI processa seu prompt e retorna a resposta em tempo real.

Esta tradução de máquina é fornecida para sua comodidade.

Integração New Relic AI para Amazon Q Business

visualização

Pré-requisitos

Criar política e função do IAM

Importante

Criar plugin NRAI

Opção 1: Criar plugin NRAI manualmente

Opção 2: Criar plugin NRAI usando AWS CLI

Parâmetro

Comunique-se com o agente da New Relic no Amazon Q Business

Esta tradução de máquina é fornecida para sua comodidade.

Integração New Relic AI para Amazon Q Business

visualização

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Criar política e função do IAM

Importante

Criar plugin NRAI

Opção 2: Criar plugin NRAI usando AWS CLI

Comunique-se com o agente da New Relic no Amazon Q Business

Pré-requisitos