Ir para conteúdo principal Pular para conteúdo complementar

Usando conexões Anthropic (Amazon Bedrock) em expressões de visualização

Além de adicionar perguntas e respostas do Anthropic ao modelo de dados do seu aplicativo usando o script de carregamento, você também pode realizar essas operações diretamente em um gráfico no seu aplicativo no modo de análise. Os dados de um único campo são enviados e recebidos entre você e o Anthropic.

Em muitos casos, o código usado para uma conexão de script de carregamento pode ser reaproveitado para uso em um gráfico, com algumas diferenças.

Se o caso de uso for baseado na entrada do usuário, você poderá usar uma conexão analítica e a sintaxe de extensão no lado do servidor correspondente na sua expressão de gráfico para criar gráficos interativos que visualizam os dados recebidos dos terminais do modelo.

Considerações para volumes de solicitação de dados

Recomenda-se usar apenas conexões Anthropic (Amazon Bedrock) em expressões de gráfico para uma ou algumas linhas de dados. Não é recomendado o uso de expressões de gráfico para enviar grandes quantidades de dados para o Anthropic.

É importante estar ciente de quantas linhas você está enviando com cada solicitação. Erros na configuração da conexão em uma expressão de gráfico podem levar a solicitações involuntariamente grandes (por exemplo, linhas idênticas com a mesma pergunta devido ao uso indevido do modelo de dados em um gráfico). Antes de interagir com uma plataforma de terceiros, certifique-se de estar ciente de como os campos usados no cálculo da expressão do gráfico e seu lugar no modelo de dados afetam seu contrato financeiro e acordos de cobrança com terceiros. Uma maior utilização da plataforma externa pode resultar em custos mais elevados.

Siga estas diretrizes para moderar e limitar o tamanho das suas solicitações:

  • Use a conexão apenas em uma expressão de gráfico Texto e imagem. É desaconselhável usar uma conexão com o Anthropic (Amazon Bedrock) em um objeto de Tabela, especialmente se você estiver adicionando a expressão a uma tabela com uma ou mais dimensões já adicionadas.

  • Se a expressão de gráfico estiver vinculada ao modelo de dados do seu aplicativo, use uma instrução se nessa expressão para calcular o gráfico somente quando uma única seleção for feita no aplicativo. Isso reduz drasticamente a contagem de linhas nas solicitações que seu gráfico enviará ao Anthropic.

  • Se você estiver usando uma conexão com o Anthropic (Amazon Bedrock) para enviar solicitações grandes, use a conexão no seu script de carregamento em vez de em uma expressão de gráfico, para que os dados sejam pré-carregados no seu modelo de dados.

Engenharia de prompts

Ao escrever as solicitações que você está enviando para um modelo generativo de IA (geralmente conhecido como prompts), siga as diretrizes específicas da plataforma com a qual você está interagindo. Para obter informações sobre engenharia de prompts e algumas diretrizes sobre como estruturar seus prompts para conectores do Amazon Bedrock, consulte Diretrizes de engenharia de prompts.

Construindo prompts para a configuração do Anthropic - Claude

Você pode usar a configuração do Anthropic - Claude desse conector para conectar-se aos seguintes modelos legados:

  • Claude 2.1

  • Claude 2

  • Claude Instant 1.2

Os prompts escritos para esta configuração requerem sintaxe específica para retornar conclusões com êxito. Eis os requisitos:

  • Cada prompt deve ser prefixado com o texto Human:

  • Cada prompt deve ser sufixado com o texto Assistant:

  • O prefixo Human: deve ter dois retornos de carro anteriores. Isso é feito adicionando chr(10) & chr(10) à expressão, antes do prefixo.

  • O sufixo Assistant: deve ter dois retornos de carro anteriores. Isso é feito adicionando chr(10) & chr(10) à expressão, antes do sufixo.

Para obter informações sobre como estruturar e formatar um prompt do Claude, consulte Construindo um prompt.

Para ver exemplos, consulte Exemplos rápidos.

Construindo prompts para a configuração do Anthropic - Claude (Messages API)

A configuração do Anthropic - Claude (Messages API) se conecta à API de mensagens. Você pode usar esta configuração para acessar os seguintes modelos do Claude:

  • Claude 3 Sonnet

  • Claude 3 Haiku

  • Claude 2.1

  • Claude 2

  • Claude Instant 1.2

