Descobrir os modelos disponíveis
Pesquisa no catálogo atual pela intenção da tarefa, em vez de inventar IDs de modelos de memória.
pesquisa no catálogo
PoYo Agent Skill oficialCódigo aberto · Verificável
Escolhe o modelo certo. Conclui a tarefa em segurança.
Instala o poyo-ai-models no teu agent de programação, liga o PoYo através de MCP ou CLI e dá ao agent um caminho fiável, da descoberta de modelos em direto até à entrega final.
Usa o PoYo no Claude Code, no Codex ou no Cursor
Cola estas duas linhas no terminal e depois fala com o teu agent. A chave fica na tua máquina.
terminal
npx -y @poyoapi/cli auth login npx skills add PoyoAPI/poyo-devtools --skill poyo-ai-models
Escolhe o teu agent quando o instalador perguntar, abre-o e diz: “Usa o PoYo para gerar uma imagem”.
Feita para agents de programação como o Codex, o Claude Code, o Cursor e o GitHub Copilot. Não usas um agent de programação? Abre a plataforma de criação do PoYo
Tarefas que podes entregar diretamente ao teu agent
Todos os exemplos pedem ao agent que compare as capacidades e os preços atuais antes de submeter com base no schema real.
Pedido ao agent / video
Transformar uma imagem de produto num vídeo curto
“Transforma esta imagem de produto numa apresentação de comércio eletrónico de cinco segundos, com um avanço lento da câmara e sem distorção do sujeito. Compara os modelos de imagem para vídeo e os preços antes de executar.”
Descobrir modelos de imagem para vídeo → ler os limites de duração → executar → consultar o task_id
O que faz a Skill
Um único guia de utilização, compacto, cobre as quatro decisões que mais vezes fazem falhar as tarefas com modelos.
Ler parâmetros e preços
Consulta os schemas em direto, os campos obrigatórios e os preços públicos antes de executar.
schema + preços
Escolher um caminho de execução
Usa o MCP para a interação com o agent e a CLI do PoYo para scripts e tarefas de CI.
MCP / CLI
Retomar trabalhos de longa duração
Guarda o task_id e distingue entre espera, sucesso e falha durante o polling.
check job
Um ciclo de vida completo da tarefa, e não uma lista de prompts
O agent passa da descoberta para a verificação do schema em direto, escolhe um caminho de execução, preserva o estado da tarefa e comunica resultados utilizáveis.
A Skill nunca substitui o catálogo, os preços ou o estado das tarefas em direto do PoYo. Ensina o agent quando e como os consultar.
agent / poyo-ai-modelsready
01Pesquisar modelosEncontra capacidades candidatas no Capability Catalog em direto.
02Ler os factosVerifica schemas, limites, preços públicos e o estado da conta.
03Escolher o caminhoUsa MCP ou CLI consoante as necessidades de interação e de automatização.
04Executar em segurançaSubmete parâmetros válidos e preserva a idempotência quando for preciso.
05Retomar tarefas longasGuarda o task_id e continua a verificar o estado a intervalos razoáveis.
06Entregar o resultadoComunica o modelo, o estado, a informação de cobrança e o resultado final.
Nunca dês uma espera por concluída
O agent tem de distinguir com exatidão entre pendente, em execução, concluída com sucesso e falhada.
Nunca repitas às cegas
Verifica o saldo e o estado e preserva os dados de idempotência e o task_id para reduzir cobranças duplicadas.
Quando deves usar MCP, CLI ou REST?
Depois da instalação, os agents continuam a escolher MCP ou CLI consoante o ambiente. Os serviços da tua aplicação continuam a usar diretamente a API REST.
PoYo MCP
Conversas com agents e clientes de programação
O raciocínio, a descoberta e a execução acontecem em conjunto
Explorar o MCPPoYo CLI
Terminais, scripts e CI
Comandos reproduzíveis, batches e automatização
Ver no GitHubAPI REST
Backends de produtos e tráfego estável de aplicações
Integração direta, controlo de filas ou streaming de tokens
Ler a documentaçãoPerguntas frequentes
As perguntas mais comuns, respondidas dentro dos limites reais do produto.
Ainda tens dúvidas? Contacta o suporte do PoYo→
É um conjunto de instruções de execução para agents de IA, que cobre a descoberta de modelos, a verificação de schemas e preços, a escolha entre MCP e CLI, a recuperação de tarefas longas e a comunicação dos resultados. Não é uma nova API de modelos e não treina nada na tua máquina.
O MCP dá ferramentas ao agent; a Skill diz-lhe em que ordem e em que condições as deve usar. Só com o MCP já é possível executar tarefas, mas a Skill reduz os parâmetros inventados, as submissões duplicadas e os erros de estado em tarefas longas.
A execução real requer uma chave de API. Executa npx -y @poyoapi/cli auth login uma vez para a guardar no keyring do sistema. Nunca coloques a chave em prompts, ficheiros do projeto nem no histórico de conversas.
Sim. A configuração funciona da mesma forma no Windows. O instalador requer Node.js 18+ e a CLI do PoYo requer Node.js 20+.
Executa npx -y @poyoapi/cli account para confirmar que a chave funciona. Se indicar que a chave é inválida, executa npx -y @poyoapi/cli auth status: uma variável de ambiente POYO_API_KEY existente sobrepõe-se à chave guardada. Depois, volta a abrir o agent para que carregue a Skill.
Não. A Skill não altera os preços dos modelos. A execução é cobrada de acordo com os preços públicos atuais do PoYo e com o pedido efetivo; o agent deve consultar e explicar essa base antes de executar.
Instala a PoYo Skill e executa a tua primeira tarefa
Cria uma chave de API, instala a Skill oficial e descreve o resultado que queres. Um único workflow verificável trata da escolha do modelo, da verificação de parâmetros e da recuperação de tarefas longas.