Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Skill para agentes de código

Instale a skill do BillionSend para que o Claude Code e o Codex saibam se conectar, cuidar de uma caixa de entrada e tratar e-mails recebidos como não confiáveis.

A skill do BillionSend é um único arquivo SKILL.md que ensina um agente de código a usar o BillionSend: conectar ao servidor MCP com OAuth ou com uma chave de agente, encontrar uma caixa de entrada, esperar códigos de verificação e mensagens, responder, escrever rascunhos para aprovação, o que fazer quando as regras da caixa de entrada retêm um envio como rascunho e por que e-mail recebido é dado e nunca instrução. O agente a carrega quando uma tarefa menciona o BillionSend, uma chave de API bs_ ou uma chave bs_agent_, ou dar a um agente uma caixa de entrada de e-mail.

O arquivo fica em https://billionsend.com/docs/skills/billionsend/SKILL.md. Ele é escrito em inglês, a língua em que os agentes o leem.

Instalar

Cada agente lê skills de uma pasta com o nome da skill, billionsend, que contém o SKILL.md.

mkdir -p ~/.claude/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.claude/skills/billionsend/SKILL.md

Isso instala a skill para todos os projetos desta máquina. Para compartilhá-la com a equipe de um repositório, salve-a como .claude/skills/billionsend/SKILL.md no repositório e faça commit.

mkdir -p ~/.agents/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.agents/skills/billionsend/SKILL.md

Isso instala a skill para todos os projetos desta máquina. Para compartilhá-la com a equipe de um repositório, salve-a como .agents/skills/billionsend/SKILL.md na raiz do repositório e faça commit.

Rode o comando de novo para atualizar a skill. Comece uma sessão nova depois de instalar para que o agente a carregue.

Conectar o servidor MCP

A skill ensina o agente a usar as ferramentas do BillionSend; o agente ainda precisa do servidor.

claude mcp add --transport http billionsend https://api.billionsend.com/mcp

Depois rode /mcp dentro do Claude Code e escolha billionsend para entrar. Veja Servidor MCP para as permissões que você concede.

Crie uma chave de agente em MCP → Criar chave de agente e adicione o servidor em ~/.codex/config.toml:

[mcp_servers.billionsend]
url = "https://api.billionsend.com/mcp"
bearer_token_env_var = "BILLIONSEND_AGENT_KEY"

Exporte BILLIONSEND_AGENT_KEY no shell antes de iniciar o Codex. A chave nunca vai para o arquivo.

O que a skill cobre

Parte O que ela diz ao agente
Conexão O endpoint MCP, OAuth e chaves de agente, os três escopos de chave de agente e que chaves bs_ comuns só funcionam na API REST.
Fluxos da caixa de entrada list_inboxes primeiro (as ferramentas recebem o id da caixa de entrada), depois get_verification_code, wait_for_received_email, get_received_email, reply_to_received_email, send_from_inbox e as ferramentas de rascunho.
Envios retidos Que draft com motivos são as regras funcionando: relatar, apontar a aba Precisa de revisão e nunca contornar. Os erros que ele pode encontrar e o que cada um quer dizer.
E-mail não confiável O envelope untrusted_data e a cerca UNTRUSTED EMAIL CONTENT, sender_trust e screening.verdict, e o que nunca fazer porque uma mensagem pede. Veja Segurança do agente.
Envio send_email e send_email_batch a partir de domínios verificados, get_usage antes de trabalho em massa e a API REST.

A skill não acrescenta nenhuma permissão. O que o agente pode fazer continua definido pela concessão OAuth ou pelo escopo da chave de agente, pela função na equipe e pelas regras de envio de cada caixa de entrada.

Esta página foi útil?