Saltar para o conteúdo

Assistentes de IA

Assistentes que respondem por si, em privado ou em público.

Abrir Assistentes de IA
Verificado com o painel em 20 de novembro de 2026

Os Assistentes de IA têm seis métodos públicos. Atuam num assistente que já existe: a marca de favorito, a fixação, o arquivo e a sua imagem. Cada um atua em nome da conta cuja chave de API usa.

Criar um assistente, alterar a sua configuração, as suas predefinições e os seus convites, enviar um convite, ler as suas sessões 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/favorite_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_ASSISTANT_ID"}'
const res = await fetch('https://xuda.ai/cpi/favorite_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    agent_id: 'YOUR_ASSISTANT_ID',
  }),
});
const { code, data } = await res.json();
import requests

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

Uma boa resposta tem code 1. Uma recusada tem um code negativo e diz porquê em data. Veja Chamar um método para as formas do pedido.

As listas de Assistentes e de Competências partilham estes métodos, por isso o campo chama-se agent_id: é o id do assistente. Cada método recebe também um workspace_id opcional, para atuar num espaço de trabalho que não o seu. Quem chama tem de ser dono dele.

Marcar um assistente

  • favorite_ai_agent recebe agent_id e marca o assistente como favorito. É o coração no seu cartão, e a opção Favoritos no menu Mostrar da página lista-o.
  • unfavorite_ai_agent recebe o mesmo campo e retira a marca.
  • pin_ai_agent recebe agent_id e marca o assistente como fixado.
  • unpin_ai_agent recebe o mesmo campo e retira a fixação.

Arquivar um assistente

archive_ai_agent recebe agent_id e arquiva o assistente. Sai da lista Ativos e aparece em Arquivado, e as suas conversas são arquivadas com ele. Um conversation_id opcional restringe as conversas arquivadas a essa.

Só quem criou o assistente o pode arquivar. Um assistente que foi partilhado consigo é recusado com Operation not allowed. Um assistente que partilhou com outros é recusado com active share found até a partilha terminar.

Restaurar um assistente arquivado e eliminá-lo definitivamente são ações do dashboard: Desarquivar e Eliminar no menu do cartão, sob o estado Arquivado.

Desenhar uma imagem

generate_ai_agent_image recebe agent_id e desenha uma nova imagem para um assistente seu, usando o gerador que corre quando um é criado. Use-o quando um cartão mostra o marcador de posição. Corre em segundo plano como uma tarefa, e a nova imagem aparece no carregamento seguinte.

As escolhas da imagem, como o país, o género, o setor e as suas próprias palavras, o uso do seu próprio retrato e uma imagem carregada, definem-se na janela de configuração do dashboard.

O que cada plano muda

Nenhum destes métodos é restringido por um plano. O que um plano muda é o que o assistente pode fazer para os visitantes, o que não é alcançável a partir de um método. Veja Planos e faturação.

Que tal está este guia?

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