OpenAI: ação Executar assistente
- Última atualização2024/10/31
OpenAI: ação Executar assistente
A OpenAI: A ação Executar assistente usa a API de assistente do OpenAI (v2) 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. Atualmente, a API de Assistentes v2 oferece suporte a três tipos de ferramentas: Intérprete de código, Pesquisa de arquivos 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 OpenAI: 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 OpenAI Create Assistant.
Procedimento
-
Insira ou selecione os seguintes campos:
-
Clique em Carregar assistentes para selecionar um assistente existente. Você precisa autenticar (consulte OpenAI: 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 OpenAI: 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: \n\n\\[0, 1, 1, 2, 3, 5, 8, 13\\]",
"annotations": []
}
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": {
"value": "The Fibonacci sequence is a series of numbers where each number is the sum of the two preceding ones, starting from 0 and 1. Let's generate the first 8 terms of the Fibonacci sequence.",
"annotations": []
}
}
]
}
],
"status": "completed"
}O exemplo a seguir demonstra como usar o assistente com a Pesquisa de arquivos 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": "Here are the holidays listed in the attached file:\n\n1. New Year's Day\n2. Martin Luther King Jr. Day\n3. Presidents' Day\n4. Memorial Day\n5. Independence Day\n6. Labor Day\n7. Columbus Day\n8. Veterans Day\n9. Thanksgiving Day\n10. Christmas Day\n\nThese holidays were found within the attached document .",
"annotations": []
}
}
]
}
],
"status": "completed"
}- Para fazer upload de múltiplos arquivos, você pode adicionar uma lista de IDs de arquivo. Esses IDs de arquivo são identificadores exclusivos atribuídos a arquivos carregados usando a OpenAI. Para obter mais informações sobre como fazer upload e recuperar arquivos em um assistente, consulte OpenAI Files Operations.
- Os arquivos da Control Room ou arquivos de área de trabalho carregados para a OpenAI podem ser encontrados no armazenamento da OpenAI.
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_Sizn8HNIKH5NzDYXQ61n05RC",
"tool_calls":[
{
"id":"call_wCWp3g9fdWLszmSvUMqglyW5",
"type":"function",
"function":{
"name":"get_weather",
"arguments":"{\"location\":\"Chicago, IL\"}"
}
}
],
"id":"run_MBq3pioUk9K0NaREPOIY4qFG"
},
"status":"requires_action"
}