docs: refresh translations for recent English changes (#3379)
This commit is contained in:
parent
d8b638304e
commit
c5d7d0b6d0
2 changed files with 3149 additions and 1047 deletions
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
translation:
|
||||
sections: [335ca2a0b266f003, d1ad562d3fe87bc0, 0bb1396c86daeba4, d1cb1235bb9ee267, 833179c09d239c83, e5d6dec2d2e655e8]
|
||||
sections: [335ca2a0b266f003, d1ad562d3fe87bc0, 25b49f89c9e6f9d0, d1cb1235bb9ee267, 833179c09d239c83, e5d6dec2d2e655e8]
|
||||
tool: 1
|
||||
---
|
||||
# Elicitação {#elicitation}
|
||||
|
|
@ -90,7 +90,8 @@ Esse schema é o formulário. `Field(description=...)` é o rótulo; um valor pa
|
|||
Um schema de elicitação não é tão expressivo quanto o schema de entrada de uma ferramenta.
|
||||
Só campos planos e primitivos: `str`, `int`, `float`, `bool` ou um `Literal` de strings
|
||||
(que vira um `enum`). Coloque um modelo dentro do modelo e `ctx.elicit` lança uma exceção
|
||||
antes de qualquer coisa ser enviada ao cliente:
|
||||
antes de qualquer coisa ser enviada ao cliente. A chamada da ferramenta falha com
|
||||
`Error executing tool <name>`, e o log do seu servidor tem o motivo:
|
||||
|
||||
```text
|
||||
TypeError: Elicitation schema field 'address' rendered as {'$ref': '#/$defs/Address'}, which is not a valid PrimitiveSchemaDefinition
|
||||
|
|
@ -113,8 +114,8 @@ Uma recusa não é um erro. A ferramenta decide o que recusar significa (aqui, n
|
|||
|
||||
!!! tip
|
||||
A resposta é validada contra seu modelo antes que seu código a veja. Um cliente que envia
|
||||
`"maybe"` para um `bool` não corrompe sua reserva: a chamada falha com um erro de
|
||||
incompatibilidade de schema, e seu `if` nem chega a executar.
|
||||
`"maybe"` para um `bool` não corrompe sua reserva: `ctx.elicit` lança `ValueError`, a
|
||||
chamada falha, e seu `if` nem chega a executar.
|
||||
|
||||
## Envie o usuário para uma URL {#send-the-user-to-a-url}
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
translation:
|
||||
sections: [c93a3e1aefd77955, 7851abd5ec54393b, f49d1ca2f330f9cd, c03764bd9dfeef7b, 4a0391691a674ae4, 2df5cd279eabf9f5]
|
||||
sections: [c93a3e1aefd77955, 7851abd5ec54393b, f49d1ca2f330f9cd, 4cc0a00347c3f534, 4a0391691a674ae4, 2df5cd279eabf9f5]
|
||||
tool: 1
|
||||
---
|
||||
# Logging {#logging}
|
||||
|
|
@ -54,6 +54,8 @@ O padrão é `"INFO"`.
|
|||
|
||||
`logging.basicConfig()` nunca substitui handlers que já existem. Se você configurar o logging por conta própria antes de criar o servidor, sua configuração vence.
|
||||
|
||||
Você também não precisa de um `try`/`except` em cada handler só para registrar falhas. Quando uma função de ferramenta ou de recurso levanta uma exceção, o SDK faz o log para você. **[Tratando erros](../servers/handling-errors.md#any-other-exception)** explica o que é registrado e em qual nível.
|
||||
|
||||
## Experimente {#try-it}
|
||||
|
||||
Execute o servidor com o MCP Inspector:
|
||||
|
|
|
|||
Loading…
Reference in a new issue