Pular para o conteúdo principal
Chame uma predefinição do painel a partir do Python com um JSON Schema, depois valide a resposta e registre os IDs de que você precisa para depurá-la. No fim, você tem um script que envia "model": "@release-summary", recebe {"summary": ..., "risk_level": ...} e imprime os detalhes de provedor e de plugin dessa solicitação. O script fica pronto para produção depois que você substituir a predefinição e o schema pelos seus. Mantenha a etapa de validação: o reparo corrige a sintaxe, não o conteúdo.

Crie

1

Crie a predefinição

Em Configurações → Predefinições, crie release-summary com o prompt de sistema, o modelo ou os modelos permitidos, as preferências de provedor, as configurações de raciocínio e a temperature que todos os chamadores devem compartilhar. Assim, o código Python só envia o que varia. Predefinições explica como a predefinição se combina com a solicitação.
2

Instale o SDK

3

Escreva o script

release_summary.py
4

Execute

Confira se funcionou

O script imprime o ID da resposta, o modelo e o provedor que responderam, o registro do plugin e um dict com summary e um dos valores low, medium ou high. Procure o ID da resposta em Configurações → Uso → Registros para ver a mesma solicitação com os detalhes de roteamento. Um modelo fora dos modelos permitidos da predefinição falha com validation_error (palavra-chave preset_model_not_allowed). Um ValueError vindo de validate() significa que o JSON foi analisado, mas o conteúdo estava errado: restrinja o schema ou o prompt em vez de adicionar novas tentativas.

Depure antes de substituir

Se uma solicitação for roteada de um jeito diferente do esperado, abra-a nos registros, leia Observabilidade do roteamento e o registro do plugin, e só mude a predefinição quando os registros mostrarem o que aconteceu. Acumular substituições inline em uma solicitação acaba com o propósito da predefinição; se um chamador realmente precisa de outro comportamento, dê a ele uma predefinição própria.
Última modificação em 5 de novembro de 2026