Habilidade de Criação de Agente Paperclip

Use esta habilidade quando for solicitado a contratar/criar um agente.

Pré-requisitos

Você precisa de:

• acesso ao quadro, ou
• permissão de agente can_create_agents=true em sua empresa

Se você não tiver essa permissão, mantenha a tarefa atual atribuída a você e identifique a autoridade de contratação ausente. Um título de CEO ou gerente não concede permissão de contratação. Não reatribua a tarefa nem crie uma tarefa de escalonamento para contornar a negação. Use o fluxo de aprovação aplicável quando disponível; caso contrário, salve uma interação de entrada humana na tarefa atual com resolverPolicy: "human_only" e continuationPolicy: "wake_assignee", então deixe-a in_review. Use o payload completo de entrada humana na habilidade paperclip; quando o usuário solicitante possui a decisão, trate-a com seu addresseeUserId real. Uma resposta humana não concede permissão por si só: verifique novamente a autorização antes de qualquer contratação.

Fluxo de Trabalho

Escolha o transporte da API

No Paperclip Runner, use as ferramentas Paperclip anunciadas. Use get_task_context e list_agents para contexto de identidade e equipe, em seguida search_api para descobrir a configuração, o modelo de instrução, o ícone e os endpoints agent-hires usados abaixo. Chame as operações descobertas com call_api; o servidor fornece o contexto da empresa e autenticação. Leia os esquemas retornados antes de redigir a contratação.

Os exemplos de shell abaixo se aplicam a adaptadores que recebem PAPERCLIP_API_URL e PAPERCLIP_API_KEY. O Paperclip Runner não fornece essas variáveis. Não procure em arquivos de workspace por um endereço de servidor ou credenciais para recriar esse caminho. Se search_api / call_api estiverem indisponíveis, relate que a contratação requer que o operador ative as ferramentas da API do runner para esta empresa. Preserve a contratação proposta na conversa; não reivindique que um agente foi criado nem substitua um subagente temporário pela contratação permanente solicitada.

1. Confirme a identidade e o contexto da empresa

curl -sS "$PAPERCLIP_API_URL/api/agents/me" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

2. Descubra a configuração do adaptador para esta instância Paperclip

curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

# Then the specific adapter you plan to use, e.g. claude_local:
curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

3. Compare as configurações de agente existentes

curl -sS "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-configurations" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

Observe as convenções de nomenclatura, ícone, linha de reporte e adaptador que a empresa já segue.

4. Descreva a função

Use um parágrafo curto de função para um novo agente: sua identidade e a responsabilidade que ele possui. Os exemplos de função são pontos de partida opcionais; para outras funções, use o guia de função base.

Instruções específicas da empresa fornecidas pelo solicitante têm precedência. Não expanda uma descrição de função em um manual de operação genérico. O harness fornece coordenação Paperclip, descoberta de habilidades e orientação do ciclo de vida da tarefa; instruções do repositório e habilidades instaladas carregam procedimentos de trabalho aplicáveis. Evite adicionar ponteiros de heartbeat, contratos de execução, comentários obrigatórios por toque, rotas fixas de revisor ou catálogos de conceitos de domínio às instruções da contratação.

Mantenha as linhas de reporte em reportsTo, as capacidades em capabilities e as habilidades em desiredSkills. Adicione detalhes de instrução apenas para um requisito concreto da empresa ou função que esses campos, a tarefa, as instruções do repositório ou as habilidades instaladas ainda não expressem.

5. Descubra ícones de agente permitidos

curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

6. Redija a configuração da nova contratação

• função / cargo / nome
• ícone (obrigatório na prática; escolha entre /llms/agent-icons.txt)
• linha de reporte (reportsTo)
• tipo de adaptador
• desiredSkills da biblioteca de habilidades da empresa quando esta função necessita de habilidades instaladas no primeiro dia
• se quaisquer desiredSkills ou configurações de adaptador expandirem o acesso ao navegador, alcance de sistema externo, escopo do sistema de arquivos ou capacidade de manuseio de segredos, justifique cada um no comentário da contratação
• configuração do adaptador e de tempo de execução alinhada a este ambiente

…