Recursos de IA

O Echo inclui um conjunto de assistentes de IA para os momentos em que um segundo par de olhos economiza tempo de verdade. Eles são opcionais, vinculados a licenças e projetados para que seus segredos nunca saiam da sua máquina.

O que os assistentes fazem

  • Explicam qualquer resposta ou erro. Selecione um payload confuso ou uma chamada que falhou e receba uma explicação em linguagem simples.
  • Geram uma requisição a partir de uma especificação colada. Cole a parte relevante da descrição de uma API e o Echo prepara a requisição para você.
  • Ajudam a importar cURL. Nos comandos cURL alterados demais para uma importação simples, o assistente ajuda a reconstruir a requisição pretendida.
  • Ajudam a depurar erros. Analise uma requisição que falha com orientação, em vez de tentar adivinhar.
  • Geram asserções e conjuntos de testes completos. Transforme uma requisição que funciona em verificações que o executor de coleções pode executar, desde uma única asserção até um conjunto completo.
  • Geram mocks a partir de um esquema. Forneça um esquema e receba um mock no desktop para desenvolver sem a dependência real.
  • Documentam fluxos. Produzem documentação para uma sequência de requisições, útil antes de publicar documentação como descrito em /docs/echo/import-export.
  • Otimizam cadeias de requisições. Deixe o assistente revisar uma cadeia e sugerir uma versão mais eficiente.

Comece uma coleção a partir de OpenAPI

O assistente de especificações do desktop reúne a importação e as etapas opcionais de IA no mesmo fluxo:

  1. Escolha o espaço de destino e abra ou cole uma especificação OpenAPI.
  2. Escolha se deseja gerar testes, um mock no desktop e documentação de fluxo junto da coleção importada.
  3. Confira a prévia das pastas e requisições e a estimativa de uso de tokens antes de começar.
  4. Inicie as etapas escolhidas e confira cada resultado. Revise os testes e as respostas dos mocks gerados antes de usar.

A importação em si não usa IA. As etapas opcionais de geração exigem uma licença Pro AI, os recursos de IA habilitados pela organização e cota disponível. Uma etapa pode estar indisponível ou ser recusada mesmo que a importação tenha funcionado. A documentação de fluxo gerada é salva no DocuVault com seu acesso existente; isso não publica um link público de documentação nem hospeda o mock. O trabalho concluído antes de uma falha posterior ou de um cancelamento continua disponível.

Você precisa de uma licença Pro AI

Os recursos de IA exigem uma licença Pro AI. As licenças são gerenciadas pela sua organização na plataforma Gapfy. Se os assistentes não aparecerem no seu Echo, pergunte ao administrador da organização se uma licença Pro AI está atribuída a você.

Todo o resto no Echo, os cinco protocolos, as coleções, os ambientes, a automação, a importação e a exportação, funciona sem IA e sem uma licença Pro AI. Os assistentes são um complemento, não uma dependência.

Seus segredos continuam sendo seus

Antes de qualquer requisição de IA sair da sua máquina, o Echo oculta os segredos de forma determinística. Tokens, chaves e outros valores sensíveis são removidos localmente, sempre, por regras e não por uma decisão pontual. O assistente vê a forma do seu problema, não suas credenciais.

Isso corresponde ao design do Echo centrado no trabalho local: o banco de dados é criptografado em repouso, o modo de convidado funciona totalmente offline e a IA é um recurso que você escolhe usar com uma licença, não um processo em segundo plano.

Aproveite ao máximo os assistentes

  1. Comece com explain-response em uma API que você esteja aprendendo. É a forma mais rápida de criar um modelo mental.
  2. Quando uma requisição funcionar, gere asserções para ela e deixe o executor de coleções protegê-la contra regressões. Consulte /docs/echo/automation.
  3. Use a geração de mocks a partir de um esquema quando a dependência necessária ainda não tiver sido implantada.