Como criar seu primeiro agente no Johan.Chat: um guia rápido para iniciantes

Guia rápido para criar seu primeiro agente no Johan.Chat

O Johan.Chat é uma plataforma low-code baseada no conceito de “Agents as Code” (Agentes como Código). Ela permite criar agentes conversacionais inteligentes com pouco código e muita flexibilidade.

1. Criando seu primeiro agente
   Na tela inicial, crie um novo agente. Você será levado para o Studio, onde pode configurar o contexto, o comportamento e as ferramentas do agente.

2. Entendendo o Studio
   No Studio, você encontra abas que definem como o agente pensa e responde:

• Contexto: uma descrição simples do papel do agente.
• Instruções: lista de regras de comportamento. Exemplo: “Sempre use os dados mais recentes”.
• Comportamento: um texto mais detalhado (como o “prompt do sistema”), que define a personalidade do agente.
• Notas: blocos curtos de informação ativados de acordo com o que o usuário digita. Útil para manter o contexto limpo e organizado.

3. Ferramentas
   É aqui que ficam as funções e recursos que o agente pode usar:

• Funções personalizadas: criadas em JavaScript para chamar APIs, executar lógica ou retornar dados dinâmicos.
• Plugins: recursos avançados disponíveis apenas para empresas com licença comercial.

4. Criando uma função personalizada
   Ao criar uma nova função, defina:

• Nome: precisa ser único.
• Descrição: explica quando o agente deve usar a função.
• Parâmetros: entradas opcionais (nome, tipo e descrição).
• Código: a lógica em JavaScript.

Estrutura básica:

const { user, agent } = args;

// sua lógica aqui

return { message: "" };

O objeto args já traz o user e o agent, além de qualquer parâmetro que você definir.

Exemplo simples de resposta:

const { user, agent } = args;

return fetch('https://api.seusite.com/balance')
  .then(response => {
    if (!response.ok) throw new Error('Erro na requisição');
    return response.json();
  })
  .then(data => {
    return { message: `Seu saldo é R$ ${data.balance}` };
  })
  .catch(error => {
    return { message: `Não foi possível buscar o saldo. Tente novamente.` };
  });

Boas práticas:

• Prefira usar .then() e .catch() em vez de await.
• Sempre retorne um objeto com pelo menos message.
• Use system e continue quando precisar que o agente prossiga a conversa com base nos dados recebidos.
• Dê nomes claros às funções e parâmetros para facilitar o raciocínio do agente.

Conclusão
O Johan.Chat facilita a criação de agentes conversacionais de forma rápida. Usando contexto, instruções e ferramentas, você consegue transformar uma ideia em um agente funcional em poucos minutos.

Fale comigo em [email protected]