Sabemos que, ao explorar uma plataforma inovadora como a nossa, dúvidas e desafios podem surgir. Por isso, reunimos algumas questões levantadas recentemente por nossos clientes e colaboradores, e preparamos um guia com explicações claras e soluções práticas. Nosso objetivo é garantir que você aproveite ao máximo todos os recursos da Tess AI.
O universo da API pode parecer um labirinto, mas estamos aqui para simplificar!
Você pode acessar a documentação da api da Pareto neste link aqui
API, ou Interface de Programação de Aplicações, é um conjunto de regras que permite que diferentes softwares se comuniquem entre si. Na Tess AI, a API permite que você:
Acesse recursos: Utilize nossos modelos de IA, crie agentes, gerencie seus agentes e muito mais.
Automatize tarefas: Integre a Tess AI em seus fluxos de trabalho e automatize processos.
Crie soluções personalizadas: Desenvolva aplicativos e integrações com a Tess AI que atendam às suas necessidades específicas.
Para começar a usar a nossa API, é importante entender alguns conceitos básicos:
URL Base: É o endereço principal da API, a base para todas as suas requisições. A URL base da Tess AI é: tess.pareto.io (ou similar, verifique a documentação mais recente). Importante: Certifique-se de usar a URL base da Tess AI e não a da OpenAI ou de outros serviços de IA.
Endpoints: São "endereços" específicos dentro da API que permitem realizar ações distintas. Cada endpoint é responsável por uma operação específica, como:
GET /templates: Para obter uma lista de templates.
POST /agents: Para executar um agente.
POST /chat/completions: Para iniciar uma conversa de chat com um modelo.
GET /users/me: Para obter dados do usuário autenticado.
E muito mais! Consulte a documentação da API para a lista completa.
Métodos HTTP: São ações que você pode realizar em um endpoint. Os mais comuns são:
GET: Para obter informações.
POST: Para enviar dados e criar ou atualizar recursos.
PUT: Para atualizar recursos existentes.
DELETE: Para remover recursos.
Autenticação: Para usar a API, você precisará de um token de autenticação (API Key). Ele é usado para identificar e autorizar suas solicitações. Você pode obter seu token na plataforma da Tess AI, nas configurações do seu usuário.
Formato de Dados: Geralmente, os dados são enviados e recebidos no formato JSON (JavaScript Object Notation), um formato leve e fácil de processar.
Root IDs para Conversas: Use o root_id para manter o histórico das suas conversas. Se você não incluir um root_id em uma nova solicitação, uma nova conversa será iniciada. A resposta do endpoint sempre retorna um root_id.
Modelos: Consulte a documentação para ver quais modelos estão disponíveis e quais são as suas funcionalidades.
Consumo de Tokens: Lembre-se que cada requisição usa tokens. Monitore seu consumo e otimize suas chamadas.
A API também oferece funcionalidades para:
Criar, executas e gerenciar agentes: Use o endpoint /Agentspara criar, obter, atualizar ou excluir seus templates.
Executar e gerenciar agentes: Use o endpoint /Agent Files para gerenciar os dados de nutrição de seus agentes
Erro de Autenticação (401): Verifique se seu token de API está correto e se você o está incluindo no cabeçalho da sua requisição (geralmente no cabeçalho Authorization: Bearer <seu_token>).
Erro de Endpoint Não Encontrado (404): Verifique se o endpoint que você está utilizando está correto e se você está utilizando o método HTTP adequado.
Erro de Formato de Dados (400): Verifique se você está enviando os dados no formato correto (geralmente JSON) e se todos os campos obrigatórios estão preenchidos.
Erro de Limite de Solicitações (429): Se você estiver recebendo esse erro, você está fazendo muitas solicitações em um curto período de tempo. Tente reduzir a frequência de suas requisições ou implementar um mecanismo de retry.
Mantenha-se atualizado:
A API da Tess AI pode sofrer alterações. Consulte sempre a documentação mais recente.
Estamos sempre trabalhando para melhorar nossa API e oferecer novas funcionalidades para nossos desenvolvedores. Fique de olho em nossa documentação e novidades!
Deixamos esse artigo pronto para que você possa analisar como cada modelo pode gastar créditos na Tess AI!
A API da Tess AI é uma ferramenta poderosa que permite que você construa soluções inovadoras e expanda as capacidades da nossa plataforma. Use a documentação, explore os endpoints, siga as dicas que listamos aqui e comece a transformar suas ideias em realidade!
Se você tiver alguma dúvida ou precisar de ajuda, não hesite em entrar em contato com nossa equipe de suporte.
Até a próxima!
Equipe Tess AI
