Saltar para o conteúdo

Skills

O que a sua IA sabe fazer, em pacotes.

Abrir Skills
Verificado com o painel em 20 de novembro de 2026

A API pública tem sete métodos para competências. A API ainda chama a uma competência um agente de IA, por isso esse é o nome em todos os métodos. Atuam em competências que já existem: fixam uma, marcam uma como favorita, arquivam uma, criam-lhe uma imagem e registam um consentimento. Cada um atua em nome da conta cuja chave de API usa.

Criar uma competência, planear uma a partir das suas palavras, alterar as suas instruções ou ferramentas, clonar, instalar a partir do marketplace, publicar, partilhar, desarquivar, eliminar e escolher um plano faz-se no dashboard. Não têm hoje método público.

Envie um pedido a um método com a sua chave:

curl -s https://xuda.ai/cpi/pin_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_SKILL_ID"}'
const res = await fetch('https://xuda.ai/cpi/pin_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', agent_id: 'YOUR_SKILL_ID' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/pin_ai_agent',
    json={'api_key': 'YOUR_API_KEY', 'agent_id': 'YOUR_SKILL_ID'},
)

Uma boa resposta tem code 1. Uma recusada tem um code negativo e diz porquê em data.

Todos os métodos recebem o id da competência como agent_id, que é a última parte do endereço da competência no dashboard. Exceto set_agent_tool_consent, cada um recebe também um workspace_id opcional, para atuar num espaço de trabalho que não o seu principal. Tem de ser dono desse espaço de trabalho.

Fixar e marcar como favorita

  • pin_ai_agent e unpin_ai_agent fixam uma competência e retiram a fixação. O dashboard é avisado de imediato, por isso uma página aberta mostra a alteração.
  • favorite_ai_agent e unfavorite_ai_agent definem e limpam a marca de favorita, o coração no cartão da competência. Um favorito é também o que a opção Favoritos do menu Mostrar lista.

Arquivar

archive_ai_agent tira uma competência da lista de ativas e passa-a para Arquivado. Uma competência arquivada deixa de contar para o número que o plano do espaço de trabalho comporta, o que é uma forma de abrir espaço sob um limite.

  • Só a pessoa que criou a competência a pode arquivar. Para qualquer outra pessoa a resposta é uma recusa que diz que a operação não é permitida.
  • Uma competência que partilhou com outros é recusada enquanto essa partilha estiver ativa. Termine primeiro a partilha.
  • conversation_id é opcional. Com ele, só essa conversa da competência é arquivada. Sem ele, todas as conversas da competência são arquivadas com ela.

Trazer uma competência de volta, ou eliminá-la definitivamente, faz-se no dashboard, a partir da vista Arquivado.

Criar uma imagem

generate_ai_agent_image cria uma nova imagem para uma competência sua e guarda-a na competência. Use-o quando uma competência não tem imagem e o seu cartão recorre ao marcador de posição. Corre em segundo plano, por isso a nova imagem aparece da próxima vez que a competência for carregada. É o mesmo que Gerar imagem no menu do cartão.

Permitir que uma competência instalada use as ferramentas do seu editor

set_agent_tool_consent regista se permite que uma competência instalada use ferramentas de plugins que correm no espaço de trabalho do seu editor. Tudo o que essas ferramentas criam fica guardado no drive do editor e não no seu. Recebe agent_id e granted, true para permitir e false para retirar, e opcionalmente owner_uid, a conta do editor. Regista apenas a sua própria decisão, nunca a de outra pessoa.

A contagem de uma competência e o seu plano

As competências são contadas pelo plano do espaço de trabalho em que estão. Veja Planos e faturação para o que conta e o que acontece no limite.

Que tal está este guia?

Última atualização em 16 de novembro de 2026