Assistentes de IA
Assistentes que respondem por si, em privado ou em público.
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:
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_agentrecebeagent_ide 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_agentrecebe o mesmo campo e retira a marca.pin_ai_agentrecebeagent_ide marca o assistente como fixado.unpin_ai_agentrecebe 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.