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:

Nome do plugin: insira um nome exclusivo para o seu plugin.

Esquema de API: Selecione as seguintes opções:

No API schema, para a opção API schema source , selecione Define with in-line OpenAPI schema editor.
Selecione o formato do esquema como YAML.

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

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