Agentes

A seção Agentes do SipPulse AI oferece uma interface poderosa para criar e gerenciar agentes inteligentes. Esses agentes são entidades personalizáveis projetadas para executar funções específicas, lidar com tarefas ou simular conversas com base em sua configuração e nas instruções fornecidas a eles.

Começando com Agentes

Criando um Agente

Inicialmente, sua lista de agentes estará vazia. Para começar a criar agentes:

• Clique no botão Criar para iniciar um novo agente.
• Essa ação leva a um formulário de configuração onde você pode definir as características do agente.

ID Único do Agente

Após a criação, cada agente recebe um ID único, visível no canto superior esquerdo da página de configuração do agente. Esse ID é crucial para integrar o agente com outras partes da plataforma, como iniciar threads ou incorporar o agente em aplicativos. Há um botão de ícone de cópia conveniente ao lado do ID, permitindo que os usuários o copiem facilmente para uso em outras partes do sistema, como a criação de threads.

Configurando seu Agente

Após a criação, você pode personalizar seu agente com várias opções para adaptar seu comportamento a tarefas específicas:

• Nome: Atribua um nome ao seu agente. Isso é apenas uma etiqueta para facilitar a identificação e não afeta o comportamento operacional do agente.
• Instruções: Defina diretrizes ou uma persona para o seu agente, orientando como ele deve interagir ou responder em cenários. Pense nisso como definir o tom e o comportamento do agente.
• Seleção de Modelo: Escolha entre uma variedade de modelos de IA. Alguns modelos vêm com uma tag Tool, indicando capacidades avançadas que suportam funções avançadas. Detalhes sobre as capacidades de cada modelo e aplicações adequadas são fornecidos para ajudar você a fazer uma escolha informada.
• Ferramentas e Funções: Você pode aprimorar seu agente com ferramentas ou funções específicas que estendem suas capacidades além de interações básicas. Esta área permite a integração de scripts personalizados ou APIs de terceiros.
• Parâmetros: Ajuste configurações como temperatura e top-p para controlar a variabilidade e criatividade da resposta do agente.

Gerenciamento do Agente

Cada agente possui botões para um gerenciamento eficaz:

• Excluir: Remova um agente permanentemente.
• Clonar: Duplicar um agente existente. Isso é útil para criar agentes semelhantes sem começar do zero.

Teste e Interação

Para garantir que seu agente esteja configurado corretamente e avaliar suas respostas:

• Use o recurso Playground clicando no respectivo botão. Este ambiente de sandbox permite interagir diretamente com seu agente.
• Durante o teste, você pode ver as respostas do agente em tempo real, o que ajuda a ajustar suas configurações e instruções.

Métricas e Análises no Playground

Ao interagir com seu agente no Playground, a interface fornece métricas valiosas:

• Métricas de Custo: Entenda o custo operacional associado ao uso do agente.
• Consumo de Tokens: Monitore quantos tokens suas interações estão consumindo, ajudando a gerenciar o uso e os custos.
• Métricas de Desempenho: Veja os tempos de resposta e outros indicadores de desempenho para avaliar a eficiência do seu agente.

Essa configuração abrangente permite um alto grau de personalização e controle, garantindo que os agentes criados no SipPulse AI possam atender efetivamente a várias necessidades operacionais. Seja para atendimento ao cliente, recuperação de dados ou diálogos interativos, esses agentes estão equipados para lidar com interações complexas de forma inteligente.

Ferramentas e Aprimoramentos para Agentes

Os agentes no SipPulse AI podem ser aprimorados com várias ferramentas para estender suas capacidades. Essas ferramentas são categorizadas em três tipos principais: Funções, Arquivos e Ferramentas Integradas. Cada tipo serve a propósitos diferentes e integra recursos diferentes ao agente.

Funções

A ferramenta de funções permite adicionar e configurar funções personalizadas que seu agente pode chamar. Essa é uma funcionalidade avançada que aprimora as capacidades do seu agente, permitindo que ele execute tarefas específicas programaticamente.

Propriedades de uma Função

1. Nome: Este é o identificador da sua função. Deve ser escrito em snake_case. Embora você possa digitá-lo em qualquer formato, ele será convertido para snake_case.

2. Descrição: Uma explicação detalhada do que a função faz. Isso é crucial, pois ajuda o agente a entender quando chamar essa função.

3. Parâmetros: Esta seção usa o esquema JSON para definir a estrutura dos parâmetros que a função aceitará. O esquema JSON é uma ferramenta poderosa para validar a estrutura dos dados JSON. Cada parâmetro deve incluir:

   • Tipo: Define o tipo de dados (por exemplo, string, número, objeto).
   • Propriedades: Lista as propriedades individuais se o parâmetro for um objeto.
   • Descrição: Uma breve explicação do que o parâmetro é usado.

   Para mais detalhes sobre o esquema JSON, você pode consultar o site do JSON Schema.

Recurso de Chamada Automática

Na parte inferior da configuração da função, você encontrará o recurso de Chamada Automática.

• Chamada Automática Desativada: Quando isso está desativado, o agente invocará a função e aguardará uma resposta do usuário para prosseguir.

• Chamada de API Habilitada: Quando esse recurso está ativado, a função chamará automaticamente a API com os parâmetros definidos pelo usuário. O agente irá:

  • Enviar uma solicitação para o endpoint da API especificado.
  • Interpretar a resposta.
  • Continuar a conversa com base na resposta da API.

  Isso é incrivelmente útil, pois permite a integração perfeita de suas próprias APIs no fluxo de trabalho do agente. Você pode configurar sua API, definir os parâmetros no corpo ou na consulta, e o agente cuidará do resto, garantindo um fluxo de conversa suave e eficiente.

Exemplo de Configuração de Função

IMPORTANT

Para reproduzir o exemplo, crie uma conta no Amadeus for Developers e obtenha uma chave de API. Substitua a URL pelo URL do seu aplicativo e MY_API_KEY pela sua chave real.

Abaixo está um exemplo de configuração de uma função para obter informações de voo:

• Nome: get_flight_info

• Descrição: Obter informações de voo a partir de um código de voo específico.

• Parâmetros:

  {
    "type": "object",
    "properties": {
      "carrierCode": {
        "type": "string",
        "description": "Código da companhia aérea. Ex: TP"
      },
      "flightNumber": {
        "type": "string",
        "description": "Número do voo. Ex: 1234"
      },
      "scheduledDepartureDate": {
        "type": "string",
        "description": "Data de partida programada. Ex: 2022-01-01"
      }
    },
    "required": ["carrierCode", "flightNumber", "scheduledDepartureDate"]
  }