Afficher et personnaliser l’affichage des traces

Après avoir créé des appels dans W&B Weave, vous aurez souvent besoin d’ouvrir un appel précis pour examiner ses entrées, ses sorties et ses métadonnées. Cette page explique comment afficher un appel dans l’interface utilisateur ou avec le SDK, et comment personnaliser le rendu des données de trace dans l’interface utilisateur de Weave à l’aide de weave.Markdown. Utilisez les onglets ci-dessous pour choisir l’interface la mieux adaptée à votre flux de travail.

Application web
Python
TypeScript
API HTTP

Pour afficher un appel dans l’interface utilisateur :

Accédez à Forge et sélectionnez votre projet.
Dans la barre latérale du projet Weave, cliquez sur Traces.
Dans le tableau, repérez l’appel que vous souhaitez afficher.
Cliquez sur l’appel pour ouvrir sa page de détails.

Pour en savoir plus sur la vue de trace, consultez Naviguer dans la vue Weave Trace.

Pour afficher un appel à l’aide du SDK Python de W&B Weave, utilisez la méthode get_call :

import weave

# Initialiser le client
client = weave.init("your-project-name")

# Obtenir un appel spécifique à partir de son ID
call = client.get_call("call-uuid-here")

print(call)

import * as weave from 'weave'

// Initialiser le client
const client = await weave.init('intro-example')

// Obtenir un appel spécifique à partir de son ID
const call = await client.getCall('call-uuid-here')

console.log(call)

Pour afficher un appel à l’aide de l’API de service, envoyez une requête au point de terminaison /call/read.

curl -L 'https://trace.wandb.ai/call/read' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "project_id": "string",
    "id": "string",
}'

Personnaliser le rendu des traces avec `weave.Markdown`

Une fois que vous pouvez afficher un appel, vous souhaiterez peut-être contrôler la façon dont ses entrées et ses sorties apparaissent dans l’interface utilisateur. Utilisez weave.Markdown pour personnaliser l’affichage des informations de trace dans Weave sans perdre les données d’origine. Vous pouvez ainsi présenter vos entrées et sorties sous forme de blocs de contenu formaté et lisible, tout en préservant la structure des données sous-jacentes.

Python
TypeScript

Utilisez les fonctions postprocess_inputs et postprocess_output dans votre décorateur @weave.op pour mettre en forme vos données de trace. L’exemple de code suivant utilise des fonctions de post-traitement pour afficher un appel dans Weave avec une mise en forme plus lisible :

import weave

def postprocess_inputs(query) -> weave.Markdown:
    search_box = f"""
**Search Query:**
``+`
{query}
``+`
"""
    return {"search_box": weave.Markdown(search_box),
            "query": query}

def postprocess_output(docs) -> weave.Markdown:
    formatted_docs = f"""
# {docs[0]["title"]}

{docs[0]["content"]}

[Read more]({docs[0]["url"]})

---

# {docs[1]["title"]}

{docs[1]["content"]}

[Read more]({docs[1]["url"]})
"""
    return weave.Markdown(formatted_docs)

@weave.op(
    postprocess_inputs=postprocess_inputs,
    postprocess_output=postprocess_output,
)
def rag_step(query):
    # exemples d'articles de presse sur des entreprises du S&P 500
    docs = [
        {
            "title": "OpenAI",
            "content": "OpenAI is a company that makes AI models.",
            "url": "https://www.openai.com",
        },
        {
            "title": "Google",
            "content": "Google is a company that makes search engines.",
            "url": "https://www.google.com",
        },
    ]
    return docs

if __name__ == "__main__":
    weave.init('markdown_renderers')
    rag_step("Tell me about OpenAI")

Cette fonctionnalité n'est pas encore disponible dans le SDK TypeScript.

Une fois l’op exécuté, Weave affiche le Markdown mis en forme à côté des données d’origine dans la page de détails de l’appel. La capture d’écran suivante présente côte à côte les sorties brutes et les sorties mises en forme. Un appel affiché dans l’interface utilisateur de Weights & Biases à l’aide de l’exemple de code.

​Personnaliser le rendu des traces avec weave.Markdown

Personnaliser le rendu des traces avec `weave.Markdown`