Parâmetros de requisição

O campo code define para que uma fonte pode ser usada no Agente de IA. O campo ajuda o sistema a entender como usar os dados. Por exemplo, se uma fonte contém uma política de devolução, ela só deve ser usada em respostas relacionadas a devoluções de produtos.

Se uma fonte tiver um código específico, o agente de IA não poderá usá-la em outros contextos. Por exemplo, um documento com o código: privacy_policy não será usado para responder a perguntas sobre envio/entrega.
No entanto, o recurso suggested_reply não leva o código em consideração, portanto, todas as fontes podem ser usadas para gerar respostas no chat.

Exemplo do Agente de IA

{
  "file_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "lang": "en",
  "url": "https://drive-c.kommo.com/download/1e8b068c-0284-580a-a87d-71534b8fde41/550e8400-e29b-41d4-a716-446655440000/Testexample.docx",
  "available_functions": ["agent"],
  "code": "privacy_policy"
}

Você adicionou uma fonte com available_functions: ["agent"] e code: "privacy_policy". Isso significa que o agente de IA só a utilizará para respostas sobre política de privacidade e não a utilizará em outros tópicos. A funcionalidade suggested_reply não indexará essa fonte ao procurar uma resposta.

Exemplo de resposta sugerida por IA


{
"file_uuid": "550e8400-e29b-41d4-a716-446655440000",
"lang": "en",
"url": "https://drive-c.kommo.com/download/1e8b068c-0284-580a-a87d-71534b8fde41/550e8400-e29b-41d4-a716-446655440000/Testexample.docx",
"available_functions": ["suggested_reply"],
"code": "shipping_policy"
}

Você adicionou uma fonte com available_functions: ["suggested_reply"]. Ao gerar respostas, essa funcionalidade não verifica o valor do campo de código, mas simplesmente usa todas as fontes disponíveis com o campo de funções disponíveis.

Existem 5 políticas únicas ao todo:

Informação de contato (contact_information)
Processamento de dados pessoais (privacy_policy)
Política de devolução (return_and_refund_policy)
Política de envio (shipping_policy)
Termos de serviço (terms_of_service)

Parâmetros de resposta

Parâmetro	Tipo de dado	Descrição
id	int	ID da fonte adicionada
name	string	Nome da fonte adicionada.
updated_at	int	Hora da última atualização da fonte. O formato da hora é Unix Timestamp.
updated_by	int	ID do último usuário a realizar uma atualização na fonte.
code	string	Valores disponíveis: contact_information privacy_policy return_and_refund_policy shipping_policy terms_of_service Se a fonte não tiver um código, este campo não aparecerá na resposta.