Skills
O que a sua IA sabe fazer, em pacotes.
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:
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_agenteunpin_ai_agentfixam 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_agenteunfavorite_ai_agentdefinem 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.
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.