Os prompts para esses modelos não requerem nenhuma sintaxe específica. Para ver exemplos, consulte Exemplos rápidos.

Criando a expressão de gráfico

  1. Ao editar uma visualização, clique em Expressão para entrar no editor de expressões.

  2. No editor de expressões, insira uma expressão no campo de expressão. A expressão deve ser construída usando a sintaxe de extensão no lado do servidor.

Exemplos rápidos

Aqui você pode encontrar expressões de exemplo que podem ser usadas ao começar a usar o conector do Anthropic (Amazon Bedrock). Considere os seguintes detalhes:

  • Use as expressões apenas com um objeto Texto e imagem.

  • Considere adicionar uma instrução if às suas expressões para controlar quando o gráfico é recalculado e para atualizar dependendo das seleções do usuário no aplicativo.

  • Para que as expressões funcionem, você deve substituir o valor connectionname e quaisquer nomes de campo para corresponder às suas próprias conexões e aplicativos.

  • Existem diferentes requisitos de sintaxe para cada configuração deste conector. Consulte Engenharia de prompts.

Exemplos de expressão de gráfico para o conector de análise do Anthropic (Amazon Bedrock)

Configuração do conector Expressão Resumo
Anthropic - Claude endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.' & chr(10) & chr(10) & 'Assistant:')

Esse comando retornará a resposta Anthropic a uma única pergunta, que foi inserida na expressão.

Nota de advertência

Essa expressão não usa uma instrução if, e não é aconselhável usá-la se estiver vinculada a um campo em seu modelo de dados. É adequado apenas para uso em uma expressão autônoma com uma única célula de entrada contendo um valor codificado.

Anthropic - Claude if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & vQuestion & chr(10) & chr(10) & ' Assistant:'))

Esta é uma instrução que pode ser usada em um objeto Texto e imagem vinculado a um controle de Entrada variável. O gráfico só é calculado quando a entrada é inserida. Quando o usuário digita a entrada no objeto e pressiona Enter, o gráfico exibe a resposta do modelo à sua entrada.

Observe que, dados os requisitos do prompt Anthropic, o usuário deve inserir o prefixo e o sufixo manualmente em sua entrada.

Para obter um passo a passo semelhante com um conector diferente, consulte Exercício: Criando uma caixa de entrada de texto usando uma variável.

Anthropic - Claude if(count(distinct [BusinessTopic]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human: write me a sample response from a technical support department for a customer complaint about ' & [BusinessTopic] & chr(10) & chr(10) & ' Assistant:')) Neste exemplo, o gráfico só será calculado se um valor distinto tiver sido selecionado no campo IssueCategory no modelo de dados do aplicativo. Uma solicitação é enviada ao modelo solicitando um exemplo de resposta de um departamento de suporte técnico sobre um tipo geral de problema, cuja lista está contida no campo IssueCategory. O gráfico é atualizado dependendo do valor selecionado pelo usuário.
Anthropic - Claude (Messages API) endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.')

Esse comando retornará a resposta Anthropic a uma única pergunta, que foi inserida na expressão.

Nota de advertência

Essa expressão não usa uma instrução if, e não é aconselhável usá-la se estiver vinculada a um campo em seu modelo de dados. É adequado apenas para uso em uma expressão autônoma com uma única célula de entrada contendo um valor codificado.

Anthropic - Claude (Messages API) if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}',vQuestion))

Esta é uma instrução que pode ser usada em um objeto Texto e imagem vinculado a um controle de Entrada variável. O gráfico só é calculado quando a entrada é inserida. Quando o usuário digita a entrada no objeto e pressiona Enter, o gráfico exibe a resposta do modelo à sua entrada.

Observe que, dados os requisitos do prompt Anthropic, o usuário deve inserir o prefixo e o sufixo manualmente em sua entrada.

Para obter um passo a passo semelhante com um conector diferente, consulte Exercício: Criando uma caixa de entrada de texto usando uma variável.

Anthropic - Claude (Messages API) if(count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]')) Neste exemplo, o gráfico só será calculado se um valor distinto tiver sido selecionado no campo IssueCategory no modelo de dados do aplicativo. Uma solicitação é enviada ao modelo solicitando um exemplo de resposta de um departamento de suporte técnico sobre um tipo geral de problema, cuja lista está contida no campo IssueCategory. O gráfico é atualizado dependendo do valor selecionado pelo usuário.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!