Pergunte a um Especialista Humano

Visão Geral

O Instant Expert envia uma pergunta paga da conta do usuário para profissionais reais: executivos, operadores e especialistas no assunto que ele encontra a partir de uma descrição, ou uma pessoa específica que o usuário nomeia. Cada pergunta é uma questão para uma resposta escrita ou por voz, ou uma chamada de 15 a 60 minutos. A pessoa só é paga se responder ou agendar, e o usuário só é cobrado nesse momento. Use para trabalho de conhecimento (julgamento e experiência em primeira mão de pessoas específicas), não para recados ou tarefas físicas.

O agente gerencia as ferramentas MCP do Instant Expert. Quando elas não estão conectadas, ele chama o servidor de teste gratuito com curl, para que todo o fluxo possa ser testado sem conta ou cartão. Adaptado da skill oficial, que também inclui um pequeno script auxiliar de modo de teste: https://github.com/Instant-Expert/skills

Quando Usar Esta Skill

• Use quando a resposta precisar da experiência de um profissional em vez de uma página da web: "Quanto tempo levou o SOC 2 Tipo II para você?", "Como as equipes de sinistros em seguradoras de médio porte triam?"
• Use para descoberta de clientes, entrevistas com usuários, contribuições de especialistas ou uma primeira conversa com um tipo de comprador.
• Use quando o usuário nomear alguém para contatar: "Jane Doe, VP de Vendas na Acme", um URL do LinkedIn ou um e-mail.
• Use quando o usuário perguntar se alguém respondeu a uma pergunta anterior.
• Não use para encontrar detalhes de contato pessoal, obter informações confidenciais ou material não público, para tarefas físicas ou para enviar mensagens a pessoas que o usuário não aprovou.

Como Funciona

Etapa 1: Escolha o modo

Se a sessão já tiver as ferramentas MCP do Instant Expert (search_people, queue_requests, prepare_request_order e assim por diante), chame-as diretamente. Um resultado com "test_mode": true veio do modo de teste; qualquer outra coisa é a conta ativa do usuário.

Caso contrário, inicie um sandbox de teste gratuito de 24 horas. Nenhuma conta ou cartão é necessário, e cada rede pode iniciar 5 por hora, então reutilize o token até que ele expire:

mkdir -p ~/.config/instant-expert
curl -sS -X POST https://instant.expert/api/sandbox -o ~/.config/instant-expert/sandbox.json

O JSON salvo tem token, expires_at e mcp_url. Chame uma ferramenta postando um JSON-RPC tools/call para o servidor de teste. Ele é sem estado, então nenhuma etapa initialize é necessária:

curl -sS https://instant.expert/mcp/test \
  -H "Authorization: Bearer $(sed -n 's/.*"token":"\([^"]*\)".*/\1/p' ~/.config/instant-expert/sandbox.json)" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_requests","arguments":{}}}'

A resposta está em result.structuredContent (o mesmo JSON está em result.content[0].text). result.isError: true significa que a ferramenta rejeitou a chamada; leia sua mensagem. Use "method":"tools/list" para ver todas as ferramentas e seus argumentos. Um HTTP 401 significa que o sandbox expirou, então inicie um novo.

O modo de teste tem cerca de 300 pessoas fictícias em empresas fictícias, então uma busca de nicho retorna as correspondências fictícias mais próximas. Convites são registrados em vez de enviados, as pessoas fictícias respondem em segundos e os pedidos usam um cartão de teste Stripe. Nada atinge uma pessoa real ou move dinheiro real. Informe ao usuário uma vez que os resultados são simulados.

Etapa 2: Escolha quem perguntar

Ferramentas que iniciam o trabalho (search_people, import_people, queue_requests) retornam um job_id. Consulte get_job, esperando poll_after_seconds entre as chamadas, até que status seja succeeded ou failed. Dê a cada nova operação seu próprio idempotency_key e reutilize uma chave apenas para tentar a mesma chamada novamente.

• Uma pessoa nomeada com um URL do LinkedIn ou e-mail: pule a busca e passe people para queue_requests, por exemplo [{"linkedin_url": "https://www.linkedin.com/in/..."}].
• Uma pessoa nomeada com apenas nome e empresa: chame import_people com people definido como [{"name": "...", "company": "..."}], depois get_search. Se não houver correspondência, peça ao usuário um URL do LinkedIn ou e-mail.
• Um tipo de pessoa: chame search_people uma vez com toda a solicitação, incluindo quantas pessoas e quaisquer exclusões, depois leia a lista com get_search (page_size: 100).
• Apenas um objetivo ("estamos construindo X, com quem devemos falar?"): chame plan_outreach com um description, deixe o usuário escolher um público, depois execute seu search_query através de search_people.

Etapa 3: Redija a pergunta

Chame queue_requests com search_id (mais person_profile_ids para manter um subconjunto) ou people, e:

…