omo criar uma ação de código do tipo MCP
As ações de código do tipo MCP (Model Context Protocol) permitem definir funções personalizadas que os agentes podem executar de forma estruturada e compreensível para os modelos de IA.
CRIAR UMA AÇÃO DE CÓDIGO MCP
- Acesse a seção "Código" na barra lateral esquerda.
- Clique em Criar nova ação de código.
- Escolha o tipo AI Function.
- Será gerado um modelo básico com a estrutura mínima que deve ser seguida.
Ao clicar em "Salvar", a ação será publicada automaticamente.
Estrutura obrigatória
Toda ação MCP deve cumprir as seguintes condições:
Elemento | Descrição |
Uma única função exportada por padrão | Deve existir um único export default function. |
Parâmetros definidos | Cada parâmetro deve ter um nome, tipo de dado e descrição. |
Documentação JSDoc | A função e seus parâmetros devem estar documentados usando o formato padrão JSDoc. |
Exemplo básico
/**
* this function multiply by 2
*
* @param myNumber the number to multiply by 2
*
* @return the double
*/
export default function double(myNumber: number): number {
return myNumber * 2;
}
Detalhamento do exemplo:
Elemento | Descrição |
| Indica o bloco de documentação JSDoc. |
| Descrição geral da função. Explica o que ela faz. |
| Parâmetro: nome (myNumber), tipo (number) e descrição. |
| Valor retornado: explica o que a função retorna. |
| Define a única função exportada que será executada pelo código MCP. |
Recomendações
- Inclua sempre uma descrição clara da função e de cada parâmetro.
- Utilize nomes simples e expressivos (em inglês ou espanhol, conforme o padrão interno).
- Teste seu código com exemplos simples antes de implementá-lo em produção.
- Se você receber um erro, verifique se sua função cumpre todos os pontos mencionados acima.
Limitações atuais (modo beta)
- Funciona apenas com modelos compatíveis com MCP (ChatGPT-4).
- Não é possível importar outras funções.
- Não acessa variáveis de usuário nem permite referências cruzadas entre ações.
- Algumas funções do ambiente ainda não estão disponíveis.
Importante
As ações de código do tipo MCP estão disponíveis em modo beta. Seu funcionamento pode mudar em versões futuras.
Lembre-se de visitar nossa Central de Ajuda para obter mais informações.
Equipe Botmaker