Criar sessão de chat embutido
Cria a sessão de um usuário da sua plataforma e devolve o `embed_url` para o `src` do iframe. O usuário não precisa de conta: ele é identificado pelo `user.id` que você manda. `restrictions` só restringe o que o agente já tem, `mcp` leva os cabeçalhos (só `authorization` e `x-*`) que o agente apresenta aos servidores MCP dos hosts que a aplicação declarou, e `context` entra no turno como dado da aplicação. O código no fragmento do `embed_url` vale 120 segundos e uma vez só.
Authorization
credencialDaAplicacao Credencial da aplicação vinculada, criada em Configurações > Aplicações: Authorization: Basic base64(client_id:client_secret). Use só no seu backend.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/embed/sessions" \ -H "Content-Type: application/json" \ -d '{ "agent": "string", "user": { "id": "string" } }'{ "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82", "embed_url": "string", "expires_at": "2019-08-24T14:15:22Z", "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84"}Consumo por pessoa da aplicação
O consumo de cada pessoa de uma aplicação: as do chat embutido e as indicadas com `user` nos runs da API, que são as mesmas pessoas. Cada linha traz o id que a aplicação mandou (`user`), o nome, as conversas, os turnos, os tokens, o custo em dólares, o último uso e a quebra por agente. `total` soma todas as pessoas do recorte, antes da página. A aplicação tem de ser da organização da chave; de outra organização, ou inexistente, a resposta é 404 `app_not_found`. Quem emitiu a chave precisa da leitura de consumo da Governança ou de administrar as aplicações (senão, 403 `forbidden`). Dado de todos os agentes, então a chave restrita a agentes é recusada (`agent_not_allowed`). Exige o escopo app_users:read.
Renovar sessão de chat embutido
Troca os cabeçalhos de MCP quando enviados, estende a sessão quando `ttl_seconds` vem (nunca encurta) e devolve um código e um `embed_url` novos. Chame quando o token do seu MCP mudar ou antes de a sessão vencer. O corpo é opcional: vazio, só emite o código novo.