> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure seu agente de código

> Instale as skills e ferramentas da Polymorfa, preserve a configuração existente e verifique uma leitura permitida.

Dê esta instrução ao seu agente de código:

```text theme={null}
Read https://docs.polymorfa.com/agent-setup/prompt.md and set up Polymorfa for this project. Preserve existing configuration and verify a permitted read before changing remote resources.
```

## Contexto

Inspecione o repositório, o gerenciador de pacotes, o cliente do agente e a configuração da Polymorfa existente. Use o [índice da documentação](https://docs.polymorfa.com/llms.txt) para encontrar o guia do recurso escolhido. Uma recomendação não concede acesso ao recurso.

Leia o código e a configuração antes de fazer perguntas. Deduza do projeto fatos
como a linguagem, o modelo de hospedagem, o provedor existente e a implementação
de webhooks. Pergunte apenas sobre decisões em aberto que mudem a recomendação.
Diferencie o comportamento existente, os planos de migração e os padrões
iniciais; explique os conflitos em vez de tratar um padrão como decisão sua.

## Tarefa

1. Instale as skills de [polymorfa/agent-kit](https://github.com/polymorfa/agent-kit) pelo instalador de plugins ou de skills do cliente. Siga as instruções de instalação do repositório para o agente em uso.
2. Conecte o MCP público da documentação em `https://docs.polymorfa.com/mcp`. Reutilize uma conexão válida existente em vez de adicionar uma duplicada. Verifique se ele consegue pesquisar um guia da Polymorfa.
3. Se o projeto precisar da CLI, siga o [guia da CLI](/pt-br/tools/cli-api). O pré-lançamento de desenvolvimento publicado exige Node.js 22 ou posterior. Confira a versão instalada antes de alterá-la.
4. Se a tarefa precisar de dados de clientes, configure o [MCP hospedado da API](/pt-br/integrations/mcp-server) com uma credencial da Polymorfa com escopo definido, fornecida pelo mecanismo de segredos do cliente do agente. O MCP da documentação, o MCP hospedado da API e o MCP local da CLI são conexões separadas.
5. Inspecione os números, as credenciais e os webhooks do projeto escolhido. Use o checklist de configuração do projeto para identificar o que falta configurar e os guias de recursos para planejar o próximo passo.

As credenciais de API existentes autorizam o MCP hospedado. Não invente um fluxo de acesso OAuth nem presuma que instalar um plugin concede acesso a uma equipe ou a um projeto.

## Restrições

Ao criar uma interface, use botões visíveis preenchidos ou com contorno, rótulos
legíveis, seleção e foco de teclado claros e áreas de toque utilizáveis.
Reutilize respostas salvas. Confira a tarefa renderizada nos temas claro e
escuro, no desktop e no celular.

Preserve a configuração existente e os arquivos não relacionados. Mescle apenas as entradas necessárias para a Polymorfa. Não sobrescreva outra conexão MCP nem ative a aprovação automática de todas as ferramentas.

Mantenha as credenciais fora de arquivos de código, logs, URLs, chats e prompts copiados. Peça ao usuário que entre na conta ou informe o segredo quando o cliente exigir. Aguarde antes de continuar um trabalho que dependa dessa etapa.

Respeite o escopo autorizado pelo usuário. Peça aprovação antes de enviar uma mensagem, criar ou excluir recursos remotos ou gerar cobranças, a menos que esses efeitos já tenham sido autorizados. Não tente novamente uma escrita cujo resultado seja incerto.

Comece em Desenvolvimento. Verifique as capacidades do número, o acesso a recursos e os requisitos de opt-in antes de configurar chamadas, catálogos, histórico de mensagens ou envio em produção. Salvar um modelo, uma campanha, um fluxo ou um webhook não comprova que a entrega funcionou.

## Verificação

Confirme a versão da CLI, se estiver instalada, descubra as ferramentas do MCP e faça uma leitura permitida se houver uma credencial disponível. Não envie uma mensagem de teste automaticamente.

Informe estes resultados separadamente: instalação local, pesquisa na documentação, acesso autenticado ao projeto, configuração salva e qualquer entrega real testada explicitamente. Indique a etapa bloqueada quando faltar uma credencial, uma permissão, uma inscrição ou uma integração configurada.

## Planeje a integração do seu projeto

Escolha **Configurar com seu agente de IA** durante o onboarding do Console. A
opção **Recomendado** mostra **Funciona com** e os ícones dos agentes de código.
**Peça ao seu agente de código** contém o prompt, o botão **Copiar prompt** e o
campo para o bloco de resposta em JSON. O campo mostra um exemplo de JSON até
você colar a saída. **Cole a saída JSON aqui** aparece acima dele; um erro de
importação ou de salvamento substitui esse texto de ajuda sem mover o campo.
Peça ao agente que inspecione a sua integração, explique as recomendações e
pergunte sobre as escolhas que ele não consegue deduzir do código. Quando
disponível, o agente usa `request_user_input` ou `AskUserQuestion` para
perguntar a você. As decisões que nenhum de vocês responder podem ficar em
aberto para você concluir no Console depois.

O seu próprio negócio inclui atender os seus compradores ou os clientes do seu
restaurante. Um produto para outras empresas conecta números que pertencem a
essas empresas. Chamadas de voz são diferentes de mensagens de áudio e de
conversão de texto em fala. O código de um provedor existente descreve o seu
ponto de partida; ele não determina qual conexão você quer depois da migração.

O prompt fornece o formato da resposta, os valores permitidos e o significado de
cada um. Peça ao agente que retorne todos os campos obrigatórios e que coloque
as evidências e as escolhas em aberto fora do bloco JSON. A primeira interação pergunta o que você quer mudar e como deve funcionar. O agente espera
a sua resposta e então começa o trabalho combinado. Você pode adicionar um único
recurso ou migrar parte de uma integração; a migração completa é opcional.

Conectar números, enviar mensagens e realizar ações pagas exige a sua autorização.

As perguntas reaproveitam as respostas que você já deu. A sua plataforma atual e
a conexão pretendida levam às perguntas de migração relevantes. Os resultados de
negócio definem quais recursos entram no checklist. Controle do fluxo de
trabalho, armazenamento de conversas e hospedagem só levam a outras perguntas
quando se aplicam. Quem usa a Polymorfa para o próprio negócio pode escolher o
básico; qualquer pessoa pode pular direto para o projeto.

Cole o bloco de respostas em **Importar respostas do agente**. Respostas
completas podem ser salvas com **Concluir**. Se o agente deixar decisões sem
resposta, **Continuar** abre apenas as perguntas restantes relevantes. Você
também pode escolher **Concluir** para salvar o que já tem e deixar essas
decisões explicitamente como desconhecidas. O Console monta o checklist a partir
das respostas confirmadas. Importar respostas não concede acesso a recursos,
não altera a retenção, não move modelos nem executa uma migração de sessão. A
importação aceita apenas as opções listadas; não inclua credenciais nem
snapshots de sessão.

Para mudanças posteriores, abra **Editar plano** no checklist do projeto e
depois **Pergunte ao seu agente**. Cada pergunta manual inclui **Perguntar ao
seu agente**. As perguntas adiadas viram um prompt de acompanhamento no final,
com as respostas que você já deu. O agente preenche as escolhas em aberto; uma
importação que altera uma resposta confirmada é recusada. Você pode voltar às
perguntas comuns para o que ele deixar de fora.

Consulte [Configuração do projeto](/console/overview#project-setup) para ver os requisitos de conclusão.

O agente pode incluir nas respostas o pacote da biblioteca ou o nome do provedor
que você já usa e o seu site público. Esses dados ficam salvos para prompts de
configuração futuros. Na configuração manual, **Outro provedor** abre **Especifique qual solução você usa**, uma caixa de texto para a sua descrição. Você não precisa de um nome de pacote nem de uma URL.

Se o agente conseguir ler o inventário completo de números conectados, ele
informa a contagem observada e quando verificou. Se você já tem uma
configuração, mas o agente não consegue ler o inventário dela, ele pede uma
faixa. Começar do zero deixa os dois campos de contagem vazios. A configuração manual só pede uma faixa se você já tem usuários de WhatsApp. Essa pergunta vem antes da etapa separada sobre a solução existente; uma faixa nunca é convertida em uma contagem exata.

Selecionar **101–500** ou **501+** números conectados mostra a oferta do
Builders Program. **Qual solução você já usa?** mostra o Suporte aprimorado para
a sua solução existente. Cada oferta inclui os benefícios e uma nota de
elegibilidade. Dispense a oferta, ou deslize-a para o lado no celular, para
continuar a configuração.

Selecione uma resposta para habilitar **Continuar**. Para sair das perguntas ou
da importação do agente sem salvar uma seleção de recursos, use **Pular** na
barra de ações inferior.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.