AiSwiftAssist

AISwiftAssist

Uma biblioteca Swift Package Manager (SPM) para iOS 13 e superior, projetada para simplificar a integração com a API Assistants da OpenAI em aplicativos iOS. Esta biblioteca permite que você crie assistentes com tecnologia de IA de forma eficiente e interativa.

Características

• Integração perfeita com a API Assistants da OpenAI.
• Crie e gerencie facilmente assistentes de IA com vários modelos e ferramentas.
• Lide com conversas por meio de tópicos e mensagens.
• Utilize ferramentas de intérprete de código, recuperação e chamada de função.
• Otimizado para iOS 13+ com Swift.

Instalação

Usando Xcode

Para adicionar AISwiftAssist ao seu projeto Xcode, siga estas etapas:

1. Abra seu projeto no Xcode.
2. Clique em "Arquivo" na barra de menu, selecione "Pacotes Swift" e depois "Adicionar Dependência de Pacote..."
3. Na caixa de diálogo exibida, insira a URL do repositório do pacote: https://github.com/DeveloperZelentsov/AiSwiftAssist.git .
4. Escolha a última versão a ser integrada e clique em “Avançar”.
5. Confirme os produtos e destinos do pacote e clique em “Concluir”.

Uso

Etapa 1: importar a biblioteca

Importe AISwiftAssist para o seu arquivo Swift onde você deseja usá-lo:

import AISwiftAssist

Etapa 2: inicializar o cliente

Crie uma instância do AISwiftAssistClient usando sua chave de API e ID da organização:

 let config = AISwiftAssistConfig ( apiKey : " your-api-key " , organizationId : " your-org-id " )
let aiSwiftAssistClient = AISwiftAssistClient ( config : config )

Etapa 3: crie um assistente

Para criar um assistente de IA, defina seus parâmetros como modelo, nome, descrição e instruções. Você também pode especificar ferramentas e IDs de arquivo, se necessário:

 let assistantParams = AssistantCreationParams (
    modelName : " gpt-4-1106-preview " ,
    name : " Math Tutor " ,
    description : " Your personal math tutor. " ,
    instructions : " Solve math problems and explain solutions. "
)

let creationAssistantParams = try await aiSwiftAssistClient . createAssistantAndThread ( with : assistantParams )
let assistantId = creationParams . assistant . id
let threadId = creationParams . thread . id

Etapa 4: gerenciar conversas

Enviando Mensagens

Envie uma mensagem ao seu assistente através de um tópico criado:

 let messageRequest : ASACreateMessageRequest = . init ( role : " user " , content : content )
try await aiSwiftAssistClient . messagesApi . create ( by : threadId , createMessage : messageRequest )

Iniciando uma corrida

Para processar a mensagem e receber uma resposta, inicie uma execução:

 let runRequest = ASACreateRunRequest ( assistantId : assistantId )
try await aiSwiftAssistClient . runsApi . create ( by : threadId , createRun : runRequest )

Buscando respostas

Recupere a resposta do assistente:

 let messages = try await aiSwiftAssistClient . messagesApi . list ( threadId : threadId )
// Process and display these messages, including the assistant's response.

Etapa 5: interação contínua

Continue a conversa enviando mensagens adicionais, iniciando execuções e buscando respostas. Isto cria um fluxo de comunicação dinâmico e interativo com o assistente.

Além do básico

Este é um exemplo do uso mais básico da API Assistants. Há potencial para assistentes muito mais complexos e interessantes, e continuarei a desenvolver esta API Swift para permitir que você aproveite esses recursos avançados.

Feedback e Contribuições

Agradecemos seus comentários e contribuições para aprimorar AISwiftAssist . Sinta-se à vontade para relatar problemas ou enviar solicitações pull em nosso repositório GitHub.

Licença

Esta biblioteca é distribuída sob a licença MIT.