Feedback de traces da uip

Sintaxe e opções para o "uip tracesfeedback", que cria e gerencia o feedback da Observabilidade do LLM anexado a um trace ou intervalo.

uip traces feedback gerencia o feedback da Observabilidade do LLM — uma classificação positiva/ negativa, comentário e tags de categoria anexadas a um trace ou intervalo. Use-a para registrar a revisão humana da saída de um agente ou para extrair feedback gravado de volta para relatórios.

Esta página faz parte da ferramenta uip traces — consulte essa página para spans get.

Resumo

uip traces feedback create --trace-id <id> (--positive | --negative) --folder-key <guid> [--span-id <id>] [--comment <text> | --comment-file <path>] [--category <tag>...] [--agent-id <guid>] [--agent-version <str>]
uip traces feedback get <id> [--folder-key <guid>]
uip traces feedback list [--agent-id <guid>] [--agent-version <str>] [--trace-id <id>] [--span-id <id>] [--status <value>...] [--positive | --negative] [--limit <n>] [--offset <n>] [--folder-key <guid>]
uip traces feedback list detailed [--agent-id <guid>] [--agent-version <str>] [--trace-id <id>] [--span-id <id>] [--status <value>...] [--positive | --negative] [--category-id <guid>...] [--after <iso> | --since <duration>] [--before <iso>] [--sort-by <field>] [--sort-order <dir>] [--limit <n>] [--offset <n>] [--folder-key <guid>]
uip traces feedback update <id> (--positive | --negative) --folder-key <guid> [--comment <text> | --comment-file <path>] [--metadata <json> | --metadata-file <path>] [--category <tag>...]
uip traces feedback delete <id> --folder-key <guid> -y

Todos os verbos honram as opções globais e os códigos de saída padrão.

criação de feedback de traces do uip

Crie feedback para um trace (ou um período específico dentro dele).

Opções

Bandeira	Description
--trace-id <id>	Obrigatório. ID do trace (hex de 32 caracteres ou GUID).
--positive / --negative	Necessário — exatamente um. Sentimento do feedback.
--folder-key <guid>	Obrigatório. Chave da pasta do Orchestrator.
--span-id <id>	ID do intervalo. Quando omitido, o padrão é o intervalo raiz do trace.
--comment <text>	Anotação de texto livre (máximo de 1.048.576 caracteres). mutuamente exclusivo com --comment-file.
--comment-file <path>	Leia o comentário de um arquivo; passe - para ler a partir de stdin. Mutualmente exclusivo com --comment.
--category <tag>	Tag da categoria. Repetível. A plataforma reconhece tags integradas como Output, Agent Error e Agent Plan Execution, mas qualquer string é aceita.
--agent-id <guid>	ID de referência do agente.
--agent-version <str>	Versão do agente (máximo de 100 caracteres).

Exemplo

uip traces feedback create \
  --trace-id 4bf92f3577b34da6a3ce929d0e0e4736 \
  --positive \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

Formato dos dados

{
  "Code": "FeedbackCreate",
  "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000002" }
}

Data é uma passagem não modificada do que a API Feedback retorna — a CLI não o projeta para um conjunto de campos fixo, então a resposta real pode carregar mais campos do que os mostrados aqui.

feedback de traces do uip obter

Obtenha um único registro de feedback por ID.

Argumentos

• <id> necessário) — ID de registro de feedback (GUID). A falha no lado do cliente com "Formato de ID de feedback inválido" se não for um GUID.

Opções

Bandeira	Description
--folder-key <guid>	Chave da pasta do Orchestrator. O servidor geralmente requer isso para autorizar a leitura, mesmo que a CLI não falhe sem ela no lado do cliente.

Exemplo

uip traces feedback get a1b2c3d4-0000-0000-0000-000000000002 \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

Formato dos dados

{
  "Code": "FeedbackGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "IsPositive": true
  }
}

Como create, Data é uma passagem bruta — a resposta real normalmente carrega mais campos (comentário, metadados, categorias, carimbos de data/hora) do que esse exemplo mínimo mostra.

lista de feedback de rastreamentos do uip

Liste entradas de feedback, filtradas por trace, período, agente, status ou sentimento.

Opções

Bandeira	Description
--agent-id <guid>	Filtrar por ID do agente.
--agent-version <str>	Filtra por versão do agente.
--trace-id <id>	Filtrar por ID do trace.
--span-id <id>	Filtrar por ID de intervalo.
--status <value>	Filtrar por status: Pending, Approved, Dismissed. Repetível.
--positive / --negative	Retorne apenas feedback positivo ou somente negativo. Mutualmente exclusivos.
--limit <n>	Resultados máximos. O padrão é 20, limitado a 100.
--offset <n>	Resultados a ignorar. O padrão é 0.
--folder-key <guid>	Chave da pasta do Orchestrator.

Exemplo

uip traces feedback list --trace-id 4bf92f3577b34da6a3ce929d0e0e4736

Formato dos dados

{
  "Code": "FeedbackList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000002",
      "IsPositive": true
    }
  ]
}

Um resultado vazio imprime "Nenhum feedback encontrado". Use "uip traces feedback criar" para adicionar feedback.".

lista detalhada de feedback de rastreamentos do uip

Liste feedback com filtros estendidos (janela de tempo, categoria, classificação) e contexto de intervalo. Este é um subcomando de list, não um verbo de nível superior — a invocação é uip traces feedback list detailed, com o espaço, não list-detailed.

Opções

