OpenAI: ação Executar assistente
- Atualizado: 2024/04/19
OpenAI: ação Executar assistente
A OpenAI: A ação Executar assistente usa a API de assistente do OpenAI para criar assistentes de IA em seus próprios aplicativos. Um Assistente possui instruções e pode aproveitar modelos, ferramentas e conhecimento para responder às dúvidas dos usuários. A API de Assistentes atualmente oferece suporte a três tipos de ferramentas: Interpretador de código, recuperação e chamada de função.
Pré-requisitos
- Você deve ter a função Criador de bots para usar a ação Executar assistente do OpenAI em uma automação.
- Certifique-se de ter as credenciais obrigatórias para enviar uma solicitação e de ter incluído Ação de autenticação antes de chamar qualquer ação do OpenAI.
- Compreendendo as limitações do assistente: Conhecer as capacidades e limitações do assistente ajuda a definir expectativas realistas.
Este exemplo mostra como carregar um assistente existente na ação Executar assistente do OpenAI para obter uma resposta adequada. Se você estiver interessado em aprender como criar seu próprio assistente, consulte Assistente de criação OpenAI.
Procedimento
-
Insira ou selecione os seguintes campos:
-
Clique em Carregar assistentes para selecionar um assistente existente. Você precisa autenticar (consulte Ação de autenticação) com a chave de API.
- Conectar ao OpenAI é exibido. Você pode inserir a chave de API por meio de uma credencial salva na guia Credencial ou selecionar a guia String insegura para colar diretamente a chave de API.
- O ID do assistente selecionado é exibido no campo ID do assistente.
Nota: Compreender as limitações de um assistente antes de selecioná-lo é crucial para uma experiência de usuário tranquila. Imagine solicitar uma reserva de voo e descobrir que o assistente não consegue acessar os sistemas de reservas. Ao se familiarizar previamente com os recursos de um assistente, você pode evitar esses cenários frustrantes.
-
Clique em Carregar assistentes para selecionar um assistente existente. Você precisa autenticar (consulte Ação de autenticação) com a chave de API.
O exemplo a seguir demonstra como usar o assistente com o interpretador de código habilitado para gerar os primeiros oito termos da sequência de Fibonacci.
A resposta da automação acima é a seguinte:
{
"metadata":{
},
"data":[
{
"role":"assistant",
"content":[
{
"type":"text",
"text":{
"value":"The first 8 terms of the Fibonacci sequence are: 0, 1, 1, 2, 3, 5, 8, 13.",
"annotations":[
]
}
}
]
}
],
"status":"completed"
}O exemplo a seguir demonstra como usar o assistente com a recuperação habilitada. Neste cenário, o assistente lerá o arquivo anexado para gerar a resposta.
A resposta da automação acima é a seguinte:
{
"metadata":{
},
"data":[
{
"role":"assistant",
"content":[
{
"type":"text",
"text":{
"value":"The holidays listed in the 2024 USA holiday schedule are as follows:\n\n1. New Year\u0027s Day: January 1, Monday\n2. MLK Day: January 15, Monday\n3. President\u0027s Day: February 19, Monday\n4. Memorial Day: May 27, Monday\n5. Juneteenth: June 19, Wednesday\n6. Independence Day: July 4, Thursday\n7. Labor Day: September 2, Monday\n8. Thanksgiving Day: November 28, Thursday\n9. Day after Thanksgiving: November 29, Friday\n10. Christmas Eve: December 24, Tuesday\n11. Christmas Day: December 25, Wednesday\n12. New Year\u0027s Eve: December 31, Tuesday",
"annotations":[
]
}
}
]
}
],
"status":"completed"
}
O exemplo a seguir demonstra como usar o assistente com uma função. Neste cenário, imagine que você deseja que seu assistente recupere informações meteorológicas. Alimentando-o com uma nova função chamada get_weather (junto com uma descrição e parâmetros), você equipa o assistente com essa nova habilidade.
{
"name": "get_weather",
"description": "Determine weather in my location",
"parameters":
{
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state e.g. San Francisco, CA"
},
"unit": {
"type": "string",
"enum": [
"c",
"f"
]
}
},
"required": [
"location"
]
}
}A saída JSON após a imagem abaixo destaca o status do assistente como requires_action. Isso indica que o assistente aguarda sua entrada sobre como proceder. Agora você pode usar o OpenAI: ação Executar função de assistente para instruir o assistente sobre como usar a função get_weather recém-introduzida e formular uma resposta adequada com base nos dados recuperados.
A resposta da automação acima é a seguinte:
{
"data":{
"thread_id":"thread_Aq8I25CKOFAZ50GkVDH4gZXw",
"tool_calls":[
{
"id":"call_zkehFEVLaXyuEND9kSRgq4O1",
"type":"function",
"function":{
"name":"get_weather",
"arguments":"{\"location\":\"Chicago, IL\"}"
}
}
],
"id":"run_s3jWsc8H2xaGV6E28CevuXsG"
},
"status":"requires_action"
}