# Autolink iOS SDK接入文档

AutolinkChainConfig * config = [[AutolinkChainConfig alloc] init];
config.appID("appID") //配置应用信息
      .apiKey("apiKey")
      .apiSecret("apiSecret");
int ret = [AutolinkChain.getInst init:config];
NSLog("初始化结果 ret = %d",ret);

LLMConfig * config = [[LLMConfig alloc] init];
config.domain(@"generalv2");
config.url(@"ws(s)://Autolink-api.xf-yun.com/v2.1/chat");//如果使用generalv2，domain和url都可缺省，SDK默认；如果使用general，url可缺省，SDK会自动补充；如果是其他，则需要设置domain和url。
LLM *llm = [[LLM alloc] initWithConfig:config];

//同步调用
// 第一轮交互，如果不需要交互上下文，均可按照此方式调用即可
NSString *query1 = @"上海有什么景点？";
LLMOutput *output  = [llm run:query1];
if (output.errCode == 0) {
     NSLog(@"同步调用：role:%@ content:%@",output.role,output.content);
 }else{
     NSLog(@"同步调用：errCode:%d errMsg:%@",output.errCode,output.errMsg);
}

//第二轮交互，示例带历史上下文
//构造历史上下文数据
NSString *query2 = @"那帮我带一份旅游计划吧。";
NSMutableArray *array = [[NSMutableArray alloc] init];
NSMutableDictionary *item1 = [[NSMutableDictionary alloc] init];
[item1 setValue:@"user" forKey:@"role"];
[item1 setValue:query1 forKey:@"content"];
NSMutableDictionary *item2 = [[NSMutableDictionary alloc] init];
[item2 setValue:@"assistant" forKey:@"role"];
[item2 setValue:result forKey:@"content"];
NSMutableDictionary *item3 = [[NSMutableDictionary alloc] init];
[item3 setValue:@"user" forKey:@"role"];
[item3 setValue:query2 forKey:@"content"];
[array addObject:item1];
[array addObject:item2];
[array addObject:item3];
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:array options:NSJSONWritingPrettyPrinted error:&error];
NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];

//调用同步接口
output = [llm run:jsonString];
if(output.errCode == 0){
     result = output.content;
     NSLog(@"result2 ==  %@",result);
 }else{
     NSLog(@"%@",output.errMsg);
}

//实现数据回调函数
- (void)llm:(LLM *)llm onResult:(LLMResult *)result usrContext:(id)usrContext {
    NSLog(@"异步调用：content:%@  status:%d",result.content,result.status);
}
- (void)llm:(LLM *)llm onEvent:(LLMEvent *)event usrContext:(id)usrContext {
    NSLog(@"异步调用：eventID:%d  eventMsg:%@",event.eventID,event.eventMsg);
}
- (void)llm:(LLM *)llm onError:(LLMError *)error usrContext:(id)usrContext {
    NSLog(@"异步调用：code:%d  msg:%@",error.errCode,error.errMsg);
}
llm.callback = self;

//异步调用
_sema = dispatch_semaphore_create(0);
dispatch_time_t time = dispatch_time(DISPATCH_TIME_NOW, 15);
NSString *myContext = @"myContext";
self.result = @"".mutableCopy;

//第一轮交互，如果不需要交互上下文，均可按照此方式调用
NSString *query1 = @"上海有什么景点？";
int ret = [llm arun:query1 usrContext:myContext];
dispatch_semaphore_wait(_sema, DISPATCH_TIME_FOREVER);

//第二轮交互 示例带历史上下文的交互
//构造历史上下文数据
self.result = @"".mutableCopy;
NSString *query2 = @"那帮我带一份旅游计划吧。";
NSMutableArray *array = [[NSMutableArray alloc] init];
NSMutableDictionary *item1 = [[NSMutableDictionary alloc] init];
[item1 setValue:@"user" forKey:@"role"];
[item1 setValue:query1 forKey:@"content"];
NSMutableDictionary *item2 = [[NSMutableDictionary alloc] init];
[item2 setValue:@"assistant" forKey:@"role"];
[item2 setValue:self.result forKey:@"content"];
NSMutableDictionary *item3 = [[NSMutableDictionary alloc] init];
[item3 setValue:@"user" forKey:@"role"];
[item3 setValue:query2 forKey:@"content"];
[array addObject:item1];
[array addObject:item2];
[array addObject:item3];
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:array options:NSJSONWritingPrettyPrinted error:&error];
NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];

//调用异步接口
ret = [llm arun:jsonString usrContext:myContext];
dispatch_semaphore_wait(_sema, DISPATCH_TIME_FOREVER);

# 接口为流式返回，此示例为最后一次返回结果，开发者需要将接口多次返回的结果进行拼接展示
{
  "header":{
    "code":0,
    "message":"Success",
    "sid":"cht000b2d3c@dx18a980cc0beb894540",
    "status":2
  },
  "payload":{
    "choices":{
      "status":2,
      "seq":9,
      "text":[
        {
          "content":"”",
          "role":"assistant",
          "index":0
        }
      ]
    },
    "usage":{
      "text":{
        "question_tokens":15,
        "prompt_tokens":15,
        "completion_tokens":61,
        "total_tokens":76
      }
    }
  }
}

[[AutolinkChain getInst] unInit];