Faça o deploy do seu workflow como uma interface de chat conversacional, que as pessoas podem usar por um link compartilhável ou por um widget incorporado. O chat suporta conversas com vários turnos, upload de arquivos e entrada por voz.
Cada mensagem do chat dispara uma nova execução do workflow, com todo o histórico da conversa passado como contexto. As respostas são transmitidas de volta em tempo real.
As execuções do chat rodam contra o snapshot do deployment ativo do seu workflow. Publique um novo deployment depois de alterar o workflow no builder para que o chat use a versão atualizada.
Criando um chat
Abra seu workflow, clique em Deploy e selecione a aba Chat. Você verá o painel de configuração do chat:
Configure os campos abaixo e clique em Launch Chat:
| Campo | Descrição |
|---|---|
| URL | Slug que forma a URL pública, por exemplo https://agent-studio.seeyu.ai/chat/your-slug. Apenas letras minúsculas, números e hifens. Precisa ser único entre todos os workspaces. |
| Title | Nome exibido no cabeçalho do chat. |
| Output | Campos de saída dos blocos do seu workflow retornados como resposta do chat. Pelo menos um precisa estar selecionado. |
| Welcome Message | Saudação exibida antes de a pessoa enviar a primeira mensagem. O padrão é "Hi there! How can I help you today?". |
| Access Control | Controla quem pode acessar o chat. Veja Controle de acesso abaixo. |
| Include thinking | Quando habilitado, o chat hospedado pode mostrar o thinking exposto pelo provider. Exige que o cliente de chat envie X-Studio-Stream-Protocol: agent-events-v1 (a UI hospedada sempre envia). O padrão é desligado. Veja Eventos de stream do Agent. |
| Include tool calls | Quando habilitado, o chat hospedado pode mostrar nomes de ferramentas e o status do ciclo de vida, de forma independente do thinking. Argumentos e resultados de ferramentas nunca são expostos. Exige o mesmo header de protocolo de stream e vem desligado por padrão. |
Seleção da saída
O dropdown de saída agrupa os campos disponíveis por bloco. Para um bloco Agent, você pode escolher entre content, model, tokens, toolCalls, providerTiming e cost. Na maioria dos casos, selecionar content do bloco Agent final é tudo o que você precisa — isso transmite a resposta em texto do agente direto para a pessoa.
Controle de acesso
| Modo | Descrição |
|---|---|
| Public | Qualquer pessoa com o link pode conversar — sem autenticação |
| Password | É preciso digitar uma senha antes de começar a conversar |
| Apenas endereços de e-mail ou domínios específicos têm acesso. A verificação é feita com um OTP de 6 dígitos enviado por e-mail | |
| SSO | Single sign-on baseado em OIDC (apenas enterprise) |
Acesso por e-mail: adicione endereços individuais (user@example.com) ou domínios inteiros (@example.com) ao campo Allowed emails. A pessoa recebe um OTP de 6 dígitos de uso único na caixa de entrada — depois de verificar, pode conversar durante toda a sessão.
Acesso por senha: um campo de senha aparece quando esse modo é selecionado. Compartilhe a senha diretamente com as pessoas; elas a digitam antes de a conversa começar.
SSO: usa OIDC para autenticar pessoas pelo seu provedor de identidade. Disponível nos planos enterprise.
Compartilhamento
Link direto
https://agent-studio.seeyu.ai/chat/your-slugIframe
<iframe
src="https://agent-studio.seeyu.ai/chat/your-slug"
width="100%"
height="600"
frameborder="0"
title="Chat"
></iframe>Envio pela API
Você também pode enviar mensagens para um chat de forma programática. As respostas são transmitidas com server-sent events (SSE).
curl -X POST https://agent-studio.seeyu.ai/api/chat/your-slug \
-H "Content-Type: application/json" \
-d '{
"input": "Hello, I need help with my order",
"conversationId": "optional-conversation-id"
}'const response = await fetch('https://agent-studio.seeyu.ai/api/chat/your-slug', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
input: 'Hello, I need help with my order',
conversationId: 'optional-conversation-id'
})
});
// Response is an SSE stream
const reader = response.body?.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader!.read();
if (done) break;
console.log(decoder.decode(value));
}Com upload de arquivos
curl -X POST https://agent-studio.seeyu.ai/api/chat/your-slug \
-H "Content-Type: application/json" \
-d '{
"input": "What does this document say?",
"files": [{
"name": "report.pdf",
"type": "application/pdf",
"size": 1048576,
"data": "data:application/pdf;base64,..."
}]
}'Chats protegidos
Para chats protegidos por senha, inclua a senha no corpo da requisição:
curl -X POST https://agent-studio.seeyu.ai/api/chat/your-slug \
-H "Content-Type: application/json" \
-d '{ "password": "secret", "input": "Hello" }'Para chats protegidos por e-mail, autentique-se primeiro com o OTP:
# Step 1: Request OTP — sends a 6-digit code to the email address
curl -X POST https://agent-studio.seeyu.ai/api/chat/your-slug/otp \
-H "Content-Type: application/json" \
-d '{ "email": "allowed@example.com" }'
# Step 2: Verify OTP — save the Set-Cookie header for subsequent requests
curl -X PUT https://agent-studio.seeyu.ai/api/chat/your-slug/otp \
-H "Content-Type: application/json" \
-c cookies.txt \
-d '{ "email": "allowed@example.com", "otp": "123456" }'
# Step 3: Send messages using the auth cookie from Step 2
curl -X POST https://agent-studio.seeyu.ai/api/chat/your-slug \
-H "Content-Type: application/json" \
-b cookies.txt \
-d '{ "input": "Hello" }'Resolução de problemas
O chat retorna 403 — O deployment está inativo. Abra o modal Deploy e faça o deploy do workflow novamente.
"At least one output block is required" — Nenhum campo de saída está selecionado no dropdown Output. Abra o modal Deploy, vá para a aba Chat e selecione ao menos uma saída de um bloco.
O e-mail com o OTP não chega — Confirme que o endereço está na lista de permitidos e verifique a pasta de spam. Os códigos OTP expiram em 15 minutos e podem ser reenviados depois de um intervalo de 30 segundos.
O chat não carrega no iframe — Verifique se a Content Security Policy do seu site permite iframes de agent-studio.seeyu.ai.
As respostas não mudam depois de alterar o workflow — O chat usa o snapshot do deployment ativo. Publique um novo deployment pelo modal Deploy para incorporar suas últimas alterações.