Pular para as operações

IA

OpenAI em um fluxo de decisão.

4 OpenAI operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
IA
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

O laboratório de IA por trás do GPT e do ChatGPT.

A OpenAI é uma empresa de pesquisa em IA que vende acesso aos modelos GPT por uma API, além do ChatGPT. Para decisão, as superfícies relevantes são geração de texto, extração estruturada e embeddings — transformar texto em vetor, que é o que torna prático deduplicar campos de texto livre.

O que um fluxo pode chamar

4 operações, cada uma um passo que você coloca no editor.

  1. POST/v1/responses

    Perguntar a um modelo (Responses)

    O endpoint de texto atual — Responses, e não Chat Completions.

  2. POST/v1/responses

    Extrair JSON estruturado

    O mesmo endpoint restrito a um esquema JSON, para que a resposta seja lida sem precisar de regex.

  3. POST/v1/embeddings

    Gerar embedding de texto (vetor)

    Transforma texto em vetor para trabalhos de similaridade — casar um empregador ou endereço em texto livre com valores conhecidos, ou identificar propostas quase duplicadas.

  4. GET/v1/models

    Listar modelos disponíveis

    Os ids de modelo que a chave realmente alcança. Jeito mais barato de confirmar que uma chave funciona, e melhor do que fixar uma lista que envelhece.

Onde isso entra na decisão

AI calls have a natural place in a flow.

Uma chamada a modelo serve para o julgamento que uma tabela não expressa — ler um documento, resumir um dossiê, pesar uma narrativa. Como a saída não é determinística, o fluxo a restringe com um esquema e guarda o prompt e a resposta na trilha, para que o raciocínio por trás de um encaminhamento continue tão inspecionável quanto uma regra.

Whatever OpenAI returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add OpenAI as a connection authenticating with an API key.
  • 02A OpenAI tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Perguntar a um modelo (Responses)” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a OpenAI em um fluxo.

Como conecto a OpenAI a um fluxo de decisão?

Adicione a OpenAI como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a OpenAI em uma decisão sem nunca ver o segredo.

Dá para testar a OpenAI sem tocar em produção?

A OpenAI expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na OpenAI?

4 operações, incluindo “Perguntar a um modelo (Responses)”, “Extrair JSON estruturado”, “Gerar embedding de texto (vetor)”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Perguntar a um modelo (Responses)”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a OpenAI deve ser chamada?

Uma chamada a modelo serve para o julgamento que uma tabela não expressa — ler um documento, resumir um dossiê, pesar uma narrativa. Como a saída não é determinística, o fluxo a restringe com um esquema e guarda o prompt e a resposta na trilha, para que o raciocínio por trás de um encaminhamento continue tão inspecionável quanto uma regra.

Also in AI

Quando você quiser

Wire OpenAI into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação