Prompts prontos de uma fonte de ferramentas

Além das ferramentas, uma fonte de ferramentas pode publicar prompts prontos: instruções que os próprios autores da fonte já escreveram para o assunto dela — um roteiro de "resumo executivo de um documento", por exemplo, publicado ao lado de uma fonte que lê arquivos. Anexar um desses prompts a um especialista faz o agente enxergá-lo como se fosse uma habilidade dele: o agente pode abrir o texto e seguir as instruções durante a conversa.

dica

Isso é diferente de instalar as ferramentas da fonte. Uma fonte pode publicar ferramentas, prompts prontos, ou os dois — e anexar um não anexa o outro. Veja Fontes de ferramentas (MCP).

Como anexar

Pela tela

No editor do especialista, a seção Prompts prontos lista os prompts de cada fonte que o especialista já referencia em tools, agrupados por fonte, cada um com uma caixa Anexar. Marque os que quiser e suba a versão do especialista — como qualquer outra mudança na configuração.

Prompt que exige um parâmetro aparece desabilitado na lista, com o motivo: a plataforma não tem como preencher esse valor sozinha, então não oferece a opção de anexar. Prompt que só tem parâmetros opcionais é anexável normalmente e roda sem eles.

No arquivo do especialista

Liste cada prompt anexado no campo installed_prompts, no formato fonte.prompt — a mesma fonte que aparece em tools:

tools:
  - documentos.ler_arquivo

installed_prompts:
  - documentos.resumo-executivo

Anexar as ferramentas de uma fonte não anexa os prompts dela. São duas listas independentes, de propósito — declare cada prompt que o especialista deve seguir. Como em qualquer outra edição, a mudança só vale depois de subir o version do especialista.

Como o agente usa um prompt anexado

Um prompt anexado se comporta como uma habilidade: o agente enxerga o nome e decide, pelo conteúdo, quando ele se aplica à conversa.

O conteúdo é buscado na fonte a cada conversa — se os autores da fonte publicarem uma versão nova do prompt, o especialista passa a segui-la a partir da próxima conversa (a plataforma guarda o resultado em cache por alguns minutos, então uma atualização muito recente pode levar um pouco para aparecer).

Se a fonte estiver fora do ar, ou se o prompt tiver sido removido dela, a conversa continua normalmente — o especialista simplesmente fica sem aquela habilidade naquela conversa. Não é um erro, e nada trava.

Limites

• Exemplos de resposta que a fonte incluir no prompt são mostrados ao agente como exemplos — nunca como coisas que ele já disse na conversa.
• Imagem ou áudio dentro de um prompt não aparece. Um aviso marca que havia esse conteúdo ali, mas o arquivo em si não chega ao agente.
• Prompt muito longo é cortado no mesmo limite de um arquivo de habilidade.
• Conversa sem usuário identificado (widget público, WhatsApp aberto): vale a mesma regra das ferramentas — se a fonte não permite acesso sem usuário identificado, ela não é consultada, então os prompts dela também não ficam disponíveis ali. Veja Fontes de ferramentas (MCP).

Perguntas frequentes

O prompt aparece desabilitado, o que fazer? Ele exige um parâmetro que a plataforma não tem como preencher sozinha. Um prompt só com parâmetros opcionais pode ser anexado normalmente, sem preencher nada.

Anexei um prompt e o agente não usa. Confira se a versão do especialista foi incrementada — sem isso a mudança não entra em vigor. Se já subiu, lembre que o conteúdo do prompt é quem decide quando ele se aplica: foi escrito pelos autores da fonte, não por você, e às vezes não deixa claro em que situação usar. Não há como editar esse texto por aqui — ele pertence à fonte.

A fonte mudou o prompt, quando o agente vê a versão nova? Na próxima conversa. A plataforma busca o conteúdo do prompt de novo a cada conversa, com um cache de poucos minutos — então uma atualização muito recente pode não aparecer de imediato.