Agentes

Ricardo Atualizado por Ricardo

Agentes

O cartão de agente permite criar conversas sofisticadas e ativas com IA que são naturais, resilientes e, honestamente, mágicas.

Está repleto de recursos poderosos recursos. Vamos analisá-los um por um.

Instruções

As instruções do seu agente definem como ele se comporta. Escreva-as de forma clara e específica para que o agente atue da maneira que você precisa.

Dicas de estímulo
Comece com uma função e um contexto: comece dizendo ao agente o que ele é e o que está fazendo. Exemplo: "Você é um assistente de lembrete de consulta de paciente" ou “Você é um bot de check-in de diabetes em nossa clínica”. Isso fundamenta todas as suas decisões.

Seja explícito sobre o que fazer: Não diga "seja útil." Diga exatamente o que você deseja: "Envie lembretes amigáveis ​​24 horas antes dos compromissos" ou "Verifique semanalmente a adesão à medicação." Quanto mais específico, melhor será o desempenho do agente.

Estabeleça limites claros: diga ao agente o que NÃO deve fazer. Para cuidados de saúde: "Nunca prescreva medicamentos," "Nunca diagnostique doenças," "Nunca discuta planos de tratamento.". Forneça orientação sobre como recusar gentilmente uma solicitação. Seja explícito sobre tópicos que precisam de revisão humana.

Mostre, não apenas diga: inclua exemplos de boas respostas. Em vez de "lidar bem com os escalonamentos," escreva: "Se um paciente relatar dor no peito, responda: 'Isso precisa de atenção imediata. Entre em contato com sua clínica imediatamente.'". Exemplos de conversas em vários turnos ajudam.

Definir o tom e o idioma: Especifique como o agente deve soar e qual idioma usar: "Mantenha as respostas breves (2 a 3 frases)," "Use linguagem médica formal," "Seja caloroso e coloquial.", "Combine a linguagem, o tom e o nível de complexidade do usuário" ou "use uma linguagem simples que alguém do 6º ano possa entender, reconheça as preocupações do usuário primeiro, faça apenas uma pergunta por vez".

Teste e refine: comece com suas instruções básicas, experimente-as com cenários reais e ajuste com base sobre o que funciona. Boas instruções geralmente precisam de iteração.

Dica profissional: o que tendemos a fazer é escrever um prompt e pedir a um LLM como ChatGPT ou Claude para melhorá-lo.

Ações

Ações são como você conecta agentes ao restante de suas jornadas. Eles permitem definir condições quando o Agente deve sair da conversa e ir para outro lugar.

Antes de responder à mensagem de um usuário, o Agente primeiro verifica se ela corresponde a alguma ação que você especificou. Se isso acontecer, ele seguirá imediatamente o ramo que você definiu em sua jornada. Caso contrário, ele responde ao usuário.

Alguns exemplos de como você pode usar isso:

  • Fluxos de trabalho do agente: conecte vários agentes especializados entre si (dica: se você estiver fazendo isso, recomendamos ter um agente 'roteador' que encaminhe o usuário sem responder, ao qual todos os subagentes se conectem).
  • Direcione os usuários para outra parte do seu jornadas: é uma ótima maneira de misturar agentes e o resto de suas jornadas
  • Escalar para um humano: se você tiver suporte humano, crie uma ação que detecte se o usuário deseja falar com uma pessoa

Memória

Por padrão, fornecemos aos Agentes todas as mensagens das últimas 2 horas de conversa. Isso faz com que ele responda contextualmente ao que aconteceu antes de começar, tornando a experiência mais integrada.

No entanto, você também pode ajustar a memória do agente para que suas configurações de memória correspondam aos seus objetivos. Veja o que as três opções fazem:

  • Nenhum: não envia mensagens anteriores ao Agente. Ótimo para situações delicadas
  • Esta jornada: envia apenas mensagens enviadas durante esta sessão nesta jornada específica.
  • Conversação: envia automaticamente mensagens anteriores da conversa, independentemente de onde elas aconteceram. Você pode personalizar até onde devemos ter memória.

A memória de longo prazo é compactada automaticamente pelo bloco do Agente sob demanda, para que o gasto do token seja ideal.

Passar campos de perfil

Você também pode passar o perfil do usuário, para que as respostas sejam mais personalizadas. Você tem controle total sobre quantos (ou poucos) campos você passa. Por padrão, não passamos nenhum — para máxima privacidade.

Coletar dados

Você também pode configurar seus agentes para coletar dados, o que é muito útil para coisas como integração, registro, agendamento de compromissos, pesquisas e qualquer coisa que exija que o Agente colete proativamente.

Basta informar quais informações você deseja e em qual campo de perfil salvá-las. Presto.

Habilidades

Por último, mas definitivamente não menos importante, os agentes também podem realizar operações em segundo plano para enriquecer a conversa. Elas são chamadas de habilidades.

Você pode usá-las sempre que seu agente precisar de alguma informação externa, como verificar a agenda de um médico para saber os horários disponíveis, recuperar qualquer contexto extra que não esteja no prompt principal ou executar uma ação como marcar uma consulta.

Existem 2 tipos de habilidades:

💡 Habilidades de conhecimento

Em vez de ter um grande prompt com tudo o que seu agente precisa saber, o que o torna caro e lento, agora você pode dividir seu conhecimento em partes menores. Cada pedaço é uma Habilidade de Conhecimento.

Então, quando o Agente precisa dessa informação, ele a recupera. Internamente, o Agente mantém um "índice" de tudo o que sabe, acessando o conhecimento apenas quando necessário.

Isso torna as gerações muito mais baratas e rápidas!

As habilidades são reutilizáveis entre diferentes Agentes, portanto, você também pode reutilizar facilmente o conhecimento entre os Agentes.

⚡️ Habilidades funcionais

Se você estiver familiarizado com chamadas de funções, você se sentirá em casa com habilidades funcionais. Eles fornecem aos seus agentes a capacidade de executar código personalizado para enriquecer suas conversas.

Deseja agendar um compromisso de forma autônoma em seu sistema? Ou recuperar uma lista de médicos e suas disponibilidades? Ou obter o clima atual? Basta criar uma habilidade funcional para seu agente e ele a usará de forma autônoma sempre que precisar.

Como criar habilidades funcionais?

As habilidades funcionais são criadas usando a linguagem de programação Lua e o Turn SDK. Aqui estão documentos para desenvolvedores detalhados.

Não é desenvolvedor? Sem problemas. LLMs são extremamente capazes de gerar código Lua. Criamos uma Habilidade do Claude que permite que você simplesmente peça ao Claude para gerar habilidades.

Assim como acontece com as habilidades de conhecimento, as habilidades funcionais também são compartilhadas entre os agentes, ajudando você a gerenciar conhecimentos e capacidades compartilhados. Escreva uma vez, use várias vezes.

Considerações finais

O cartão de agente é a maneira mais poderosa de construir com o Turn.io atualmente. Todos esses pequenos recursos, combinados, permitem que você crie experiências de conversação extremamente ricas e de alta qualidade baseadas em IA.

Mal podemos esperar para ver o que você fará com eles.

Esse artigo foi útil?

Use os blocos de IA para criar seu serviço de chat com inteligência artificial

Como aproveitar ao máximo os Playbooks de GenAI

Contato