Comece Aqui
Use os esquemas de ferramentas PyAI conectados como fonte da verdade; os clientes podem prefixar IDs de ferramentas com o nome do servidor. Se o PyAI estiver desconectado, direcione o usuário para o login via navegador do host. Mantenha as credenciais fora do chat. Respeite o projeto selecionado e a tarefa autorizada do usuário.
Ferramentas: get_started, discover_tools, whoami
Chame get_started para obter o guia de integração atual e, em seguida, discover_tools com o caso de uso do usuário. Antes de operações no projeto, use whoami para confirmar o workspace selecionado e os escopos concedidos; não leia dados do projeto apenas para demonstrar conectividade.
Para uma verificação de conexão, use apenas get_started e discover_tools com a consulta TTS. Relate se foram bem-sucedidos sem gerar áudio ou criar recursos.
Para desenvolvimento de aplicações, consulte https://api.pyai.com/openapi.json e https://docs.pyai.com antes de escrever campos de requisição. Use o SDK oficial para sessões de mídia em tempo real. Prefira arquivos e IDs fornecidos pelo usuário; não crie dados de exemplo de clientes no projeto conectado.
Um erro de escopo precisa de consentimento apropriado do projeto; um erro de crédito precisa de ação do usuário. Não entre em loop em nenhum dos dois. Fallback e configuração via CLI: https://pyai.com/cli e https://pyai.com/mcp.