Bandeira	Description
--agent-id <guid>	Filtrar por ID do agente.
--agent-version <str>	Filtra por versão do agente.
--trace-id <id>	Filtrar por ID do trace.
--span-id <id>	Filtrar por ID de intervalo.
--status <value>	Filtrar por status: Pending, Approved, Dismissed. Repetível.
--positive / --negative	Retorne apenas feedback positivo ou somente negativo. Mutualmente exclusivos.
--category-id <guid>	Filtra por ID de categoria. Repetível.
--after <iso>	Criado após este carimbo de data/hora ISO 8601.
--before <iso>	Criado antes deste carimbo de data/hora ISO 8601.
--since <duration>	Atalho de Lookback relativo para --after — por exemplo, 1h, 24h, 7d. Apenas unidades h (horas) e d (dias) são aceitas.
--sort-by <field>	Campo de classificação: createdAt ou updatedAt. O padrão é createdAt.
--sort-order <dir>	Direção da classificação: asc ou desc. O padrão é desc.
--limit <n>	Resultados máximos. O padrão é 20, limitado a 200 (maior que o limite de 100 de list simples).
--offset <n>	Resultados a ignorar. O padrão é 0.
--folder-key <guid>	Chave da pasta do Orchestrator.

Observação:

--since e --after definem o mesmo filtro de hora de início subjacente — --since é avaliado em relação a "agora" no momento em que o comando é executado.

Exemplo

uip traces feedback list detailed --since 24h

Formato dos dados

{
  "Code": "FeedbackListDetailed",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000002",
      "IsPositive": true,
      "TraceId": "4bf92f3577b34da6a3ce929d0e0e4736"
    }
  ]
}

A resposta da API subjacente é paginada ({ items, totalCount }), mas a CLI emite apenas a matriz items como Data — a contagem total de correspondências (totalCount) não é exibida. Para saber se existem mais resultados além de --limit, compare a contagem retornada com --limit em vez de confiar em um total.

Atualização de feedback de rastreamentos do uip

Atualizar o sentimento, o comentário, os metadados ou as categorias de um registro de feedback existente.

Importante:

A API substitui o registro inteiro em vez de corrigi-lo, então a CLI lê o registro existente primeiro e carrega qualquer campo que você não passou — exceto --category: omitir isso deixa as categorias existentes intactas, mas essa leitura e gravação é não anônimo. Um destino de edição simultâneo entre a leitura e a gravação é perdido silenciosamente.

Argumentos

• <id> necessário) — ID de registro de feedback (GUID).

Opções

Bandeira	Description
--positive / --negative	Necessário — exatamente um. Novo sentimento.
--folder-key <guid>	Obrigatório. Chave da pasta do Orchestrator.
--comment <text>	Comentário atualizado (máximo de 1.048.576 caracteres). mutuamente exclusivo com --comment-file. Omita para manter o comentário existente.
--comment-file <path>	Ler o comentário atualizado de um arquivo; passe - para stdin. Mutualmente exclusivo com --comment.
--metadata <json>	Metadados atualizados; deve ser um JSON válido (máximo de 1.048.576 caracteres). mutuamente exclusivo com --metadata-file. Omita para manter os metadados existentes.
--metadata-file <path>	Ler metadados atualizados de um arquivo; passe - para stdin. Mutualmente exclusivo com --metadata.
--category <tag>	Tags de categoria de substituição. Repetível. Omita totalmente para deixar as categorias existentes como estão — passá-lo substitui o conjunto completo, ele não mescla.

Exemplos

# change sentiment and add a comment
uip traces feedback update a1b2c3d4-0000-0000-0000-000000000002 \
  --negative \
  --comment "Wrong output" \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

# attach metadata read from a file
uip traces feedback update a1b2c3d4-0000-0000-0000-000000000002 \
  --positive \
  --metadata-file review.json \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001

Formato dos dados

{
  "Code": "FeedbackUpdate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "IsPositive": false
  }
}

exclusão de feedback de traces do uip

Excluir um registro de feedback por ID. Esta é uma operação destrutiva — requer -y, --yes; a CLI nunca solicita.

Argumentos

• <id> necessário) — ID de registro de feedback (GUID).

Opções

Bandeira	Description
--folder-key <guid>	Obrigatório. Chave da pasta do Orchestrator.
-y, --yes	Confirme esta operação irreversível. Necessário — a CLI nunca solicita.

Exemplo

uip traces feedback delete a1b2c3d4-0000-0000-0000-000000000002 \
  --folder-key a1b2c3d4-0000-0000-0000-000000000001 \
  --yes

Formato dos dados

{
  "Code": "FeedbackDelete",
  "Data": { "Id": "a1b2c3d4-0000-0000-0000-000000000002" }
}

Comportamento de erro

• 401 da API deFailure: "Not authenticated. Run 'uip auth login' first." Feedback:.
• 403: Failure: "Insufficient permissions. Ensure you have Logs.View / Logs.Create / Logs.Delete on this folder.".
• 404: Failure nomeando o ID de feedback ausente.
• Um ID que não é um GUID (get, update, delete): Failure: "Invalid feedback ID format: <id>", verificado no lado do cliente antes de qualquer chamada de rede.

Relacionado

• uip traces spans get — origem dos valores --trace-id/--span-id usados acima.
• Ferramentas ( plugins ) — instalam, atualizam e desinstalam o pacote traces-tool .
• uip login — sessão usada para autenticar cada verbo nesta página.

Veja também

• uip traces