agencia-conversion/conversion-agent-plugin/novo-projeto

/conversion-agent:novo-projeto [<cliente>] [--vault <slug-do-vault>]

Cria o projeto de um cliente no Brain do Search Hub.

O que "criar projeto" significa aqui

No Search Hub, criar projeto é provisionar o Brain de um cliente que já existe no cadastro. Diga isso ao usuário se ele pedir algo que não caiba:

• O cliente precisa estar ativo e ter a squad do vault como responsável.

Não dá para criar projeto avulso, sem cliente cadastrado.

• Use o nome do cliente, não o do grupo. Ex.: o grupo Atacadão Pneus tem o

cliente Bransales; o grupo Grupo OLX tem OLX, Viva Real e ZAP Imóveis.

• Um Brain por grupo. Clientes do mesmo grupo caem no mesmo projeto.
• É idempotente: se o Brain já existe, a tool devolve o projeto existente

com created: false. Não é erro — só avise que já estava criado.

Comportamento

1. Vault. Sem --vault, liste os vaults com

searchhub_list_workspaces_projects e pergunte qual squad é a responsável pelo cliente. Mostre o nome da squad, não o slug com hash.

1. Cliente. Sem argumento, pergunte o nome do cliente como está no

cadastro. Não slugifique você mesmo — a tool faz isso com a regra do backend.

1. Criar. Chame searchhub_create_project({ ws_slug, client }).
2. Materializar. Com sucesso, chame

searchhub_materialize_project({ ws_slug, proj_slug: project.slug, set_active: true }).

1. Responder em 2 linhas: se foi criado ou já existia, e o nome do projeto

ativo. Sugira /brain para o usuário ver o contexto.

Erros — traduza assim

Quando a tool não existe

searchhub_create_project só aparece nos modos searchhub (o padrão) e parallel. Se o plugin estiver em CONVERSION_TOOLSET_MODE=legacy, não há criação pelo plugin: oriente a criar o projeto no admin de https://agent.conversion.com.br por um owner do workspace, e depois materialize com materialize_project.

Regras

• Nunca invente cliente, slug ou vault. Se o usuário não souber, pergunte.
• Não exponha curl nem a rota da API.