Introdução às APIs para Desenvolvedores de Agentes de IA na TESS

O que é uma API?

Uma API (Application Programming Interface) funciona como um garçom em um restaurante. Quando você faz um pedido:

• Você (o cliente) envia uma solicitação para a API (o garçom)
• A API transmite essa solicitação ao servidor (a cozinha)
• O servidor processa a solicitação e prepara uma resposta
• A API entrega essa resposta de volta a você

Esta analogia ilustra perfeitamente o papel intermediário da API, que atua como ponte entre o usuário e o servidor da empresa.

Por que APIs são necessárias?

Existem quatro razões principais para usarmos APIs em vez de acessar diretamente os servidores:

• Segurança: As APIs fornecem uma camada de proteção, evitando acesso direto aos servidores e seus dados sensíveis
• Padronização: Mesmo empresas diferentes usam padrões semelhantes em suas APIs, facilitando o desenvolvimento de integrações
• Escala e Performance: As APIs podem limitar requisições, garantindo que o sistema não seja sobrecarregado e mantenha boa performance para todos os usuários
• Compatibilidade: A padronização das APIs permite que desenvolvedores acessem múltiplos serviços usando metodologias similares

Entendendo Requisições HTTP

As requisições HTTP (Protocolo de Transferência de Hipertexto) são como cartas enviadas a um destinatário. Cada requisição HTTP contém:

• URL - O "endereço" do servidor (ex: tess.pareto.io/api/agents/{ID}/execute)
• Método - A ação desejada (GET para obter informações, POST para enviar dados)
• Headers (Cabeçalhos) - Informações adicionais como autenticação (ex: Authorization: Bearer + Token)
• Body (Corpo) - O conteúdo da requisição, geralmente em formato JSON

Anatomia de uma Requisição HTTP para a TESS AI

Uma requisição típica para executar um agente na TESS inclui:

• URL: Endereço específico que identifica o agente a ser executado
• Método: Normalmente POST para executar ações
• Headers:
  • Authorization com seu token de acesso
  • Content-Type indicando o formato (geralmente application/json)
• Body: Dados em JSON contendo parâmetros como:
  • temperatura (nível de criatividade)
  • modelo a ser utilizado
  • mensagem a ser processada
  • ferramentas disponíveis
  • opções de espera pela execução
  • anexos (se necessário)

Exemplo de requisição HTTP

Suponha que você queira acessar a API da TESS AI e executar um agente. Você pode fazer uma requisição HTTP com a seguinte estrutura:

• URL: tess.pareto.io/api/agents/EXECUTOR
• Método: POST
• Headers: Authorization: Bearer [seu_token]
• Body: JSON com informações do agente, como temperatura e modelo.

Esta introdução prepara o terreno para os próximos treinamentos, onde serão abordadas aplicações práticas, como executar agentes via API e processar as respostas recebidas!