Pular para o conteúdo principal
Adicione um SKILL.md ao seu repositório para que os agentes de programação chamem o Phaseo do jeito que o seu projeto espera: a mesma URL base, a mesma variável de chave, o mesmo endpoint, os modelos aprovados e o mesmo registro em log. No fim, você tem as skills públicas do Phaseo instaladas, uma skill do projeto por cima delas e um módulo de cliente compartilhado para o qual a skill aponta. A skill e o módulo abaixo estão prontos para produção depois que você substituir os IDs de modelo e os nomes das predefinições pelos seus.
1

Instale as skills públicas do Phaseo

As skills públicas cobrem o Gateway, os SDKs, as predefinições, o roteamento e as migrações. Instale-as a partir de phaseo.app/docs:
Troque --agent pelo agente que a sua equipe usa. Deixe no seu próprio SKILL.md apenas as regras específicas do projeto.
2

Instale o SDK

3

Adicione um cliente compartilhado

Os agentes reutilizam um helper pequeno e óbvio com mais confiabilidade do que um wrapper grande. Coloque o cliente em um único módulo e importe-o em todos os lugares:
src/lib/phaseo.ts
Mantenha um único caminho de chamada para cada área que você usa, como geração de texto, embeddings, geração de imagens ou vídeo assíncrono.
4

Escreva a skill do projeto

Crie o SKILL.md na raiz do repositório ou na pasta de skills que o seu agente lê (por exemplo, .agents/skills/phaseo-project/SKILL.md). O agente lê o name e a description do frontmatter para decidir quando carregar a skill:
SKILL.md

Confira se funcionou

Peça ao seu agente para adicionar um pequeno recurso com o Phaseo, como “resumir um ticket com o Phaseo”. A alteração deve importar src/lib/phaseo.ts, ler PHASEO_API_KEY, usar um modelo ou uma predefinição aprovados e registrar o ID da resposta. Se isso não acontecer, provavelmente a description da skill não corresponde ao pedido: use as palavras que a sua equipe usa para a tarefa.

O que colocar na skill

Responda às perguntas que mais custam tempo a um agente, e a nada mais: Codex, o Vercel AI SDK e Exemplos mostram as mesmas convenções em cada ferramenta.
Última modificação em 5 de novembro de 2026