Tutorial: Criando um Agente de Consulta de CEP

José David Atualizado por José David

Este tutorial vai guiá-lo passo a passo para criar, entender e implantar seu primeiro agente, um assistente que consulta endereços a partir de um código postal brasileiro (CEP).

Passo 1: Configurar seu Projeto

Primeiro, você precisa selecionar em qual projeto da Plataforma Weni irá trabalhar.

# Lista todos os projetos aos quais você tem acesso 
weni project list 

# Selecione um projeto usando seu UUID
weni project use SEU_PROJECT_UUID

# Verifique se o projeto correto está selecionado
weni project current
O UUID do projeto é o identificador único de cada projeto. Você pode encontrá-lo na URL do projeto: https://dash.weni.ai/projects/PROJECT_UUID/agent-builder/init

Passo 2: Criar a Estrutura do Agente com weni init

O comando init é a maneira mais rápida de começar. Ele cria todos os arquivos necessários com um código de exemplo.

weni init

Este comando gera uma estrutura de pastas como esta:

.
├── agent_definition.yaml
└── tools/
    └── get_address/
        ├── main.py
        └── requirements.txt

Passo 3: Entendendo os Arquivos Criados

O weni init gerou dois componentes principais:

  1. agent_definition.yaml: É o cérebro que define o que é o seu agente e o que ele pode fazer. Contém o nome, as instruções e as ferramentas que ele utiliza.
    Para saber mais, consulte nosso guia completo sobre a Anatomia de um Agente########.
  2. tools/get_address: Contém o código Python que executa a lógica da ferramenta (consulta da API de CEP).
    Para se aprofundar, leia nosso guia sobre Ferramentas (Tools)####.

Passo 4: Implantar seu Primeiro Agente

Parabéns! Agora você tem um agente funcional. Para implantá-lo em seu projeto, basta executar:

weni project push agent_definition.yaml

Seu agente já estará disponível na Plataforma Weni e poderá ser visualizado na seção de Agentes Personalizados.

Como a gente se saiu?

untitled article

Contato