Passo 4 · Evidência operacional · Evidência operacional · Integração K3, Responses e tools PT-BREN
CLIProxyAPI 7.2.70 · kimi-k3 · Visual Course

Integração K3, Responses e tools

kimi-k3 é o nome público; k3 é o nome upstream. O mesmo exemplo precisa responder em chat, Responses estruturado e tools.

Leia primeiro (fonte primária)
CONFIG-MODEL-POLICY-EVIDENCE.md

Registro local redigido do gateway em execução e do exemplo kimi-k3.

Leia a versão simples, ou abra a camada técnica em qualquer seção.
1

A grande ideia


kimi-k3 é o nome público; k3 é o nome upstream. O mesmo exemplo precisa responder em chat, Responses estruturado e tools.

Pense como… É um intérprete entre dois idiomas: o apelido local não altera o nome que o provedor entende. A analogia falha porque cada protocolo possui envelope próprio..

Por baixo do capô

Chat retornou upstream k3 e sentinela; Responses estruturado retornou completed e sentinela; tools preservou echo_probe sem enviar tool_choice. reasoning_effort=max é registrado nos dois protocolos.

2

Em uma imagem


01 · alias kimi-k3alias kimi-k3governaupstream k3kimi-k3 mapeia para upstream k3.
alias kimi-k3 — governa — kimi-k3 mapeia para upstream k3.
3

No código


Este é o caminho local real e um comando seguro de leitura.

CONFIG-MODEL-POLICY-EVIDENCE.md
# trecho real, não editado
node validation-harness/validate-gateway-full-window.mjs
# use structured Responses input; keep the local credential outside output

Acesse você mesmo

node validation-harness/validate-gateway-full-window.mjs # use structured Responses input; keep the local credential outside output

4

Experimente


Use os controles para recuperar a evidência antes de ler a explicação.

02 · upstream k3upstream k3confere comchat completionsResponses estruturado devolveu mensagem e sentinela.
upstream k3 — confere com — Responses estruturado devolveu mensagem e sentinela.
03 · chat completionschat completionsroteia paraResponses inputecho_probe chegou sem tool_choice.
chat completions — roteia para — echo_probe chegou sem tool_choice.
04 · Responses inputResponses inputexcluiitem reasoningkimi-k3 mapeia para upstream k3.
Responses input — exclui — kimi-k3 mapeia para upstream k3.
05 · item reasoningitem reasoningprovaitem messageResponses estruturado devolveu mensagem e sentinela.
item reasoning — prova — Responses estruturado devolveu mensagem e sentinela.
06 · item messageitem messagedelimitastatus completedecho_probe chegou sem tool_choice.
item message — delimita — echo_probe chegou sem tool_choice.
07 · status completedstatus completedmapeia parareasoning maxkimi-k3 mapeia para upstream k3.
status completed — mapeia para — kimi-k3 mapeia para upstream k3.
08 · reasoning maxreasoning maxreinicia comotools envelopeResponses estruturado devolveu mensagem e sentinela.
reasoning max — reinicia como — Responses estruturado devolveu mensagem e sentinela.
09 · tools envelopetools envelopepreservaecho_probeecho_probe chegou sem tool_choice.
tools envelope — preserva — echo_probe chegou sem tool_choice.
10 · echo_probeecho_probecompara comtool_choice filtradokimi-k3 mapeia para upstream k3.
echo_probe — compara com — kimi-k3 mapeia para upstream k3.
11 · tool_choice filtradotool_choice filtradoretornasentinela chatResponses estruturado devolveu mensagem e sentinela.
tool_choice filtrado — retorna — Responses estruturado devolveu mensagem e sentinela.
12 · sentinela chatsentinela chatconfirmasentinela Responsesecho_probe chegou sem tool_choice.
sentinela chat — confirma — echo_probe chegou sem tool_choice.
13 · sentinela Responsessentinela Responsesqualificaalias kimi-k3 registro de verificaçãokimi-k3 mapeia para upstream k3.
sentinela Responses — qualifica — kimi-k3 mapeia para upstream k3.
14 · alias kimi-k3 registro de verificaçãoalias kimi-k3 registro de verificaçãoregistraalias kimi-k3Responses estruturado devolveu mensagem e sentinela.
alias kimi-k3 registro de verificação — registra — Responses estruturado devolveu mensagem e sentinela.

Resumo em três quadros

1 Alias local aponta para k3
2 Chat e Responses diferem
3 Tools chegam sem tool_choice
Chat retornou upstream k3 e sentinela; Responses estruturado retornou completed e sentinela; tools preservou echo_probe sem enviar tool_choice. reasoning_effort=max é registrado nos dois protocolos.
Registre a observação, preserve a exceção e escolha a próxima prova estreita.
recupereAlias público kimi-k3clique para virar
kimi-k3 mapeia para upstream k3.
recupereEnvelope Responses estruturadoclique para virar
Responses estruturado devolveu mensagem e sentinela.
recupereTool echo_probeclique para virar
echo_probe chegou sem tool_choice.
Preveja antes de revelar

Por que usar input estruturado em Responses?

A forma estruturada foi a que preservou item de mensagem e sentinela na evidência.

Exemplo resolvido
1Abra CONFIG-MODEL-POLICY-EVIDENCE.md.
2Confronte alias kimi-k3 com item message.
3Registre sentinela chat como próxima prova.
Revisão de recuperação
Por que usar input estruturado em Responses?

A forma estruturada foi a que preservou item de mensagem e sentinela na evidência.

Pergunte qual fronteira você provaria a seguir; a próxima lição reduz outro risco operacional.