Uso e solução de problemas
Encontre uma solicitação, entenda um limite e escolha o que corrigir antes de tentar novamente.
Descubra o que aconteceu
Abra Registros para ver a atividade do workspace. Para focar em uma identidade de agente, abra Perfis, selecione o nome e escolha Atividade.
Verifique a ação, o horário e o resultado em relação ao que a ferramenta tentou fazer. Um Perfil pode ter várias chaves; cada evento mostra o rótulo da chave que fez a chamada quando um está registrado. Alterações humanas também podem aparecer na atividade do workspace, então nem todo evento pertence a uma chave de agente.
Se uma ferramenta relatar um erro, mantenha o código de status e a mensagem para diagnóstico. Nunca inclua sua chave secreta em uma mensagem de suporte, captura de tela ou registro compartilhado.
Leia o uso diário e os limites
Abra Configurações → Faturamento para inspecionar os medidores de uso. A criação de Perfil inclui Orçamento diário (tokens) e Limite de perguntas (por dia). Todas as chaves que usam um Perfil compartilham essas configurações; adicionar uma chave não adiciona outra cota. Abra um perfil para alterar qualquer um dos números depois: reduzir um abaixo do que o perfil já usou hoje bloqueia novas chamadas até você aumentá-lo ou os contadores reiniciarem, e a alteração aparece no registro de atividade.
Um token é cerca de 4 caracteres de texto em inglês, aproximadamente três quartos de uma palavra. Três exemplos aproximados:
- Uma pergunta curta.
What is our refund policy?tem 26 caracteres, então 7 tokens, mais qualquer evidência que voltar. - Uma pergunta típica. Pergunta mais alguns trechos de evidência geralmente chega a algumas centenas de tokens.
- Um envio. Um documento de cinco páginas com cerca de 15,000 caracteres custa cerca de 3,750 tokens quando é indexado.
Para escala, os 300,000 tokens diários do Ember são cerca de 1,200,000 caracteres, aproximadamente oitenta documentos de cinco páginas indexados por dia. Isso é muito mais do que algumas centenas de perguntas vão gastar.
Então, para perguntas e respostas comuns, você geralmente atingirá a contagem de perguntas primeiro. Algumas centenas de perguntas diárias a algumas centenas de tokens cada fica muito abaixo da cota de tokens do workspace. Os orçamentos de tokens importam, em vez disso, para evidências pesadas, e para envios e importações, cujo texto convertido conta contra a cota do workspace quando é indexado.
Os contadores diários reiniciam no dia UTC, que pode diferir da sua meia-noite local. Um orçamento de tokens e uma contagem de perguntas são limites diferentes: uma solicitação pode atingir um antes do outro.
Uma resposta 429 pode ser um limite de taxa de curto prazo, um orçamento de Perfil ou uma cota do workspace. Leia a mensagem e os medidores antes de tentar novamente. Solicitações repetidas imediatas não reabastecem uma cota diária.
Diagnostique uma solicitação com falha
| Sintoma | O que verificar |
|---|---|
| Não é possível acessar a API | Verifique a rede com takibi version. A verificação de versão não precisa de chave, então teste uma busca depois para verificar a autenticação. |
401 | Verifique se a ferramenta consegue ler sua chave completa, e se a chave foi rotacionada ou revogada ou o Perfil pausado. Verifique também se a ação solicitada precisa de uma sessão humana. |
403 ou 404 | Verifique o ID da coleção, as concessões de documento e a capacidade necessária. Alguns recursos fora do escopo aparecem como não encontrados. Não amplie o acesso a menos que a ferramenta deva realmente tê-lo. |
409 | Atualize a tarefa antes de tentar novamente. Outro Perfil pode tê-la reivindicado, ou seu estado pode ter mudado. |
429 | Leia se este é um limite de taxa ou de orçamento diário. Reduza a velocidade das solicitações com limite de taxa; os orçamentos diários reiniciam no próximo dia UTC. |
| Falha no servidor | Mantenha a mensagem de erro, verifique a disponibilidade do serviço e tente novamente após o problema subjacente ser resolvido. Verifique se uma alteração anterior foi concluída antes de repeti-la. |
A CLI sai com 0 para sucesso, 1 para falhas de transporte ou API, e 2 para erros de uso. Para erros de uso, execute takibi --help e verifique os argumentos do comando.
Uma solicitação bem-sucedida não retornou evidências
Uma resposta sem evidências não é um erro de autenticação ou rede. O JSON a marca como abstained: true. Verifique se a fonte está indexada, se o Perfil consegue ler sua localização e se a pergunta é coberta por essa fonte.
Tente uma frase de busca específica e inspecione o texto convertido. Se o conhecimento estiver faltando ou pouco claro, atualize a fonte em vez de fazer repetidamente a mesma pergunta. Veja campos de evidência e sugestões de tópicos ausentes.