effort.go (package eai)
Source : sdks/go/effort.go. Retour à l'index de la référence du SDK Go.
Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.
Alias de type Effort
Effort est l'effort de raisonnement normalisé (common.schema.json#/$defs/effort), traduit pour chaque modèle par le Capability Resolver.
Définition : string.
Valeurs :
| Membre | Valeur | Description |
|---|---|---|
EffortNone | "none" | Aucun raisonnement, valeur none sur le réseau. |
EffortLow | "low" | Effort de raisonnement faible, valeur low sur le réseau. |
EffortMedium | "medium" | Effort de raisonnement moyen, valeur medium sur le réseau. |
EffortHigh | "high" | Effort de raisonnement élevé, valeur high sur le réseau. |
EffortMax | "max" | Effort de raisonnement maximal, valeur max sur le réseau. |
Effort.Valid
Valid() bool
Valid indique si e est un effort connu.
Cet élément ne prend aucun paramètre.
Retour : bool. true pour none, low, medium, high et max.
Classe ContextBudget
ContextBudget est le budget de jetons d'un appel de modèle : B_context = W_model - B_output - B_reasoning - B_safety (Context Contract v1, champ budget).
Champs :
| Nom | Type | Requis | Description |
|---|---|---|---|
Window (window) | int | oui | Fenêtre de contexte du modèle en jetons (window). |
OutputReserved (output_reserved) | int | oui | Jetons réservés à la sortie du modèle (output_reserved). |
ReasoningReserved (reasoning_reserved) | int | oui | Jetons réservés au raisonnement du modèle (reasoning_reserved). |
SafetyMargin (safety_margin) | int | oui | Marge de sécurité en jetons (safety_margin) ; NewContextBudget la fixe à 5 pour cent de la fenêtre, au moins 256. |
ContextBudget.Context
Context() int
Context renvoie les jetons restants pour le contexte assemblé (négatif quand les réservations dépassent la fenêtre).
Cet élément ne prend aucun paramètre.
Retour : int. Window moins les réservations de sortie, de raisonnement et de sécurité, en jetons.
ContextBudget.Fits
Fits(tokens int) bool
Fits indique si tokens tient dans le budget de contexte.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
tokens | int | oui | Nombre de jetons du contexte à placer. |
Retour : bool. true quand tokens vaut au plus Context().
ContextBudget.MarshalJSON
MarshalJSON() ([]byte, error)
MarshalJSON ajoute le champ calculé context_budget.
Cet élément ne prend aucun paramètre.
Retour : ([]byte, error). JSON des quatre champs plus context_budget, la valeur de Context().
Erreurs levées : error.
ContextBudget.Overflow
Overflow(tokens int) int
Overflow renvoie combien de jetons retirer pour tenir (0 si ça tient).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
tokens | int | oui | Nombre de jetons du contexte à placer. |
Retour : int. Jetons au-delà de Context(), 0 quand tokens tient.
Fonctions
ParseEffort
ParseEffort(s string) (Effort, error)
ParseEffort valide une valeur reçue sur le réseau.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
s | string | oui | Valeur du réseau : none, low, medium, high ou max. |
Retour : (Effort, error). Un Effort : l'effort de raisonnement normalisé (common.schema.json#/$defs/effort), traduit pour chaque modèle par le Capability Resolver. L'error est une erreur typée du SDK, nil en cas de succès.
Erreurs levées : error.
NewContextBudget
NewContextBudget(window int, output int, reasoning int) ContextBudget
NewContextBudget prend une marge de sécurité par défaut de 5 pour cent de la fenêtre, au moins 256 jetons.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
window | int | oui | Fenêtre de contexte du modèle en jetons. | |
output | int | oui | Jetons réservés à la sortie du modèle. | |
reasoning | int | oui | Jetons réservés au raisonnement du modèle. |
Retour : ContextBudget. Un ContextBudget : le budget de jetons d'un appel de modèle, B_context = W_model - B_output - B_reasoning - B_safety (Context Contract v1, champ budget).
EstimateTokens
EstimateTokens(text string) int
EstimateTokens applique l'heuristique caractères/4 de l'estimateur de repli du Control Plane.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
text | string | oui | Texte à mesurer. |
Retour : int. Nombre de runes divisé par 4, arrondi au supérieur ; 0 pour un texte vide.