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

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

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

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

Veja quais workflows, procedimentos e macros 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 da 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 não alteradas 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 é Publicar. Salvar como rascunho (ou Atualizar rascunho, se houver um rascunho) está no menu.

Em um conector novo, rascunho ou pausado, o botão principal é Salvar como rascunho (ou Atualizar rascunho). Publicar está no menu.

Publicar pergunta “Pronto para publicar?” primeiro. Fica desabilitado até que o teste do Operator seja aprovado, a menos que o conector use uma resposta mock. 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 Excluir e um aviso de que não pode ser desfeita.

O ícone de lixeira (Descartar alteração) descarta a proposta.

Aplicar tudo 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 mock. 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.

Uma resposta mock — 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 da 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 através 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 do 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, nem 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 baseia sua alteração na versão ao vivo. Aplicá-la, seja com Publicar ou Salvar como rascunho, 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, nem 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 do Fin — Quando o Operator faz uma pergunta de teste ao Fin, o Fin usa a resposta de teste salva ou mock em vez de chamar a API. Exclusões pendentes não são pré-visualizadas, e uma alteração sem resposta de teste ou mock não tem o que retornar.