Construindo um Agente de Viagem com ChatGPT AgentKit: Um Guia Completo

Construir fluxos de trabalho de IA complexos frequentemente envolve escrever muito código, o que pode retardar o desenvolvimento e tornar mais difícil iterar. E se você pudesse projetar, testar e lançar agentes de IA usando uma interface visual de arrastar e soltar? O novo Agent Builder da OpenAI torna isso possível, fornecendo um espaço tudo-em-um para criar poderosos fluxos de trabalho de agente sem escrever nenhuma linha de código.

Este guia irá guiá-lo pelos principais recursos do Agent Builder e mostrar como criar seu primeiro agente, usando um exemplo prático de assistente de viagem do tutorial da OpenAI. Você aprenderá como conectar diferentes componentes, testar o desempenho do seu agente e prepará-lo para implantação.

O que é o Agent Builder?

O Agent Builder faz parte do AgentKit, a suíte tudo-em-um da OpenAI para construir, implantar e otimizar agentes de IA. Como um componente essencial do AgentKit, o Agent Builder fornece uma interface visual que simplifica o processo de design de fluxos de trabalho de múltiplos agentes — sem necessidade de codificação. Ele permite que você conecte diferentes blocos funcionais, chamados de nós, para construir um fluxo de trabalho completo. Você pode começar a partir de modelos pré-construídos ou criar um fluxo de trabalho personalizado do zero.

Uma de suas características mais valiosas é o sistema de avaliação integrado, que ajuda você a testar como seus agentes performam e fazer ajustes sob demanda. Quando seu agente está pronto, você pode exportar todo o fluxo de trabalho como código ou integrá-lo diretamente no seu produto usando o ID do fluxo de trabalho fornecido. Isso agiliza o caminho da ideia para a produção.

Construindo um Agente de Viagem: Um Exemplo Passo a Passo

Para ver o Agent Builder em ação, vamos explorar como criar um agente de viagem útil. Este agente será capaz de lidar com dois tipos de solicitações do usuário: construir um itinerário de viagem e pesquisar informações de voos.

1. Configurando o Fluxo de Trabalho

Todo fluxo de trabalho começa com um Nó de Início. Este nó é onde você pode definir variáveis de entrada que seu agente usará. Para nosso agente de viagem, as configurações padrão são suficientes para começar. A solicitação do usuário será passada através deste nó para o resto do fluxo de trabalho.

2. Classificando a Intenção do Usuário

Como nosso agente precisa lidar com duas tarefas diferentes, precisamos de uma maneira de determinar o que o usuário quer. É aqui que entra um Agente Classificador. Um classificador é um agente especializado que categoriza a entrada do usuário.

Podemos configurar este nó com um prompt que o instrui a atuar como um assistente de viagem e classificar a mensagem do usuário como “itinerário” ou “info de voo”. Para garantir que a saída seja estruturada e previsível, podemos especificar o formato de saída como JSON.

Aqui está um exemplo da estrutura de saída JSON:

{
  "classification": "itinerário"
}

3. Ramificando a Lógica com um Nó Se/Senão

Uma vez que a intenção do usuário é classificada, precisamos direcionar a solicitação para o agente especializado correto. Um Nó Se/Senão nos permite criar ramificações condicionais em nosso fluxo de trabalho.

Podemos configurar a condição para verificar a saída do nosso classificador.

• Se classification for “info de voo,” o fluxo de trabalho prossegue para o agente de voo.
• Caso contrário, o fluxo de trabalho prossegue para o agente de itinerário.

Esta lógica de ramificação simples garante que cada solicitação seja tratada pelo agente melhor equipado para a tarefa.

4. Criando Agentes Especializados

Agora, criamos os dois agentes especializados que realizarão as tarefas principais.

O Agente de Itinerário

Para usuários que pedem sugestões de viagem, criaremos um Agente de Itinerário. Este é outro nó de agente configurado com um prompt específico, como: “Você é um assistente de viagem. Construa um itinerário conciso.” Este agente pegará a solicitação do usuário (ex.: “O que fazer em um dia em Tóquio?”) e gerará um plano detalhado.

O Agente de Voo

Para usuários procurando detalhes de voos, configuraremos um Agente de Voo. Seu prompt pode ser algo como: “Você é um assistente de viagem. Sempre recomende um voo específico. Use códigos de aeroporto.”

Para fornecer as informações mais precisas e atuais, podemos dar a este agente acesso a ferramentas como Busca na Web. Isso permite que o agente pesquise dados de voo em tempo real com base na consulta do usuário (ex.: “SFO para Tóquio em 7 de outubro”).

5. Testando Seu Fluxo de Trabalho

Com a estrutura básica no lugar, você pode usar o painel Executar Visualização para testar seu agente. Quando você insere um prompt como “O que fazer em um dia em Tóquio?”, você pode assistir enquanto o visualizador de fluxo de trabalho mostra a solicitação movendo-se do classificador para a ramificação se/senão e finalmente para o agente de itinerário, que gera a saída.

Este loop de feedback imediato é ótimo para depuração e entender como seu agente processa informações.

Melhorando a Experiência do Usuário com Widgets

Uma resposta de texto simples para informações de voo é funcional, mas podemos fazer melhor. O Agent Builder permite que você crie experiências de usuário mais ricas e interativas usando Widgets.

Você pode projetar componentes de UI personalizados no Widget Studio. Para nosso agente de voo, podemos criar um widget que exibe detalhes do voo, como locais de partida e chegada, horários e outras informações relevantes, em um formato de cartão visualmente atraente.

Depois de projetar o widget, você pode baixar seu modelo e enviá-lo diretamente para o nó do agente de voo. Você pode até adicionar instruções mais criativas ao prompt do agente, como “Escolha uma cor de fundo criativamente com base no destino.” Quando testado, o agente pode pesquisar na web, encontrar um voo e depois exibi-lo usando o widget personalizado com uma cor de fundo que ele associa à cidade de destino.

Publicando Seu Agente

Uma vez que você está satisfeito com o desempenho do seu agente, publicá-lo é simples. Você pode dar um nome ao seu fluxo de trabalho, como “Agente de Viagem,” e publicá-lo.

Depois de publicar, você tem duas opções principais para integração:

1. Agents SDK: Você pode usar o Software Development Kit para integrar o agente em sua aplicação. Isso dá mais controle, mas também exige gerenciar mais código.
2. ID do Fluxo de Trabalho com ChatKit: Para uma integração muito mais simples, sem código, você pode pegar o ID do fluxo de trabalho gerado e colocá-lo diretamente em seu produto usando o ChatKit.

Comece a Usar o Agent Builder

O Agent Builder faz parte da suíte AgentKit da OpenAI e foi projetado para funcionar perfeitamente com ferramentas relacionadas como ChatKit e Connector Registry, tornando mais fácil construir, personalizar e implantar fluxos de trabalho de IA de ponta a ponta. Ao oferecer um canvas visual, testes integrados e opções de implantação fáceis, ele capacita você a se concentrar em projetar ótimas experiências de usuário.

Se você tem um projeto que poderia se beneficiar de um fluxo de trabalho com IA, experimente o Agent Builder. Explore seus recursos, construa um agente simples e veja o quão rápido você pode dar vida às suas ideias.

---

Construiu uma ferramenta de IA que deseja compartilhar? Eu compilei uma lista curada de diretórios de IA onde você pode enviar seus projetos de IA. Cada diretório inclui minha revisão pessoal, detalhes do processo de envio e indicadores de qualidade para ajudá-lo a escolher as melhores plataformas para seu lançamento.