Crie seu primeiro agente de IA para análise de sentimento

Comece a usar IA na Digibee criando seu primeiro Agent em apenas quatro etapas.

Construa uma API funcional de análise de sentimento com IA que classifica feedbacks de clientes como positivo, negativo ou neutro.

Passo a passo

Neste guia rápido, você criará uma API simples que analisa o sentimento de um texto em quatro etapas.

1

Obtenha a API Key do seu provedor de LLM

Antes de começar, certifique-se de ter o seguinte:

• Uma API key de um provedor de LLM (por exemplo, OpenAI, Anthropic, Google).

• A API key registrada na Digibee como uma conta do tipo Secret Key.

Se você ainda não tiver essa conta, consulte a documentação para criar uma conta Secret Key.

2

Crie um pipeline acionado por um trigger do tipo REST

Crie um novo pipeline e configure o trigger da seguinte forma:

• Tipo: Selecione REST.

• Methods: Remova todos os métodos e deixe apenas POST.

• Outras configurações: Mantenha os valores padrão.

Para expor esse pipeline como uma API, é necessário configurar uma API key e fazer o deploy do pipeline. Consulte a documentação para saber como expor um pipeline como API.

3

Adicione o Agent Component

Adicione o Agent Component ao pipeline logo após o trigger e configure-o da seguinte forma:

• Modelo: Selecione o modelo de sua preferência (por exemplo, OpenAI - GPT-4o Mini).

• Conta: Clique no ícone de engrenagem ao lado do modelo e selecione a conta Secret Key registrada no passo 1.

Em seguida, configure as mensagens do Agent:

• Mensagem do Sistema: Define o papel e o comportamento da IA.

Você é um analisador de sentimentos. Classifique o texto como positivo, negativo ou neutro.

• Mensagem do Usuário: Prompt que será analisado pela IA.

{{ message.body.text }}

A expressão {{ message.body.text }} recupera dinamicamente dados do payload da requisição. Quando a API é chamada com {"body": {"text": "algum texto qualquer"}}, o Agent recebe e processa esse valor. Para saber mais, veja como as expressões Double Braces são usadas para referenciar dados dinamicamente.

4

Teste o Agent

Na configuração do Agent Component, utilize o Painel de Teste, localizado no lado direito da página, e insira o seguinte input:

{
  "body": {
    "text": "Este produto é incrível! Melhor compra de todas."
  }
}

Em seguida, clique em Executar para visualizar o resultado.

Abaixo está um exemplo de saída retornada pelo Agent:

{
  "body": {
    "text": "Positivo"
  },
  "tokenUsage": {
    "inputTokenCount": 41,
    "outputTokenCount": 2,
    "totalTokenCount": 43
  }
}

Resultado

Parabéns! Você agora tem uma API de análise de sentimento com IA totalmente funcional. Como próximo passo, aprenda como estruturar o output para forçar a IA a retornar respostas JSON consistentes e determinísticas.

Tópicos relacionados

• Transforme respostas de IA em uma saída JSON estruturada: Transforme respostas não estruturadas em saídas estruturadas.

• Use ferramentas do MCP Server para conectar agentes de IA a sistemas externos: Use ferramentas para recuperar dados externos por meio do Deepwiki MCP Server.

• Sistema de validação de relatórios de despesas com IA: Explore uma implementação real neste guia How-to.

• Análise de sinistros de seguros com IA: Construa um sistema multiagente para auxiliar na revisão de sinistros de seguros.