“Crie um conector que consulte um pedido Shopify pelo número.”

“O Fin continua dizendo que não encontra o pedido. Você pode corrigir o conector Get Order?”

Pesquise seus conectores e leia a configuração completa de cada um.

Leia a resposta de teste salva de um conector ou a resposta simulada.

Veja quais workflows e procedimentos usam um conector.

Verifique as taxas de sucesso recentes e o histórico de execuções. Ele vê status e tempo, não o que foi enviado ou recebido.

Liste os atributos que podem ser usados na requisição ou como alvos de mapeamento.

Liste seus tokens de autenticação por nome e tipo. Ele nunca vê o segredo.

O cabeçalho mostra o nome do conector e um selo New, Live, Draft ou Paused. Uma renomeação mostra o nome antigo riscado.

API mostra o método, URL, entradas de dados, cabeçalhos, payload, teste e tokens de autenticação.

Data mostra os campos de resposta, código Python e mapeamentos de objetos.

Fin mostra o prompt que o Fin lê e o público-alvo.

Security mostra a configuração de autenticação do cliente.

Para uma edição, o cartão mostra as mudanças em relação à versão ao vivo. Seções inalteradas começam recolhidas, e cada seção mostra quantas linhas foram adicionadas e removidas.

Tokens de autenticação são mostrados apenas pelo nome.

Em um conector ativo, o botão principal é Publish. Save as draft (ou Update draft, se existir um rascunho) está no menu.

Em um conector novo, rascunho ou pausado, o botão principal é Save as draft (ou Update draft). Publish está no menu.

Publish pergunta “Pronto para publicar?” primeiro. Fica desabilitado até que o teste do Operator seja aprovado, a menos que o conector use uma resposta simulada. Uma edição que não altera a requisição (URL, método, cabeçalhos, corpo, entradas e tokens de autenticação) mantém o teste aprovado anterior do conector.

Uma exclusão mostra um botão vermelho Delete e um aviso de que não pode ser desfeita.

O ícone de lixeira (Discard change) descarta a proposta.

Apply all aplica todas as alterações no chat. Um conector novo é salvo como rascunho, e uma edição mantém seu estado atual, ativo ou rascunho.

Nome e descrição — Os colegas veem a descrição nas configurações do conector.

A requisição — URL, método, cabeçalhos e corpo. A URL deve ser HTTPS.

Entradas de dados — Os valores que o Fin coleta do cliente, como um número de pedido. Cada entrada tem nome, tipo e descrição, é marcada como obrigatória ou opcional, e pode ter um valor padrão.

Tokens de autenticação — O Operator pode anexar ou desanexar tokens existentes. Cada token é enviado como seu próprio cabeçalho.

Campos de resposta — Construídos a partir de uma resposta de teste ou resposta simulada. Eles decidem quais campos o Fin vê, como cada um é chamado, seu formato e como valores codificados são traduzidos em palavras. Um bloco de código Python pode remodelar a resposta.

Resposta simulada — Um corpo de resposta de exemplo, usado para construir os campos de resposta antes que a API possa ser testada.

Mapeamentos de objetos — Escreva valores de resposta em atributos de conversa, usuário ou objeto personalizado.

Como o Fin usa — Se o Fin pode escolher o conector sozinho, o prompt que o Fin lê para decidir quando usá-lo, se o Fin pode escrever por meio dele, e um público construído a partir de segmentos.

Verificação do cliente — Se o Fin chama o conector apenas para clientes que passaram pela verificação de identidade.

Créditos do Operator — Chats com o Operator usam créditos do Operator como qualquer outro trabalho do Operator.

Você aplica todas as alterações — O Operator não pode publicar, salvar ou excluir um conector sozinho.

Testes enviam solicitações reais — Se um conector cria, atualiza ou exclui dados, testá-lo faz essa alteração no sistema conectado. Use registros de teste.

Tokens — O Operator não pode ver os valores dos tokens de autenticação, e não pode criar, editar ou excluir tokens. Adicione um novo token nas configurações de autenticação, depois peça ao Operator para anexá-lo. Mantenha chaves API em tokens, não na URL ou corpo, onde o Operator pode lê-las.

Aplicar substitui edições de rascunho não publicadas — O Operator constrói sua alteração na versão ao vivo. Aplicá-la, seja com Publish ou Save as draft, substitui quaisquer edições de rascunho feitas no editor desde então. Publique ou descarte suas próprias edições de rascunho primeiro.

Conectores ativos não podem ser excluídos — O Operator pode excluir apenas conectores em rascunho ou pausados. Para excluir um conector ativo, pause-o primeiro nas configurações. O Operator não pode pausar, retomar, duplicar ou arquivar conectores, nem reverter para uma versão anterior.

Conectores MCP — O Operator não pode editar, testar ou excluir conectores que vêm de um servidor MCP. Gerencie-os nas configurações do servidor MCP.

Sem modelos — O Operator não pode instalar um conector a partir de um modelo.

Tipos de entrada — O Operator não pode adicionar valores de entrada estáticos, ou tipos de entrada lista e objeto.

Releases — Alterações de conectores feitas pelo Operator são aplicadas diretamente ao conector. Elas não podem ser adicionadas a um Fin Release.

Pré-visualização Fin — Quando o Operator faz uma pergunta de teste ao Fin, o Fin usa a resposta de teste salva ou simulada em vez de chamar a API. Exclusões pendentes não são pré-visualizadas, e uma alteração sem resposta de teste ou simulada não tem nada para retornar.

Link de configurações — Na lista “Você aplicou” do chat, o nome do conector não tem link para sua página de configurações. Abra o conector nas configurações de Conectores de Dados.